This class allows you to modify and use hooks for all items, including vanilla items. Create an instance of an overriding class then call Mod.AddGlobalItem to use this. More...

Inherits Terraria.ModLoader.GlobalType< Item, GlobalItem >.

Inherited by Terraria.ModLoader.Default.UnloadedGlobalItem.

Public Member Functions
virtual void	AddRecipes ()
	This is essentially the same as Mod.AddRecipes or ModItem.AddRecipes. Use whichever method makes organizational sense for your mod.

virtual bool	AllowPrefix (Item item, int pre)
	Force a re-roll of a prefix by returning false.

virtual bool	AltFunctionUse (Item item, Player player)
	Allows you to make an item usable by right-clicking. Returns false by default. When the item is used by right-clicking, player.altFunctionUse will be set to 2.

virtual void	AnglerChat (int type, ref string chat, ref string catchLocation)
	Allows you to set what the Angler says when the Quest button is clicked in his chat. The chat parameter is his dialogue, and catchLocation should be set to "Caught at [location]" for the given type. More...

virtual void	ArmorArmGlowMask (int slot, Player drawPlayer, float shadow, ref int glowMask, ref Color color)
	Allows you to modify which glow mask and in what color is drawn on the player's arms. Note that this is only called for body armor. More...

virtual void	ArmorSetShadows (Player player, string set)
	Allows you to determine special visual effects a vanity has on the player without having to code them yourself. More...

virtual bool	CanAccessoryBeEquippedWith (Item equippedItem, Item incomingItem, Player player)
	Allows you to prevent similar accessories from being equipped multiple times. For example, vanilla Wings. Return false to have the currently equipped item swapped with the incoming item - ie both can't be equipped at same time.

virtual ? bool	CanAutoReuseItem (Item item, Player player)
	Allows you to modify the autoswing (auto-reuse) behavior of any item without having to mess with Item.autoReuse. Useful to create effects like the Feral Claws which makes melee weapons and whips auto-reusable. Return true to enable autoswing (if not already enabled through autoReuse), return false to prevent autoswing. Returns null by default, which applies vanilla behavior. More...

virtual ? bool	CanBeChosenAsAmmo (Item ammo, Item weapon, Player player)
	Whether or not the given ammo item is valid for the given weapon; called on the ammo. If this, or CanChooseAmmo on the weapon, returns false, then the ammo will not be valid for this weapon. By default, returns null and allows Item.useAmmo and Item.ammo to decide. Return true to make the ammo valid regardless of these fields, and return false to make it invalid. If false is returned, the CanConsumeAmmo, CanBeConsumedAsAmmo, OnConsumeAmmo, and OnConsumedAsAmmo hooks are never called. More...

virtual bool	CanBeConsumedAsAmmo (Item ammo, Item weapon, Player player)
	Whether or not the given ammo item will be consumed; called on the ammo. By default, returns true; return false to prevent ammo consumption. If false is returned, the OnConsumeAmmo and OnConsumedAsAmmo hooks are never called. More...

virtual ? bool	CanBurnInLava (Item item)
	Returns whether or not this item will burn in lava regardless of any conditions. Returns null by default (follow vanilla behaviour).

virtual ? bool	CanCatchNPC (Item item, NPC target, Player player)
	Allows you to determine whether the given item can catch the given NPC. Return true or false to say the given NPC can or cannot be caught, respectively, regardless of vanilla rules. Returns null by default, which allows vanilla's NPC catching rules to decide the target's fate. If this returns false, CombinedHooks.OnCatchNPC is never called. NOTE: this does not classify the given item as an NPC-catching tool, which is necessary for catching NPCs in the first place. To do that, you will need to use the "CatchingTool" set in ItemID.Sets. More...

virtual ? bool	CanChooseAmmo (Item weapon, Item ammo, Player player)
	Whether or not the given ammo item is valid for the given weapon; called on the weapon. If this, or CanBeChosenAsAmmo on the ammo, returns false, then the ammo will not be valid for this weapon. By default, returns null and allows Item.useAmmo and Item.ammo to decide. Return true to make the ammo valid regardless of these fields, and return false to make it invalid. If false is returned, the CanConsumeAmmo, CanBeConsumedAsAmmo, OnConsumeAmmo, and OnConsumedAsAmmo hooks are never called. More...

virtual bool	CanConsumeAmmo (Item weapon, Item ammo, Player player)
	Whether or not the given ammo item will be consumed; called on the weapon. By default, returns true; return false to prevent ammo consumption. If false is returned, the OnConsumeAmmo and OnConsumedAsAmmo hooks are never called. More...

virtual ? bool	CanConsumeBait (Player player, Item bait)
	Allows you to choose if a given bait will be consumed by a given player Not consuming will always take priority over forced consumption More...

virtual bool	CanEquipAccessory (Item item, Player player, int slot, bool modded)
	Allows you to disallow the player from equipping an accessory. Return false to disallow equipping the accessory. Returns true by default. More...

virtual ? bool	CanHitNPC (Item item, Player player, NPC target)
	Allows you to determine whether a melee weapon can hit the given NPC when swung. Return true to allow hitting the target, return false to block the weapon from hitting the target, and return null to use the vanilla code for whether the target can be hit. Returns null by default.

virtual bool	CanHitPvp (Item item, Player player, Player target)
	Allows you to determine whether a melee weapon can hit the given opponent player when swung. Return false to block the weapon from hitting the target. Returns true by default.

virtual bool	CanPickup (Item item, Player player)
	Allows you to determine whether or not the item can be picked up

virtual bool	CanResearch (Item item)
	Allows you to prevent an item from being researched by returning false. True is the default behaviour. More...

virtual bool	CanRightClick (Item item)
	Returns whether or not an item does something when right-clicked in the inventory. Returns false by default.

virtual bool	CanShoot (Item item, Player player)
	Allows you to prevent an item from shooting a projectile on use. Returns true by default. More...

virtual bool	CanStack (Item increase, Item decrease)
	Allows you to prevent items from stacking. This is only called when two items of the same type attempt to stack. This is usually not called for coins and ammo in the inventory/UI. This covers all scenarios, if you just need to change in-world stacking behavior, use CanStackInWorld. More...

virtual bool	CanStackInWorld (Item increase, Item decrease)
	Allows you to prevent items from stacking in the world. This is only called when two items of the same type attempt to stack. More...

virtual bool	CanUseItem (Item item, Player player)
	Returns whether or not any item can be used. Returns true by default. The inability to use a specific item overrides this, so use this to stop an item from being used.

virtual void	CaughtFishStack (int type, ref int stack)
	Allows you to modify how many of an item a player obtains when the player fishes that item.

virtual int	ChoosePrefix (Item item, UnifiedRandom rand)
	Allows you to manually choose what prefix an item will get. More...

virtual bool	ConsumeItem (Item item, Player player)
	If the item is consumable and this returns true, then the item will be consumed upon usage. Returns true by default. If false is returned, the OnConsumeItem hook is never called.

virtual void	DrawArmorColor (EquipType type, int slot, Player drawPlayer, float shadow, ref Color color, ref int glowMask, ref Color glowMaskColor)
	Allows you to modify the colors in which the player's armor and their surrounding accessories are drawn, in addition to which glow mask and in what color is drawn. More...

virtual void	ExtractinatorUse (int extractType, ref int resultType, ref int resultStack)
	Allows you to modify what item, and in what quantity, is obtained when an item of the given type is fed into the Extractinator. An extractType of 0 represents the default extraction (Silt and Slush). By default the parameters will be set to the output of feeding Silt/Slush into the Extractinator. More...

virtual ? Color	GetAlpha (Item item, Color lightColor)
	Allows you to determine the color and transparency in which an item is drawn. Return null to use the default color (normally light color). Returns null by default.

virtual void	GetHealLife (Item item, Player player, bool quickHeal, ref int healValue)
	Allows you to temporarily modify the amount of life a life healing item will heal for, based on player buffs, accessories, etc. This is only called for items with a healLife value. More...

virtual void	GetHealMana (Item item, Player player, bool quickHeal, ref int healValue)
	Allows you to temporarily modify the amount of mana a mana healing item will heal for, based on player buffs, accessories, etc. This is only called for items with a healMana value. More...

virtual void	GrabRange (Item item, Player player, ref int grabRange)
	Allows you to modify how close an item must be to the player in order to move towards the player.

virtual bool	GrabStyle (Item item, Player player)
	Allows you to modify the way an item moves towards the player. Return false to allow the vanilla grab style to take place. Returns false by default.

virtual void	HoldItem (Item item, Player player)
	Allows you to make things happen when the player is holding an item (for example, torches make light and water candles increase spawn rate).

virtual void	HoldItemFrame (Item item, Player player)
	Allows you to modify the player's animation when the player is holding an item.

virtual ? Vector2	HoldoutOffset (int type)
	Allows you to determine the offset of an item's sprite when used by the player. This is only used for items with a useStyle of 5 that aren't staves. Return null to use the item's default holdout offset; returns null by default. More...

virtual ? Vector2	HoldoutOrigin (int type)
	Allows you to determine the point on an item's sprite that the player holds onto when using the item. The origin is from the bottom left corner of the sprite. This is only used for staves with a useStyle of 5. Return null to use the item's default holdout origin; returns null by default. More...

virtual void	HoldStyle (Item item, Player player, Rectangle heldItemFrame)
	Allows you to modify the location and rotation of the item the player is currently holding. More...

virtual void	HorizontalWingSpeeds (Item item, Player player, ref float speed, ref float acceleration)
	Allows you to modify the horizontal flight speed and acceleration of wings.

GlobalItem	Instance (Item item)

virtual bool	IsAnglerQuestAvailable (int type)
	Whether or not specific conditions have been satisfied for the Angler to be able to request the given item. (For example, Hardmode.) Returns true by default. More...

virtual string	IsArmorSet (Item head, Item body, Item legs)
	Allows you to determine whether the player is wearing an armor set, and return a name for this set. If there is no armor set, return the empty string. Returns the empty string by default. More...

virtual string	IsVanitySet (int head, int body, int legs)
	Returns whether or not the head armor, body armor, and leg armor textures make up a set. This hook is used for the PreUpdateVanitySet, UpdateVanitySet, and ArmorSetShadows hooks, and will use items in the social slots if they exist. By default this will return the same value as the IsArmorSet hook, so you will not have to use this hook unless you want vanity effects to be entirely separate from armor sets. More...

virtual bool	ItemSpace (Item item, Player player)
	Return true to specify that the item can be picked up despite not having enough room in inventory. Useful for something like hearts or experience items. Use in conjunction with OnPickup to actually consume the item and handle it.

virtual void	LoadData (Item item, TagCompound tag)
	Allows you to load custom data that you have saved for this item. Try to write defensive loading code that won't crash if something's missing. More...

virtual void	MeleeEffects (Item item, Player player, Rectangle hitbox)
	Allows you to give melee weapons special effects, such as creating light or dust.

virtual void	ModifyHitNPC (Item item, Player player, NPC target, ref int damage, ref float knockBack, ref bool crit)
	Allows you to modify the damage, knockback, etc., that a melee weapon does to an NPC.

virtual void	ModifyHitPvp (Item item, Player player, Player target, ref int damage, ref bool crit)
	Allows you to modify the damage, etc., that a melee weapon does to a player.

virtual void	ModifyItemLoot (Item item, ItemLoot itemLoot)
	Allows you to add and modify the loot items that spawn from bag items when opened. The Basic NPC Drops and Loot 1.4 Guideexplains how to use the ModNPC.ModifyNPCLoot(NPCLoot) hook to modify NPC loot as well as this hook. A common usage is to use this hook and ModNPC.ModifyNPCLoot(NPCLoot) to edit non-expert exlclusive drops for bosses. This hook only runs once per item type during mod loading, any dynamic behavior must be contained in the rules themselves. More...

virtual void	ModifyItemScale (Item item, Player player, ref float scale)
	Allows you to dynamically modify the given item's size for the given player, similarly to the effect of the Titan Glove. More...

virtual void	ModifyManaCost (Item item, Player player, ref float reduce, ref float mult)
	Allows you to temporarily modify the amount of mana an item will consume on use, based on player buffs, accessories, etc. This is only called for items with a mana value. More...

virtual void	ModifyResearchSorting (Item item, ref ContentSamples.CreativeHelper.ItemGroup itemGroup)
	Allows you to set an item's sorting group in Journey Mode's duplication menu. This is useful for setting custom item types that group well together, or whenever the default vanilla sorting doesn't sort the way you want it. More...

virtual void	ModifyShootStats (Item item, Player player, ref Vector2 position, ref Vector2 velocity, ref int type, ref int damage, ref float knockback)
	Allows you to modify the position, velocity, type, damage and/or knockback of a projectile being shot by an item. These parameters will be provided to Shoot(Item, Player, EntitySource_ItemUse_WithAmmo, Vector2, Vector2, int, int, float) where the projectile will actually be spawned. More...

virtual void	ModifyTooltips (Item item, List< TooltipLine > tooltips)
	Allows you to modify all the tooltips that display for the given item. See here for information about TooltipLine.

virtual void	ModifyWeaponCrit (Item item, Player player, ref float crit)
	Allows you to dynamically modify a weapon's crit chance based on player and item conditions. Can be utilized to modify damage beyond the tools that DamageClass has to offer. More...

virtual void	ModifyWeaponDamage (Item item, Player player, ref StatModifier damage)
	Allows you to dynamically modify a weapon's damage based on player and item conditions. Can be utilized to modify damage beyond the tools that DamageClass has to offer. More...

virtual void	ModifyWeaponKnockback (Item item, Player player, ref StatModifier knockback)
	Allows you to dynamically modify a weapon's knockback based on player and item conditions. Can be utilized to modify damage beyond the tools that DamageClass has to offer. More...

virtual bool	NeedsAmmo (Item item, Player player)
	Whether or not having no ammo prevents an item that uses ammo from shooting. Return false to allow shooting with no ammo in the inventory, in which case the item will act as if the default ammo for it is being used. Returns true by default.

virtual void	NetReceive (Item item, BinaryReader reader)

virtual void	NetSend (Item item, BinaryWriter writer)

virtual void	OnCatchNPC (Item item, NPC npc, Player player, bool failed)
	Allows you to make things happen when the given item attempts to catch the given NPC. More...

virtual void	OnConsumeAmmo (Item weapon, Item ammo, Player player)
	Allows you to make things happen when the given ammo is consumed by the given weapon. Called by the weapon. Called before the ammo stack is reduced, and is never called if the ammo isn't consumed in the first place. More...

virtual void	OnConsumedAsAmmo (Item ammo, Item weapon, Player player)
	Allows you to make things happen when the given ammo is consumed by the given weapon. Called by the ammo. Called before the ammo stack is reduced, and is never called if the ammo isn't consumed in the first place. More...

virtual void	OnConsumeItem (Item item, Player player)
	Allows you to make things happen when this item is consumed. Called before the item stack is reduced.

virtual void	OnConsumeMana (Item item, Player player, int manaConsumed)
	Allows you to make stuff happen when a player consumes mana on use of an item. More...

virtual void	OnCreate (Item item, ItemCreationContext context)

virtual void	OnHitNPC (Item item, Player player, NPC target, int damage, float knockBack, bool crit)
	Allows you to create special effects when a melee weapon hits an NPC (for example how the Pumpkin Sword creates pumpkin heads).

virtual void	OnHitPvp (Item item, Player player, Player target, int damage, bool crit)
	Allows you to create special effects when a melee weapon hits a player.

virtual void	OnMissingMana (Item item, Player player, int neededMana)
	Allows you to make stuff happen when a player doesn't have enough mana for an item they are trying to use. If the player has high enough mana after this hook runs, mana consumption will happen normally. Only runs once per item use. More...

virtual bool	OnPickup (Item item, Player player)
	Allows you to make special things happen when the player picks up an item. Return false to stop the item from being added to the player's inventory; returns true by default.

virtual void	OnResearched (Item item, bool fullyResearched)
	Allows you to create custom behaviour when an item is accepted by the Research function More...

virtual void	OnSpawn (Item item, IEntitySource source)
	Gets called when any item spawns in world

virtual void	OnStack (Item increase, Item decrease, int numberToBeTransfered)
	Allows you to make things happen when items stack together. More...

virtual void	OpenVanillaBag (string context, Player player, int arg)

virtual void	PickAmmo (Item weapon, Item ammo, Player player, ref int type, ref float speed, ref StatModifier damage, ref float knockback)
	Allows you to modify various properties of the projectile created by a weapon based on the ammo it is using. More...

virtual void	PostDrawInInventory (Item item, SpriteBatch spriteBatch, Vector2 position, Rectangle frame, Color drawColor, Color itemColor, Vector2 origin, float scale)
	Allows you to draw things in front of an item in the inventory. This method is called even if PreDrawInInventory returns false.

virtual void	PostDrawInWorld (Item item, SpriteBatch spriteBatch, Color lightColor, Color alphaColor, float rotation, float scale, int whoAmI)
	Allows you to draw things in front of an item. This method is called even if PreDrawInWorld returns false.

virtual void	PostDrawTooltip (Item item, ReadOnlyCollection< DrawableTooltipLine > lines)
	Allows you to do things after this item's tooltip is drawn. The lines contain draw information as this is ran after drawing the tooltip. More...

virtual void	PostDrawTooltipLine (Item item, DrawableTooltipLine line)
	Allows you to do things after a tooltip line of this item is drawn. The line contains draw info. More...

virtual void	PostReforge (Item item)
	This hook gets called immediately after an item gets reforged by the Goblin Tinkerer. Useful for modifying modded data based on the reforge result.

virtual void	PostUpdate (Item item)
	Allows you to make things happen when an item is lying in the world. This will always be called, even when the item is being grabbed by a player. This hook should be used for adding light, or for increasing the age of less valuable items.

virtual bool	PreDrawInInventory (Item item, SpriteBatch spriteBatch, Vector2 position, Rectangle frame, Color drawColor, Color itemColor, Vector2 origin, float scale)
	Allows you to draw things behind an item in the inventory. Return false to stop the game from drawing the item (useful if you're manually drawing the item). Returns true by default.

virtual bool	PreDrawInWorld (Item item, SpriteBatch spriteBatch, Color lightColor, Color alphaColor, ref float rotation, ref float scale, int whoAmI)
	Allows you to draw things behind an item, or to modify the way an item is drawn in the world. Return false to stop the game from drawing the item (useful if you're manually drawing the item). Returns true by default.

virtual bool	PreDrawTooltip (Item item, ReadOnlyCollection< TooltipLine > lines, ref int x, ref int y)
	Allows you to do things before this item's tooltip is drawn. More...

virtual bool	PreDrawTooltipLine (Item item, DrawableTooltipLine line, ref int yOffset)
	Allows you to do things before a tooltip line of this item is drawn. The line contains draw info. More...

virtual ? bool	PrefixChance (Item item, int pre, UnifiedRandom rand)
	To prevent putting the item in the tinkerer slot, return false when pre is -3. To prevent rolling of a prefix on spawn, return false when pre is -1. To force rolling of a prefix on spawn, return true when pre is -1. More...

virtual bool	PreOpenVanillaBag (string context, Player player, int arg)

virtual bool	PreReforge (Item item)
	This hook gets called when the player clicks on the reforge button and can afford the reforge. Returns whether the reforge will take place. If false is returned, the PostReforge hook is never called. Reforging preserves modded data on the item.

virtual void	PreUpdateVanitySet (Player player, string set)
	Allows you to create special effects (such as the necro armor's hurt noise) when the player wears the vanity set with the given name returned by IsVanitySet. This hook is called regardless of whether the player is frozen in any way. More...

virtual bool	ReforgePrice (Item item, ref int reforgePrice, ref bool canApplyDiscount)
	Returns if the normal reforge pricing is applied. If true or false is returned and the price is altered, the price will equal the altered price. The passed reforge price equals the item.value. Vanilla pricing will apply 20% discount if applicable and then price the reforge at a third of that value.

virtual void	RightClick (Item item, Player player)
	Allows you to make things happen when an item is right-clicked in the inventory. Useful for goodie bags.

virtual void	SaveData (Item item, TagCompound tag)
	Allows you to save custom data for this item. NOTE: The provided tag is always empty by default, and is provided as an argument only for the sake of convenience and optimization. NOTE: Try to only save data that isn't default values. More...

virtual void	SetDefaults (Item item)
	Allows you to set the properties of any and every item that gets created.

virtual void	SetMatch (int armorSlot, int type, bool male, ref int equipSlot, ref bool robes)
	Allows you to modify the equipment that the player appears to be wearing. More...

sealed override void	SetupContent ()
	If you make a new ModType, seal this override, and call SetStaticDefaults in it. More...

virtual bool	Shoot (Item item, Player player, EntitySource_ItemUse_WithAmmo source, Vector2 position, Vector2 velocity, int type, int damage, float knockback)
	Allows you to modify an item's shooting mechanism. Return false to prevent vanilla's shooting code from running. Returns true by default. This method is called after the ModifyShootStats hook has had a chance to adjust the spawn parameters. More...

virtual void	SplitStack (Item increase, Item decrease, int numberToBeTransfered)
	Allows you to make things happen when an item stack is split. Usually transfers 1 and only occurs with the first transfer. Split stack is called before the stack values are modified. More...

virtual void	Update (Item item, ref float gravity, ref float maxFallSpeed)
	Allows you to customize an item's movement when lying in the world. Note that this will not be called if the item is currently being grabbed by a player.

virtual void	UpdateAccessory (Item item, Player player, bool hideVisual)
	Allows you to give effects to accessories. The hideVisual parameter is whether the player has marked the accessory slot to be hidden from being drawn on the player.

virtual void	UpdateArmorSet (Player player, string set)
	Allows you to give set bonuses to your armor set with the given name. The set name will be the same as returned by IsArmorSet. More...

virtual void	UpdateEquip (Item item, Player player)
	Allows you to give effects to armors and accessories, such as increased damage.

virtual void	UpdateInventory (Item item, Player player)
	Allows you to make things happen when an item is in the player's inventory (for example, how the cell phone makes information display).

virtual void	UpdateVanity (Item item, Player player)
	Allows you to give effects to this accessory when equipped in a vanity slot. Vanilla uses this for boot effects, wings and merman/werewolf visual flags

virtual void	UpdateVanitySet (Player player, string set)
	Allows you to create special effects (such as dust) when the player wears the vanity set with the given name returned by IsVanitySet. This hook will only be called if the player is not frozen in any way. More...

virtual void	UseAnimation (Item item, Player player)
	Allows you to make things happen when an item's use animation starts.

virtual float	UseAnimationMultiplier (Item item, Player player)
	Allows you to change the effective useAnimation of an item. Note that this hook may cause items' actions to run less or more times than they should per a single use. More...

virtual ? bool	UseItem (Item item, Player player)
	Allows you to make things happen when an item is used. The return value controls whether or not ApplyItemTime will be called for the player. Return true if the item actually did something, to force itemTime. Return false to keep itemTime at 0. Return null for vanilla behavior.

virtual void	UseItemFrame (Item item, Player player)
	Allows you to modify the player's animation when an item is being used.

virtual void	UseItemHitbox (Item item, Player player, ref Rectangle hitbox, ref bool noHitbox)
	Changes the hitbox of a melee weapon when it is used.

virtual float	UseSpeedMultiplier (Item item, Player player)
	Allows you to safely change both useTime and useAnimation while keeping the values relative to each other. Useful for status effects. More...

virtual void	UseStyle (Item item, Player player, Rectangle heldItemFrame)
	Allows you to modify the location and rotation of any item in its use animation. More...

virtual float	UseTimeMultiplier (Item item, Player player)
	Allows you to change the effective useTime of an item. Note that this hook may cause items' actions to run less or more times than they should per a single use. More...

virtual void	VerticalWingSpeeds (Item item, Player player, ref float ascentWhenFalling, ref float ascentWhenRising, ref float maxCanAscendMultiplier, ref float maxAscentMultiplier, ref float constantAscend)
	Allows you to modify the speeds at which you rise and fall when wings are equipped.

virtual bool	WingUpdate (int wings, Player player, bool inUse)
	Allows for Wings to do various things while in use. "inUse" is whether or not the jump button is currently pressed. Called when wings visually appear on the player. Use to animate wings, create dusts, invoke sounds, and create lights. False will keep everything the same. True, you need to handle all animations in your own code. More...

Public Member Functions inherited from Terraria.ModLoader.GlobalType< Item, GlobalItem >
virtual bool	AppliesToEntity (TEntity entity, bool lateInstantiation)
	Use this to control whether or not this global should be associated with the provided entity instance. More...

virtual TGlobal	Clone (TEntity from, TEntity to)
	Create a copy of this instanced global. Called when an entity is cloned. More...

virtual TGlobal	NewInstance (TEntity target)
	Only called if GlobalType.InstancePerEntity and AppliesToEntity(target , ...) are both true More...

virtual TModType	Clone (TEntity newEntity)
	Create a copy of this instanced global. Called when an entity is cloned. More...

virtual bool	IsLoadingEnabled (Mod mod)
	Allows you to stop Mod.AddContent from actually adding this content. Useful for items that can be disabled by a config. More...

virtual void	Load ()
	Allows you to perform one-time loading tasks. Beware that mod content has not finished loading here, things like ModContent lookup tables or ID Sets are not fully populated. More...

virtual TModType	NewInstance (TEntity entity)
	Create a new instance of this ModType for a specific entity More...

virtual void	SetStaticDefaults ()
	Allows you to modify the properties after initial loading has completed. More...

virtual void	SetupContent ()
	If you make a new ModType, seal this override, and call SetStaticDefaults in it. More...

virtual void	Unload ()
	Allows you to safely unload things you added in Load. More...

virtual bool	IsLoadingEnabled (Mod mod)
	Whether or not this type should be loaded when it's told to. Returning false disables Mod.AddContent from actually loading this type. More...

abstract void	Load (Mod mod)
	Called when loading the type. More...

abstract void	Unload ()
	Called during unloading when needed. More...

virtual TModType	Clone (TEntity newEntity)
	Create a copy of this instanced global. Called when an entity is cloned. More...

virtual bool	IsLoadingEnabled (Mod mod)
	Allows you to stop Mod.AddContent from actually adding this content. Useful for items that can be disabled by a config. More...

virtual void	Load ()
	Allows you to perform one-time loading tasks. Beware that mod content has not finished loading here, things like ModContent lookup tables or ID Sets are not fully populated. More...

virtual TModType	NewInstance (TEntity entity)
	Create a new instance of this ModType for a specific entity More...

virtual void	SetStaticDefaults ()
	Allows you to modify the properties after initial loading has completed. More...

virtual void	SetupContent ()
	If you make a new ModType, seal this override, and call SetStaticDefaults in it. More...

virtual void	Unload ()
	Allows you to safely unload things you added in Load. More...

Protected Member Functions
sealed override void	Register ()
	If you make a new ModType, seal this override. More...

override void	ValidateType ()
	Check for the correct overrides of different hook methods and fields and properties More...

Protected Member Functions inherited from Terraria.ModLoader.GlobalType< Item, GlobalItem >
override void	ValidateType ()
	Check for the correct overrides of different hook methods and fields and properties More...

Protected Member Functions inherited from Terraria.ModLoader.ModType< TEntity, TModType >
abstract TEntity	CreateTemplateEntity ()

virtual void	InitTemplateInstance ()
	Create dummy objects for instanced mod-types More...

override void	InitTemplateInstance ()
	Create dummy objects for instanced mod-types More...

abstract void	Register ()
	If you make a new ModType, seal this override. More...

virtual void	ValidateType ()
	Check for the correct overrides of different hook methods and fields and properties More...

Protected Member Functions inherited from Terraria.ModLoader.ModType< TEntity >
abstract TEntity	CreateTemplateEntity ()

virtual void	InitTemplateInstance ()
	Create dummy objects for instanced mod-types More...

override void	InitTemplateInstance ()
	Create dummy objects for instanced mod-types

abstract void	Register ()
	If you make a new ModType, seal this override. More...

virtual void	ValidateType ()
	Check for the correct overrides of different hook methods and fields and properties More...

Additional Inherited Members
Static Public Member Functions inherited from Terraria.ModLoader.GlobalType< Item, GlobalItem >
static TResult	GetGlobal< TEntity, TGlobal, TResult > (Instanced< TGlobal >[] globals, bool exactType)

static TResult	GetGlobal< TEntity, TGlobal, TResult > (Instanced< TGlobal >[] globals, TResult baseInstance)

static T	Instance< T > (Instanced< T >[] globals, ushort index)

static bool	TryGetGlobal< TGlobal, TResult > (Instanced< TGlobal >[] globals, bool exactType, out TResult result)

static bool	TryGetGlobal< TGlobal, TResult > (Instanced< TGlobal >[] globals, TResult baseInstance, out TResult result)

Properties inherited from Terraria.ModLoader.GlobalType< Item, GlobalItem >
virtual bool	CloneNewInstances `[get]`
	Whether to create new instances of this mod type via Clone or via the default constructor Defaults to false (default constructor).

ushort	Index `[get, set]`

virtual bool	InstancePerEntity `[get]`
	Whether to create a new instance of this Global for every entity that exists. Useful for storing information on an entity. Defaults to false. Return true if you need to store information (have non-static fields).

virtual bool	IsCloneable `[get]`
	Whether or not this type is cloneable. Cloning is supported if all reference typed fields in each sub-class which doesn't override Clone are marked with [CloneByReference]

Properties inherited from Terraria.ModLoader.ModType< TEntity, TModType >
virtual bool	CloneNewInstances `[get]`
	Whether to create new instances of this mod type via Clone(TEntity) or via the default constructor Defaults to false (default constructor).

TEntity	Entity `[get, set]`

string	FullName `[get]`
	The internal name of this, including the mod it is from. More...

virtual bool	IsCloneable `[get]`
	Whether or not this type is cloneable. Cloning is supported if all reference typed fields in each sub-class which doesn't override Clone are marked with [CloneByReference]

Mod	Mod `[get, set]`
	The mod this belongs to. More...

virtual string	Name `[get]`
	The internal name of this. More...

Properties inherited from Terraria.ModLoader.IModType
string	FullName `[get]`
	=> $"{Mod.Name}/{Name}" More...

Mod	Mod `[get]`
	The mod this belongs to. More...

string	Name `[get]`
	The internal name of this instance. More...

Properties inherited from Terraria.ModLoader.ModType< TEntity >
virtual bool	CloneNewInstances `[get]`
	Whether to create new instances of this mod type via Clone(TEntity) or via the default constructor Defaults to false (default constructor).

TEntity	Entity `[get, set]`

string	FullName `[get]`
	The internal name of this, including the mod it is from. More...

virtual bool	IsCloneable `[get]`
	Whether or not this type is cloneable. Cloning is supported if all reference typed fields in each sub-class which doesn't override Clone are marked with [CloneByReference]

Mod	Mod `[get, set]`
	The mod this belongs to. More...

virtual string	Name `[get]`
	The internal name of this. More...

Properties inherited from Terraria.ModLoader.IIndexed
ushort	Index `[get]`

Detailed Description

This class allows you to modify and use hooks for all items, including vanilla items. Create an instance of an overriding class then call Mod.AddGlobalItem to use this.

Member Function Documentation

◆ AnglerChat()

virtual void Terraria.ModLoader.GlobalItem.AnglerChat	(	int	type,
		ref string	chat,
		ref string	catchLocation
	)

virtual

Allows you to set what the Angler says when the Quest button is clicked in his chat. The chat parameter is his dialogue, and catchLocation should be set to "Caught at [location]" for the given type.

This method is not instanced.

◆ ArmorArmGlowMask()

virtual void Terraria.ModLoader.GlobalItem.ArmorArmGlowMask	(	int	slot,
		Player	drawPlayer,
		float	shadow,
		ref int	glowMask,
		ref Color	color
	)

virtual

Allows you to modify which glow mask and in what color is drawn on the player's arms. Note that this is only called for body armor.

This method is not instanced.

◆ ArmorSetShadows()

virtual void Terraria.ModLoader.GlobalItem.ArmorSetShadows	(	Player	player,
		string	set
	)

virtual

Allows you to determine special visual effects a vanity has on the player without having to code them yourself.

This method is not instanced.

player.armorEffectDrawShadow = true;

◆ CanAutoReuseItem()

virtual ? bool Terraria.ModLoader.GlobalItem.CanAutoReuseItem	(	Item	item,
		Player	player
	)

virtual

Allows you to modify the autoswing (auto-reuse) behavior of any item without having to mess with Item.autoReuse.
Useful to create effects like the Feral Claws which makes melee weapons and whips auto-reusable.
Return true to enable autoswing (if not already enabled through autoReuse), return false to prevent autoswing. Returns null by default, which applies vanilla behavior.

Parameters

item	The item.
player	The player.

◆ CanBeChosenAsAmmo()

virtual ? bool Terraria.ModLoader.GlobalItem.CanBeChosenAsAmmo	(	Item	ammo,
		Item	weapon,
		Player	player
	)

virtual

Whether or not the given ammo item is valid for the given weapon; called on the ammo. If this, or CanChooseAmmo on the weapon, returns false, then the ammo will not be valid for this weapon.
By default, returns null and allows Item.useAmmo and Item.ammo to decide. Return true to make the ammo valid regardless of these fields, and return false to make it invalid.
If false is returned, the CanConsumeAmmo, CanBeConsumedAsAmmo, OnConsumeAmmo, and OnConsumedAsAmmo hooks are never called.

Parameters

ammo	The ammo that this hook is being called for.
weapon	The weapon attempting to select the ammo.
player	The player which the weapon and this potential ammo belong to.

Returns

◆ CanBeConsumedAsAmmo()

virtual bool Terraria.ModLoader.GlobalItem.CanBeConsumedAsAmmo	(	Item	ammo,
		Item	weapon,
		Player	player
	)

virtual

Whether or not the given ammo item will be consumed; called on the ammo.
By default, returns true; return false to prevent ammo consumption.
If false is returned, the OnConsumeAmmo and OnConsumedAsAmmo hooks are never called.

Parameters

ammo	The ammo that this hook is being called for.
weapon	The weapon attempting to consume the ammo.
player	The player which the weapon and this ammo belong to.

Returns

◆ CanCatchNPC()

virtual ? bool Terraria.ModLoader.GlobalItem.CanCatchNPC	(	Item	item,
		NPC	target,
		Player	player
	)

virtual

Allows you to determine whether the given item can catch the given NPC.
Return true or false to say the given NPC can or cannot be caught, respectively, regardless of vanilla rules.
Returns null by default, which allows vanilla's NPC catching rules to decide the target's fate.
If this returns false, CombinedHooks.OnCatchNPC is never called.

NOTE: this does not classify the given item as an NPC-catching tool, which is necessary for catching NPCs in the first place.
To do that, you will need to use the "CatchingTool" set in ItemID.Sets.

Parameters

item	The item with which the player is trying to catch the target NPC.
target	The NPC the player is trying to catch.
player	The player attempting to catch the NPC.

Returns

◆ CanChooseAmmo()

virtual ? bool Terraria.ModLoader.GlobalItem.CanChooseAmmo	(	Item	weapon,
		Item	ammo,
		Player	player
	)

virtual

Whether or not the given ammo item is valid for the given weapon; called on the weapon. If this, or CanBeChosenAsAmmo on the ammo, returns false, then the ammo will not be valid for this weapon.
By default, returns null and allows Item.useAmmo and Item.ammo to decide. Return true to make the ammo valid regardless of these fields, and return false to make it invalid.
If false is returned, the CanConsumeAmmo, CanBeConsumedAsAmmo, OnConsumeAmmo, and OnConsumedAsAmmo hooks are never called.

Parameters

weapon	The weapon that this hook is being called for.
ammo	The ammo that the weapon is attempting to select.
player	The player which this weapon and the potential ammo belong to.

Returns

◆ CanConsumeAmmo()

virtual bool Terraria.ModLoader.GlobalItem.CanConsumeAmmo	(	Item	weapon,
		Item	ammo,
		Player	player
	)

virtual

Whether or not the given ammo item will be consumed; called on the weapon.
By default, returns true; return false to prevent ammo consumption.
If false is returned, the OnConsumeAmmo and OnConsumedAsAmmo hooks are never called.

Parameters

weapon	The weapon that this hook is being called for.
ammo	The ammo that the weapon is attempting to consume.
player	The player which this weapon and the ammo belong to.

Returns

◆ CanConsumeBait()

virtual ? bool Terraria.ModLoader.GlobalItem.CanConsumeBait	(	Player	player,
		Item	bait
	)

virtual

Allows you to choose if a given bait will be consumed by a given player Not consuming will always take priority over forced consumption

Parameters

bait	The bait being used
player	The player using the item

◆ CanEquipAccessory()

virtual bool Terraria.ModLoader.GlobalItem.CanEquipAccessory	(	Item	item,
		Player	player,
		int	slot,
		bool	modded
	)

virtual

Allows you to disallow the player from equipping an accessory. Return false to disallow equipping the accessory. Returns true by default.

Parameters

item	The item that is attepting to equip.
player	The player.
slot	The inventory slot that the item is attempting to occupy.
modded	If the inventory slot index is for modded slots.

◆ CanResearch()

virtual bool Terraria.ModLoader.GlobalItem.CanResearch ( Item item )

virtual

Allows you to prevent an item from being researched by returning false. True is the default behaviour.

Parameters

item	The item being researched

◆ CanShoot()

virtual bool Terraria.ModLoader.GlobalItem.CanShoot	(	Item	item,
		Player	player
	)

virtual

Allows you to prevent an item from shooting a projectile on use. Returns true by default.

Parameters

item	The item being used.
player	The player using the item.

Returns

◆ CanStack()

virtual bool Terraria.ModLoader.GlobalItem.CanStack	(	Item	increase,
		Item	decrease
	)

virtual

Allows you to prevent items from stacking.
This is only called when two items of the same type attempt to stack.
This is usually not called for coins and ammo in the inventory/UI.
This covers all scenarios, if you just need to change in-world stacking behavior, use CanStackInWorld.

Returns: Whether or not the items are allowed to stack

◆ CanStackInWorld()

virtual bool Terraria.ModLoader.GlobalItem.CanStackInWorld	(	Item	increase,
		Item	decrease
	)

virtual

Allows you to prevent items from stacking in the world.
This is only called when two items of the same type attempt to stack.

Returns: Whether or not the items are allowed to stack

◆ ChoosePrefix()

virtual int Terraria.ModLoader.GlobalItem.ChoosePrefix	(	Item	item,
		UnifiedRandom	rand
	)

virtual

Allows you to manually choose what prefix an item will get.

Returns: The ID of the prefix to give the item, -1 to use default vanilla behavior

◆ DrawArmorColor()

virtual void Terraria.ModLoader.GlobalItem.DrawArmorColor	(	EquipType	type,
		int	slot,
		Player	drawPlayer,
		float	shadow,
		ref Color	color,
		ref int	glowMask,
		ref Color	glowMaskColor
	)

virtual

Allows you to modify the colors in which the player's armor and their surrounding accessories are drawn, in addition to which glow mask and in what color is drawn.

This method is not instanced.

◆ ExtractinatorUse()

virtual void Terraria.ModLoader.GlobalItem.ExtractinatorUse	(	int	extractType,
		ref int	resultType,
		ref int	resultStack
	)

virtual

Allows you to modify what item, and in what quantity, is obtained when an item of the given type is fed into the Extractinator. An extractType of 0 represents the default extraction (Silt and Slush). By default the parameters will be set to the output of feeding Silt/Slush into the Extractinator.

This method is not instanced.

◆ GetHealLife()

virtual void Terraria.ModLoader.GlobalItem.GetHealLife	(	Item	item,
		Player	player,
		bool	quickHeal,
		ref int	healValue
	)

virtual

Allows you to temporarily modify the amount of life a life healing item will heal for, based on player buffs, accessories, etc. This is only called for items with a healLife value.

Parameters

item	The item being used.
player	The player using the item.
quickHeal	Whether the item is being used through quick heal or not.
healValue	The amount of life being healed.

◆ GetHealMana()

virtual void Terraria.ModLoader.GlobalItem.GetHealMana	(	Item	item,
		Player	player,
		bool	quickHeal,
		ref int	healValue
	)

virtual

Allows you to temporarily modify the amount of mana a mana healing item will heal for, based on player buffs, accessories, etc. This is only called for items with a healMana value.

Parameters

item	The item being used.
player	The player using the item.
quickHeal	Whether the item is being used through quick heal or not.
healValue	The amount of mana being healed.

◆ HoldoutOffset()

virtual ? Vector2 Terraria.ModLoader.GlobalItem.HoldoutOffset ( int type )

virtual

Allows you to determine the offset of an item's sprite when used by the player. This is only used for items with a useStyle of 5 that aren't staves. Return null to use the item's default holdout offset; returns null by default.

This method is not instanced.

return new Vector2(10, 0);

◆ HoldoutOrigin()

virtual ? Vector2 Terraria.ModLoader.GlobalItem.HoldoutOrigin ( int type )

virtual

Allows you to determine the point on an item's sprite that the player holds onto when using the item. The origin is from the bottom left corner of the sprite. This is only used for staves with a useStyle of 5. Return null to use the item's default holdout origin; returns null by default.

This method is not instanced.

◆ HoldStyle()

virtual void Terraria.ModLoader.GlobalItem.HoldStyle	(	Item	item,
		Player	player,
		Rectangle	heldItemFrame
	)

virtual

Allows you to modify the location and rotation of the item the player is currently holding.

Parameters

item	The item.
player	The player.
heldItemFrame	The source rectangle for the held item's texture.

◆ IsAnglerQuestAvailable()

virtual bool Terraria.ModLoader.GlobalItem.IsAnglerQuestAvailable ( int type )

virtual

Whether or not specific conditions have been satisfied for the Angler to be able to request the given item. (For example, Hardmode.) Returns true by default.

This method is not instanced.

◆ IsArmorSet()

virtual string Terraria.ModLoader.GlobalItem.IsArmorSet	(	Item	head,
		Item	body,
		Item	legs
	)

virtual

Allows you to determine whether the player is wearing an armor set, and return a name for this set. If there is no armor set, return the empty string. Returns the empty string by default.

This method is not instanced.

◆ IsVanitySet()

virtual string Terraria.ModLoader.GlobalItem.IsVanitySet	(	int	head,
		int	body,
		int	legs
	)

virtual

Returns whether or not the head armor, body armor, and leg armor textures make up a set. This hook is used for the PreUpdateVanitySet, UpdateVanitySet, and ArmorSetShadows hooks, and will use items in the social slots if they exist. By default this will return the same value as the IsArmorSet hook, so you will not have to use this hook unless you want vanity effects to be entirely separate from armor sets.

This method is not instanced.

◆ LoadData()

virtual void Terraria.ModLoader.GlobalItem.LoadData	(	Item	item,
		TagCompound	tag
	)

virtual

Allows you to load custom data that you have saved for this item.
Try to write defensive loading code that won't crash if something's missing.

Parameters

item	The item.
tag	The TagCompound to load data from.

Reimplemented in Terraria.ModLoader.Default.UnloadedGlobalItem.

◆ ModifyItemLoot()

virtual void Terraria.ModLoader.GlobalItem.ModifyItemLoot	(	Item	item,
		ItemLoot	itemLoot
	)

virtual

Allows you to add and modify the loot items that spawn from bag items when opened. The Basic NPC Drops and Loot 1.4 Guideexplains how to use the ModNPC.ModifyNPCLoot(NPCLoot) hook to modify NPC loot as well as this hook. A common usage is to use this hook and ModNPC.ModifyNPCLoot(NPCLoot) to edit non-expert exlclusive drops for bosses.
This hook only runs once per item type during mod loading, any dynamic behavior must be contained in the rules themselves.

Parameters

item	A default item of the type being opened, not the actual item instance
itemLoot	A reference to the item drop database for this item type

◆ ModifyItemScale()

virtual void Terraria.ModLoader.GlobalItem.ModifyItemScale	(	Item	item,
		Player	player,
		ref float	scale
	)

virtual

Allows you to dynamically modify the given item's size for the given player, similarly to the effect of the Titan Glove.

Parameters

item	The item to modify the scale of.
player	The player wielding the given item.
scale	The scale multiplier to be applied to the given item. Will be 1.1 if the Titan Glove is equipped, and 1 otherwise.

◆ ModifyManaCost()

virtual void Terraria.ModLoader.GlobalItem.ModifyManaCost	(	Item	item,
		Player	player,
		ref float	reduce,
		ref float	mult
	)

virtual

Allows you to temporarily modify the amount of mana an item will consume on use, based on player buffs, accessories, etc. This is only called for items with a mana value.

Parameters

item	The item being used.
player	The player using the item.
reduce	Used for decreasingly stacking buffs (most common). Only ever use -= on this field.
mult	Use to directly multiply the item's effective mana cost. Good for debuffs, or things which should stack separately (eg meteor armor set bonus).

◆ ModifyResearchSorting()

virtual void Terraria.ModLoader.GlobalItem.ModifyResearchSorting	(	Item	item,
		ref ContentSamples.CreativeHelper.ItemGroup	itemGroup
	)

virtual

Allows you to set an item's sorting group in Journey Mode's duplication menu. This is useful for setting custom item types that group well together, or whenever the default vanilla sorting doesn't sort the way you want it.

Parameters

item	The item being used
itemGroup	The item group this item is being assigned to

◆ ModifyShootStats()

virtual void Terraria.ModLoader.GlobalItem.ModifyShootStats	(	Item	item,
		Player	player,
		ref Vector2	position,
		ref Vector2	velocity,
		ref int	type,
		ref int	damage,
		ref float	knockback
	)

virtual

Allows you to modify the position, velocity, type, damage and/or knockback of a projectile being shot by an item.
These parameters will be provided to Shoot(Item, Player, EntitySource_ItemUse_WithAmmo, Vector2, Vector2, int, int, float) where the projectile will actually be spawned.

Parameters

item	The item being used.
player	The player using the item.
position	The center position of the projectile.
velocity	The velocity of the projectile.
type	The ID of the projectile.
damage	The damage of the projectile.
knockback	The knockback of the projectile.

◆ ModifyWeaponCrit()

virtual void Terraria.ModLoader.GlobalItem.ModifyWeaponCrit	(	Item	item,
		Player	player,
		ref float	crit
	)

virtual

Allows you to dynamically modify a weapon's crit chance based on player and item conditions. Can be utilized to modify damage beyond the tools that DamageClass has to offer.

Parameters

item	The item being used.
player	The player using the item.
crit	The total crit chance of the item after all normal crit chance calculations.

◆ ModifyWeaponDamage()

virtual void Terraria.ModLoader.GlobalItem.ModifyWeaponDamage	(	Item	item,
		Player	player,
		ref StatModifier	damage
	)

virtual

Allows you to dynamically modify a weapon's damage based on player and item conditions. Can be utilized to modify damage beyond the tools that DamageClass has to offer.

Parameters

item	The item being used.
player	The player using the item.
damage	The StatModifier object representing the totality of the various modifiers to be applied to the item's base damage.

◆ ModifyWeaponKnockback()

virtual void Terraria.ModLoader.GlobalItem.ModifyWeaponKnockback	(	Item	item,
		Player	player,
		ref StatModifier	knockback
	)

virtual

Allows you to dynamically modify a weapon's knockback based on player and item conditions. Can be utilized to modify damage beyond the tools that DamageClass has to offer.

Parameters

item	The item being used.
player	The player using the item.
knockback	The StatModifier object representing the totality of the various modifiers to be applied to the item's base knockback.

◆ OnCatchNPC()

virtual void Terraria.ModLoader.GlobalItem.OnCatchNPC	(	Item	item,
		NPC	npc,
		Player	player,
		bool	failed
	)

virtual

Allows you to make things happen when the given item attempts to catch the given NPC.

Parameters

item	The item used to catch the given NPC.
npc	The NPC which the player attempted to catch.
player	The player attempting to catch the given NPC.
failed	Whether or not the given NPC has been successfully caught.

◆ OnConsumeAmmo()

virtual void Terraria.ModLoader.GlobalItem.OnConsumeAmmo	(	Item	weapon,
		Item	ammo,
		Player	player
	)

virtual

Allows you to make things happen when the given ammo is consumed by the given weapon. Called by the weapon.
Called before the ammo stack is reduced, and is never called if the ammo isn't consumed in the first place.

Parameters

weapon	The currently-active weapon.
ammo	The ammo that the given weapon is currently using.
player	The player which the given weapon and the given ammo belong to.

◆ OnConsumedAsAmmo()

virtual void Terraria.ModLoader.GlobalItem.OnConsumedAsAmmo	(	Item	ammo,
		Item	weapon,
		Player	player
	)

virtual

Allows you to make things happen when the given ammo is consumed by the given weapon. Called by the ammo.
Called before the ammo stack is reduced, and is never called if the ammo isn't consumed in the first place.

Parameters

ammo	The currently-active ammo.
weapon	The weapon that is currently using the given ammo.
player	The player which the given weapon and the given ammo belong to.

◆ OnConsumeMana()

virtual void Terraria.ModLoader.GlobalItem.OnConsumeMana	(	Item	item,
		Player	player,
		int	manaConsumed
	)

virtual

Allows you to make stuff happen when a player consumes mana on use of an item.

Parameters

item	The item being used.
player	The player using the item.
manaConsumed	The mana consumed from the player.

◆ OnMissingMana()

virtual void Terraria.ModLoader.GlobalItem.OnMissingMana	(	Item	item,
		Player	player,
		int	neededMana
	)

virtual

Allows you to make stuff happen when a player doesn't have enough mana for an item they are trying to use. If the player has high enough mana after this hook runs, mana consumption will happen normally. Only runs once per item use.

Parameters

item	The item being used.
player	The player using the item.
neededMana	The mana needed to use the item.

◆ OnResearched()

virtual void Terraria.ModLoader.GlobalItem.OnResearched	(	Item	item,
		bool	fullyResearched
	)

virtual

Allows you to create custom behaviour when an item is accepted by the Research function

Parameters

item	The item being researched
fullyResearched	True if the item was completely researched, and is ready to be duplicated, false if only partially researched.

◆ OnStack()

virtual void Terraria.ModLoader.GlobalItem.OnStack	(	Item	increase,
		Item	decrease,
		int	numberToBeTransfered
	)

virtual

Allows you to make things happen when items stack together.

Parameters

increase	The item that will have its stack increased.
decrease	The item that will be removed or have its stack reduced.
numberToBeTransfered	The number that will be transfered from decrease to increase.

◆ PickAmmo()

virtual void Terraria.ModLoader.GlobalItem.PickAmmo	(	Item	weapon,
		Item	ammo,
		Player	player,
		ref int	type,
		ref float	speed,
		ref StatModifier	damage,
		ref float	knockback
	)

virtual

Allows you to modify various properties of the projectile created by a weapon based on the ammo it is using.

Parameters

weapon	The item that is using the given ammo.
ammo	The ammo item being used by the given weapon.
player	The player using the item.
type	The ID of the fired projectile.
speed	The speed of the fired projectile.
damage	The damage modifier for the projectile. Total weapon damage is included as Flat damage. Be careful not to apply flat or base damage bonuses which are already applied to the weapon.
knockback	The knockback of the fired projectile.

◆ PostDrawTooltip()

virtual void Terraria.ModLoader.GlobalItem.PostDrawTooltip	(	Item	item,
		ReadOnlyCollection< DrawableTooltipLine >	lines
	)

virtual

Allows you to do things after this item's tooltip is drawn. The lines contain draw information as this is ran after drawing the tooltip.

Parameters

item	The item
lines	The tooltip lines for this item

◆ PostDrawTooltipLine()

virtual void Terraria.ModLoader.GlobalItem.PostDrawTooltipLine	(	Item	item,
		DrawableTooltipLine	line
	)

virtual

Allows you to do things after a tooltip line of this item is drawn. The line contains draw info.

Parameters

item	The item
line	The line that was drawn

◆ PreDrawTooltip()

virtual bool Terraria.ModLoader.GlobalItem.PreDrawTooltip	(	Item	item,
		ReadOnlyCollection< TooltipLine >	lines,
		ref int	x,
		ref int	y
	)

virtual

Allows you to do things before this item's tooltip is drawn.

Parameters

item	The item
lines	The tooltip lines for this item
x	The top X position for this tooltip. It is where the first line starts drawing
y	The top Y position for this tooltip. It is where the first line starts drawing

Returns: Whether or not to draw this tooltip

◆ PreDrawTooltipLine()

virtual bool Terraria.ModLoader.GlobalItem.PreDrawTooltipLine	(	Item	item,
		DrawableTooltipLine	line,
		ref int	yOffset
	)

virtual

Allows you to do things before a tooltip line of this item is drawn. The line contains draw info.

Parameters

item	The item
line	The line that would be drawn
yOffset	The Y offset added for next tooltip lines

Returns: Whether or not to draw this tooltip line

◆ PrefixChance()

virtual ? bool Terraria.ModLoader.GlobalItem.PrefixChance	(	Item	item,
		int	pre,
		UnifiedRandom	rand
	)

virtual

To prevent putting the item in the tinkerer slot, return false when pre is -3. To prevent rolling of a prefix on spawn, return false when pre is -1. To force rolling of a prefix on spawn, return true when pre is -1.

To reduce the probability of a prefix on spawn (pre == -1) to X%, return false 100-4X % of the time. To increase the probability of a prefix on spawn (pre == -1) to X%, return true (4X-100)/3 % of the time.

To delete a prefix from an item when the item is loaded, return false when pre is the prefix you want to delete. Use AllowPrefix to prevent rolling of a certain prefix.

Parameters

item
pre	The prefix being applied to the item, or the roll mode. -1 is when the item is naturally generated in a chest, crafted, purchased from an NPC, looted from a grab bag (excluding presents), or dropped by a slain enemy (if it's spawned with prefixGiven: -1). -2 is when the item is rolled in the tinkerer. -3 determines if the item can be placed in the tinkerer slot.
rand

Returns

◆ PreUpdateVanitySet()

virtual void Terraria.ModLoader.GlobalItem.PreUpdateVanitySet	(	Player	player,
		string	set
	)

virtual

Allows you to create special effects (such as the necro armor's hurt noise) when the player wears the vanity set with the given name returned by IsVanitySet. This hook is called regardless of whether the player is frozen in any way.

This method is not instanced.

◆ Register()

sealed override void Terraria.ModLoader.GlobalItem.Register ( )

protectedvirtual

If you make a new ModType, seal this override.

Implements Terraria.ModLoader.ModType< TEntity, TModType >.

◆ SaveData()

virtual void Terraria.ModLoader.GlobalItem.SaveData	(	Item	item,
		TagCompound	tag
	)

virtual

Allows you to save custom data for this item.

NOTE: The provided tag is always empty by default, and is provided as an argument only for the sake of convenience and optimization.
NOTE: Try to only save data that isn't default values.

Parameters

item	The item.
tag	The TagCompound to save data into. Note that this is always empty by default, and is provided as an argument only for the sake of convenience and optimization.

Reimplemented in Terraria.ModLoader.Default.UnloadedGlobalItem.

◆ SetMatch()

virtual void Terraria.ModLoader.GlobalItem.SetMatch	(	int	armorSlot,
		int	type,
		bool	male,
		ref int	equipSlot,
		ref bool	robes
	)

virtual

Allows you to modify the equipment that the player appears to be wearing.

Note that type and equipSlot are not the same as the item type of the armor the player will appear to be wearing. Worn equipment has a separate set of IDs. You can find the vanilla equipment IDs by looking at the headSlot, bodySlot, and legSlot fields for items, and modded equipment IDs by looking at EquipLoader.

This method is not instanced.

Parameters

armorSlot	head armor (0), body armor (1) or leg armor (2).
type	The equipment texture ID of the item that the player is wearing.
male	True if the player is male.
equipSlot	The altered equipment texture ID for the legs (armorSlot 1 and 2) or head (armorSlot 0)
robes	Set to true if you modify equipSlot when armorSlot == 1 to set Player.wearsRobe, otherwise ignore it

◆ SetupContent()

sealed override void Terraria.ModLoader.GlobalItem.SetupContent ( )

virtual

If you make a new ModType, seal this override, and call SetStaticDefaults in it.

Reimplemented from Terraria.ModLoader.ModType< TEntity, TModType >.

◆ Shoot()

virtual bool Terraria.ModLoader.GlobalItem.Shoot	(	Item	item,
		Player	player,
		EntitySource_ItemUse_WithAmmo	source,
		Vector2	position,
		Vector2	velocity,
		int	type,
		int	damage,
		float	knockback
	)

virtual

Allows you to modify an item's shooting mechanism. Return false to prevent vanilla's shooting code from running. Returns true by default.
This method is called after the ModifyShootStats hook has had a chance to adjust the spawn parameters.

Parameters

item	The item being used.
player	The player using the item.
source	The projectile source's information.
position	The center position of the projectile.
velocity	The velocity of the projectile.
type	The ID of the projectile.
damage	The damage of the projectile.
knockback	The knockback of the projectile.

◆ SplitStack()

virtual void Terraria.ModLoader.GlobalItem.SplitStack	(	Item	increase,
		Item	decrease,
		int	numberToBeTransfered
	)

virtual

Allows you to make things happen when an item stack is split. Usually transfers 1 and only occurs with the first transfer. Split stack is called before the stack values are modified.

Parameters

increase	The new item which is a clone of decrease. increase.stack will always be 0. It is increased after SplitStack.
decrease	The original item that will have it's stack reduced.
numberToBeTransfered	The number that will be transfered from decrease to increase.

◆ UpdateArmorSet()

virtual void Terraria.ModLoader.GlobalItem.UpdateArmorSet	(	Player	player,
		string	set
	)

virtual

Allows you to give set bonuses to your armor set with the given name. The set name will be the same as returned by IsArmorSet.

This method is not instanced.

◆ UpdateVanitySet()

virtual void Terraria.ModLoader.GlobalItem.UpdateVanitySet	(	Player	player,
		string	set
	)

virtual

Allows you to create special effects (such as dust) when the player wears the vanity set with the given name returned by IsVanitySet. This hook will only be called if the player is not frozen in any way.

This method is not instanced.

◆ UseAnimationMultiplier()

virtual float Terraria.ModLoader.GlobalItem.UseAnimationMultiplier	(	Item	item,
		Player	player
	)

virtual

Allows you to change the effective useAnimation of an item.
Note that this hook may cause items' actions to run less or more times than they should per a single use.

Returns: The multiplier on the animation time. 1f by default. Values greater than 1 increase the item animation's length.

◆ UseSpeedMultiplier()

virtual float Terraria.ModLoader.GlobalItem.UseSpeedMultiplier	(	Item	item,
		Player	player
	)

virtual

Allows you to safely change both useTime and useAnimation while keeping the values relative to each other.
Useful for status effects.

Returns: The multiplier on the use speed. 1f by default. Values greater than 1 increase the overall item speed.

◆ UseStyle()

virtual void Terraria.ModLoader.GlobalItem.UseStyle	(	Item	item,
		Player	player,
		Rectangle	heldItemFrame
	)

virtual

Allows you to modify the location and rotation of any item in its use animation.

Parameters

item	The item.
player	The player.
heldItemFrame	The source rectangle for the held item's texture.

◆ UseTimeMultiplier()

virtual float Terraria.ModLoader.GlobalItem.UseTimeMultiplier	(	Item	item,
		Player	player
	)

virtual

Allows you to change the effective useTime of an item.
Note that this hook may cause items' actions to run less or more times than they should per a single use.

Returns: The multiplier on the usage time. 1f by default. Values greater than 1 increase the item use's length.

◆ ValidateType()

override void Terraria.ModLoader.GlobalItem.ValidateType ( )

protectedvirtual

Check for the correct overrides of different hook methods and fields and properties

Reimplemented from Terraria.ModLoader.ModType< TEntity, TModType >.

◆ WingUpdate()

virtual bool Terraria.ModLoader.GlobalItem.WingUpdate	(	int	wings,
		Player	player,
		bool	inUse
	)

virtual

Allows for Wings to do various things while in use. "inUse" is whether or not the jump button is currently pressed. Called when wings visually appear on the player. Use to animate wings, create dusts, invoke sounds, and create lights. False will keep everything the same. True, you need to handle all animations in your own code.

This method is not instanced.

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ AnglerChat()

◆ ArmorArmGlowMask()

◆ ArmorSetShadows()

◆ CanAutoReuseItem()

◆ CanBeChosenAsAmmo()

◆ CanBeConsumedAsAmmo()

◆ CanCatchNPC()

◆ CanChooseAmmo()

◆ CanConsumeAmmo()

◆ CanConsumeBait()

◆ CanEquipAccessory()

◆ CanResearch()

◆ CanShoot()

◆ CanStack()

◆ CanStackInWorld()

◆ ChoosePrefix()

◆ DrawArmorColor()

◆ ExtractinatorUse()

◆ GetHealLife()

◆ GetHealMana()

◆ HoldoutOffset()

◆ HoldoutOrigin()

◆ HoldStyle()

◆ IsAnglerQuestAvailable()

◆ IsArmorSet()

◆ IsVanitySet()

◆ LoadData()

◆ ModifyItemLoot()

◆ ModifyItemScale()

◆ ModifyManaCost()

◆ ModifyResearchSorting()

◆ ModifyShootStats()

◆ ModifyWeaponCrit()

◆ ModifyWeaponDamage()

◆ ModifyWeaponKnockback()

◆ OnCatchNPC()

◆ OnConsumeAmmo()

◆ OnConsumedAsAmmo()

◆ OnConsumeMana()

◆ OnMissingMana()

◆ OnResearched()

◆ OnStack()

◆ PickAmmo()

◆ PostDrawTooltip()

◆ PostDrawTooltipLine()

◆ PreDrawTooltip()

◆ PreDrawTooltipLine()

◆ PrefixChance()

◆ PreUpdateVanitySet()

◆ Register()

◆ SaveData()

◆ SetMatch()

◆ SetupContent()

◆ Shoot()

◆ SplitStack()

◆ UpdateArmorSet()

◆ UpdateVanitySet()

◆ UseAnimationMultiplier()

◆ UseSpeedMultiplier()

◆ UseStyle()

◆ UseTimeMultiplier()

◆ ValidateType()

◆ WingUpdate()