-
Notifications
You must be signed in to change notification settings - Fork 0
Menu
/rpgmood with no arguments (or /rpgmood menu explicitly) opens a GUI — the visual hub for
everything the text commands already expose. It's an additional way in, not a replacement:
every subcommand on the Commands page still works exactly as before.
No permission is required to open the menu itself; each panel shows whatever the viewing player is already allowed to see.
A 27-slot inventory with a bordered frame and one icon per feature area:
| Icon | Opens | Shows |
|---|---|---|
| 📖 Written Book | Adventure Journal | The same book as /diary
|
| 🌟 Nether Star | Achievements | Category-filtered achievement browser, unlocked/total count |
| 🧭 Compass | Current Zone | Zone, biome, distance from spawn, local mob danger |
| 🗡 Diamond Sword | Leaderboard | Top 10 by deaths, zones, or mob level |
| 🌾 Wheat | Farming | Current season, growth multiplier, this season's crops |
| 🐄 Hay Bale | My Animals | Your befriended animals with affection/health |
| ⚔ Netherite Sword | RPGLoot | Only shown if RPGLoot is installed |
| ✦ Experience Bottle | Level | Your progression level, XP to next level, animal cap bonus |
| 🎚 Comparator | Settings | Ambient effects, zone titles, action bar vs. chat |
| 🛠 Redstone | Admin Config | Only shown to players with rpgmood.admin |
Every submenu has a "← Back" icon that returns to this main menu.
54-slot inventory. Five category tabs across the top (Exploration, Combat, Survival, Farming,
Loot) — click a tab to filter the grid below it. Each tab shows its own unlocked/total count
and highlights (▶, yellow) when selected.
Unlocked achievements show a lime dye icon with their real icon/name and full description. Locked achievements show a gray dye icon with just the name and "Not yet unlocked" — same information split as the text version, just browsable instead of dumped all at once. See Achievements for the full list of all 31.
27-slot. Three panels: your current zone name and biome, distance from world spawn, and the mob difficulty level a Zombie, Skeleton, and Enderman would each receive if they spawned at your exact location right now.
Unlike /rpgmood info (which requires rpgmood.admin), this panel
is open to every player — a deliberate choice, since "how dangerous is it here?" is useful
information for anyone, not just staff tuning mob_scaling.
27-slot. Three tabs — Deaths, Zones Explored, Highest Mob Level — click to switch, same three
categories as /rpgmood leaderboard.
Top 10 entries listed below the tabs with a player head icon, rank, and value.
36-slot. A season panel (icon, day count, growth multiplier, flavor description) plus one icon per crop harvestable this season, using each crop's actual item as its icon.
36-slot. One icon per animal you've befriended, using that animal type's spawn egg, showing its name, type, affection hearts, and health/sickness status. If you haven't befriended any animals yet, shows a hint: feed a wild cow/chicken/sheep/goat its favorite food — see Farming → Befriending.
27-slot, only reachable if the RPGLoot plugin is installed on the server. Reads RPGLoot's data directly (no hard dependency — see Compatibility):
- Equipment — your 5 equipped slots (helmet/chest/legs/boots/held item), each colored by rarity if it's an RPGLoot item (Legendary gold, Hero green, Rare purple, Uncommon yellow)
- Active set — if you have a full 5-piece matching set equipped, shows its tier and a best-effort guess at the set's name
-
Lifetime stats — legendaries found, sets completed, artifacts found (out of 4), read
straight from RPGLoot's
playerstats.yml
Not a separate menu — a single icon on the main menu itself (Experience Bottle) showing your
progression level: current level, XP progress toward the next one, and
a note that it's earned from scaled-mob kills and discovering new zones. Same information
/rpgmood level prints to chat, always visible without an extra click. Doesn't show the animal
cap bonus line the chat command does — check /rpgmood level directly for that once you're past
level 5.
27-slot. Three clickable toggles, each reflecting live state (green/✅ = on, gray/❌ = off) and flipping when clicked — the same three preferences the text commands already control:
| Toggle | Same as | Effect |
|---|---|---|
| Ambient Effects | /rpgmood toggle |
Master switch for zone titles, sounds, and ambient messages |
| Zone Titles | /rpgmood toggle titles |
Just the big on-screen Title/Subtitle on zone entry |
| Action Bar Delivery | (menu-only — see below) | On: ambient messages show above your hotbar. Off: sent to chat instead |
The Action Bar Delivery toggle is the first way to actually reach the per-player
player_actionbar.<uuid> preference — the underlying support has existed in MessageService
since the zone/action-bar audit, but no command ever called it. See
Configuration → messages.
36-slot, only shown on the main menu to players with rpgmood.admin (clicking it without the
permission does nothing). Not a general-purpose config editor — a handful of steppers for the
config.yml values that came up most often, each with a −/+ pane either side of an icon
showing the current value, writing straight to config.yml on disk the moment you click:
| Stepper | Config key | Step | Bounds |
|---|---|---|---|
| Spawn Protection Radius | spawn_protection.radius |
±8 blocks | ≥ 0 |
| Early Game Fraction | mob_scaling.early_game_fraction |
±0.05 | 0.1–1.0 |
| Parity Level | mob_scaling.parity_level |
±1 | ≥ 1 |
| Night Bonus | mob_scaling.night_bonus |
±1 | ≥ 0 |
| Thunder Bonus | mob_scaling.thunder_bonus |
±1 | ≥ 0 |
Plus a click-to-toggle Weather Effects switch (lime/gray dye) for weather_effects.enabled. Every
change re-renders the panel immediately with the new value, and calls the same saveConfig()
path a hand-edit + /rpgmood reload would — no separate "apply" step. See
Mob Scaling and Configuration for what each of these tunables
actually does; this panel is a faster way to nudge them, not a replacement for understanding
them.
Built on the same pattern RPGLoot's SetsMenu/SetsMenuListener already uses: each menu is
an InventoryHolder, and a single shared Listener cancels all clicks/drags on any RPGMood
menu and dispatches them by slot. Nothing here introduces a new permission — every panel
inherits the same access the equivalent command already had (or, for Current Zone, is
deliberately opened up further — see above).