OEssentials

Modern Essentials. Built for entire networks.

Homes • Warps • Economy • Chat • Player Sync • Moderation
Auction House • Market • Vaults • Rewards • Web Panel • Developer API

Paper • Spigot • Folia • Cross-Server

---

What is OEssentials?

OEssentials is a complete server core designed for modern Minecraft servers and multi-server networks.

Instead of installing separate plugins for homes, warps, economy, chat, player storage, moderation, rewards, marketplaces, teleportation, server utilities, and many other systems, OEssentials brings them together under one consistent platform.

It can be used on a standalone survival server or across an entire proxy network.

Enable what you need. Disable what you don't.

OEssentials is designed to grow with your server.

DOCS: Click Here

---

Previously OreoEssentials

OEssentials was previously known as OreoEssentials.

This is not simply a rename.

The project has undergone a major restructuring and architectural rewrite to provide a cleaner foundation for future development.

The modern OEssentials architecture introduces:

• A new modular architecture
• MinecraftModulith integration
• Cleaner feature ownership
• Managed module lifecycles
• Improved startup and shutdown handling
• Better separation between systems
• Cleaner configuration organization
• Improved developer APIs
• Modern Java 21 architecture

Previously OreoEssentials. Rebuilt for what comes next.

---

Built with MinecraftModulith

OEssentials contains a large number of independent systems.

Rather than turning the project into one giant monolithic codebase, OEssentials uses MinecraftModulith to organize features into independent managed modules.

The current architecture contains 56 MinecraftModulith modules.

Major systems have clearly defined ownership over their:

• Services
• Initialization
• Shutdown
• Listeners
• Scheduled tasks
• Resources
• Dependencies

MinecraftModulith also validates module dependencies during compilation.

For a plugin this large, architecture matters.

This approach means:

• Features have defined boundaries
• Modules know what they depend on
• Tasks are associated with the systems that created them
• Listeners can be cleaned up correctly
• Dependencies can be validated
• Startup failures can roll back cleanly
• Shutdown happens in a controlled order
• Individual systems are easier to maintain and debug

---

Cross-Server by Design

OEssentials was designed with Minecraft networks in mind.

Players should not lose their server environment simply because they move from one backend server to another.

Supported OEssentials systems can synchronize across your network, including:

• Inventory
• Armor
• Offhand
• Ender Chest
• Health
• Hunger
• Experience
• Potion effects
• Economy
• Custom currencies
• Homes
• Warps
• Player Warps
• Chat
• Private messages
• Teleport requests
• Player trading
• TempFly
• Moderation
• Auction House
• Market Orders

Switch servers without leaving your server ecosystem behind.

---

Network Infrastructure

OEssentials supports modern network infrastructure for persistent storage, caching, and real-time communication.

MongoDB

Used for persistent network data across supported modules.

RabbitMQ

Used for real-time communication between servers.

This allows systems such as chat, marketplaces, teleportation, and other network features to communicate between backend servers without relying only on database polling.

Redis

Available for fast caching and network-related data handling.

A single standalone server does not necessarily need the complete network stack. Network infrastructure is primarily intended for installations that want cross-server synchronization.

---

Web Panel

OEssentials can connect your Minecraft network to the Oreo Studios web platform.

This allows supported player and administration systems to extend beyond the Minecraft client itself.

Player Dashboard

Players can access supported information through their browser, including:

• Player profile
• Playtime
• Balance
• Homes
• Warps
• Vault information
• Inventory-related features
• Pending deliveries
• Account information

Server Management

Server owners can access supported administration features including:

• Registered player management
• Network information
• Permission management
• LuckPerms synchronization
• Live server information
• Online configuration
• Administrative tools

---

Online Configuration Editor

Not every server owner wants to spend hours manually editing YAML.

OEssentials provides browser-based configuration tools for supported systems.

Supported editor functionality can include:

• Feature toggles
• Cooldowns
• Permission mappings
• Tier configuration
• Chat formatting
• MiniMessage previews
• Per-world settings
• Dynamic configuration values

Configure supported systems visually and export the resulting configuration for your server.

---

Cleaner File Structure

OEssentials separates administrator-facing configuration from internally managed plugin data.

plugins/OEssentials/
├── config/
│   └── Configuration files you edit
└── data/
    └── Runtime and persistent plugin data

This keeps larger installations much easier to navigate.

---

Auction House

OEssentials includes a complete Auction House system.

Players can list items and browse available listings through a GUI.

On network installations, listings can be shared across servers.

Features include:

• Cross-server listings
• Live GUI updates
• Item categories
• Item search
• Price sorting
• Seller fees
• Buyer taxes
• Configurable listing durations
• Sold item reclaim
• Expired item reclaim
• Discord notifications
• Custom item integration
• Atomic purchase handling

---

Market Orders

The Auction House answers:

"What are players selling?"

Market Orders answer:

"What are players looking to buy?"

For example:

Buying: 64 Diamonds
Price: $150 each

Another player can fulfil that order.

On supported network setups, orders can work between different backend servers.

OEssentials handles the transaction and can use pending delivery systems when the receiving player is offline.

---

Economy

OEssentials includes built-in economy functionality with Vault integration.

Supported functionality includes:

• Player balances
• Player payments
• Balance administration
• Balance leaderboards
• Vault integration
• Network synchronization

The economy can be used by other OEssentials systems such as shops, marketplaces, rewards, and supported server features.

---

Multiple Custom Currencies

Need more than one economy?

OEssentials allows server owners to create additional currencies.

For example:

• Gems
• Tokens
• Credits
• Crystals
• Event Points
• Premium Coins

Each currency can have its own:

• Balance
• Name
• Symbol
• Transfers
• Leaderboards
• PlaceholderAPI placeholders

Supported OEssentials systems can also use custom currencies instead of the primary economy.

---

Modern Chat System

OEssentials includes a configurable chat system suitable for both standalone servers and networks.

Channels can use different scopes depending on who should receive a message.

Available scopes include:

• Global
• Server
• World
• Range
• Shard

This allows you to create channels such as:

• Global
• Local
• Trade
• Help
• Staff
• Administration
• Custom channels

Chat Formatting

Supported functionality includes:

• MiniMessage
• RGB colors
• Gradients
• Hover events
• Click events
• PlaceholderAPI
• LuckPerms groups
• Per-rank formatting
• Item-in-chat
• Cross-server chat
• Discord webhook integration

Private messaging and supported moderation systems can also operate across a network.

---

Homes

A complete home system is built into OEssentials.

Commands include:

• /home
• /sethome
• /delhome
• /homes

Features include:

• Permission-based home limits
• Home GUI
• Administrative access
• Cross-server support

---

Warps

Manage server locations using OEssentials' built-in warp system.

Commands include:

• /warp
• /warps
• /setwarp
• /delwarp

Features include:

• Warp GUI
• Permission-controlled warps
• Cross-server support

---

Player Warps

Players can create and manage their own public locations.

Features include:

• Player-created warps
• Configurable warp limits
• GUI browsing
• Whitelisting
• Administration tools
• Network visibility

---

Teleportation

OEssentials includes the teleportation commands commonly expected from an Essentials-style server core.

Supported systems include:

• /spawn
• /back
• /deathback
• /tpa
• /tpahere
• /tpaccept
• /tpdeny
• /tp
• /tphere
• /rtp
• /top
• /bottom

Cross-server teleportation is available on supported network configurations.

---

Random Teleport

The RTP system includes configurable safe-location searching and permission-based functionality.

Server owners can configure different behavior depending on their setup.

Features include:

• Configurable radius
• Permission tiers
• Safe-location searching
• Network support
• Group RTP functionality

---

Player Vaults

Give players additional personal storage directly through OEssentials.

Features include:

• Multiple vaults
• Permission-based access
• Configurable row sizes
• Rank-based storage
• Per-vault customization
• Cross-server storage
• PlaceholderAPI integration

---

Ender Chest Management

OEssentials can also manage player Ender Chests.

Features include:

• Player Ender Chest access
• Administrative Ender Chest access
• Permission-based sizes
• Rank-based rows
• Cross-server synchronization

---

Kits

Create and manage kits directly through OEssentials.

Features include:

• Unlimited kit setups
• Permissions
• Configurable cooldowns
• GUI browsing
• Cooldown bypass
• PlaceholderAPI support
• Supported custom item integrations

---

Daily Rewards

Reward players for returning to your server.

OEssentials supports configurable daily rewards with cooldown tracking and GUI functionality.

Daily rewards can be used for:

• Currency
• Items
• Commands
• Keys
• Rank-related rewards
• Other configured actions

---

Playtime Rewards

Reward players based on actual playtime.

For example:

1 Hour  -> Starter Reward
10 Hours -> Rare Key
25 Hours -> Currency Reward
50 Hours -> Veteran Reward

Rewards can be configured as one-time milestones or repeatable milestones.

---

Player Trading

OEssentials includes controlled player-to-player trading.

Instead of throwing items on the floor, players can exchange supported items through a dedicated GUI.

Supported network configurations can also provide cross-server functionality.

---

Shop GUI

OEssentials contains built-in shop functionality.

Features include:

• Buy items
• Sell items
• GUI interface
• Vault economy support
• Custom currency support
• Custom item integrations

---

Sell GUI

Players can place supported items inside a GUI and sell them according to your configured prices.

Supported integrations can include custom items from compatible systems such as ItemsAdder and Nexo.

---

Moderation

OEssentials includes a complete collection of common moderation and staff tools.

Features include:

• Ban
• Temporary ban
• Unban
• Kick
• Mute
• Temporary mute
• Unmute
• Warnings
• Warning history
• Punishment history
• Jail
• Freeze
• Vanish
• God mode
• Inventory inspection
• Ender Chest inspection
• Cross-server moderation
• Moderation GUI

Network installations can synchronize supported moderation information between backend servers.

---

Java and Bedrock UI Support

OEssentials is designed to provide modern interfaces for both Java and Bedrock players.

On supported Paper versions, OEssentials can use the native Paper Dialog API for interactive actions instead of relying entirely on inventory GUIs or chat commands.

Paper 1.21.5+ dialog support can be used for supported systems such as:

• Teleport request Accept / Deny
• Homes
• Kits
• Chat Channels
• Confirmation prompts
• Other supported OEssentials interactions

When your server uses GeyserMC, supported Paper dialogs can be presented to Bedrock players as native-style Bedrock forms.

This allows Java and Bedrock players to interact with the same OEssentials systems using an interface appropriate for their client.

Java Edition: Paper Dialog API interfaces.

Bedrock Edition: Geyser-converted Bedrock forms where supported.

Fallback: If the Paper Dialog API is unavailable, supported features can fall back to traditional inventory GUI or text-based interaction.

One server. Two editions. A UI designed for both.

---

Mail System

Players can send mail even when the recipient is offline.

Supported functionality includes:

• Text mail
• Item mail
• Mailbox GUI
• Read state
• Mail deletion
• Administrative broadcast mail

---

TempFly

Give players flight for a limited amount of time.

TempFly can be useful for:

• Rewards
• Ranks
• Events
• Shops
• Temporary perks

On supported network installations, remaining flight time can follow players between servers.

---

AFK System

OEssentials includes AFK detection and management.

Features include:

• Automatic AFK detection
• Manual AFK
• AFK duration
• Optional AFK pool behavior
• Web panel synchronization

---

Holograms

OEssentials contains its own hologram system.

Features include:

• Multiple lines
• PlaceholderAPI
• Display customization
• Visibility handling
• Runtime updates
• API events

---

Portals and JumpPads

Create interactive transportation systems without requiring another general-purpose utility plugin.

Portals

Features include:

• Cuboid regions
• Configurable destinations
• Server transportation functionality

JumpPads

Features include:

• Configurable launch behavior
• Effects
• Transportation utilities

---

Custom Crafting

Create custom recipes directly through OEssentials.

The system includes GUI-based management and support for compatible custom item systems.

---

Interactive Commands

Create interactions tied to blocks and entities.

This allows server owners to build interactive server elements and command-based interactions without having to write a separate plugin for every use case.

---

Developer API

OEssentials provides APIs intended for developers who want to integrate their own plugins with supported OEssentials systems.

Depending on the module, integrations can interact with services exposed by OEssentials rather than directly depending on internal implementation details.

The modular architecture also helps keep public APIs separated from internal feature implementation.

---

Integrations

OEssentials supports integrations with commonly used Minecraft server platforms and APIs.

Supported integrations can include:

• Vault
• PlaceholderAPI
• LuckPerms
• ItemsAdder
• Nexo
• Oraxen
• MythicMobs
• GeyserMC
• Discord webhooks

Integration availability can depend on the OEssentials feature being used.

Make sure any required or optional dependencies for the version you install are also listed in the Dependencies section of the corresponding Modrinth version.

---

Standalone or Network Setup

OEssentials does not require you to run a large network.

You can use it as the primary server core for a standalone server and enable only the systems you want.

For multi-server installations, additional infrastructure can be enabled to provide synchronization and real-time communication.

A typical network setup can use:

                    ┌───────────────┐
                    │    Proxy      │
                    └───────┬───────┘
                            │
             ┌──────────────┼──────────────┐
             │              │              │
        Survival        Skyblock         Lobby
             │              │              │
             └──────────────┼──────────────┘
                            │
                ┌───────────┴───────────┐
                │                       │
             MongoDB                RabbitMQ
                │
              Redis
             optional

MongoDB provides persistent network data.

RabbitMQ provides real-time server-to-server communication.

Redis can provide caching and network-related functionality where configured.

---

Modular Configuration

OEssentials is designed so that you do not have to use every included feature.

Server owners can enable the systems they need and disable systems that are handled by another plugin.

This makes OEssentials suitable for both:

• Servers looking for an all-in-one core
• Existing servers that only want selected OEssentials modules

---

Why OEssentials?

OEssentials is intended for server owners who want a unified platform instead of maintaining a large collection of disconnected server-core plugins.

It provides:

• A large collection of server essentials in one project
• Cross-server functionality designed for networks
• Standalone server support
• Economy and custom currencies
• Auction House and Market Orders
• Homes, Warps and Player Warps
• Player storage
• Chat and messaging
• Moderation tools
• Teleportation
• Rewards
• Trading and shops
• Java and Bedrock-friendly interfaces
• Web-based tools
• Modern Java 21 architecture
• A modular MinecraftModulith-based codebase
• Developer APIs
• Paper and Folia support

Instead of building your server around dozens of unrelated systems, OEssentials provides one platform that can grow alongside your server.

---

Important Installation Information

OEssentials uses Java 21.

Paper is the recommended platform for access to the complete modern feature set.

Some functionality can depend on the server platform, Minecraft version, integrations, or network infrastructure being used.

For cross-server installations, configure the required storage and messaging services before enabling network synchronization.

Always check the dependency information attached to the Modrinth version you are downloading.

---

Support

If you need help configuring OEssentials, setting up network synchronization, or understanding a feature, use the official Oreo Studios documentation and support channels linked on this Modrinth project page.

When reporting an issue, providing your:

• Minecraft version
• Server software and version
• OEssentials version
• Relevant configuration
• Error logs or stack traces

will make troubleshooting significantly easier.

---

AI Usage Disclosure

Generative AI was used as an assistance tool for the publication of this project page.

AI was used to help correct spelling and grammar mistakes, improve wording, organize sections, and make the written description clearer and easier to read.

The information describing OEssentials, including its features, functionality, architecture, integrations, and technical details, originates from and was reviewed by the project author.

Generative AI was not used as the primary creator of OEssentials.

Any images uploaded to this Modrinth project page must comply with Modrinth's rules regarding generative AI and should not be generated or derived from generative AI output.