Gah - a solution with more questions. – EntropicLqd

Legacy:EnhancedItems

From Unreal Wiki, The Unreal Engine Documentation Site
Jump to: navigation, search

Overview[edit]

Created by: Wormbo

The EnhancedItems package can be used to create mods with interesting features:

  • firing speed of weapons can easily be changed by inventory items
  • death and suicide messages based on the weapon or projectile that caused the death
  • multiple pickups spawning at the same location (similar to the method used by Chaos UT)
  • some fixes and new features for the UWindow system like auto-size for combo boxes and the ability of creating complex pulldown menus (these are also available as Open Source scripts)
  • an enhanced player icon (EIChallengeHUD package)
  • extended INT file definitions (can also be used by non-EnhancedItems mods)
  • many more...

Downloads[edit]

Note: Like the UnrealScript Source downloads for UT200x, the EnhancedItems source should only be used as a reference.

Do not recompile the EnhancedItems, EIChallengeHUD or MIConverter packages!

EnhancedItems is currently used in Rockets UT, Arena Match, BUF Bonus Pack, Quake 3 Tournament, the Enhanced Items Mod, Who Pushed Me? and various smaller mutators.
There will be no EnhancedItems package for Unreal Tournament 200x.

Class Overview[edit]

Also see Legacy:EnhancedItems/Class Hierarchy for the full class tree of all EnhancedItems classes.

Package: EnhancedItems[edit]

Actor (UT) subclasses:[edit]

These are used for visual effects. If an effects causes damage it can also use the new death messages.

EnhancedMutator subclasses class can easily create and modify MultiPickupPlus actors. They can also replace the DMMutator (UT's BaseMutator for most gametypes) with EIDMMutator, a configurable version of DMMutator. The mutator can then choose, which Unreal weapons and items should be replaced by their UT counterparts.

EnhancedArena can be used to create Arena mutators that keep the Translocator and have some other small enhancements.

EIDeathMessageMutator and MIConverter are utility classes that are spawned automatically by EnhancedMutators. The EIDeathMessageMutator handles the extended death message support in EnhancedItems-based mods, while the MIConverter converts Chaos UT MultiItems to MultiPickupPlus actors.

The MultiPickupPlus is a nice tool for coders as well as mappers. If placed on the map it can spawn a random item from a given list. Once that item is picked up the MPP spawns another (probably the same) item from the list.

See MultiPickupBase for a UT2003 version of this actor.

EnhancedProjectiles can display death messages indepentantly from the weapon the player used or currently holds.

EnhancedWeapons allow HUD mutators and PickupPlus items to draw on the Canvas right before or after the RenderOverlays function is executed. This function is called before the HUD mutators' PostRender function.

The firing speed of an EnhancedWeapon can be changed easily from the PickupPlus class.

The PickupPlus class and it's subclasses can be used to create complex items that can interact with each other and with EnhancedWeapons. The effects of multiple PickupPlus items can stack, i.e. if two items want to increase the player's speed or want to be the Affector of the player's weapon they don't have to access those values directly. Instead they call special functions (in this case SetOwnerSpeed() or RegisterAsAffector(Weapon)) and the PickupPlus code applies the changes, respecting the changes made by the other item.

Object (UT) >> UWindowBase subclasses:[edit]

Various improvements for the UWindow system. The editbox, combobox and checkbox controls allow automatic resizing. The dialog client window displays help texts of its controls by default. The pull-down/pop-up menus allow any number of submenus.

Package: EIChallengeHUD[edit]

Actor (UT) >> Info (UT) >> Mutator (UT) >> Legacy:EnhancedItems/EnhancedMutator >> EIChallengeHUD >> CustomHUDIcon

The CustomHUDIcon class is used by the enhanced player status icon HUD mutator (EIChallengeHUD) to customize the appearance of the status icon in non-standard game types.

Related Topics[edit]

  • Open Source
  • EWindow – a precompiled package with all kinds of UWindow enhancements including new radioboxes
  • MultiPickupBase – the UT2003 version of the MultiPickupPlus class