Skip to content

Home

Jump to bottom
okereke-dev edited this page Jul 12, 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 15 achievements across exploration, combat, farming, and survival
Farming Harvest Moon-style crops, seasons, cooking, and animal husbandry
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

  • 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, and show level-tiered particle auras
  • Zones — entering a named biome zone, a WorldGuard region, or an unclaimed area shows a title/subtitle, plays a sound and particles, and a moment later drops a short flavor line
  • Adventure journal (/diary) — a written book of your character's recent zone arrivals and deaths, persisted per player
  • Achievements (/rpgmood achievements) — 15 achievements for exploration, combat, farming, and survival, 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