Skip to main content

Mobs Overview

Mobs are the core of BTCMobs. You can create custom creatures with unique stats, behaviors, skills, and equipment.

Configuration

Mob files are located in plugins/btcMobs/Mobs/ or in pack directories under plugins/btcMobs/Packs/<pack-name>/Mobs/.

Basic Structure

MobInternalName:
  Type: <EntityType>
  Display: "<DisplayName>"
  Health: <number>
  Damage: <number>
  Options:
    # Various mob options
  AIGoalSelectors:
    # AI behavior goals
  AITargetSelectors:
    # AI targeting rules
  Skills:
    # Skill definitions
  Drops:
    # Drop table references

Example

ForestGuardian:
  Type: ZOMBIE
  Display: "&2Forest Guardian"
  Health: 100
  Damage: 10
  Options:
    AlwaysShowName: true
    PreventSunburn: true
  AIGoalSelectors:
    - clear
    - meleeattack{speed=1.2}
    - randomstroll{speed=0.8}
  AITargetSelectors:
    - clear
    - hurtby
    - players
  Skills:
    - effect:particles{p=happyVillager;amount=5} @self ~onSpawn
    - effect:sound{s=entity.zombie.ambient;v=0.5} @self ~onSpawn

Configuration Sections

SectionDescription
TypeThe base entity type (ZOMBIE, SKELETON, etc.)
DisplayCustom display name with color codes
HealthMaximum health points
DamageBase attack damage
OptionsVarious behavior flags
AIGoalSelectorsAI goal behaviors
AITargetSelectorsAI targeting rules
SkillsSkill configurations
EquipmentGear and items
DropsDrop table references