Skip to content

Commands

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

Commands

All three commands (/rpgmood, /diary, /rpgmood-farm) have full Tab-completion for their subcommands and categories.


Command list

Command Permission Description
/rpgmood or /rpgmood menu none Opens the GUI menu — the visual hub for everything below
/rpgmood reload rpgmood.admin Reload config.yml, zones.yml, triggers.yml, and farming/achievement data 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
/rpgmood achievements rpgmood.player.achievements Show your unlocked/locked achievements
/diary (alias /diario) rpgmood.player.diary Open your adventure journal
/rpgmood-farm season rpgmood.player.farming Show the current season and growth multiplier
/rpgmood-farm crops rpgmood.player.farming List this season's harvestable crops
/rpgmood-farm recipes [all] rpgmood.player.farming Show your discovered recipes, or all recipes with all
/rpgmood-farm animal list rpgmood.player.farming List your animals

/rpgmood reload

Reloads config.yml, zones.yml, triggers.yml, and farming.yml-backed data (crop/recipe/animal definitions, plus each manager's persisted player data). 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.

/rpgmood achievements

Shows how many of the 31 achievements you've unlocked, with unlocked entries showing their icon/name/description and locked entries showing only the icon/name. The GUI menu's Achievements panel shows the same thing without the wall of chat text.

/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. Achievement unlocks and farming milestones (recipe discoveries, gold-quality harvests, animal befriending) also get logged here.

/rpgmood-farm

Full reference on the Farming page. Quick summary. Note that claiming an animal isn't a subcommand — feed a wild cow/chicken/sheep/goat its normal vanilla breeding food to befriend it, see Farming → Befriending.

Subcommand Effect
season Current season, day count, and growth multiplier
crops Crops harvestable this season
recipes Your discovered recipes
recipes all Every recipe, discovered or not
animal list Your owned animals with affection/health/sickness

Looking at your own animal with a stick shows its detail view (affection hearts, health, hunger, sickness) — see Farming.


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
rpgmood.player.achievements true /rpgmood achievements
rpgmood.player.farming true /rpgmood-farm (all subcommands — not split per-subcommand yet)

Clone this wiki locally