Shadows Configuration

Files

File	Purpose
`config.yml`	Extraction, summon, AI, regions, ModelEngine
`shadow-archetypes.yml`	Per-archetype stats, abilities, `model-engine-id`
`leash-preferences.yml`	Per-player leash distance (generated)

Key	Description
`install-blueprints`	Copy bundled `.bbmodel` to ModelEngine on enable
`overwrite-blueprints`	Replace existing blueprint files
`reload-after-install`	Run `/meg reload` after install (default off)
`debug`	Verbose ModelEngine logging
`reapply-after-pack-load`	Re-apply models when resource pack loads

Required: ModelEngine plugin + merged resource pack (Core resource-pack.merge-modelengine-pack).

Key	Description
`min-rank`	Minimum hunter rank (default `C`)
`base-success`	Base extraction chance
`rank-success-bonus-per-tier`	Bonus per rank tier
`boss-bonus` / `boss-power-multiplier`	Boss kill modifiers
`offer-timeout-seconds`	Pending offer duration
`wild-kill-enabled`	Extraction from gate/dungeon wild mobs
`rare-archetypes`	Special rolls (e.g. Void Dragon)

Key	Description
`max-active-summons`	Max shadows out at once
`default-behavior-mode`	`SQUAD`, `FOLLOW`, `FREE_ROAM`, etc.
`max-leash-blocks`	Default roam distance
`leash-permissions`	Map blocks → permission node
`mana-cost-per-tier`	Mana per summon by rank tier
`nameplate`	Floating name format
`particles`	Summon/dismiss VFX
`ai.*`	Pathing, combat, squad formation, LOD

Storage capacity comes from AscensionCore rank shadow-capacity.

Dungeon/gate mobs with custom AI. Archetypes and models in shadow-archetypes.yml (wild-model-engine-id).

WorldGuard/Towny integration — where shadows can fight or extract. Bypass: ascension.shadow.region.bypass.

Key	Description
`clickable-army-list`	Clickable `/shadows list` in chat
`clickable-extract-offer`	Clickable extraction prompts

min-length, max-length, blocked-words, use-builtin-filter for shadow rename/bind.

Automatic XP while summoned — max-level, xp-per-kill, strength-per-level, etc.