xRGMessage - Region-Based Messaging Plugin
Overview
xRGMessage is a Bukkit/Spigot plugin that enhances player experience by dynamically displaying titles, subtitles, and playing sounds when entering or exiting WorldGuard regions.
Features
✔ Custom titles, subtitles, and sounds on region enter/exit.
✔ Execute custom commands when players enter/exit a region.
✔ Supports Hex colors, Minecraft color codes, and Unicode text.
✔ Animated text effects (Flash effect, instant display, configurable duration).
✔ Compatible with Minecraft 1.20.1 - 1.21.4
✔ Debug mode with particles and logging for easy configuration.
Installation
- Ensure you have WorldGuard installed.
- Download the latest xRGMessage plugin JAR.
- Place the JAR file in your server's /plugins folder.
- Restart your server.
- Configure the plugin in plugins/xRGMessage/config.yml.
Spoiler: Config.yml
Configuration
settings:
debug-mode: false # Enable detailed debugging
debug-particle-effect: true # Show particles at region boundaries in debug mode
log-level: "normal" # Options: normal, verbose, minimal
animations:
enabled: true # Enable animations
type: "FLASH" # Options: FLASH, NONE
duration: 10 # Animation duration (ticks)
enter-color: "#00FF00" # Color when entering
exit-color: "#FF0000" # Color when exiting
Example Region Configurations
Region 1 - Welcome Message & Warp Command
format-1:
region-enter:
region-name: "your-regionname"
command: "/warp pinata %player%"
title: "Welcome!"
subtitle: "Enjoy your stay."
playsound: "minecraft:entity.ender_pearl.throw"
Region 2 - PvP Status Notification
format-2:
region-enter:
region-name: "spawn"
title: "#00FF00&lᴘᴠᴘ ᴅɪѕᴀʙʟᴇ"
subtitle: "#FFFFFFʏᴏᴜ ᴀʀᴇ ѕᴀꜰᴇ ɴᴏᴡ"
playsound: "minecraft:entity.player.levelup"
animation:
type: "FLASH"
duration: 10
start-color: "#FF0000"
Color Codes
title: "#00FF00Welcome to &lSpawn"
subtitle: "&eEnjoy your stay!"
Placeholders
settings:
debug-mode: false # Enable detailed debugging
debug-particle-effect: true # Show particles at region boundaries in debug mode
log-level: "normal" # Options: normal, verbose, minimal
animations:
enabled: true # Enable animations
type: "FLASH" # Options: FLASH, NONE
duration: 10 # Animation duration (ticks)
enter-color: "#00FF00" # Color when entering
exit-color: "#FF0000" # Color when exiting
Example Region Configurations
Region 1 - Welcome Message & Warp Command
format-1:
region-enter:
region-name: "your-regionname"
command: "/warp pinata %player%"
title: "Welcome!"
subtitle: "Enjoy your stay."
playsound: "minecraft:entity.ender_pearl.throw"
Region 2 - PvP Status Notification
format-2:
region-enter:
region-name: "spawn"
title: "#00FF00&lᴘᴠᴘ ᴅɪѕᴀʙʟᴇ"
subtitle: "#FFFFFFʏᴏᴜ ᴀʀᴇ ѕᴀꜰᴇ ɴᴏᴡ"
playsound: "minecraft:entity.player.levelup"
animation:
type: "FLASH"
duration: 10
start-color: "#FF0000"
Color Codes
- Minecraft Color Codes: &0-&f, &l, &m, &n, &o, &r
- Hex Colors (Minecraft 1.16+): #RRGGBB
title: "#00FF00Welcome to &lSpawn"
subtitle: "&eEnjoy your stay!"
Placeholders
- %player% → Player's name
- %displayname% → Player's display name
- %world% → World name
Commands
Command Description
/xrgmessage reload Reloads the plugin configuration
/xrgmessage help Displays help information
/xrgmessage version Shows plugin version
/xrgmessage debug [on off]
/xrgmessage loglevel [normal verbose]
Permissions
Permission Description
xrgmessage.use Basic command access (default: true)
xrgmessage.reload Permission to reload the plugin (default: op)
xrgmessage.debug Permission to use debug commands (default: op)
xrgmessage.admin Full admin access (default: op)
Debug Mode
- Enable debugging with /xrgmessage debug on
- Set logging level: /xrgmessage loglevel normal | verbose | minimal
- When enabled:
- Particles show at region boundaries (green for enter, gray for exit).
- Admins receive chat messages when crossing regions.
- Detailed logs appear in the console.
Need help? Contact the author on Discord: godxpro.exe
Credits
Plugin Development: GodXPro
Testing & Feedback: GodXPro Community
Special Thanks: WorldGuard team for their amazing region protection plugin.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.16, 1.17, 1.18
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
xRGMessage – Set Custom Messages On Enter/Exit Regions is a free Minecraft Java mod. Compatible with Minecraft 1.16, 1.17, 1.18, 1.19 and newer. Downloaded 430 times (via Spigot). Download it and open it directly in the game.