Home

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.19.0

---

Pages

Page	Description
Zones	Organic zone clusters, subzones, and dynamic zone naming
Mob Scaling	How mob difficulty levels are calculated, combat AI, and the boss hard curve
Death Messages	The combinatorial death message system
Ambient Events	Time, weather, and block-break triggers
Achievements	35 achievements across exploration, combat, survival, farming, villages, and RPGLoot integration
Farming	Harvest Moon-style crops, seasons, cooking, and animal husbandry
Villages	Seasonal villager trades, the Deep Dark wandering trader, village reputation, and cartographer quests
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 / subzones.yml / triggers.yml / farming.yml reference
Compatibility	PlaceholderAPI and Squaremap 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, knockback resistance, attack 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
• Smarter combat AI — level-gated line-of-sight/omniscient aggro, level-aware bow aim (clumsy → laser → predictive), pack assist, kiting archers, relentless creepers, and seasonal combat modifiers — see Mob Scaling → Advanced AI
• Boss hard curve & elites — Warden/Wither/Elder Guardian/Ender Dragon scale on a separate curve that also boosts their special attacks; level 35+ mobs and bosses get combat-gated colored glow, offhand shield/totem/torch loadouts, and deep-biome environment effects — see Mob Scaling → Boss hard curve
• Radial spawn protection — hostile mobs never naturally spawn within a configurable radius of world spawn
• Zones — every chunk you explore belongs to an organically-grown, permanently-named zone cluster (flood-filled by shared biome, persisted, colored by local danger to match RPGLoot's rarity palette); cave biomes and vanilla structures layer their own subzone Title on top; an optional Squaremap integration draws every cluster on the web map — see Zones
• Sidebar scoreboard (/rpgmood toggle scoreboard) — an optional sidebar showing current zone, local danger, and session kills — see Zones → Sidebar scoreboard
• Zone discovery (/rpgmood zones [fav <name>]) — tracks every zone you've ever entered, with first-seen dates, favorites, distance, and danger — see Zones → Zone discovery
• Villages — seasonal Farmer/Cleric trades, a Deep Dark wandering trader, per-village reputation (%rpgmood_village_rep%), and light cartographer crop/emerald quests — see Villages
• 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 — low-probability flavor sounds by time of day — 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, and night/thunder bonuses, 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) — 35 achievements for exploration, combat, survival, farming, villages, 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%, %rpgmood_village_rep%) and Squaremap (zone clusters drawn on the web map); 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