Animal Definition

Defines a tycoon animal with research tree, catalyst mechanics, fusion, and economy stats

清单由 Tycoon 提供

字段

字段	类型	默认值	描述
entityDefinition	Ref<EntityDefinitionEntry>	—	The entity definition providing the visual model (NPC, ModelEngine, vanilla mob)
category	String	—	Research category this animal belongs to
rarity	AnimalRarity	COMMON	Rarity tier driving revenue, capture weight, and fatigue可选值：COMMONUNCOMMONRAREEPICLEGENDARY
catalystPowerRequired	Double	15.0	Total catalyst power required before fuel can be applied
acceptedCatalystItems	List<CatalystItemDef>	empty	Items accepted by the catalyst and their power contribution CatalystItemDef（3） 字段 类型 默认值 描述 itemId String — — powerValue Double 1.0 — displayName String — —
fuelItem	String	—	Fuel item consumed to trigger the research attempt
successChance	Double	0.3	Base chance of successful research before rarity and profession modifiers
alternativeRewards	List<AlternativeReward>	empty	Rewards granted if the player already owns this animal AlternativeReward（4） 字段 类型 默认值 描述 itemId String — — amount Int 1 — weight Double 1.0 — commands List<String> empty —
spaceCost	Int	5	Zoo spaces one individual of this species occupies. Revenue is expected to scale with it: a raccoon at 5 spaces earns far less than an elephant at 20.
baseRevenueRate	Double	0.5	Base revenue per second at level 1
revenueScaling	Double	0.1	Revenue multiplier per level above 1
biomeAffinities	AnimalBiomeAffinity	—	Biome affinity map for zoo revenue bonuses. Only read when biome affinity is enabled in the economy config.变体：multinonesimple multi（1） 字段 类型 默认值 描述 affinities Map<String, Double> empty — none（1） 字段 类型 默认值 描述 _dummy Boolean false — simple（2） 字段 类型 默认值 描述 biome String PLAINS — multiplier Double 1.5 —
isMountable	Boolean	false	Whether this animal can be ridden as a mount
fatigueCapacity	Int	180	Base fatigue capacity in seconds when used as a mount
mountSpeed	Double	1.0	Movement speed multiplier when mounted
fusionMinLevel	Int	1	Minimum level required to attempt fusion with another animal of this species
fusionParentRequired	Boolean	true	Whether two parents are required for fusion (true) or just one (false = breeding)
requiredProfessionLevel	Int	1	Minimum RPG profession level required
description	String	—	Flavor description for the bestiary
icon	String	—	Icon item for GUI representation
modelVariants	List<ModelVariantDef>	empty	Alternative model/skin variants — each references an existing EntityDefinition with a retrievable ID ModelVariantDef（2） 字段 类型 默认值 描述 entityDefinition String — — displayName String — —

TypeWriter 通用字段（displayName）

字段	类型	默认值	描述
displayName	String	—	Display name shown in GUI and messages

How to use it

• Research — category is the id of a Research Category, which must also list the animal in animals. acceptedCatalystItems pairs an itemId (a Material name such as SWEET_BERRIES) with a powerValue; the catalyst is full at catalystPowerRequired. fuelItem is a Material name. The real chance of success is successChance times the rarity capture weight (1.0 for COMMON down to 0.02 for LEGENDARY).
• Economy — spaceCost is the zoo space used; baseRevenueRate is revenue per second at level 1, revenueScaling the bonus per level above 1. Balance them together: a big animal should earn more per space spent.
• Mount — isMountable, mountSpeed and fatigueCapacity (seconds) apply on the adventure map.
• Models — entityDefinition is the visual; modelVariants are alternative skins that reference other entity definitions.
• Alternative rewards — granted, by weight, when a player researches an animal they already own. Each reward runs its commands with {player} replaced by the player name.