Skip to content

Home

Jump to bottom
okereke-dev edited this page Jul 13, 2026 · 9 revisions

RPGMood Wiki

Welcome to the RPGMood documentation. RPGMood is a Paper/Spigot plugin that adds atmosphere and a sense of danger to Minecraft — mobs scale with distance and biome, zones react to where you are, deaths get narrative flavor text, and the world reacts to time and weather.

Supported versions: Paper/Spigot 1.20.4+ · Java 21+ · Latest release: v1.8.0

Pages

Page Description
Zones Biome and WorldGuard region zones, dynamic zone naming
Mob Scaling How mob difficulty levels are calculated
Death Messages The combinatorial death message system
Ambient Events Time, weather, and block-break triggers
Achievements 31 achievements across exploration, combat, survival, farming, and RPGLoot integration
Farming Harvest Moon-style crops, seasons, cooking, and animal husbandry
Menu The /rpgmood GUI — a visual hub for zone info, achievements, leaderboard, farming, animals, RPGLoot, progression level, settings, and (admins) an in-game config editor
Commands All commands with full usage and permissions
Configuration Full config.yml / zones.yml / triggers.yml / farming.yml reference
Compatibility PlaceholderAPI and WorldGuard integration
Developer API Bukkit events for other plugins to hook into RPGMood

Quick overview

  • GUI menu (/rpgmood or /rpgmood menu) — an inventory-based hub for everything below: journal, achievements, current zone, leaderboard, farming, animals, RPGLoot (if installed), progression level, settings, and (admins) an Admin Config panel. See Menu
  • Custom join/quit messages — replace the vanilla chat broadcast with an action-bar message and sound, with a distinct first-time-ever template
  • Mob scaling — hostile mobs gain levels based on distance from spawn, biome, nearby structures, how many players are nearby, and whether it's night or thunderstorming right now; a mob's level scales its health, damage, armor, speed, and aggro (follow) range, grants bonus XP on kill, shows level-tiered particle auras, and can roll RPG affixes (Swift, Wraith, Bleeding, and more) — see Mob Scaling
  • Radial spawn protection — hostile mobs never naturally spawn within a configurable radius of world spawn
  • Zones — entering a named biome zone, a WorldGuard region, or an unclaimed area shows a title/subtitle (colored by local danger, matching RPGLoot's rarity palette), plays a sound, particles, and optional per-zone music, and a moment later drops a short flavor line — see Zones
  • Sidebar scoreboard & zone BossBar (/rpgmood toggle scoreboard) — an optional sidebar showing current zone, local danger, and session kills, plus a temporary danger-colored BossBar on every zone change — see Zones → Sidebar scoreboard & zone BossBar
  • Zone discovery (/rpgmood zones [fav <name>]) — tracks every zone you've ever entered, with first-seen dates, favorites, and (for dynamic zones) distance/danger — see Zones → Zone discovery
  • Player progression level (/rpgmood level) — a separate XP/level track from mob difficulty, earned from scaled-mob kills and zone discoveries; every 5 levels raises your animal ownership cap — see Commands → /rpgmood level
  • Day/night ambient sounds and mechanical weather effects — low-probability flavor sounds by time of day, plus brief Darkness pulses during thunderstorms and small wind nudges during rain in the open — see Ambient Events
  • Nether acid rain — a periodic damage hazard for players in the Nether, since there's no vanilla weather to hook into there — see Ambient Events → Nether acid rain
  • In-game Admin Config panel (rpgmood.admin) — steppers for spawn protection radius, the mob-scaling curve, night/thunder bonuses, and a weather-effects toggle, writing straight to config.yml — see Menu → Admin Config
  • Config files auto-merge new keys on startup/reload — updating the plugin never loses your customizations
  • Adventure journal (/diary) — a written book of your character's recent zone arrivals and deaths, persisted per player
  • Achievements (/rpgmood achievements) — 31 achievements for exploration, combat, survival, farming, and (if RPGLoot is installed) loot, persisted across restarts
  • Farming (/rpgmood-farm) — seasonal crops with Bronze/Silver/Gold quality, discoverable cooking recipes with temporary Mood buffs, and animal husbandry
  • Narrative death messages — biome-, cause-, killer-, and PvP-aware flavor text, composed from independent building blocks so the same exact line rarely repeats
  • Ambient time/weather events — scheduled messages and sounds on time-of-day and weather transitions, delivered via the action bar by default
  • Leaderboard (/rpgmood leaderboard) — top 10 players by deaths, zone changes, or highest mob level killed
  • High-level mob announcements — a server-wide message when a dangerously scaled mob spawns
  • Public API — Bukkit events (PlayerZoneChangeEvent, MobScaleEvent, PlayerDeathMessageEvent, PlayerCropHarvestEvent) for other plugins to hook into, see Developer API
  • Soft-integrates with PlaceholderAPI (%rpgmood_zone%, %rpgmood_area_danger%) and WorldGuard (region-type zones); exposes each scaled mob's level via PersistentDataContainer for other plugins (e.g. loot plugins) to hook into
  • Admin command /rpgmood info shows the current zone and mob difficulty at your location — useful for tuning config.yml

Clone this wiki locally