Skip to content

Home

Jump to bottom
okereke-dev edited this page Jul 4, 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
Commands All commands with full usage and permissions
Configuration Full config.yml / zones.yml / triggers.yml reference
Compatibility PlaceholderAPI and WorldGuard integration

Quick overview

  • Mob scaling — hostile mobs gain levels based on distance from spawn, biome, nearby structures, and how many players are nearby, and grant bonus XP on kill proportional to their level
  • 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 in chat
  • Adventure journal (/diary) — a written book of your character's recent zone arrivals and deaths, persisted per player
  • 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
  • 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
  • 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