BTC Mob Template

Native BTC mob template

DéfinitionFourni par BTCMobs

Native Typewriter definition of a BTC mob. The entry is deliberately declarative: references are resolved once by the registry and dynamic values are evaluated only when a player-scoped action spawns the mob. This keeps the hot path independent from Typewriter entry lookup.

Champs

Champ	Type	Par défaut	Description
entityType	Var<String>	ZOMBIE	Vanilla entity type used as the base entity
display	Var<String>	—	Display name of the spawned mob
level	Var<Double>	1.0	Default mob level
maxHealth	Var<Double>	20.0	Maximum health before level modifiers
attackDamage	Var<Double>	2.0	Attack damage before level modifiers
armor	Var<Double>	0.0	Base armor before level modifiers
skills	List<String>	empty	Skill lines composed in declaration order
conditions	List<String>	empty	Conditions applied before each skill line
targeters	List<String>	empty	Targeter declarations shared by the skill composition
drops	List<String>	empty	Drop table references
threatTable	Boolean	true	Whether this mob maintains a threat table
faction	String	—	Faction used by the native threat and relationship system
options	Map<String, String>	empty	MythicMobs mob options preserved as normalized key/value pairs
equipment	Map<String, String>	empty	Equipment slot declarations preserved as slot/item pairs
aiGoalSelectors	List<String>	empty	Ordered MythicMobs AI goal selector declarations
aiTargetSelectors	List<String>	empty	Ordered MythicMobs AI target selector declarations
levelModifiers	Map<String, Double>	empty	Level modifier declarations
damageModifiers	Map<String, Double>	empty	Damage modifier declarations
immunityTable	Map<String, Boolean>	empty	Damage immunity declarations
modelProvider	String	—	Optional model backend: bettermodel or modelengine
modelId	String	—	Optional model identifier registered by the selected model backend
modelAnimations	List<String>	empty	Animations started after the model is attached
modelLifecycle	MobModelAnimations	—	Animations ponctuelles du modele : apparition, attaque, blessure, mort (jouee jusqu'au bout avant que le modele ne disparaisse) MobModelAnimations (4) Champ Type Par défaut Description apparition String spawn Animation jouee une fois a l'apparition. Vide = aucune. attaque String attack Animation jouee une fois a chaque attaque de la creature. Vide = aucune. blessure String hurt Animation jouee une fois a chaque coup recu non mortel. Vide = aucune. mort String death Animation jouee a la mort, jusqu'au bout, avant que le modele ne disparaisse. Vide = le modele disparait a la mort, comme avant.
modelVariants	MobVisualVariants	—	Variantes visuelles tirees a l'apparition et gardees a vie : teinte des seuls groupes du corps, groupe de decoration assorti, groupes optionnels MobVisualVariants (3) Champ Type Par défaut Description teintes List<MobTintVariant> empty Teintes possibles ; une seule est tiree par creature. Vide = aucune teinte. MobTintVariant (2) Champ Type Par défaut Description couleur String #FFFFFF Couleur RGB appliquee aux groupes du corps, en hexadecimal (ex. `#F9801D`). groupe String — Groupe du modele affiche avec cette teinte, et lui seul. Vide = `fleurs_<id>`. groupesTeintes List<String> empty Groupes du corps teintes, enfants compris. Vide = tout le modele. Les groupes des teintes et les groupes optionnels ne sont jamais teintes, meme places sous un groupe du corps. groupesOptionnels List<MobOptionalGroup> empty Groupes affiches selon une probabilite (variante de spawn occasionnelle). MobOptionalGroup (2) Champ Type Par défaut Description groupe String — Groupe du modele concerne (ex. `fleurs`). probabilite Double 0.0 Probabilite de l'afficher, entre 0 et 1. Le tirage est fait une fois, a l'apparition.
onSpawn	List<Ref<ActionEntry>>	empty	Actions executed when this template is spawned
onDeath	List<Ref<ActionEntry>>	empty	Actions executed when this template dies
reproduction	ReproductionSpec	—	Reproduction : laisser desactive pour un mob qui ne s'eleve pas ReproductionSpec (7) Champ Type Par défaut Description active Boolean false Active la reproduction pour ce gabarit. Desactive, tout le reste est ignore. declencheur String — Objet a donner a CHAQUE parent. Identifiant de catalogue BTC (ex. `bait_simple`) ou nom de matiere vanilla (ex. `WHEAT`). Vide = aucune reproduction possible, meme si `active`. dureeAmourSecondes Int 30 Duree pendant laquelle un parent nourri cherche un partenaire, en secondes. reposSecondes Int 300 Delai qu'un parent observe apres une naissance avant de pouvoir etre renourri, en secondes. porteeBlocs Double 8.0 Distance maximale a laquelle deux parents se trouvent, en blocs. mode ModeDeNaissance ADULTE Le petit nait adulte, ou juvenile avec son propre gabarit. gabaritDuPetit String — Gabarit du petit quand le mode est JUVENILE. Vide = le gabarit des parents, ce qui revient a une naissance adulte : le mode JUVENILE sans gabarit est donc refuse et signale.
vanillaReplica	Boolean	false	Replique d'une creature du jeu de base : son butin n'est pas amorti par l'ecart de niveau (l'XP de Combat l'est toujours). Vrai sur les templates btc_vanilla_*.
levelGapExempt	Boolean	false	Exception au bareme d'ecart de niveau : ni l'XP de Combat ni le butin ne sont amortis. A reserver aux cas voulus — un boss d'evenement, une creature de quete.
group	Ref<GroupEntry>	—	Optional Typewriter group used for audience and fact composition

Champs TypeWriter communs (criteria, modifiers, triggers)

Champ	Type	Par défaut	Description
criteria	List<Criteria>	empty	—
modifiers	List<Modifier>	empty	—
triggers	List<Ref<TriggerableEntry>>	empty	—

How to use it

The template id is the key every other entry uses: spawners, natural spawns, actions, events, facts and NPC definitions all take the id, not the display name, and ignore case.

• Base stats. entityType is a Minecraft entity name such as ZOMBIE. maxHealth, attackDamage and armor are the values before level modifiers; levelModifiers, damageModifiers and immunityTable refine them.
• Skills. Each line of skills is skillId or skillId~trigger, for example shockwave~onTimer:100 or rage~onDamaged. conditions and targeters apply to all skill lines.
• Drops. drops lists drop declarations or drop table ids, for example exp 10to20 or BONE 2 0.5.
• Model. modelProvider is bettermodel or modelengine and modelId the model name. Only idle animations in modelAnimations are started at spawn. modelLifecycle names the one-shot animations played at spawn, on each attack, on each non-lethal hit and on death (the death animation plays to the end before the model disappears); empty disables that moment.
• Hooks. onSpawn and onDeath run TypeWriter actions. faction and threatTable drive the threat system.
• Reproduction. Leave reproduction inactive unless the mob must breed: it needs a declencheur item given to each parent.
• Level gap. vanillaReplica and levelGapExempt control how a level gap between player and mob reduces rewards.