Skip to main content

Configuration

The main plugin configuration file is located at plugins/btcMobs/config.yml.

Default Configuration

# BTCMobs Configuration
# Version: 0.0.1

# General Settings
debug: false
auto-reload: false

# Mob Behavior
mobs:
  # Default follow range for custom mobs
  default-follow-range: 24.0
  
  # Default despawn behavior
  default-despawn: true
  
  # Enable threat table by default
  threat-table-enabled: true

# Spawner Settings
spawners:
  # Global tick interval (in ticks)
  tick-interval: 20
  
  # Check for players before spawning
  require-players: true
  
  # Default activation range
  default-activation-range: 32

# Performance Settings
performance:
  # Maximum mobs per spawner
  max-mobs-per-spawner: 10
  
  # Chunk loading behavior
  load-chunks: false

# Integration Settings
integrations:
  # ModelEngine integration
  model-engine:
    enabled: true
    
  # PlaceholderAPI integration
  placeholder-api:
    enabled: true

Configuration Options

General

OptionTypeDefaultDescription
debugbooleanfalseEnable debug logging
auto-reloadbooleanfalseAuto-reload on file changes

Mob Settings

OptionTypeDefaultDescription
mobs.default-follow-rangedouble24.0Default detection range
mobs.default-despawnbooleantrueAllow natural despawning
mobs.threat-table-enabledbooleantrueEnable aggro/threat system

Spawner Settings

OptionTypeDefaultDescription
spawners.tick-intervalint20Spawner check interval (ticks)
spawners.require-playersbooleantrueRequire players nearby
spawners.default-activation-rangeint32Default spawner range

Performance

OptionTypeDefaultDescription
performance.max-mobs-per-spawnerint10Maximum alive mobs per spawner
performance.load-chunksbooleanfalseLoad chunks for spawning

Directory Structure

plugins/btcMobs/
├── config.yml           # Main configuration
├── Mobs/               # Mob definitions
│   └── *.yml
├── Skills/             # Skill files
│   └── *.yml
├── DropTables/         # Drop table configurations
│   └── *.yml
├── Spawners/           # Spawner configurations
│   └── *.yml
├── Items/              # Custom item definitions
│   └── *.yml
└── Packs/              # Modular configuration packs
    └── <pack-name>/
        ├── packinfo.yml
        ├── Mobs/
        ├── Skills/
        └── ...