🚀 Overview

OreoEssentials is the next generation of Essentials built for modern Minecraft networks with true cross-server synchronisation. Clean, fast, and extremely easy to configure.

Everything syncs across servers: Homes, Warps, Economy, Chat, Inventories, Enderchests, Health, Food, Teleports, Auction House, Player Warps, Trades, and more.

This plugin is 100% Open Source. If you'd like to support development and future updates, donations are appreciated. Please also consider leaving positive feedback!

⚡ FOR VELOCITY USERS — Want cross-server tab and join/quit messages across your entire network? Download our Oreo Velocity Extension

🌐 OreoEssentials Web Panel — Something Never Done Before

OreoEssentials is the FIRST and ONLY Minecraft plugin to come with its own fully-featured web panel. No other essentials plugin — not CMI, not ZEssentials, not EssentialsX, not SunLight — has ever offered anything like this. This is a first in the Minecraft plugin space.

The OreoEssentials Web Panel is a real web application hosted alongside your server, accessible from any browser. It gives your players and server owners a completely new way to interact with your network — without ever opening Minecraft.

✅ Player Web Dashboard

Players can log in to the web panel with their Minecraft account and access their personal data from anywhere.

• View their playtime, balance, homes, warps, and vault contents
• View their Inventories, Manage it, delete items, give to friends
• Add Friends to the Panel
• Access their full profile including statistics
• Secure 2-step login with email OTP verification — the same security standard used by banking apps

✅ Server Owner Dashboard

Server owners get a dedicated owner dashboard to manage their network from a web browser.

• View and manage registered players across the network
• Full admin control panel
• Real-time data synced from the MongoDB backend
• Manage ALL OREOESSENTIALS Perms from the online Webeditor directly — by a simple ON/OFF Button
• Secure owner-only access with role-based permissions

✅ Online Config Editor — Edit Your Plugin Configs From A Browser

This is something no other Minecraft plugin has ever done. OreoEssentials includes a full online visual config editor at oreostudios.fr — a browser-based GUI to edit every single config file the plugin uses, without touching a single line of YAML by hand.

• Visual editors for: settings.yml, chat-format.yml, auctionhouse/settings.yml, rtp.yml, craft-actions.yml, maintenance.yml, and more
• Live MiniMessage preview — see gradient and color formatting in real time as you type
• Feature toggle panels — flip modules on/off with checkboxes, no YAML knowledge needed
• Dynamic KV editors for tiers, permission mappings, cooldowns, and per-world overrides
• Download the finished YAML directly — drop it in your server and restart
• No installation required — runs in your browser, works from any device

✅ Account Security & Authentication

• Email-based OTP (one-time password) verification on every login and registration
• Forgot password flow — receive a secure reset link by email and set a new password
• Email case-insensitive login — works regardless of how you type your email
• BCrypt password hashing — passwords are never stored in plaintext
• JWT access tokens + refresh token rotation — industry-standard session management
• IP address logging on every login and registration for security auditing

⚡ Core Features

✅ Full Cross-Server Synchronisation

True real-time sync powered by MongoDB + Redis + RabbitMQ — not just shared databases, actual cross-server communication.

• 🔄 Player data follows users across your entire network
• 💬 Global chat and messaging
• 🚀 Cross-server teleports and homes
• 💰 Unified economy system
• 🛡️ Synchronized moderation tools

✅ Cross-Server Auction House

A fully-featured, live-synced auction house across every server in your network. Players list items on any server, buyers bid or buy from any other. Real-time updates push to every open GUI instantly — no refresh, no delay.

• 10 built-in item categories with automatic detection
• Custom item support: ItemsAdder, Nexo, Oraxen — textures show correctly everywhere
• Full search by item name, category filter, and price sort
• Seller fees, buyer tax, configurable listing durations
• Expired / sold item reclaim system
• Discord webhook notifications on sales
• MongoDB atomic writes — zero duplicate purchases, zero item loss
• Live GUI refresh via RabbitMQ — every open AH updates in real time

✅ Cross-Server Market / Orders (Buy Order System)

Players post buy orders — "I want 64 Diamond Swords, paying $10 each." Other players fill those orders from any server and get paid instantly. The money is escrowed up front, so the requester always pays and the filler always gets paid.

• Full cross-server order sync via RabbitMQ + MongoDB
• Supports Vault economy AND custom currencies
• Atomic fill logic — no race conditions, no double-spending
• Pending delivery system — items safely delivered even if the requester is offline
• Live market browser with real-time updates across the network
• Optional creation fees and fill fees

✅ Shop GUI & Sell GUI

Fully integrated shop and sell interfaces with ItemsAdder and Nexo support.

• SellGUI: drag and drop any item to sell, configurable shop prices per item
• ShopGUI: supports Vault economy and custom currencies per item
• Cross-server economy sync ensures balances are always current when players shop

✅ Custom Multiple Economy System

Create as many custom economies as you want — tokens, gems, crystals, anything. Full cross-server sync. Works in the Auction House, Market, Shop, and anywhere else.

• Per-currency balances, top lists, and transfer commands
• Fully independent from Vault — or use both side-by-side
• Supported in AH, Market/Orders, Shop, and Kits

💬 Advanced Chat System

Five scope types: ALL, WORLD, RANGE, SERVER, SHARD — put each channel exactly where it belongs. Per-rank format overrides via LuckPerms primary groups.

🪧 Custom Nameplates — No Extra Plugin Needed

You no longer need CustomNameplates, NametagEdit, or any third-party nametag plugin. OreoEssentials does it natively — better, and fully Folia-compatible.

Custom Nameplates replaces the vanilla name display above players' heads with fully configurable TextDisplay entities — supporting MiniMessage gradients, PlaceholderAPI, per-player conditions, and multiple stacked layers. Everything is configured in a single, clean custom-nameplates/config.yml.

nametag:
  enabled: true
  update-interval-ticks: 100
  show-to-self: true
  view-range: 48.0
  layers:
    rank:
      text: "%luckperms_prefix%"
      y-offset: 2.5
      background: transparent
    name:
      text: "<white>%player_name%</white>"
      y-offset: 2.1
      background: transparent

💬 Chat Bubbles

Players' chat messages appear as floating TextDisplay bubbles above their head — visible to nearby players in real time, with smooth fade-in and fade-out animations.

chat-bubbles:
  enabled: true
  y-offset: 2.6
  view-range: 32.0
  stay-duration: 80
  appear-duration: 5
  disappear-duration: 10
  max-lines: 3
  background: transparent
  sender-conditions: []
  viewer-conditions: []

✅ Playtime Rewards & Daily Rewards

Reward players automatically based on how long they play. Configurable milestones that trigger once or repeat. Full GUI to claim rewards.

• One-time milestone rewards (e.g. "1 hour played → reward pack")
• Repeatable rewards for ongoing engagement
• /daily command for daily login rewards with cooldown tracking
• PlaceholderAPI integration: show state (LOCKED / READY / CLAIMED / REPEATING) in scoreboards

✅ TempFly — Temporary Flight

Give players temporary flight with a countdown. Buy time with in-game currency, give it with commands, or award it via kits and rewards.

• Configurable time units via command: /tempfly give <player> <time>
• Remaining time shown via PlaceholderAPI placeholders
• Auto-lands players safely when time expires
• Full cross-server support — fly time follows the player across servers

🎁 Kits & Cooldowns

Unlimited kits with per-kit permissions, configurable cooldowns, and an optional GUI browser.

✅ Player Vaults (Cross-Server)

Your players' personal vaults sync seamlessly across all servers via MongoDB.

• Permission-based vault count and row size (tier system)
• Per-vault title customisation
• PlaceholderAPI: check vault count, rows, access status

🛠️ Moderation Suite

Complete cross-server moderation with a unified interface.

✓ /ban, /tempban, /unban, /kick, /mute, /tempmute, /unmute
✓ /jail, /unjail with configurable jail locations
✓ /god, /vanish for staff utilities
✓ /invsee, /invlook — inspect any player's inventory live
✓ Cross-server mute sync via RabbitMQ
✓ ModGUI — moderate your entire network from one interface

✅ Alias Editor System

Create runtime command aliases with full logic, conditions, cooldowns, and run-as-player or run-as-console modes. No restarts needed — changes apply instantly.

• GUI editor for non-technical admins
• Condition checks: permissions, money, EXP level, PlaceholderAPI values (with >=, <=, =, !=, contains, startsWith operators)
• AND/OR logic for multi-condition aliases
• Per-alias and per-line cooldowns
• permGate: gate an alias behind a permission node
• Custom tab completions per alias
• Runtime registration — enabled/disabled aliases apply to all players immediately

🎨 Additional Features

🔄 Cross-Server Sync Modules

• Homes & Warps — Access your homes from any server
• Player Warps — Players' public warps visible network-wide
• Economy — Vault, MongoDB or PostgreSQL with full sync
• Custom Currencies — Multiple economies, fully synced
• Auction House — Live listings and purchases across all servers
• Market / Orders — Buy orders filled from any server
• Chat & Global Messages — Channels, private messages, and mutes across your network
• Inventories, Enderchests, Health, Food, Potions — Complete player state sync
• Teleport Requests & RTPs — Cross-server teleportation
• Trades — Players on different servers trade items in real time
• TempFly — Fly time follows the player across servers
• Moderation Logs — Network-wide moderation tracking

Powered by a hybrid backend: MongoDB + Redis + RabbitMQ

🔌 Integrations

Plugin	Support Level	Description
	✅ Full	Complete economy integration
	✅ Full	Two expansions: %oreo_...% and %oreoah_...%
	✅ Full	AH, Market, Shop, Kits, Chat, Crafting
	✅ Full	AH, Market, Shop, Kits, Chat, Crafting
	✅ Full	Custom item support
	✅ Full	Custom mob loot and drops
	✅ Full	Groups in chat, per-rank formats
	✅ Full	Per-channel webhooks + AH sale alerts

🎬 Preview Videos

FULL GUI CONTROL:

• ▶ Full GUI Showcase

Feature Showcases:

📦 Installation

⚡ Quick Start

Step 1: Drop the JAR

📁 plugins/
  └── OreoEssentials.jar

Step 2: Generate Configs

Start your server once to auto-generate configuration files.

Step 3: Configure Databases

Edit config.yml with your database credentials:

MongoDB:
  enabled: true
  uri: "mongodb://user:[email protected]:27017/oreo"

RabbitMQ:
  enabled: true
  uri: "amqp://guest:[email protected]:5672/"

Redis:
  enabled: true
  host: "127.0.0.1"
  port: 6379
  password: "yourpass"

Step 4: Restart & Enjoy

Restart all servers — cross-server sync activates automatically! 🎉

💡 Need Help with Setup?

Online Config Editor: Never touch a YAML file again — use our free browser-based visual config editor at oreostudios.fr with live MiniMessage preview.

🌐 Cross-Server Setup — What You Need

Component	Purpose	Required?	Recommended?
	Core data (Homes, Warps, Inventories, AH listings, Orders)	Yes ✅	Yes ⭐
	Real-time cross-server messaging (Chat, AH sync, Orders, TP, Moderation)	Yes ✅	Yes ⭐
	Cache for Economy & Chat	Optional	Highly 🔥
	Optional economy backend	Optional	Optional

📚 Full Setup Guides Available

Documentation: docs.oreostudios.fr/oreoessentials

• ✅ Cross-Server Sync Setup
• ✅ RabbitMQ on Pterodactyl (egg included)
• ✅ MongoDB + Redis Configuration
• ✅ Troubleshooting Guide

🎮 Feature Showcase

💬 Global Chat Example

[Survival] [VIP] Elias: Hello from Server 1!
[Creative] [Admin] Sarah: Hey from Server 2!

🔐 Private Channels

Configure custom channels in chat-format.yml:

channels:
  staff:
    format: "&c[Staff] {player}: &f{message}"
    permission: "oreo.chat.staff"

⚙️ Configuration Highlights

• Custom Nameplates — Multi-layer TextDisplay nametags, MiniMessage, PAPI, conditions, per-viewer visibility, all in custom-nameplates/config.yml
• Chat Bubbles — Floating speech bubbles above players' heads, fade animations, view range, conditions — same config file
• Chat Format System — MiniMessage, per-rank formats, Discord webhooks, full cross-server sync
• Auction House — categories, fees, listing duration, Discord notifications, all in auctionhouse/settings.yml
• Market / Orders — escrow fees, fill fees, currency picker, cross-server in orders/settings.yml
• TabList — Animated headers/footers, per-world layouts
• EnderChest — Tier rows via oreo.tier.vip, etc.
• RTP — Safe spawn search, tier-based distances
• TempFly — Configurable units, auto-land, balance deduction
• Playtime Rewards — Milestone and repeatable reward definitions in playtime/rewards.yml
• Alias Editor — aliases.yml + full GUI, no restart needed
• Online Config Editor — Edit all configs visually in your browser at oreostudios.fr, no YAML knowledge required

chat-format:
  default: "&7{player}: &f{message}"
  vip: "&6[VIP] &e{player}: &f{message}"
  staff: "&b[Staff] &3{player}: &f{message}"
  admin: "&c[Admin] &4{player}: &f{message}"

rtp:
  default-radius: 5000
  max-radius: 15000
  safe-spawn: true
  warmup: 3
  cooldown: 300
  tier-multipliers:
    default: 1.0
    vip: 1.5
    mvp: 2.0

kits:
  starter:
    items:
      - "DIAMOND_SWORD 1 name:&bStarter_Sword"
      - "COOKED_BEEF 32"
      - "GOLDEN_APPLE 5"
    permission: "oreo.kit.starter"
    cooldown: 0
  vip:
    items:
      - "DIAMOND_CHESTPLATE 1 enchant:PROTECTION:4"
      - "DIAMOND_PICKAXE 1 enchant:EFFICIENCY:5"
    permission: "oreo.kit.vip"
    cooldown: 86400

homes:
  limits:
    default: 5
    vip: 10
    mvp: 20
    ultimate: 50

🛡️ Permissions

🔑 Quick Access Permissions

# Full admin access
oreo.*

# Administrative commands
oreo.admin

# Moderation tools only
oreo.mod

🎯 Tier System

⚡ Performance

Built for speed:

• ✅ Java 21 optimized
• ✅ Fully asynchronous I/O across all modules
• ✅ Redis caching layer for economy and player lookups
• ✅ Thread-safe operations throughout
• ✅ Debounced live GUI refresh — events batched before re-rendering
• ✅ Atomic MongoDB writes — no race conditions in AH or Market
• ✅ Tested on Paper / Purpur / Folia

🖥️ Supported Platforms

Minimum Requirements: Java 21+ • Paper 1.20.1+

🗄️ Database Architecture

┌─────────────────────────────────────────┐
│         Application Layer               │
│         (OreoEssentials)                │
└─────────────┬───────────────────────────┘
              │
    ┌─────────┴──────────┐
    │                    │
┌───▼────┐          ┌────▼────┐
│ Redis  │◄────────►│ RabbitMQ│
│ Cache  │          │ Messages│
└───┬────┘          └─────────┘
    │
┌───▼─────────────────────────────────┐
│  Primary Storage                     │
│  ┌──────────┐    ┌──────────────┐  │
│  │ MongoDB  │ or │ PostgreSQL   │  │
│  └──────────┘    └──────────────┘  │
└──────────────────────────────────────┘

📊 Plugin Comparison — OreoEssentials vs Others

🤝 Official Partners

MineStrator is now the hosting provider we officially recommend if you want to test our plugins, host your projects, or run a production server.

• ✅ Fast setup
• ✅ Stable infrastructure
• ✅ Perfect for modern networks (databases, proxies, cross-server setups)

Get 10% OFF with code: OREOSTUDIOS

🔗 Click here to get started with MineStrator

Thank you MineStrator for the trust • Thank you for supporting Oreo Studios ❤️

❓ Why OreoEssentials?

• ✅ Open Source
• ✅ Fully Cross-Server
• ✅ Replaces CMI / EssentialsX / ZEssentials / CustomNameplates
• ✅ Built-in Custom Nameplates — multi-layer TextDisplay nametags with MiniMessage, PAPI, conditions, and smooth interpolation. No separate plugin needed
• ✅ Built-in Chat Bubbles — floating speech bubbles above players' heads with fade animations, zero extra dependencies
• ✅ Built-in Auction House + Market — no extra plugins needed
• ✅ Built for Networks — designed from the ground up for multi-server setups
• ✅ The ONLY Essentials plugin with a Web Panel — a first for any Minecraft plugin, never done before
• ✅ Players can access their stats, homes, vaults, and profile from any browser
• ✅ Server owners get a full admin dashboard and online config editor — manage your network without touching YAML
• ✅ Online Config Editor at oreostudios.fr — edit all configs visually in your browser with live MiniMessage preview
• ✅ Backed by Oreo Studios

🤝 Support & Community

📜 License

OreoEssentials is released under a custom open-source license authored by Oreo Studios.

🔗 Full license text