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.

● ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
OreoEssentials — Update v4.4
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🌐 WEB PANEL — REBUILT FROM SCRATCH

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

✨ 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

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

🍪 OreoEssentials v4.8 — Massive Systems Update

One of the BIGGEST OreoEssentials updates yet is here.

This update introduces entirely new moderation systems, utility commands, server management tools, performance protections, and massive internal rewrites focused on stability, Folia compatibility, and large-network performance.

✨ New Commands

• /day & /night • /oeworld — advanced world management • /top & /bottom • /price & /recipe • /help, /motd, /rules • /mail send|read|clear • /ignore & /unignore • /warn, /warnings, /unwarn • /history • /setfirstspawn

🆕 New Systems

⚠️ Warnings system with auto punishments ✉️ Persistent player mail 🚫 Ignore system 📖 Configurable help pages 📢 MOTD system 📜 Rules system 🧾 Punishment history logger 🛡️ Join flood protection 📦 Container spam protection 🌍 Async world pre-generator 🕳️ Void world generator

🔧 Major Rewrites & Improvements

✨ Holograms

• Fixed Paper 1.26.x support • FlatFile rewrite • Improved command routing • Better stability overall

📊 Scoreboards

• Massive internal rewrite • Better Folia compatibility • Reduced recreate spam

📋 Tablist

• Packet-based layout rewrite • Improved custom layouts • Better rendering stability

🏠 Homes

• Cleaner cross-server handling • Major command rewrite

💰 Economy / Cheques

• Full cheque rewrite • Backend improvements

🛒 Shop

• Buy/sell edge case fixes • TransactionProcessor improvements

🌐 Portals

• Cross-server broker improvements • Listener fixes

🏷️ Nametags

• Added conditional nametag support

📍 Spawn

• Better first join handling • SpawnService refactor

…and MANY more internal fixes & optimizations.

⚙️ Config Changes

Added: • server/help.yml • server/motd.yml • server/rules.yml • server/warnings.yml

Expanded: • settings.yml • tab.yml • custom-nameplates/config.yml

plugin.yml → +117 new lines (commands & permissions)

🚀 Focus of This Update

• Better Folia support • Async safety • Cross-server improvements • Packet optimizations • Large-network stability • Lower overhead

OreoEssentials continues pushing toward becoming the most complete modern Essentials core for Paper & Folia servers.

❤️ Thank you for supporting OreoEssentials.

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.

Folia Fixes spam and errorsa

• 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 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 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)

/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

[code=YAML] background-icon config block (in custom-nameplates/config.yml): background-icon:
enabled: false
text: '' # MiniMessage — put your font:...glyph here
scale: 1.0 # Multiplier > 1.0 = bigger icon
offset-x: 0.0 # Horizontal shift in blocks
offset-y: 0.0 # Extra vertical shift (positive = higher) [/code]

• 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'
• Nexo example: text: 'font:nexo:your_namespace\uE001'

━━━━━━━━━━━━━━━━━━

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

Full Folia Support Full rewrite for holograms systems

Added FULL FOLIA SUPPORT Rewrite Holograms system

in the tab config replace network key content with this

  network:
    all-servers: true
    # Servers whose players are hidden from the tab list of other servers.
    # Use the exact server name as registered in your proxy (case-insensitive).
    excluded-servers:
      # - hub

WebPanel Update Added a full webpanel for players and server owners Check here: https://oreostudios.fr/wiki/webpanel.html

Small Fixes + Added Support for FakePlayers ( REQUIRES 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!

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"

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.