RegionInfo
PluginMIT

RegionInfo

RegionInfo | Region and player names in Action Bar and more

24
Downloads
3
Followers
2 months ago
Updated
📦
1
Versions

📖About RegionInfo

RegionInfo – Smart Region Display for Your Server

RegionInfo

RegionInfo – Always Know Where You Stand

I am in my own region
I am in the region as a member
I am in someone else's region

Lightweight, multilingual, fully customizable region information plugin for Spigot/Paper 1.21+ with WorldGuard support


✨ Features

Feature Description
📍 Smart Action Bar Shows current region, owner, and your role in real time
🎬 Enter & Exit Notifications Title, subtitle, or action bar popup when changing regions
🌍 3 Languages English, Ukrainian, Russian
🎨 Per-Region Customization Custom text and sounds for specific regions
🔔 Sound Alerts Play configurable sounds on enter/exit
🛡️ Spam Protection Smart cooldown prevents notification spam
👤 Player Toggle Players can enable or disable the display
⚡ Instant Reload Reload config without restarting the server
🧩 WorldGuard Integration Works with owners, members, priorities, and overlapping regions
🔧 Lightweight Minimal performance impact

🎮 How it looks in-game

When you are inside a region:

  • 📺 Action Bar:
    ⛏ You are in your own region

  • 📺 Action Bar:
    🪓 You are in region Spawn owned by zamber

When you enter a region:

  • 📢 Title / Subtitle popup
  • 🔊 Sound: ENTITY_EXPERIENCE_ORB_PICKUP

When you leave a region:

  • 🚪 Region text disappears or updates
  • 🔊 Sound: BLOCK_NOTE_BLOCK_BASS

⚠️ All messages, sounds, titles, colors, and display modes are fully customizable in config.yml and messages/*.yml.


📋 Commands

Command Description Aliases
/regioninfo toggle Toggle region display /rinfo toggle
/regioninfo on Enable display
/regioninfo off Disable display
/regioninfo lang <code> Change language EN, UA, RU
/regioninfo reload Reload plugin config
/regioninfo help Show help menu

Language codes: EN (English), UA (Ukrainian), RU (Russian)


🔐 Permissions

Permission Description Default
regioninfo.toggle Allows toggling region display true
regioninfo.lang Allows changing personal language true
regioninfo.admin Access to reload commands 👑 op

⚙️ Configuration (config.yml)

# Enable region display
enabled: true

# Default plugin language
language: en

# Action bar refresh interval (ticks)
update-interval-ticks: 20

# Display mode: actionbar, title, both
display-mode: actionbar

# Notification duration
actionbar-notification:
  enabled: true
  seconds: 4.0

# Render interval for smooth updates
actionbar-render-interval-ticks: 2

# Default enabled state for new players
player-default: true

# Anti-spam cooldown
notification-cooldown-seconds: 1.5

Sound settings

sounds:
  enabled: true

  enter:
    sound: ENTITY_EXPERIENCE_ORB_PICKUP
    volume: 0.9
    pitch: 1.15

  exit:
    sound: BLOCK_NOTE_BLOCK_BASS
    volume: 0.9
    pitch: 0.9

Region-specific customization

region-overrides:
  spawn:
    in-region: "&6★ &eWelcome to Spawn! &6★"

    enter-sound: UI_TOAST_CHALLENGE_COMPLETE
    enter-sound-volume: 0.7
    enter-sound-pitch: 1.0

📝 Message formats (messages/en.yml)

in-region: "&2🪓 &7You are in region &e{region} &7owned by &6{owners}"

own-region: "&2⛏ &7You are in &ayour own region"

member-region: "&2🏠 &aYou are a member of region &e{region} &7owned by &6{owners}"

no-region: ""

toggled-on: "&aRegion display: &2enabled ✔"

toggled-off: "&cRegion display: &4disabled ✖"

reloaded: "&aConfiguration reloaded."

no-permission: "&cYou don't have permission."

Placeholders:
{region} → Region name
{owners} → Region owner list

Color codes: &0-9 &a-f &k-o &r


🚀 Installation

  1. Download RegionInfo.jar
  2. Place it in your server's plugins/ folder
  3. Install WorldGuard
  4. Restart your server
  5. (Optional) Edit config.yml or messages/*.yml
  6. Done! The plugin works immediately

❓ FAQ

  • How do I change the language?
    Use /regioninfo lang EN, /regioninfo lang UA, or /regioninfo lang RU

  • How do I disable sounds?
    Set sounds.enabled: false in config.yml

  • How do I disable the display by default?
    Set player-default: false in config.yml

  • Does it support overlapping WorldGuard regions?
    Yes! RegionInfo automatically respects WorldGuard priorities.

  • Can I customize specific regions?
    Yes — use region-overrides in config.yml.

  • Can players disable it?
    Yes — /regioninfo toggle


📞 Support

  • 🐛 Report a bugJoin our Discord
  • 💬 Suggest a feature – Same link
  • Get help – Same link