Minor Fixes

⚡ OreoEssentials Update — Mail System, Group RTP Portals & Major Fixes
Bug Fixes

• Fixed currency display and editing issues.
  
  
• Fixed a startup crash that could occur on certain server configurations.
  
  
• Fixed language files not loading correctly (the plugin could become stuck in English only).
  
  
• Fixed errors occurring when browsing custom crafting recipes with /oecraft.
  
  
• Fixed cross-server features occasionally failing to reconnect properly after a restart.
  

✨ New Features
Group RTP Portals
Travel together with your friends!

Step into a Group RTP Portal with your party and get teleported together to a random location. Perfect for survival, SMP, and adventure servers.

Supports cross-server networks, allowing groups to teleport seamlessly between servers.

Complete Mail System Overhaul
The mail system has been completely redesigned:

• Send items through the mail.
  
  
• Receive mail from players on other servers.
  
  
• Browse your mailbox through a user-friendly GUI.
  
  
• Administrators can send broadcast mail to all players across the network.
  

Vault Economy Integration
Economy commands now properly hook into your server's Vault economy provider, ensuring better compatibility with economy plugins and custom setups.

⚙️ Improvements

• Improved server startup performance and stability.
  
  
• Optimized command handling for increased reliability.
  
  
• Various backend improvements and code cleanup.
  
  
• Better cross-server synchronization and networking performance.
  

Thank you for using OreoEssentials! ❤️

️ Nametags
Fixed
Nameplates (TextDisplay entities) now properly respect player visibility states.

• Nametags instantly hide when a player starts sneaking.
  
  
• Nametags instantly reappear when the player stops sneaking.
  
  
• Vanished players now correctly refresh for all viewers when their vanish status changes.
  
  
• Fixed cases where nametags could remain visible above sneaking or vanished players.
  

Group RTP
Fixed
Resolved an issue where Group RTP could fail after the countdown completed, resulting in players receiving a "Couldn't find a safe location" message and never being transferred.

Improvements

• Increased the cross-server transfer delay from 3 ticks (0.15s) to 20 ticks (1 second) to prevent packet synchronization issues.
  
  
• Safe-location failures on the destination server now provide clear feedback to the player.
  
  
• Packet transmission errors are now properly caught and reported instead of silently failing.
  

Paper Dialog API Support (NEW)
Requires Paper 1.21.5+

OreoEssentials now supports the brand-new Paper Dialog API.

When enabled, supported commands will use native Minecraft dialog windows instead of inventory GUIs.

Bedrock Support Included
Players connecting through GeyserMC + Floodgate automatically receive native Bedrock forms via Cumulus without any additional configuration.

Enable in settings.yml
dialog:
enabled: true

Feature Toggles
dialog:
enabled: true
features:
homes: true
warps: true
tpa: true
player-warps: true
kits: true
near: true
channels: true
confirm-delhome: true
confirm-delwarp: true
confirm-mailclear: true
confirm-pwremove: true

New Dialog Interfaces
Homes

• /home
• /homesgui

View all homes and teleport with a single click.
Warps

• /warps

Browse available server warps and teleport instantly.

Player Warps

• /pw gui

View add teleport to player-created warps.

Kits

• /kits

Displays available kits alongside cooldown information.

Nearby Players

• /near [radius]

View nearby players and teleport directly to them.

Channels

/oechannels

Switch chat channels through a native dialog interface.
Confirmation Dialogs
Added confirmation windows for destructive actions:

• /delhome <name>
• /delwarp <name>
• /mail clear
• /pw remove <warp>
  

Players must explicitly confirm before the action executes.

TPA Dialogs
Incoming teleport requests now display a native dialog containing:

• ✅ Accept
• ❌ Deny

The request can no longer be missed in chat and requires a direct response.

Fallback Support
If the Dialog API is unavailable, unsupported, or disabled, OreoEssentials automatically falls back to the existing inventory GUI or chat-based behavior.

Other Fixes
Fixed

• Removed a duplicate reloadPlayerWarpsConfig() method definition that caused compilation errors.
  

Thank you for supporting OreoEssentials ❤️

As always, if you encounter any issues or have feature suggestions, feel free to join our Discord and let us know!

Fixed a premade config setting where balance and money command where added as aliases

Implemented Command API Lib by @ Traqueur_
Traqueur-dev/CommandsAPI: CommandsAPI is a framework designed to enhance and simplify command management on Spigot servers and JDA bot. It provides an intuitive API, advanced permission handling, improved autocompletion, contextual commands, robust argument validation, and a modular design.

- Fix: Cross-server RTP now works correctly — the RTP bridge was never being registered because packetManager is initialized asynchronously; bridge init moved to the correct async callback
- Fix: Nametag "show to self" now defaults to false

- Config Fixes
- Lang Fixes

Bug Fixes
[FOLIA] UnsupportedOperationException on startup — YamlPlayerWarpStorage
Replaced a Bukkit.getScheduler().runTask() call inside the constructor with OreScheduler.run(). Folia throws UnsupportedOperationException on any CraftScheduler call, causing the plugin to crash immediately on boot.
---
[FOLIA] IllegalStateException: Asynchronous Recipe Add! — Custom Crafting
When saving a recipe via /oecraft browse, the recipe was being registered to Bukkit's recipe manager from inside an async thread (Async.run()). Bukkit.addRecipe() requires the main thread on both Folia and Paper.
Added saveAndRegisterAsync() method: file I/O stays on the async thread, then switches to the main thread via OreScheduler.run() before calling registerBukkitRecipe().
---
[FOLIA / PAPER] RabbitMQ connection blocking the server thread
Phase 1: Added factory.setConnectionTimeout(5000) and factory.setHandshakeTimeout(5000) to the ConnectionFactory. Without these, a failed connection would block the server thread for the full OS-level TCP timeout (20–30+ seconds).
Phase 2: Fully refactored initRabbitMQ() to be non-blocking. The server now instantly starts in local mode, fires an async thread to connect to RabbitMQ, and if successful, upgrades to cross-server mode on the main thread. Server startup is no longer affected by RabbitMQ availability at all.
---
[BUG] Brokers initializing before RabbitMQ connected
After the async RabbitMQ refactor, initBrokers() was running synchronously before the async connection completed, causing all brokers (MOD-BRIDGE, TRADE, HomeTeleportBroker, TPA, BackBroker, etc.) to report "PacketManager unavailable" even when RabbitMQ would later connect successfully.
initBrokers() was removed from onEnable() and is now called from inside the RabbitMQ async callback — once on successful connect (with full PacketManager), and once on failure (sets all brokers to null with proper disabled messages).
---
[BUG] Language setting not applied — server.language not read
config.yml stores the language under server.language (nested under the server: block), but Lang.init() and Lang.reload() were reading from the root key language, causing the language to always default to English regardless of config.
Fixed to read server.language first, falling back to the root language key for backwards compatibility.

Added Loadbefore comapatibility with Perfranknpcs and ajLeaderboards

Mail Item Sending
Players can now send items directly through the mail system.

Command
/mail senditem <player> [optional message]

Examples
/mail senditem Steve
/mail senditem Steve Here's the diamond sword I promised

The item currently held in the player's main hand gets attached to the mail.
The recipient can:

• Open /mail
• Click the mail item in the GUI
• Instantly claim the item

If their inventory is full, the item drops at their feet automatically.

Rules

• You cannot send mail to yourself
• Message is optional
• Max message length: 256 characters
• Permission:

oreo.mail.senditem

New Group RTP System
Added a full /grouprtp system for creating group teleport zones.

Commands
/grouprtp wand
/grouprtp pos1
/grouprtp pos2
/grouprtp create <id> [world]
/grouprtp delete <id>
/grouprtp list
/grouprtp info <id>
/grouprtp sessions
/grouprtp clearcooldown <player>
/grouprtp reload

This allows servers to create DonutSMP-style group RTP areas where multiple players enter a portal/zone and get teleported together to the SAME random location.

Perfect for:
✔ Survival servers
✔ SMPs
✔ Events
✔ Team adventures
✔ Dungeon entrances
✔ Portal-based gameplay

The OreoStudios web panel has been completely redesigned and rewritten.
New layout, better performance, and a ton of new features.
──────────────────────────────────────
⚙️ CONFIG EDITOR (NEW FEATURE)
──────────────────────────────────────
You can now manage all your OreoEssentials config files
directly from the web panel — no more SSH, no more FTP.
Supported files:
• config.yml
• chat-format.yml
• tab.yml
• clearlag.yml
• settings.yml
• scoreboard.yml
• afk.yml
• maintenance.yml
• rtp.yml
• craft-actions.yml
• join-quit-messages.yml
• playervaults.yml
• playerwarps.yml
• dailyrewards.yml
Features:
[+] Visual form editor — edit settings through a clean UI
[+] Raw YAML editor — full text editing with live validation
[+] Push to Plugin — send config changes live via RabbitMQ
(no server restart required)
[+] Fetch from Plugin — pull current config files from
your running server directly into the panel
[+] Auto-save to database — configs are stored server-side
──────────────────────────────────────
️BUG FIXES
──────────────────────────────────────
[*] Fixed internal server error when saving config files
[*] Fixed RabbitMQ connection status showing incorrect state
[*] Fixed panel crash on load (null element errors)
[*] Fixed push failing silently when plugin was online
[*] Fixed YAML parse error when config root was not a map
[*] Stability improvements to the AMQP listener
──────────────────────────────────────
➕ OTHER CHANGES
──────────────────────────────────────
[+] Servers can now be deleted from the dashboard
[+] Improved error messages across the panel
[+] Better RabbitMQ reconnection handling

Custom Nameplates :
Nameplate TextDisplay entities now stay hidden from the owning player when jumping in first-person view. The bug was caused by `entity.teleport()` resending the entity spawn packet to the client, which silently reset the `hideEntity` state. Visibility is now re-enforced for all non-viewers after every position update.
MOTD
Fixes an issue where MOTD was not parsing minimessage correctly

Fixed a Missing Lang Keys
Fixed a bug related to the webpanel
Updated NEW Docs section

✨ New Commands
/day → Set server time to day
/night → Set server time to night

/oeworld → Full world management system
• Gamerules
• Borders
• Weather
• Async pre-generation
• Void world creation

/bottom → Teleport to the lowest solid block below you
/top → Teleport to the highest block above you

/price → Check buy/sell value of held item
/recipe → View crafting recipe of held item

/help → Fully configurable help menu
/motd → Display server MOTD
/rules → Display server rules

/mail send|read|clear → Persistent player mail system

/ignore → Ignore player messages
/unignore → Remove ignored player

/warn → Warn a player
/unwarn → Remove warnings
/warnings → View warnings

/history → View punishment history

/setfirstspawn → Configure first join spawn

New Systems & Modules
⚠️ Warnings System
A complete warning & moderation framework.

Features:

• Persistent warning history
• Configurable punishment thresholds
• Auto punishments
• /warn, /warnings, /unwarn
• Configurable in:
  server/warnings.yml

✉️ Mail System
Players can now send persistent offline mail to each other.

Features:

• Read mail anytime
• Clear mailbox
• Persistent storage
• Lightweight & optimized

Commands:


/mail send
/mail read
/mail clear

Ignore System
Block chat/messages from specific players.

Commands:


/ignore
/unignore

Help System
Fully configurable paginated help menu.

Config:


server/help.yml

Supports:

• Multiple pages
• Permission-based entries
• MiniMessage formatting
• Custom categories

MOTD System
Dynamic configurable MOTD command.

Config:


server/motd.yml

Rules System
Server rules management via configuration.

Config:


server/rules.yml

Punishment Logger
Track punishment history across your server.

Tracks:

• Bans
• Kicks
• Mutes
• Warnings

View via:


/history <player>

️ Join Flood Guard
New protection layer preventing massive join spam from impacting server stability.

Helps protect:

• Login spikes
• Bot floods
• Sudden player surges

Container Spam Guard
Prevents players from rapidly opening containers and causing unnecessary load.

Benefits:

• Reduces packet spam
• Protects TPS
• Improves large-server stability

World Pre-Generator
Generate chunks asynchronously in the background.

Command:


/oeworld pregen

Features:

• Async chunk generation
• No TPS freeze
• Progress tracking
• Paper/Folia optimized

️ Void Chunk Generator
Create fully empty void worlds directly from OreoEssentials.

Integrated into:


/oeworld

Major Improvements & Rewrites
✨ Holograms

• Fixed Paper 1.26.x support
• Version adapter fallback system added
• Improved AddLine / SetLine / Copy commands
• FlatFile storage rewrite for better stability
• Fixed command routing after unregisterCommandHard

Scoreboard
Complete internal rewrite.

Improvements:

• Better Folia compatibility
• Reduced recreation spam
• Cleaner packet handling
• Better async safety

Tab List
Massive rewrite of CustomTablistLayout.

Features:

• More robust packet handling
• Improved custom layouts
• Better compatibility
• Cleaner rendering pipeline

Near (/near)

• Added GUI provider support
• New NearGuiProvider

Homes

• Major command rewrite
• Cleaner cross-server synchronization
• Improved service architecture

Economy / Cheques

• Full cheque system rewrite
• Improved JSON/YAML backends
• Better transaction reliability

Shop

• Fixed multiple buy/sell edge cases
• TransactionProcessor improvements
• ShopItem model fixes

Trade

• Fixed inventory close detection
• Cleaner TradeSession handling

Portals

• Cross-server broker improvements
• Listener fixes
• Better transfer reliability

Player Warps

• Browse menu improvements
• YAML storage fixes

TempFly

• Service-level fixes
• Better timer handling

️ Nametags

• Added NametagCondition support
• Conditional nametag visibility
• PlayerNametagManager improvements

Spawn

• Improved first join spawn listener
• SpawnService refactor
• Better startup reliability

Jump Pads

• Manager fixes
• Stability improvements

Shards

• ShardManager fixes

⏱️ Playtime Rewards

• Internal service improvements

RabbitMQ

• RabbitMQSender improvements
• Better broker stability
• Cleaner async handling

⚙️ Config & Resource Updates
Added New Config Files

server/help.yml
server/motd.yml
server/rules.yml
server/warnings.yml

Expanded Existing Configs

settings.yml
tab.yml
custom-nameplates/config.yml

plugin.yml

• 117 new lines added
• New permissions
• New command registrations

Performance & Stability
This update focuses heavily on:

• Folia compatibility
• Async safety
• Cross-server infrastructure
• Packet optimization
• Reduced memory overhead
• Large-network stability

OreoEssentials continues pushing toward being the most complete and optimized all-in-one Essentials core for modern Minecraft servers.

New Commands
- /price — item price lookup
- /recipe — view crafting recipes
- /top — likely top players (balance/stats)
- /oeworld (OeWorldCommand) — admin world management (625 lines, major feature)
- /help — custom help system with HelpConfig
- /ignore — player ignore system with IgnoreService
- /mail — in-game mail system (MailCommand, MailService, MailListener)
- /rules — display server rules
- /history — punishment history viewer
- /warn / /unwarn / /warnings — full warnings system with WarnService
- /setfirstspawn — set the first-join spawn point
New Systems / Services
- MOTD — MotdConfig + MotdService
- Join Flood Guard — JoinFloodGuardService (rate-limits joins)
- Container Spam Guard — ContainerSpamGuardListener (anti-spam for container opens)
- Punishment Logger — PunishmentLogger for audit logging
- Void Chunk Generator — VoidChunkGenerator for void worlds
Improvements
- /cheque — heavily reworked (ChequeCommand, tab completer)
- /near — GUI provider added (NearGuiProvider)
- /homes — significant rework
- Scoreboard — service refactor
- Tab list — CustomTablistLayout expanded
- Nametag manager — expanded
- World gamerules menu — reworked GUI
- /msg — minor additions

New: /oeworld — World Management
Full in-game world creation, import, and pre-generation without restarting the server.
/oeworld create <name> <normal|nether|end|void> <border> <true|false>
/oeworld import <worldname> [normal|nether|end|void] [border]
/oeworld cancel <worldname>
- Create normal, nether, end, and void worlds on the fly
- Void worlds include a single bedrock platform at the center — players teleport directly onto it
- Import existing worlds from disk — detects environment automatically from level.dat, registers for auto-load on restart
- World border applied on creation/import
- Lag-free async pre-generation — uses Paper's async chunk API, all chunk generation runs off the main thread with zero TPS impact. Progress reported every 5% in chat
- Cancel any active pre-generation at any time with /oeworld cancel
- Worlds persist across restarts — saved to plugins/OreoEssentials/worlds.yml and auto-loaded on startup
- Full tab completion with inline hints (<worldname>, <border_in_blocks>, etc.)
- Permission: oreo.oeworld (default: op)
---
New: /setfirstspawn
Sets a separate spawn location used exclusively for players joining the server for the very first time. Falls back to the regular spawn if not set.
- Permission: oreo.setfirstspawn (default: op)
---
Fix: PAPI placeholders not resolving in LuckPerms prefix/suffix
PlaceholderAPI placeholders (e.g. %nexo_...%) set directly inside a LuckPerms prefix or suffix were shown as literal text in chat instead of being replaced. Fixed in both the standard chat listener and the chat channels handler.
---
Fix: Server crash on startup when importing worlds without a border
Importing a world without specifying a border saved Minecraft's default world border size (60,000,000) which is above Bukkit's hard cap of 59,999,968, causing IllegalArgumentException on the next startup. The value is now treated as "no border" and saved as 0.
---
Compatibility: Paper / Folia / Purpur 1.21+


FIXES:
1 : reloadHolograms() race condition
Previously unloadHolograms() submitted an async task and returned immediately, then loadHolograms() was called right away. The async unload could fire after the load, deleting newly-loaded holograms. Now reloadHolograms() submits unloadHologramsSync() and blocks with .get() until it completes before
loading.
2:unloadHolograms() / unloadHolograms(world) key mismatch (three call sites)
The holograms map uses name.toLowerCase() as its key, but all holograms.remove() calls in the unload methods were using hologram.getName() (no lowercase). Holograms with uppercase letters in their names were silently left in the map. All three removed.


3: saveConfig() swallows SnakeYAML exceptions
Only IOException was caught. SnakeYAML's YAMLException (which can be thrown for unusual Unicode codepoints like ItemsAdder glyphs) is unchecked, so it was silently swallowed by the executor — the file was never written and the hologram reappeared on restart. Now a second catch (Exception e) block logs
the error visibly.

Fix 4 : Shutdown ordering (OHolograms.java nDisable)
The hologram thread and file executor were shut down simultaneously. Pending hologram-thread tasks (like delete saves) that submit work to the file executor would get RejectedExecutionException if the file executor shut down first. Now the hologram thread is fully awaited before the file executor is shut
down.

Performance
- Optimized the custom tab layout system.
- Fixed a major tab performance issue where player list names were being rebuilt repeatedly in the same update cycle.
- Tab header/footer and player names now use smarter caching and only update when needed.
- Optimized scoreboard refresh performance.
- Scoreboard rendering now shares cached animated/static line output across the refresh cycle instead of rebuilding the same content for every player.
- Reduced unnecessary scheduler load from repeated UI rendering tasks.
- Moved player-directory presence writes off the main thread.
- Batched web panel sync to reduce spike lag.
- Reduced unnecessary bossbar, actionbar, and nametag update work.
- Redesigned nametag visibility updates to avoid constant full scans.

Fixed some console spam on folia

• Patch Notes
- Fixed /vanish behavior.
- /vanish now supports on, off, and toggle.
- Vanish now persists through logout.
- Vanish now syncs cross-server when cross-server support is enabled.
- Mobs now stop targeting vanished players.
- Vanish join/quit visibility was fixed so players do not reappear incorrectly.
- The misleading /vanish alias/config collision was cleaned up.
- Fixed spawn and respawn handling.
- First-join spawn now works properly.
- Death respawn routing was fixed.
- Spawn now uses clear local/global behavior instead of mixing server identifiers.
- /setspawn and respawn flows now behave consistently across shards.
- Fixed cross-server teleport flows.
- Cross-server /tp routing was stabilized.
- Cross-server /tpa routing was stabilized.
- Cross-server /home routing was stabilized.
- Cross-server retry paths no longer re-teleport players multiple times from the same request.
- Cross-server request state now clears correctly after success.
- Pending arrival handling for TPA was hardened so accepts do not overwrite each other.
- Fixed cross-server trade flows.
- Cross-server trade state now handles packet ordering correctly.
- Trade replay now actually replays the missing start packet.
- Trade cancel reasons now stay intact.
- Trade grant and close delivery paths were hardened.
- Fixed cross-server inventory and invsee flows.
- Remote inventory apply now writes offhand to the correct slot.
- Cross-server inventory sync now preserves XP/level data.
- Cross-server inventory state handling is now more reliable.
- Fixed chat sync and messaging routing.
- Cross-server chat payload parsing was corrected.
- /msg and /reply now use live current server presence instead of stale last-known server data.
- /tp and /move now avoid stale routing to players who are no longer on that server.
- Fixed and expanded MiniMessage compatibility.
- Broken typo tags like <dar_puruple> and <mwhilte> now render correctly.
- The same typo-tolerant handling was extended across scoreboard, tab, holograms, bossbars, actionbar, chat bubbles, lang rendering, and other shared MiniMessage surfaces.
- Valid formatting behavior was preserved.
- Fixed /bubblecolor validation.
- Invalid MiniMessage color/style input can no longer be silently saved.
- Improved performance for larger shards.
- Player-directory presence writes are now off the main thread.
- Scoreboard rendering now uses cached render state instead of full rebuilds every refresh.
- Tab PlaceholderAPI reflection is cached instead of being resolved every update.
- Bossbar updates now skip unnecessary property resets.
- Web-panel periodic sync is batched to reduce spikes.
- Nametag position updates now skip unnecessary work when players have not meaningfully moved.
- Nametag visibility no longer does full owner/viewer sweeps every cycle.
- Added shard-aware UI safeguards.
- You can now disable heavy UI systems on specific high-population shards.
- Supported guarded modules include scoreboard, tab, bossbar, nametag, chat-bubbles, actionbar, and multi-bossbar.
- This lets the biggest shards run lighter while smaller shards keep the full UI stack.
- Cleaned up runtime logging.
- Several hot-path debug logs were reduced or gated.
- This makes production console output quieter and easier to scan.

Now /vanish and /v will suggest on, off, toggle as you type, filtered by what you've already typed (e.g. typing o shows both on and off).