Configuration

Configuration

RPGMood ships three config files, generated automatically in plugins/RPGMood/ on first start: config.yml, zones.yml, and triggers.yml. Edit them and run /rpgmood reload to apply changes.

• zones.yml — zone definitions. See Zones.
• triggers.yml — time/weather/block-break events. See Ambient Events.
• config.yml — everything else, detailed below.

---

settings

Key	Type	Default	Description
zone_change_cooldown	Integer (seconds)	45	Minimum time between zone-change feedback for the same player
particle_update_interval	Integer (ticks)	40	Reserved for future ambient particle scheduling — not yet read by any feature

messages

Key	Default
no_permission	&c[RPGMood] You do not have permission to use this command.
plugin_reloaded	&a[RPGMood] Configuration reloaded successfully.
toggle_enabled	&a[RPGMood] Effects enabled.
toggle_disabled	&e[RPGMood] Effects disabled.

mob_scaling

See Mob Scaling for the full formula. Quick reference:

Key	Type	Default	Description
enabled	Boolean	true	Master switch
hostile-only	Boolean	true	Only scale Monster entities
max-level	Integer	40	Upper clamp on the computed level
health_per_level	Decimal	2.0	Max health added per level
damage_per_level	Decimal	0.12	Attack damage added per level
armor_per_level	Decimal	0.25	Armor added per level
speed_per_level	Decimal	0.0015	Movement speed added per level
radius.step_distance	Decimal (blocks)	180	Distance per "ring" of difficulty from spawn
players_bonus_per_player	Integer	1	Level added per nearby player (within ~30 blocks)
name_format	String	"&cLv. {level} {name}"	Custom name shown above scaled mobs. Supports {level} and {name}
bonus_xp_per_level	Integer	2	Bonus XP granted per level when a player kills a scaled mob. 0 disables
base-levels	Map<EntityType, Integer>	see below	Per-mob-type difficulty seed
biome-bonuses	Map<Biome, Integer>	see below	Flat bonus per biome
structure-bonuses	Map<structure key, Integer>	see below	Flat bonus near a vanilla structure
announcement.*	—	see below	Server-wide broadcast when a high-level mob spawns

mob_scaling:
  base-levels:
    ZOMBIE: 1
    SKELETON: 2
    SPIDER: 2
    CREEPER: 3
    ENDERMAN: 4
    WITHER_SKELETON: 5
  biome-bonuses:
    PLAINS: 0
    FOREST: 1
    MOUNTAINS: 3
    SOUL_SAND_VALLEY: 4
  structure-bonuses:
    stronghold: 3
    desert_pyramid: 2
    jungle_pyramid: 2
    woodland_mansion: 4
    ocean_monument: 4
    nether_fortress: 3
  announcement:
    enabled: true
    min-level: 25
    cooldown-seconds: 120
    message: "&c⚠ A Level {level} {name} has emerged in {biome}!"

Any EntityType / Biome not listed defaults to 0 (or 1 for base-levels) — you don't need to list every enum value, only the ones you want to deviate from baseline. See Mob Scaling for the rewards and announcement behavior in detail.

death_messages

Fully documented on the Death Messages page. Top-level keys: fallback, causes (includes killers.player for PvP), biomes, killers, killer_synonyms, armed, modifiers, location_name_templates, location_name_descriptors (ships per-biome pools for common biomes plus default), location_names.

player_effects

Not hand-edited — RPGMood writes player_effects.<uuid>: true|false here automatically when a player runs /rpgmood toggle.

stats.yml

A separate file (not config.yml) — not hand-edited. Backs /rpgmood leaderboard: per-player deaths, zone changes, and highest mob level killed. See Commands.