OmegaRichest

Keep your Discord community up to date with the richest players on your Minecraft server!

OmegaRichest automatically retrieves player balances through Vault and publishes regularly updated leaderboards directly to your Discord server. With support for popular economy plugins such as EssentialsX and CMI, setup is simple and maintenance-free.

━━━━━━━━━━━━━━━━━━━━

✨ Features

Automatic Leaderboards

Automatically publishes updated leaderboards every 10, 15, 30 or 60 minutes, with posts aligned to the hour.

Customisable Discord Messages

Choose between rich Discord embeds or plain text messages. Customise titles, descriptions, footers and embed colours.

Custom Rank Formatting

Give the top three players special medal formatting (), with separate formatting for all remaining leaderboard positions.

Player & Rank Filtering

Exclude server operators and specific Vault permission groups, such as Admin or OP, from appearing on the leaderboard.

️
Custom Webhook Identity

Customise the webhook's display name and avatar to match your server's branding.

Timezone Support

Configure your preferred timezone for scheduled posts and the {time} placeholder.

Instant Test Command

Send a test leaderboard to your Discord webhook instantly to preview your configuration before going live.

⚙️
Fully Configurable

Customise all in-game messages, Discord content, formatting and plugin settings through YAML configuration files. No hardcoded player-facing messages.

━━━━━━━━━━━━━━━━━━━━

Commands

Command
Description

/omegarichest Displays the main command information.

/omegarichest status Shows the broadcaster status and next scheduled post.

/omegarichest test Immediately sends a test leaderboard to Discord.

/omegarichest reload Reloads all configuration files without restarting.

Aliases: /orich, /richest, /baltop

Permission: omegarichest.admin

Default Access: Server Operators

━━━━━━━━━━━━━━━━━━━━

Installation

Getting started with OmegaRichest only takes a few minutes!

1. Install the Plugin

Download OmegaRichest.jar and place it inside your server's plugins folder. Restart your server to generate the configuration files.

1. Create a Discord Webhook

Navigate to your chosen Discord channel:

Edit Channel → Integrations → Webhooks → New Webhook

Create your webhook and copy its URL.

1. Configure OmegaRichest

Open plugins/OmegaRichest/config.yml and paste your webhook URL into the webhook-url option.

1. Test Your Configuration

Run /omegarichest test in-game to send a test leaderboard to your Discord channel.

1. You're Ready!

Your leaderboard will automatically begin posting according to your configured schedule.

━━━━━━━━━━━━━━━━━━━━

Requirements

• Server Software: Paper or Spigot
• Minecraft Versions: 1.16+
• Dependencies: Vault
• Economy Plugins: EssentialsX, CMI or another Vault-compatible economy plugin.

━━━━━━━━━━━━━━━━━━━━

Documentation

⚙️ Configuration Files

OmegaRichest uses three YAML configuration files, each responsible for a different part of the plugin.

config.yml

Scheduling, general settings and plugin behaviour.

Option
Description

enabled Enables or disables automatic leaderboard posting. Test commands remain available when disabled.

interval-minutes Sets the posting interval: 10, 15, 30 or 60 minutes.

top-count Maximum number of players displayed (1–10).

exclude-operators Excludes server operators from the leaderboard.

excluded-ranks Excludes specified Vault permission groups, such as Admin or OP.

timezone Sets the timezone used for scheduling and time placeholders. Supports server-default or any valid Java ZoneId.

webhook-username Overrides the Discord webhook's display name.

webhook-avatar-url Overrides the Discord webhook's avatar.

message-style Selects the message format: EMBED or PLAIN.

embed-color Sets the Discord embed accent colour.

gather-on-main-thread Forces economy data collection onto the main server thread. Only enable if your economy plugin requires it.

webhook.yml

Discord message content and leaderboard formatting.

Controls exactly how your leaderboard appears in Discord.

Supported Message Formats:

• Rich Discord embeds.
• Plain text messages.
• Custom titles, descriptions and footers.
• Discord Markdown formatting.

Available Placeholders:

Placeholder
Description

{count} Total number of players displayed.

{lines} All formatted leaderboard entries.

{time} Current time using your configured timezone.

Leaderboard Line Formatting:

Option
Description

line-format Default formatting applied to leaderboard entries.

line-formats Individual formatting overrides for specific leaderboard positions.

Available Line Placeholders:

Placeholder
Description

{rank} Player's leaderboard position.

{player} Player's Minecraft username.

{balance} Player's current Vault balance.

Custom Rank Examples:

You can give the top three players their own unique formats using medal emojis:

First Place

Second Place

Third Place

All remaining positions can use your default line-format.

messages.yml

In-game messages and command responses.

Contains all player-facing messages used throughout OmegaRichest, including:

• Command help information.
• Success and error messages.
• Reload confirmations.
• Broadcaster status information.
• Test command responses.
• Permission messages.

All messages can be customised to match your server's branding.

━━━━━━━━━━━━━━━━━━━━

Helpful Tips

Discord Formatting

Minecraft colour codes are not supported by Discord webhooks. Instead, use Discord Markdown:

• Bold Text
• Italic Text
• Inline Code
• > Blockquotes

Preview Your Changes

After editing webhook.yml, run /omegarichest test to instantly preview your changes in Discord.

⏰ Consistent Scheduling

OmegaRichest uses hour-aligned scheduling rather than simply waiting for a set amount of time after startup.

For example, with a 15-minute interval, posts will always be scheduled for:

12:00 → 12:15 → 12:30 → 12:45

This prevents scheduling drift and keeps your Discord leaderboard consistent.

No Restart Required

Configuration changes can be applied using /omegarichest reload. There is no need to restart your Minecraft server.

━━━━━━━━━━━━━━━━━━━━

Developed by Omega Plugins

━━━━━━━━━━━━━━━━━━━━

IMAGES:

Webhook