━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Overview
OreoEssentials is the next generation of Essentials.
Built for modern networks with true cross-server synchronisation — fast, clean, and simple to configure.
Everything syncs across servers: Homes, Warps, Economy, Chat, Inventories, Enderchests, Health, and Food.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ Core Features
✅ Full Cross-Server Synchronisation
Homes, warps, inventories, economy, chat, health, food, and enderchests sync via MongoDB + Redis + RabbitMQ.


✅ All-in-One Essentials Core
Replace 10+ plugins (EssentialsX, CMI, MyWarp/MyHome, DiscordSRV pieces, etc.).

✅ Economy (Vault Compatible)
Backends: PostgreSQL or MongoDB, with Redis caching.

✅ Chat & Tab Manager
Global chat, per-rank formats, Discord webhooks, beautiful tab headers/footers.

✅ Warps, Homes & RTP
Tier-based limits and rank radius boosts.

✅ Kits & Cooldowns
Unlimited kits, permissions, cooldowns, optional GUI.


✅ Moderation Tools

✅ Utilities

✅ Portals & JumpPads
Cuboid portals and configurable launch pads with effects.

✅ Smart Inventories PlaceholderAPI
Modern GUIs and full PAPI support everywhere.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Cross-Server Sync Modules
• Homes & Warps
• Economy (Vault, MongoDB or PostgreSQL)
• Chat & Global Messages
• Inventories, Enderchests, Health, Food
• ️ Teleport Requests & RTPs
• Moderation Logs
Powered by a hybrid backend: MongoDB + Redis + RabbitMQ.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
️ Installation
1) Drop the JAR into `/plugins`.
2) Start once to generate configs.
3) Configure databases in `config.yml`:
4) Restart all servers — syncing starts automatically.
Don’t want to self-host? Oreo Studios offers pre-configured DB hosting for **$2/month** — open a ticket on our Discord:
https://discord.gg/A6wCGJD2Ez
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Cross-Server Setup — What You Need

Type	Purpose	Optional	Recommended?
MongoDB	Core data (Homes, Warps, Inventories, etc.)	No	Yes
RabbitMQ	Real-time cross-server messaging (Chat/TP/Moderation)	No	Yes
Redis	Cache for Economy & Chat	Optional	Highly
PostgreSQL	Optional economy backend	Optional	Optional

Full guides in the wiki:
• Cross-Server Sync Setup
• RabbitMQ on Pterodactyl (egg)
• MongoDB + Redis Setup
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Global Chat Example
Private channels in `chat-format.yml`:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Configuration Highlights
• Chat Format System (PAPI, rank formats, Discord webhooks, sync)
• TabList (animated headers/footers, per-world layouts)
• EnderChest (tier rows via `oreo.tier.vip`, etc.)
• RTP (safe search, tier distances)
Permissions
Use `oreo.*` for full access, or per-command nodes. Tiers: `oreo.tier.default`, `oreo.tier.vip`, `oreo.tier.mvp`.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Performance
Java 21, async I/O, caching, thread-safe operations.
Tested on Paper / Purpur / Folia.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Plugin Comparison

Feature	OreoEssentials	ZEssentials	⚙️ EssentialsX	CMI	☀️ SunLight
Cross-Server Homes & Warps	✅ Full sync (MongoDB)	⚠️ Partial (shared DB)	❌	⚠️ MySQL only	❌
Cross-Server Chat	✅ RabbitMQ live	❌	❌	⚠️ Discord bridge	❌
Cross-Server Economy	✅ Redis/Mongo/PG	⚠️ Shared SQL	❌	⚠️ MySQL partial	❌
Inventories & Enderchests Sync	✅ Yes	❌	❌	❌	❌
Health & Food Sync	✅ Yes	❌	❌	❌	❌
RabbitMQ Messaging	✅ Built-in	❌	❌	❌	❌
Redis Cache	✅ Yes	❌	❌	❌	❌
All-in-One System	✅ Replaces 10+	⚙️ Modular	⚙️ Basic	⚙️ Complex	⚙️ Basic
MongoDB Support	✅ Native	⚙️ Partial	❌	❌	❌
Performance (Async/Java 21)	✅ Optimized	⚙️ Standard	⚙️ Standard	⚙️ Heavy	⚙️ Basic
Modern GUIs	✅ SmartInvs	⚙️ Basic	❌	⚙️ Custom	❌
Price	FREE	19.99€	Free	Paid	Paid

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Why OreoEssentials?
✅ Completely Free • ✅ Fully Cross-Server • ✅ Replaces CMI/EssentialsX/ZEssentials • ✅ Built for networks • ✅ Backed by Oreo Studios
Links
• Wiki: https://docs.oreo-studio.shop/oreoessentials
• Discord Support: https://discord.gg/A6wCGJD2Ez
• Support the project: (donation/sponsor link)