🖥️ Server Owner Guide

This guide walks you through registering your Minecraft server on the OreoStudios panel, installing the plugin, and enabling all live features. Follow every step in order.

Requirements

Requirement	Notes
Minecraft server	Paper / Purpur 1.20+
OreoEssentials plugin	The plugin that connects your server to the panel
RabbitMQ server Optional	Required only for live inventory sync. If you skip this, the panel updates on a delay instead.
Panel account	Register at `oreostudios.fr/panel-login.html`

Step 1 — Register Your Server

1 Create a panel account

Go to oreostudios.fr/panel-login.html and create an account if you don't have one. Use an admin email you control.

2 Open the Owner Panel

After logging in, click your username in the top-right corner and select Owner Panel. This is the admin area only visible to server owners.

3 Register a new server

Click Add Server (or the + button). Fill in:

Server Name — the name players will see (e.g. My Survival SMP)
Server IP — your Minecraft server's public IP or hostname
Description — optional short description

Click Register. Your server will appear in the owner panel list.

4 Copy your API Key

Once registered, the panel shows you an API Key. It looks like:

sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Copy this key — you'll need it in the next step. Keep it secret. Anyone with this key can send data to your server's panel entry.

⚠️ Never share your API key publicly (no GitHub repos, no Discord messages). If it leaks, regenerate it from the owner panel.

Step 2 — Install OreoEssentials

1 Download the plugin

Get OreoEssentials.jar from your purchase or the OreoStudios panel download page.

2 Drop it in your plugins folder

Place OreoEssentials.jar into your server's /plugins/ directory.

3 Start (or restart) the server

The plugin will generate its config files in plugins/OreoEssentials/. You'll see it load in the console.

Step 3 — Configure the API Key

Open plugins/OreoEssentials/config.yml in any text editor. Find the web-panel section:

# ── Web Panel ───────────────────────────────────────
web-panel:
  enabled: true
  url: "https://oreostudios.fr"   # Leave as-is unless self-hosting
  api-key: "sk_live_xxxxxxxxxxxxxxxxxxxxxxxx"   # ← Paste your API key here

What each setting does

Setting	What it does
`enabled: true`	Turns the web panel sync on. Set to `false` to disable completely.
`url`	The web panel URL. Leave as `https://oreostudios.fr` unless you self-host.
`api-key`	Your secret API key from the owner panel. Required.

After saving the file, run /oe reload in your server console or restart the server.

✅ Verify it works: Check your server console for a line like:
[OreoEssentials] Web panel sync enabled. Server registered successfully.

Step 4 — Set Up RabbitMQ (Live Sync)

RabbitMQ is what makes inventory updates instant. Without it, data syncs every few seconds instead of in real-time. This step is optional but highly recommended.

ℹ️ What is RabbitMQ? It's a message broker — think of it as a very fast post office that delivers tiny messages between your Minecraft server and the web panel instantly. Each server owner runs their own RabbitMQ instance.

1 Install RabbitMQ

If you're using Pterodactyl, install a RabbitMQ egg. Otherwise, install it on your VPS:

apt install rabbitmq-server -y
rabbitmq-server start

Default port is 5672. The default login is guest / guest on localhost only.

2 Create a dedicated user

For security, create a new RabbitMQ user instead of using the default:

rabbitmqctl add_user myuser mysecretpassword
rabbitmqctl set_permissions -p / myuser ".*" ".*" ".*"

3 Add your RabbitMQ URI to the Owner Panel

In the owner panel, open your server's settings and find the RabbitMQ URI field. Enter your connection string:

amqp://myuser:mysecretpassword@your-server-ip:5672/

Save. The panel will test the connection and show a green ✓ if it works.

4 Add the same URI to OreoEssentials config

In plugins/OreoEssentials/config.yml, find the rabbitmq section:

rabbitmq:
  enabled: true
  uri: "amqp://myuser:mysecretpassword@your-server-ip:5672/"

Run /oe reload or restart. Your server console should show:
[OreoEssentials] RabbitMQ connected. Live sync active.

✅ Test it: Open the panel in your browser, log in, and join the Minecraft server. Break a block or pick up an item — the live inventory in the browser should update within 1–2 seconds. Look for the green ● LIVE badge in the inventory section.

Step 5 — Using the Owner Panel

The Owner Panel is your server admin dashboard. Access it by clicking your username → Owner Panel.

Feature	What it does
📋 Player List	See all players linked to your server with their status
🔑 API Key	View or regenerate your server API key
🐇 RabbitMQ URI	Set your RabbitMQ connection string for live sync
📦 Give Item	Send any item directly to a player's inventory
🗑️ Take Item	Remove a specific item from a player's inventory
🔨 Ban Player	Ban a player from your server via the panel
👢 Kick Player	Kick a currently online player
📣 Broadcast	Send a notification to all players on your server
📊 Market Orders	View all active market listings on your server

Step 6 — Admin Features In Detail

📦 Give an Item to a Player

From the Owner Panel → Player detail → click Give Item:

Enter the Minecraft item ID (e.g. minecraft:diamond)
Set the quantity
Click Send

The item is queued as a pending delivery. When the player joins the server (or is already online), it lands in their inventory automatically.

🗑️ Take an Item from a Player

Click Take Item on a player's detail page. Select the item from their live inventory view and confirm. The item is removed next time their inventory syncs.

🔨 Ban / Kick

On the player detail page, use the Ban or Kick button. Banning records the ban in the panel and sends a command to the Minecraft server via the plugin. The player is kicked immediately if online.

📣 Broadcast a Message

From the server overview in the Owner Panel, click Broadcast. Type your message and click Send. All currently-online players on your server receive a notification in the panel and an in-game message.

FAQ

Do I need RabbitMQ?

No — but without it, inventory updates are delayed (the plugin sends updates periodically instead of instantly). For the best experience, set up RabbitMQ.

A player linked their account but I can't see them in my owner panel

The player must have linked while on your server. If they used a different server's /weblink code, they're linked to that server. Have them run /weblink while on your server.

My API key stopped working after I regenerated it

Update the key in plugins/OreoEssentials/config.yml on your Minecraft server and reload with /oe reload.

The RabbitMQ connection keeps failing

Check: (1) the URI format is correct amqp://user:pass@host:port/, (2) port 5672 is open in your firewall, (3) the user has permissions set with rabbitmqctl set_permissions.

How do I remove a server from the panel?

In the Owner Panel, open the server settings and click Delete Server. This removes all linked players and data for that server. This cannot be undone.

← Player Guide Next: All Features →