Skip to content

Commands

okereke-dev edited this page Jul 4, 2026 · 7 revisions

Commands


Command list

Command Permission Description
/rpgmood reload rpgmood.admin Reload config.yml, zones.yml, and triggers.yml from disk
/rpgmood toggle [titles] rpgmood.player.toggle Toggle ambient effects on/off; titles toggles just the on-screen Title/Subtitle
/rpgmood info rpgmood.admin Show your current zone and the mob difficulty level at your location
/rpgmood leaderboard [deaths|zones|level] rpgmood.player.leaderboard Show the top 10 players for a tracked stat
/diary (alias /diario) rpgmood.player.diary Open your adventure journal

/rpgmood reload

Reloads config.yml, zones.yml, and triggers.yml. Applies immediately to new events — doesn't retroactively change mobs that were already scaled.

/rpgmood toggle [titles]

Lets a player opt out of ambient effects without affecting anyone else. The preference is stored per-player in config.yml and persists across sessions.

  • /rpgmood toggle — master switch (player_effects.<uuid>). Disables zone sound/particles/chat/title and time/weather ambient messages entirely.
  • /rpgmood toggle titles — narrower switch (player_titles.<uuid>). Disables only the big on-screen Title/Subtitle on zone entry; sound, particles, and the chat flavor line keep working. For players who find the screen text specifically distracting (e.g. while flying or navigating), without losing the rest of the ambience.

See Zones → Avoiding title spam for how RPGMood also automatically limits titles (dwell time, per-zone memory, shorter duration while moving fast) before a player even needs to touch this setting.

/rpgmood info

Admin/debug tool. Shows:

  • Your current zone's display name
  • Your current biome
  • Distance from world spawn
  • The mob scaling level a Zombie, Skeleton, and Enderman would each receive if they spawned at your exact location right now

Use this while standing at the edge of a farm, near a structure, or at a chosen distance from spawn to sanity-check your mob_scaling tuning without needing to wait for a real mob to spawn.

/rpgmood leaderboard [deaths|zones|level]

Shows the top 10 players for a tracked stat, server-wide. Defaults to deaths if no category is given.

Category What it counts
deaths Total deaths recorded
zones Total zone-change events triggered (see Zones)
level Highest-level scaled mob ever killed

Stats are persisted in plugins/RPGMood/stats.yml.

/diary {#diary}

Opens a written book containing your character's adventure journal — the most recent zone arrivals and deaths (up to 50 entries, most recent first), each timestamped. Entries are persisted to plugins/RPGMood/playerdata/<uuid>.yml and survive restarts. A fresh player with no recorded events sees a short placeholder page instead.


Permissions reference

Permission Default Description
rpgmood.admin op /rpgmood reload, /rpgmood info
rpgmood.player.toggle true /rpgmood toggle
rpgmood.player.diary true /diary
rpgmood.player.leaderboard true /rpgmood leaderboard

Clone this wiki locally