ELF's Wishlist

Adds a referral system to the game. Players can invite other players and receive rewards for this.
 
Commands
referal - open interface promo [promocode] -  activate promo code  
Permissions
You can set permission in config, for example:  
"Permission (example: referrals.use)": "referrals.use",  
Hooks
private void OnPromoCodeActivated(BasePlayer player, string promocode)  
API
private string GetPromoCode(BasePlayer member) private string GetPromoCode(string member) private string GetPromoCode(ulong member)  
Config
{ "Commands": [ "ref", "referal" ], "Commands to activate the promo code": [ "promo", "code" ], "Permission (example: referrals.use)": "", "Work with Notify?": true, "Use auto-wipe?": false, "Promo Code Chars": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", "Promo Code Length": 8, "Awards": [ { "Invites Amount": 1, "Type": "Item", "ID": 1, "Image": "", "Title": "", "Command (%steamid%)": "", "Plugin": { "Hook": null, "Plugin name": null, "Amount": 0 }, "Display Name (empty - default)": "", "ShortName": "wood", "Skin": 0, "Amount": 20000, "Chance": 70.0 }, { "Invites Amount": 2, "Type": "Item", "ID": 2, "Image": "", "Title": "", "Command (%steamid%)": "", "Plugin": { "Hook": null, "Plugin name": null, "Amount": 0 }, "Display Name (empty - default)": "", "ShortName": "stones", "Skin": 0, "Amount": 15000, "Chance": 70.0 }, { "Invites Amount": 5, "Type": "Item", "ID": 3, "Image": "", "Title": "", "Command (%steamid%)": "", "Plugin": { "Hook": null, "Plugin name": null, "Amount": 0 }, "Display Name (empty - default)": "", "ShortName": "leather", "Skin": 0, "Amount": 2400, "Chance": 55.0 }, { "Invites Amount": 7, "Type": "Item", "ID": 4, "Image": "", "Title": "", "Command (%steamid%)": "", "Plugin": { "Hook": null, "Plugin name": null, "Amount": 0 }, "Display Name (empty - default)": "", "ShortName": "cloth", "Skin": 0, "Amount": 2300, "Chance": 55.0 }, { "Invites Amount": 10, "Type": "Item", "ID": 5, "Image": "", "Title": "", "Command (%steamid%)": "", "Plugin": { "Hook": null, "Plugin name": null, "Amount": 0 }, "Display Name (empty - default)": "", "ShortName": "lowgradefuel", "Skin": 0, "Amount": 1500, "Chance": 50.0 } ] }  
 
FAQ
Item as kit

Introducing UltimateLeaderboard, the most advanced and comprehensive leaderboard system designed for Rust servers! Elevate your server competitive spirit by tracking an extensive range of player statistics—everything from kills and deaths to resources gathered, items crafted, structures built, and more. Featuring a sleek, customizable user interface and seamless integration with popular plugins, UltimateLeaderboard is the perfect addition to engage your players and showcase their achievements.
 

 
⭐ Features of Ultimate Leaderboard
Track a wide variety of player statistics, including kills, deaths, resources gathered, items crafted, structures built, and more. Fully customizable leaderboard—choose which stats to display and tailor it to your server unique style. Intuitive and visually appealing user interface for players to view their stats and compare rankings. Seamless integration with plugins like ServerPanel for enhanced displays, and Notify/UINotify for in-game alerts. Flexible data storage options: choose between JSON, SQLite, or MySQL to suit your server needs. Built-in awards system to reward top-performing players across various categories. Optimized for high performance, ensuring smooth operation even with large player bases and extensive data.  
🖼️ Showcase
Fullscreen Template

ServerPanel V1 (V1.1)

ServerPanel V2

 
📨  Video Overview
 
🎮 Commands
/leaderboard or /stats - Opens the leaderboard interface for players to view stats and rankings. /leaderboard <steamid>  - Opens another player's profile (requires ultimateleaderboard.profile permission). leaderboard.hide <steamid>  - Console command to hide a player from the leaderboard (server console only). leaderboard.wipe  - Console command to reset all leaderboard data (server console only). leaderboard.migrate <migration_id>  - Console command to perform database migrations (server console only).  
🛡️ Permissions
ultimateleaderboard.use - grants players access to leaderboard commands and interface. ultimateleaderboard.profile  - allows players to view other players' profiles using the leaderboard command.  
⚙️ Web Config Editor
Easily manage your UltimateLeaderboard settings with our web-based configuration editor. This tool allows you to adjust plugin configurations through a user-friendly interface, eliminating the need to manually edit files on your server.

P.S. To access the web config editor, you must be part of the "UltimateLeaderboard" group in our Discord server. Join us at https://discord.gg/mevent and request the group to get started.
 
📚 FAQ
Q: How do I install UltimateLeaderboard?
A: Download the UltimateLeaderboard.cs file, place it in your oxide/plugins directory, and restart your server or reload the plugin using the Oxide command oxide.reload UltimateLeaderboard.
Q: Can I choose which statistics to track and display?
A: Yes! The plugin allows you to customize tracked statistics and leaderboard displays via the configuration file. You can enable or disable specific stats like kills, resources, or events to suit your server.
Q: What data storage options are available?
A: UltimateLeaderboard supports JSON, SQLite, and MySQL. You can select your preferred storage method in the config file, offering flexibility for small or large servers.
Q: How do I set up the awards system?
A: In the configuration file, define award categories (e.g., most kills, top gatherer) and their criteria. The plugin will automatically track and assign awards to top players based on your settings.
Q: What happens to the data on a server wipe?
A: By default, data wipes with a new save file, but you can disable this in the config (Wipe data on new save) to persist stats across wipes if desired.
Q: I see black images with Rust logo or get error 429 when loading images. What should I do?
A: These issues occur when there are problems downloading images from the internet. To fix this, enable Offline Image Mode which will use local images instead:
Enable the mode in config: Open "oxide/config/UltimateLeaderboard.json" (or "carbon/config/UltimateLeaderboard.json" for Carbon) Set "Enable Offline Image Mode": true Set up the images: Create folder "TheMevent" in "oxide/data" (or "carbon/data" for Carbon) Download PluginsStorage (click "CODE" → "Download ZIP") Extract the ZIP and copy all contents to the "TheMevent" folder Reload the plugin: Type o.reload UltimateLeaderboard (Oxide) or c.reload UltimateLeaderboard (Carbon) Note: If using a hosting service, you may need to use their file manager or FTP to upload the files.
 
💻 Custom Prefabs
UltimateLeaderboard supports advanced custom prefabs for granular statistics tracking and display:
total_play_time - Total playtime (in seconds) current_playtime - Current session duration kdr - Kill/Death ratio points - Internal points system longest_kill_distance - Longest kill distance record total_hits - Total player hits total_resources - Total resources gathered total_items_crafted - Items crafted events_won - Event victories structures_built - Structures built upgrades_performed - Building upgrades name/nickname - Player display name formatеed_total_playtime - Human-readable playtime (Xd Xh Xm) kd - K/D formatted as "Kills/Deaths" favorite_resource - Most gathered resource favorite_crafted_item - Most crafted item favorite_event - Most won event favorite_building_material - Preferred building material favorite_weapon - Most used weapon total_quests_completed - Total completed quests  
📊 Available Loot Types
None Construction Medical Event
Available prefabs: Convoy Sputnik Caravan GasStationEvent AirEvent SatDishEvent Triangulation WaterEvent HarborEvent FerryTerminalEvent ArcticBaseEvent JunkyardEvent SupermarketEvent PowerPlantEvent ArmoredTrainEvent SurvivalArena KillBoss Gather Kill
Available prefabs: helisignals_{skin} - Tracks helicopter kills from HeliSignals (e.g., "helisignals_2920175997") bradleydrops_{skin} - Tracks bradley kills from BradleyDrops (e.g., "bradleydrops_2905355269") helicopter - Tracks helicopter kills Custom NPC support: horde_npc - For NPCs from ZombieHorde plugin raidbase_npc - For NPCs from Raidable Bases plugin For NPCs from NpcSpawn use NPC name as key (BossMonster, BetterNpc, NPCs from events, etc.) Other entity prefabs can be found in-game by using the "spawn" command in the F1 console Consume Raid Death Craft Crate LootItems Fishing Puzzle
Available prefabs: keycard_1 keycard_2 keycard_3 Custom Upgrade ShotFired ExplosiveUsed RecycleItem BodyHits WeaponUsed RaidableBases
Available prefabs: easy medium hard expert nightmare points random Economy
Available prefabs: ShoppyStock Economics IQEconomic Quest EconomyBalance
Available prefabs: Economics ServerRewards BankSystem IQEconomic Gambling
Available prefabs: BlackjackDeposit BlackjackWon SlotDeposit SlotWon PockerDeposit PockerWon WheelDeposit WheelWon SkillTree
Available prefabs: xp - Experience points earned level - Skill tree level reached  
📡 API for Developers
UltimateLeaderboard provides a comprehensive API for developers to integrate with other plugins and extend functionality:
📊 Methods
JArray API_GetUltimateLeaderboardUsers(int offset, int limit, int? columnIndex = null) - Get leaderboard users with pagination float API_GetPlayerStat(ulong playerId, string lootType, string shortname) - Get specific player statistic bool API_IsHiddenFromLeaderboard(ulong playerId) - Check if player is hidden from leaderboard void API_OnItemGather(ulong player, string shortname, int amount) - Add gather statistics for a player void API_OnEventWin(ulong userID, string eventName, int amount = 1) - Record event wins for a player 🎣 Hooks
void OnUltimateLeaderboardContent(BasePlayer player, string categoryType, CuiElementContainer container) - Called when displaying custom category content void OnUltimateLeaderboardCached() - Called when leaderboard data is cached and ready

THIS TOOL REQUIRES A BATTLEMETRICS RCON SUBSCRIPTION
 
📌 Overview
The BattleMetrics Moderation Bot    is designed to allow trial staff to submit mutes, kicks, bans, and lift bans without requiring full access to BattleMetrics  or other moderation tools.  
How It Works:
- Trial staff submit moderation actions through Discord forms.  
- Actions remain pending for approval  until reviewed by verified staff.  
- Verified staff can accept, deny, or create a discussion thread  for further review.  
- The bot integrates exclusively with BattleMetrics  and requires a BattleMetrics RCON Subscription  to function.  
Additional Features:
- All bot actions are logged  in a dedicated Logs  folder for full transparency and record-keeping.  
- Uses BattleMetrics API  to ensure secure and efficient moderation.  
If you need assistance, contact bxcas  on Discord.
---
🔧 Configuration Settings for BattleMetrics Moderation Bot
This section explains each configuration setting in the config.json  file, what it does, and where to find the necessary values.
---
🛠️ Discord Configuration
The discord  section contains the bot's authentication details, server settings, and channels for admin messages.
"discord": {   "clientId": "BOT CLIENT ID",   "token": "BOT TOKEN",   "guildId": "DISCORD SERVER ID",   "channels": {     "message": "ADMINS CHANNEL ID",     "request": "TRIAL CHANNEL REQUEST ID"   },   "roles": {     "trialStaff": ["TRIAL STAFF ROLE ID 1", "TRIAL STAFF ROLE ID 2"],     "seniorStaff": ["SENIOR STAFF ROLE ID 1", "SENIOR STAFF ROLE ID 2"]   } } 🔍 Where to Find These Values?

---
🛡️ BattleMetrics Configuration (battlemetrics)
This section contains settings related to BattleMetrics, which is used for managing bans and tracking players.
"battlemetrics": {   "organizationId": "BATTLEMETRICS ORGANIZATION ID",   "banListId": "BATTLEMETRICS BAN LIST ID",   "apiToken": "BATTLEMETRICS API TOKEN" }
🔍 Where to Find These Values?

🌐 Server Configuration (servers)
This section defines the Rust servers managed by the bot.
"servers": [   {     "name": "SERVER NAME",     "id": "SERVER ID"   } ] 🔍 Where to Find These Values?
 

---
🔥 Example Full Configuration
{   "discord": {     "clientId": "123456789012345678",     "token": "YOUR_DISCORD_BOT_TOKEN",     "guildId": "987654321098765432",     "channels": {       "message": "123456789012345678",       "request": "876543210987654321"     },     "roles": {       "trialStaff": ["123456789012345678", "234567890123456789"],       "seniorStaff": ["345678901234567890", "456789012345678901"]     }   },   "battlemetrics": {     "organizationId": "112233",     "banListId": "445566",     "apiToken": "your_battlemetrics_api_token"   },   "servers": [     {       "name": "Main Rust Server",       "id": "999999"     },     {       "name": "Test Server",       "id": "888888"     }   ] }
---
🚀 Installation Guide - BattleMetrics Moderation Bot
📌 Requirements
To run the bot, you need a machine with:  
- A server or hosting environment  (e.g., a VPS, dedicated machine, or a Pterodactyl Egg).  
- Node.js installed  (recommended: latest LTS version => 22).  
---
📌 Installation Steps
1️⃣ Ensure Node.js  is installed on your machine.  
2️⃣ Place the bot files in your preferred directory.  
3️⃣ Open a terminal or command prompt in the bot’s directory.  
4️⃣ Run the following command to install dependencies:  
 
npm install
5️⃣ Start the bot by running:
node .  
The bot will now run without any issues.
---  
📌 Logs
A Logs folder will be created automatically.
All bot activity and errors will be logged inside this folder.
Support
If you need assistance, contact `bxcas` on Discord.

Simple script to manage multiple pop bots and a global one for rust game servers in discord
 
NB : If your not using a bot container :
You will need to install python and git (must be 3.7+)
(https://www.youtube.com/watch?v=XF_rklW9XkU&ab_channel=CBTNuggets)
 
1. Go to https://discord.com/developers/applications, create a new bot application
2. Go to O2Auth - > URL Generator -> Select bot & invite the bot to your discord
3. Go to BOT -> reset token -> input token in the config
 
Example Config
{ "RefreshRate":10, "GlobalBotDiscordToken":"", "Servers":[ { "name":"server_name_1", "ip":"168.100.161.191", "rcon_port":28065, "rcon_password":"", "discord_bot_token":"" }, { "name":"server_name_2", "ip":"168.100.161.191", "rcon_port":28085, "rcon_password":"", "discord_bot_token":"" } ] } 5. Input your rust game info, serverip, rcon port and password
6. Install requirements run **pip install -r requirements.txt** in your console
7. Run the main.py file to run the script
 
NB - The server names must be unique for the script to work
Suggested hosts -> https://serverstarter.host/ or anything offering a simple bot container - Python is key!

This file is a PREFAB, does not include any maze plugin.

this prefab supports a maze arena / built in walls custom made, and community liked for pvp / modded servers. Used in Aspect Rust and Dusk Offwipe the people love it. Tons of pvp walls, but also funnels and a great opportunity for people to have a great time.

if you need support please contact me via discord: Zirixy#0001 or https://discord.gg/ZZ5WSpkr2A

The reason for the high price is it took time, and heart making this also having been used in many big servers and so many people love. Set at a high price for not to be given away and bought by trusted / wanted customers. I will be releasing multiple varients. + A maze plugin compatible for it soon! Join our discord to be ready for that:  https://discord.gg/ZZ5WSpkr2A



© 2025 Zirixyrust. All rights reserved. Website design and content are protected by copyright law. If stolen can, and will result in legal action.