⚙️ Config Editor

OreoEssentials
How it works: Edit your plugin config files visually right here. When you save, the config is stored on our servers. Your plugin will download the latest version next time it starts (or you can run /oe reload). You can also paste your existing config via the Import button.
✓ Logged in
Import your plugin's config.yml directly from your server
🌈 Gradient Builder LIVE PREVIEW
▼
Pick two hex colors to generate a <gradient:#HEX:#HEX>text</gradient> tag. Perfect for bossbar text, scoreboard title/lines, join messages, and more.
Preset Palettes
🎮 In-Game Preview LIVE
▼
Live preview of your Bossbar and Scoreboard. Supports <gradient>, named colors (<red>, <gold>…), legacy &a codes, and placeholder pills.
📊 Bossbar
Boss bar text…
📋 Scoreboard Sidebar
Scoreboard
Configure lines in the Scoreboard section below…
🖥️ Server Settings
▼
The name shown in the web panel and in-game messages.
Default plugin language for messages.
🌐 Web Panel Connection
▼
Enable Web Panel Sync
Sync player data to the OreoStudios web panel in real-time.
The URL of your OreoStudios web panel deployment.
Found in your panel's Server Settings page. Keep it secret!
🗄️ Storage
▼
Use MongoDB for multi-server networks.
Your MongoDB connection string.
💰 Economy
▼
New players start with this amount.
✨ Features (Enable / Disable)
▼
📊 Boss Bar
▼
Preview will appear here…
1.0
0 = empty bar, 1 = full bar
💤 AFK System
▼
Enable Auto-AFK
Automatically mark players as AFK when inactive.
How many seconds of inactivity before marking as AFK. Default: 300 (5 minutes).
🏠 Homes & TPA
▼
Players can set this many homes by default. Use LuckPerms for per-rank limits.
How long before a TPA request expires.
🌈 Gradient Builder LIVE PREVIEW
▼
Pick two hex colors to generate a MiniMessage <gradient:#HEX:#HEX>text</gradient> tag. Click a preset or use the color pickers. The preview updates in real time.
Preset Palettes
💬 Chat Settings
▼
Enable Chat Formatting
Allow OreoEssentials to format player chat messages.
Used when channels are disabled. Placeholders: <lp_prefix>, <player_name>, <chat_message>, <player_world>, <player_ping>…
Preview will appear here…
Hover Card (player info on mouse-over)
Show health, level, ping, world and rank when hovering a player's name in chat.
Item-in-Chat ([item] placeholder)
Players type [item] in chat to show a clickable display of their held item.
📡 Channel System
▼
Enable Channels
Global, Local, Trade, Staff, Help and Announcements channels.
Players start in this channel when they join.
Enable / Disable Individual Channels
🔗 Discord Bridge (non-channel)
▼
Enable Discord Webhook Bridge
Mirror player chat to a Discord channel via webhook (simple mode, no channels).
🐇 Cross-Server Chat Sync (RabbitMQ)
▼
Enable RabbitMQ Chat Sync
Sync chat messages between multiple servers and with the OreoBot Discord bot. Requires a working RabbitMQ instance.
Format: amqp://user:password@host:5672/vhost — same URI you set in the Discord bot config.
🌈 Gradient Builder LIVE PREVIEW
▼
Build <gradient:#HEX:#HEX>text</gradient> tags for header/footer frames, name formats, and more.
Preset Palettes
⚙️ General Settings
▼
Enable Tab
Enable OreoEssentials tab list customization.
Use PlaceholderAPI
Allow %placeholder% tags in tab header/footer/formats.
Network — All Servers
Apply this tab layout across all servers on the network.
How often the tab list refreshes. 20 ticks = 1 second.
CUSTOM uses the header/footer/player sections below.
🎨 Custom Layout
▼
Enable Custom Layout
8 ticks ≈ 0.4 s. Controls speed of the animated wave header/footer.
⬆️ Top Section — Header Frames
▼
Each line = one animation frame. Use &#RRGGBB inline hex colors, legacy &l/&m/&r codes, or MiniMessage tags. Embed newlines within a single frame using \n (the plugin splits on it).
Paste all animation frames here, one per line. Each frame can embed \n to create multi-line headers.
👥 Player Section
▼
Enable Player Section
Preview will appear here…
Rank Colors (prefix code applied to player name per rank)
Show AFK Indicator
Show Ping Bars
⬇️ Bottom Section — Footer Frames
▼
Same format as header frames — one animation frame per line.
🌈 Gradient Builder LIVE PREVIEW
▼
Build <gradient:#HEX:#HEX>text</gradient> or legacy &6 color codes for broadcast messages.
Preset Palettes
⚡ General Settings
▼
Enable ClearLag
Enable automatic entity/item cleanup to reduce lag.
Enable Plugin API
Expose OreoLag API for other plugins to hook into.
Use Internal TPS
Use OreoEssentials' own TPS measurement instead of the server's.
Auto Update
Automatically update the plugin when a new version is released.
📢 Global Broadcasts
▼
Enable Global Broadcasts
Announce clearlag events to all players.
Async Broadcasts
Send broadcasts asynchronously (off-thread).
Use Permission for Broadcasts
Only players with the broadcast permission see clearlag messages.
🗑️ Auto Ground-Item Removal
▼
Enable Auto Removal
Periodically clear ground items and specified entities.
Broadcast Removal
480 s = 8 min. Reduce on laggy servers.
Entity Flags — check to remove
🧟 Auto Kill Mobs
▼
Enable Auto Kill Mobs
Periodically kill mobs to reduce entity count.
Remove Named Mobs
Also remove mobs with custom name tags.
Broadcast Removal
Mobs listed here will NOT be killed.
📈 TPS Monitor
▼
Enable TPS Monitor
Automatically run cleanup when TPS drops below the trigger threshold.
Broadcast Enabled
Cleanup runs when TPS falls below this.
Considered recovered above this value.
🌈 Gradient Builder LIVE PREVIEW
▼
Build color codes for MOTD lines, kick/join-denied messages, and timer format. Supports legacy &c &a &l codes and <gradient:#HEX:#HEX> MiniMessage tags.
Preset Palettes
🔧 Maintenance Mode
▼
Enable Maintenance Mode
When ON, only whitelisted players (or those with oreo.maintenance.bypass) can join. All others see the kick/join-denied message.
📝 Server List MOTD
▼
Shown in the Minecraft server list when maintenance is active. Supports &c red, &a green, &7 gray, &e yellow, &l bold, &r reset.
💬 Player Messages
▼
Supports legacy & color codes and line breaks. Use | in YAML for literal block style (preserves newlines).
🖥️ Server List Display
▼
Show Server as Full (0/0 players)
Makes the server appear completely full in the multiplayer list, discouraging join attempts.
Hide Player Count (shows ???)
Hides the player count entirely. Takes priority over "show as full" if both are enabled.
✅ Allowed Players (Whitelist)
▼
Players listed here can join during maintenance. Enter a Minecraft username or UUID and press Enter. Players with permission oreo.maintenance.bypass can always join regardless.
⏱️ Auto-Disable Timer
▼
Enable Timer
Automatically turn off maintenance after a set duration. Set the duration in-game with /maintenance clock set <duration>.
Show Timer in MOTD
Display remaining time in the server list MOTD when the timer is active.
0 = no end time set.
Feature Toggles
Enable or disable individual OreoEssentials modules. Disabling a module unregisters its commands and listeners — a server reload is required for changes to take effect.
World Sharding
Distribute worlds across multiple servers. Set to true only when sharding infrastructure is in place.
AFK Pool
Teleport AFK players to a designated pool region.
Boss Bar
Animated welcome boss bar shown to players on join.
Chat Formatting
Custom chat format, channels, hover cards, and Discord bridge.
Homes
/sethome, /home, /delhome commands.
Shop
In-game shop system.
Currency
Currency system (cheques, currency items).
Economy
/balance, /pay, /eco and Vault integration.
Jump Pads
Pressure plate jump pads with configurable power.
Kits
/kit command — starter and rank kits.
Mobs
Mob health bars and custom mob settings.
ClearLag
Master switch for ClearLag module (/olagg, auto clear, TPS monitor).
Oreo Holograms
3D floating hologram displays with PAPI support.
Player Vaults
Personal storage (/vault command).
Playtime Rewards
Reward players automatically based on total playtime milestones.
Portals
Custom portal regions with cross-server teleport support.
RTP (Random Teleport)
/rtp command — teleports player to a random safe location.
Scoreboard
Animated sidebar scoreboard.
Sit
/sit command — players can sit on stairs and slabs.
TempFly
Temporary flight with duration tracking.
Trade
Player-to-player item/money trading GUI.
Discord Moderation
Sync bans/kicks/mutes to Discord via webhook.
Tablist (Tab)
Animated tab header/footer with rank colors.
Cross-Server Sync
Controls which data is synchronized across servers via the network transport (RabbitMQ / Redis). Only effective when network.cross-server is enabled in config.yml.
Homes
Warps
Spawn
Economy
Ender Chest
Inventory
Invsee
Player Warps (/pw)
Player Warps Enabled
Master toggle for the /pw command.
Cross-Server Warps
Only effective when essentials.storage = mongodb.
Features
Description
Rating
Categories
Cost
Whitelist
Managers
Favourites
Password
Lock
RTP
GUI
Warp Limits per Rank
Teleport Cooldowns
Cooldowns prevent spam-teleporting. Set cooldown-amount to 0 for instant teleport even when cooldown is enabled.
TPA
Warp
Spawn
Death & Respawn
Custom Respawn Enabled
Override where players respawn on death. When disabled, vanilla bed/anchor respawn is used.
Custom Respawn Location (used when mode = CUSTOM)
Auto Reboot
Auto Reboot Enabled
Automatically restart the server on a schedule or interval.
Safe Zone
Safe Zone Enabled
Holograms
Nametag
Controls the player nametag displayed above heads in-game. Supports PAPI placeholders and legacy & color codes.
Nametag Enabled
Craft Actions
Define commands and messages triggered when a player crafts an item.
Key: Vanilla material name (e.g. DIAMOND_PICKAXE) or custom recipe name from recipes.yml (e.g. legendary_sword).
Commands run as console. Messages support MiniMessage format (<green>, <gradient:red:gold>, etc.) and multi-line.
Placeholders: %player%  •  %player_uuid%  •  %world%  •  %item%  •  %amount%  +  any PlaceholderAPI placeholder.
Global Settings
RTP Enabled
Master switch for the /rtp command.
Permission Tiers (global radius overrides by permission)
Each row maps a permission node to a max radius. Players with that permission get the larger radius when using /rtp.
Allowed Worlds
List of worlds where /rtp is available. Leave empty to allow all worlds.
Unsafe Blocks
Ground blocks that cannot be landed on. Use Minecraft Material names (e.g. LAVA, CACTUS).
Cross-Server RTP
Sends players to a different proxy server based on the target world. Only works with Bungee / Velocity network setup.
Cross-Server Enabled
World → Server Mapping
Per-World Overrides
Override radius, min-radius, and tier permissions on a per-world basis. Fields left empty fall back to global values.
Cooldowns (seconds per rank)
Map rank/permission keys to cooldown durations in seconds. The default key applies to players with no specific rank.
Editing: config.yml