com.hypixel.hytale.server.core.asset.type.item.config

Package: com.hypixel.hytale.server.core.asset.type.item.config

Item and crafting recipe asset configuration types. Defines the data model for all items, recipes, tools, weapons, armor, and related configurations. Types marked as API surface are used by multiple game systems. The package includes two subpackages: container for drop table logic and metadata for system-specific item metadata.

Primary Asset Types

Type	Kind	API Surface	Description
Item	class	yes	Central item asset definition with all item properties.
CraftingRecipe	class	yes	Crafting recipe with inputs, outputs, bench requirements.
ItemDropList	class	no	Reusable named drop list asset.
BlockGroup	class	no	Named group of block types for recipes and tools.

Item Behavior Types

Type	Kind	API Surface	Description
ItemWeapon	class	yes	Weapon damage, speed, and knockback configuration.
ItemTool	class	yes	Tool mining speed and durability configuration.
ItemTool.DurabilityLossBlockTypes	class	yes	Per-block-type durability loss rates.
ItemToolSpec	class	yes	Tool capability specifications.
ItemArmor	class	yes	Armor defense and slot configuration.
ItemGlider	class	yes	Glider physics parameters.
ItemUtility	class	yes	Consumable/usable item behavior.
PortalKey	class	yes	Portal access key configuration.

Display & Appearance

Type	Kind	API Surface	Description
AssetIconProperties	class	yes	Icon rendering configuration (scale, translation, rotation).
ItemTranslationProperties	class	yes	Localization/translation keys.
ItemAppearanceCondition	class	yes	Conditional visual appearance rules.
ItemReticleConfig	class	no	Crosshair/reticle configuration.
ItemReticle	class	no	Single reticle definition.
ItemReticleWithDuration	class	no	Duration-based reticle state.

Item Systems

Type	Kind	API Surface	Description
ItemEntityConfig	class	yes	Dropped entity spawning configuration.
ItemPullbackConfig	class	yes	Charge/pullback mechanics for bows.
ItemStackContainerConfig	class	yes	Container item (bag/pouch) configuration.
BlockSelectorToolData	class	yes	Block selector tool UI configuration.
BuilderToolItemReferenceAsset	class	no	Builder tool item reference.

Categorization

Type	Kind	Description
ItemCategory	class	UI sorting categories.
ItemQuality	class	Quality/rarity tiers.
FieldcraftCategory	class	Field crafting recipe categories.
ResourceType	class	Material-based crafting resource types.
ItemDrop	class	Single drop entry (item, quantity, chance).
InteractionModifierId	enum	Interaction modifier identifiers.

Subpackages

Package	Description
container	Item drop container hierarchy for loot tables.
metadata	System-specific item metadata extensions.