⚡ 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 and 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 vault and money command were 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 compatiblity withPerfRankNpcs 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
Improved Docs section of the plugin

✨ 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.

Bug Fixes:
- Fixed holograms with ItemsAdder glyphs not being deletable
(SnakeYAML serialization errors were silently swallowed, leaving the hologram in holograms.yml even after /hologram remove)
- Fixed holograms reappearing after /oholograms reload due to a race
condition where the async unload ran AFTER the new load completed
- Fixed holograms with uppercase names not being removed from memory
during unload (map key mismatch stored as lowercase, removed as-is)
- Fixed pending hologram deletes being silently dropped on server stop
(file storage executor was shut down before the hologram thread finished)

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

OreoEssentials — Update 4.7a

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+

New: /oeworld : In-game World Creation & Management
You can now create and manage worlds directly from in-game or console without restarting the server.
Command syntax:
/oeworld create <name> <normal|nether|end|void> <border> <true|false>
/oeworld cancel <worldname>
Features:
- Create normal, nether, end, and void worlds on the fly
- Automatic world border applied on creation
- Void worlds spawn with a single bedrock platform at the center — players teleport directly onto it
- Lag-free pre-generation — uses Paper's async chunk API, all generation happens off the main thread with zero TPS impact. Progress is reported every 5% in chat
- Cancel an active pre-generation at any time with /oeworld cancel <worldname>
- Worlds persist across restarts — created worlds are saved to plugins/OreoEssentials/worlds.yml and automatically loaded on startup
- Full tab completion for all arguments
- Permission: oreo.oeworld (default: op)
Compatibility: Paper / Folia 1.21+

Fixed 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.

Patch Notes
- Fixed /vanish so the real OreoEssentials command now supports /vanish on, /vanish off, and /vanish toggle.
- Fixed vanish mob behavior: mobs now stop targeting vanished players.
- Fixed misleading command metadata so /vanish usage matches the actual implementation.
- Renamed the confusing sample vanish alias so it no longer clashes conceptually with the real vanish command.
- Fixed vanish persistence: vanish no longer clears on logout.
- Added persistent vanish state storage.
- Added local YAML fallback storage for vanish state.
- Added Mongo-backed vanish storage for shared network state when cross-server storage is available.
- Added cross-server vanish sync when cross-server support is enabled.
- Added features.cross-server.vanish: true to settings.yml.
- Players now restore their saved vanish state automatically on join.
- Added configurable first-join spawn handling.
- New players can now be teleported to server/global spawn on their very first connection.
- First-join spawn uses the configured spawn service and falls back cleanly if no spawn is set.
- Added configurable death respawn override handling.
- Respawn mode can now be set to:
- NORMAL
- GLOBAL_SPAWN
- WORLD_SPAWN
- CUSTOM
- Added respect-bed-anchor support so valid bed / respawn-anchor spawns can still be preserved.
- Added support for custom respawn coordinates and per-world respawn overrides in settings.yml.
- Fixed MiniMessage typo handling in the scoreboard so broken tags like <dar_puruple> and <Mwhilte> work.
- Extended the same typo-tolerant handling across other MiniMessage-rendered surfaces.
- Added shared compatibility utility for typo normalization.
Affected Areas
- Vanish
- Cross-server sync
- First join spawn
- Death respawn routing
- Scoreboard
- Tab list
- Holograms
- Bossbar
- Shared MiniMessage / lang rendering
Compatibility
- Existing valid MiniMessage tags still behave the same.
- Existing & color codes still behave the same.
- Typo handling is additive: only a small known set of broken tags is normalized.
- The only visible behavior change there is if someone intentionally wanted typo tags to appear literally as raw text.

AFK — Reworked & Expanded
- AFK config moved to its own dedicated file: plugins/OreoEssentials/afk/config.yml — no longer buried in the main config. Auto-merges new defaults on update so you never miss new options
- Action bar now shows how long you've been AFK, updating every second (toggleable)
- "Back" message now tells you how long you were AFK when you return (e.g. You were AFK for 5m 32s) — also fixed a bug where the duration placeholder wasn't being
parsed
- Permission tiers: configure different AFK timeout durations per permission group
- Custom messages per permission group — different now-afk, no-longer-afk, and back messages for different ranks
- Cross-server AFK tracking via RabbitMQ — AFK status now broadcasts across all servers in real time
- Global AFK map tracks player location, world, server, and AFK timestamp across the whole network
Web Panel — Fixed
- AFK enter/exit events now push to the panel instantly (via RabbitMQ if available, REST fallback otherwise)
- Added a heartbeat system: every 30 seconds the plugin sends the full list of online players to the backend — fixes stale "online" flags that got stuck after
server crashes or failed disconnect syncs
- Panel now correctly reflects AFK state across all servers
Lang
- All 9 language files synced with missing keys (fallback to English where not yet translated)

# OREOESSENTIALS v4.3 IS OUT NOW!
A brand new update has landed for **OreoEssentials** with major internal improvements and brand new visual features
━━━━━━━━━━━━━━━━━━
## ✨ WHAT’S NEW IN v4.3
━━━━━━━━━━━━━━━━━━
- **Full plugin reorganization**
- OreoEssentials has been **fully reorganized into several folders/modules**
- Cleaner structure
- Better maintainability
- Easier future updates and expansions
- **Added Chat Bubbles!**
- Players can now display stylish **chat bubbles above their head**
- A much more immersive and modern social experience in-game
- ️ **Added Multiple-Line Custom Nametags!**
- You can now create **fully customizable nametags with multiple lines**
- Perfect for advanced player displays, role info, status lines, custom formatting, and more
━━━━━━━━━━━━━━━━━━
## ⚠️ IMPORTANT UPDATE NOTICE
━━━━━━━━━━━━━━━━━━
For the **best performance** and to ensure everything loads as cleanly as possible with this update:
✅ **We strongly recommend fully regenerating your config files**
### Recommended steps:
1. **Make a backup** of your current config files first
2. Delete the old config files
3. Let **OreoEssentials regenerate fresh new ones**
4. Then simply **copy/paste your old settings back in manually if needed**
⚠️ **Important:**
OreoEssentials will still **automatically port/migrate your settings by itself** in most cases, so updating should normally work fine.
However, because this update includes **major internal reorganizing**, a **full config regeneration is the safest and cleanest option** for maximum stability and performance.
**Backup first, regenerate clean, then reapply your custom settings if needed.**

/bubblecolor <color|reset>
Players with oe.chatbubble.color can set the color of their own chat bubbles:
/bubblecolor red
/bubblecolor #FF5500
/bubblecolor gradient:red:gold
/bubblecolor reset
- Tab completion shows 20 preset color names + gradient examples
- Shows a live preview after setting
- reset / clear / off all revert to server default
- Color is applied per-player on top of the server's text-prefix/text-suffix — the admin's global styling still wraps around it
- Colors are in-memory only (reset on server restart — no DB needed for a cosmetic preference)
- Aliases: /bccolor, /chatbubblecolor
---
- Spawns a separate TextDisplay entity at the background position, rendered before the text entity so it appears behind
- Fades in/out in perfect sync with the text bubble
- Fully cleaned up on quit/world-change/reload like the main bubble
- ItemsAdder example: text: '<font:default>\uE001</font>'
- Nexo example: text: '<font:nexo:your_namespace>\uE001</font>'

Fixed a bug with Holograms Persistance

Fixed a bug in holograms module in which after switching servers holograms where disappearing

Changed And full recode of Holograms system
Added Folia Support across ALL PLUGINS MODULES
Recode of the TAB module
Recode of scoreboard module
Fixed Shop color parsing issues

Fixes Tab issues with minimessage and luckperms formatting
Fixed an issue where chat format had a non compatibility issue with CHC

OreoEssentials now has its own webpanel !
-> OreoStudios Web Panel — Documentation Hub | OreoStudios Wiki

Discord Bot:
-> OreoBot — Documentation & Wiki

Some small bug fixes + Support for fake players ( OreoVelocity)

OreoEssentials 4.0 — New Update Released!

We’re excited to announce a new update for OreoEssentials 4.0 with powerful new systems and improvements!

New Orders System (DonutSMP-style)
A brand new Orders Market system has been added!
Players can request items and other players can fill those orders by selling items to them.
✔ Fully configurable
✔ Supports custom currencies + Vault
✔ Cross-server compatible
✔ Live updates across servers using the network system

Rotating Shops
You can now create rotating shops!
Configure a shop with many items and the plugin will automatically rotate which items are displayed (for example daily or at a custom interval).

⏱ New Playtime Placeholders
New placeholders have been added to make tracking playtime easier:
• Playtime Hours
• Playtime Minutes
• Playtime Days

Walk Speed Support
Added support for player walk speed management.

This update brings more flexibility for economy systems, dynamic shops, and server networks.

If you encounter any issues or have suggestions, feel free to report them in the support channels!

This update is for the beta fix of EssentialsX Migrator
Bug 1 Wrong world key (homes & warps)
EssentialsX's LocationTypeSerializer writes two separate keys:
world: "550e8400-e29b-41d4-a716-446655440000" # world UUID AND NOT the name
world-name: "world" # human-readable name
My original code read cfg.getString(path + ".world") and passed the UUID string directly to Bukkit.getWorld(String), which looks up by name so it would silently return null for every home and warp, and everything would be skipped.

Bug 2 — Warp name from file vs. from key
EssentialsX sanitises warp filenames ("My Home" → my-home.yml). The canonical name is stored in a name: key inside the file. The old code derived the warp name from the filename, which would produce wrong names for warps with spaces or special characters.

OreoEssentials 3.9-SNAPSHOT Update
A new snapshot build is available with major fixes, improvements, and brand-new migration tools.
✅ Fixes & Improvements

• Fixed an issue where /msg was not working cross-server
• Fixed MobHealthbars issues
• Fixed /sit not working correctly on half blocks
• Fixed Furnace command issues
• Fixed HealthBarListener
  ➜ Added support for Placeholders
  ➜ Added support for Nexo Symbols
• Added Hologram icon support
  ➜ You can now insert icons/symbols into any hologram text line
• Added separate permissions:
  • oreo.tpa
  • oreo.tphere
  • oreo.tpdeny
    

Discord Command Support (Preparation for 4.0)
This version introduces support for the new Discord commands system.

⚠ Important:

• The commands are implemented and ready.
• The official OreoEssentials Discord Bot will release in 4.0.
• You will be able to use these commands without the bot once 4.0 is out.
  

Migration & Compatibility System (NEW)
OreoEssentials now supports migration from:

• EssentialsX
• zEssentials

Works with all OreoEssentials storage backends:

• YAML
• JSON
• MongoDB

EssentialsX Migration
Configuration (config.yml)

How To Use

1. Set enabled: true
2. Make sure data-path points to your EssentialsX folder
3. Run:

/migrateessentials
or
/migrateessentials homes
/migrateessentials warps
/migrateessentials economy

1. Set enabled: false after migration (one-time operation)

zEssentials Migration
Configuration (config.yml)

Usage
/zimport all
/zimport homes
/zimport warps
/zimport economy

Imports:

• Homes
• Warps
• Economy

Conflict handling:

• skip → Keeps existing OreoEssentials data
• overwrite → Replaces existing data
  

Full rewrite of hologram system added all 1.21+ versions compatibility
Fixed an issue with Join / Leave messages
Added new placeholders for tempfly

Hey Guys !

As promised OreoEssentials focuses on your performance more then on anything ! Here is a new Module added to OreoEssentials !
- A full auction house system fully configurable and modifiable !You can fine evything in /oreoessentials plugin folder then auctionhouse folder and have fun !

- Added a brand new placeholder to show number of players in the network
- Added a brad new placeholder to show number of players in the network


FIXES:
- Fixed an issue with custom currencies command!

This update contains several bug fixes including :
Economy Fixes
Custom Currencies Fixes
Chat System Fixes
ClearLag imporoved and added Mob Clear System
AND MORE !

- Fixed ecnomy issues with Baltop
- Added Craft-actions.yml in which you can
Define commands and messages to execute/send when items are crafted.

FIXES:
- FIXED an issue where oreobot wa snot keeping its modified values after restart fomr config.yml
- FIXED an issue where holgrams had a dark background
- FIXED an issue with command handeling

ADDED commandtoggle.yml
You cna now toggle and choose which command you want / OR / Dont want to have in oreoessentials

In this update we fixed the fact that nexo minimessages tag were not parsing on the scoreboard + we fixed a couple of issues with placeholders

More Placeholder Fixes and some Scoreboard tweaks

Fixed an issue for some people where palceholders were not parsing
Fixed an issue with Scoreboard ( returning to line was impossible)
Changed Default Config on scorabord to give better example

➕ New Features & Additions
Auto Restart System

• Fully configurable automatic server restart
• Supports:
  • Time-based or interval-based restarts
  • Warning broadcasts before restart
  • Pre-restart commands
• New SAFE_ZONE mode:
  • Instead of kicking players, they can be:
    • Teleported to a WorldGuard region
    • Or sent to another server (cross-server safe reboot)

AFK Pool System

• Automatic AFK detection based on inactivity
• When AFK:
  • Players can be teleported to a WorldGuard AFK pool
  • Optional cross-server support (send AFK players to hub)
• Fully configurable timers & checks
• Designed for performance and large networks

Command Control System (PL Hide Pro–like)

• Advanced command visibility & execution control
• Features:
  • Hide commands from tab completion
  • Block command execution entirely
  • Permission-based command access
  • Default DENY ALL mode (allow only what you want)
• Perfect for:
  • Hiding plugin commands
  • Cleaning player tab completion
  • Controlling what each rank can see/use
    

Notes

• All new systems are disabled by default and fully configurable
• Designed for networks & multi-server setups
• No performance impact observed

New Admin GUI ! TO EDIT And customise all your Custom Created economies !
Preview video :

Fixes Placeholders related to CustomCurrencies

Updated Docs with DeluxeMenus integration tutorial

- Improved Scoreboard color supported for animation
- Added a complete new Multiple Currency System
check more info here: Custom Multiple Economy System | OreoEssentials

Cross Server Back Stability

= fixed issue with back command
= imporved server tab into a fully custom method
= Added chat channels