-
Notifications
You must be signed in to change notification settings - Fork 0
Commands
All three commands (/rpgmood, /diary, /rpgmood-farm) have full Tab-completion for
their subcommands and categories.
| 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|scoreboard] |
rpgmood.player.toggle |
Toggle ambient effects on/off; titles toggles just the on-screen Title/Subtitle, scoreboard toggles the sidebar scoreboard & zone BossBar
|
/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 |
/rpgmood zones [fav <name>] |
rpgmood.player.zones |
List your discovered zones, or mark one a favorite |
/rpgmood level |
rpgmood.player.level |
Show your progression level and XP |
/diary (alias /diario) |
rpgmood.player.diary |
Open your adventure journal |
/rpgmood-farm season |
rpgmood.player.farming.season |
Show the current season and growth multiplier |
/rpgmood-farm crops |
rpgmood.player.farming.crops |
List this season's harvestable crops |
/rpgmood-farm recipes [all] |
rpgmood.player.farming.recipes |
Show your discovered recipes, or all recipes with all
|
/rpgmood-farm animal list |
rpgmood.player.farming.animal |
List your animals |
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.
Lets a player opt out of ambient effects without affecting anyone else. Each 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. -
/rpgmood toggle scoreboard— switch (player_scoreboard.<uuid>) for the sidebar scoreboard & zone BossBar (current zone, local danger, session kills). On by default; independent of the other two toggles.
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.
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.
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.
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.
Lists every zone you've discovered so far, oldest first:
- A star (★) if marked favorite
- Display name
- Biome (or zone id) and current danger level, where computable — see the limitation note below
- First-seen date (
yyyy-MM-dd)
Below the list, shows the distance in blocks to your nearest other discovered zone (skipping whichever one you're currently standing in).
/rpgmood zones fav <name> toggles the favorite star on a zone you've already discovered. <name> is matched against the zone's display name, case-insensitively, and can contain spaces without quotes (e.g. /rpgmood zones fav Elden Meadows). Replies with an error if you haven't discovered a zone by that name yet.
Limitation: danger level and "distance to nearest known zone" only work for dynamically-generated zones — their zone key embeds an approximate location, which the 3 zones you hand-curate in zones.yml don't have (a BIOME zone can match anywhere that biome occurs; a WORLDGUARD zone anywhere inside its region). For those, danger shows blank and they're excluded from the nearest-zone distance calculation. See Zones → Zone discovery for the full explanation.
Shows your RPGMood progression level — a separate track from mob difficulty levels, earned by playing rather than tuned by an admin:
- Current level and XP progress toward the next one
- Your current animal ownership cap bonus (only shown once it's above 0)
Reaching level L from zero requires 100 * L^1.5 total XP (rounded) — early levels come quickly, later ones take progressively longer. XP is earned two ways:
| Source | XP |
|---|---|
| Killing a scaled mob |
level * 5 (e.g. a level 20 kill is worth 100 XP) |
| Discovering a new zone (first time only) |
15 flat |
Every 5 levels raises your animal ownership cap by 1, stacking on top of farming.animals.max_per_player — see Farming → Animal husbandry. Also shown on the GUI menu's main page.
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.
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.
As of v1.8.0, each subcommand has its own permission node (see Permissions reference below) instead of one shared rpgmood.player.farming — all default true, so nothing changes for anyone unless an admin explicitly restricts one.
| Subcommand | Permission | Effect |
|---|---|---|
season |
rpgmood.player.farming.season |
Current season, day count, and growth multiplier |
crops |
rpgmood.player.farming.crops |
Crops harvestable this season |
recipes |
rpgmood.player.farming.recipes |
Your discovered recipes |
recipes all |
rpgmood.player.farming.recipes |
Every recipe, discovered or not |
animal list |
rpgmood.player.farming.animal |
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.
| Permission | Default | Description |
|---|---|---|
rpgmood.admin |
op |
/rpgmood reload, /rpgmood info, the Admin Config menu panel
|
rpgmood.player.toggle |
true |
/rpgmood toggle (master, titles, and scoreboard) |
rpgmood.player.diary |
true | /diary |
rpgmood.player.leaderboard |
true | /rpgmood leaderboard |
rpgmood.player.achievements |
true | /rpgmood achievements |
rpgmood.player.zones |
true | /rpgmood zones |
rpgmood.player.level |
true | /rpgmood level |
rpgmood.player.farming |
true | Parent node granting all 4 /rpgmood-farm subcommand permissions below (shorthand only) |
rpgmood.player.farming.season |
true | /rpgmood-farm season |
rpgmood.player.farming.crops |
true | /rpgmood-farm crops |
rpgmood.player.farming.recipes |
true | /rpgmood-farm recipes [all] |
rpgmood.player.farming.animal |
true | /rpgmood-farm animal list |