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+

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, and settings
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), and settings. 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, and how many players are nearby, grant bonus XP on kill proportional to their level, show 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 and particles, and a moment later drops a short flavor line
  • 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