ELF's Wishlist

Discover the EventsManager plugin, a powerful and flexible tool crafted specifically for Rust game servers. Designed by senyaa  & M&B-Studios, this plugin streamlines the management and scheduling of various in-game events, enhancing player engagement and server dynamics.
 

 
🌟  Features of Events Manager
Multi-Event Support: Seamlessly manage multiple events, each with customizable settings. Customizable Display: Assign distinct names, commands, and colors for UI buttons to each event. Scheduling Flexibility: Schedule events to run on specific days and at designated hours. Administrative Control: Utilize commands to launch events, providing server admins with ultimate flexibility. Enhanced Player Experience: Introduce regular events to boost player engagement within the Rust environment. Random Event Start: Introduce surprise elements by allowing the plugin to randomly select events from a pool. Integration of Facepunch Events: Enjoy a dynamic gameplay experience with popular Facepunch events now included in the plugin.  
🎮  Commands
/em: Set up events, including start time and day. /newevent: Add new events tailored to your preferences, enhancing the versatility of the Event Manager. /newcreator: Easily add new creators to the event manager. eventmanager.convert.v2: Migrates V2 data to V3 (console only)  
💬  Permissions
eventsmanager.use: This permission allows users to access the event management features and open the menu.  
🎥  Video Overview
 
📚  FAQ
Q: Where can I see an example of a config?
A:    Config
Q: Do I need to configure anything special for events?
A: Yes, it's important to disable autostart in your events when using EventsManager. The plugin handles the scheduling and starting of events, so having autostart enabled could cause conflicts or unexpected behavior.

DynamicMonuments is a groundbreaking plugin for Rust servers that breathes new life into your maps!
Say goodbye to tedious manual map editing or relying on RustEdit.
With just a few clicks, your server will be transformed, featuring 18 unique monuments that blend seamlessly into any environment.
 

Key Features:
Dynamic Spawning:
- Monuments can spawn randomly during wipes or with each server restart (optional)
-  Customize spawn frequency and zones through the plugin's configuration
-  A variety of monument complexities, ranging from cozy hideouts to sprawling fortresses
18 Unique Monuments:
- Water Monuments
- Coastal Monuments
- River Monuments
- Roadside Monuments
- Modifications for Standard Monuments: (Metro entrances, power line towers, substations, quarries, and more).
Personalization:
- Give players personal monuments
Versatility:
- Compatible with both custom and procedural maps.
- Automatically adapts to terrain, water, and roads.
- No RustEdit required! Everything is managed through the plugin's configuration.

Giving a monument to a player
9 out of 18 monuments can be given to players for personal placement.
The dynamic monument is represented as a flare with a unique skin, which can be given to players in any way, such as through an in-game store.
To spawn the monument, the player must hold the flare and find a suitable location, receiving instructions in the chat and notifications.
Once placed, the monument is locked to the player, and only they can loot it.
Chat commands (admin only)
/killmonument -    destroys the DynamicMonument you're looking at /replacecrate NewCratePresetName - replaces the crate you're looking at on the location with  NewCratePresetName /spawnmonument  PresetName -  spawns a monument in a random position /spawnmonumentmypos PresetName -  spawns  the monument in your position /killallmonuments -  destroys all DynamicMonuments on the server /respawnmonuments -  forcibly launches automatic respawn of DynamicMonuments /givemonument  PresetName -  give the monument to yourself /addprefabspawnpoint PresetName — adds a crate or static NPC spawn point to a monument at your current position   (only for Static Npc and crates) /removemonumententity command — removes  entity spawn point you're looking at. (only for StaticNpc/crates/Entities for respawn) Console commands (RCON only)
spawnmonument  PresetName -  spawns a monument in a random position killallmonuments - destroys all DynamicMonuments on the server respawnmonuments -    forcibly launches automatic respawn of DynamicMonuments givemonument PresetName userID -  give the DynamicMonument to the player Plugin Config
en  –  example of plugin configuration in English ru  –  example of plugin configuration in Russian  
Check out the rest of my work:  Adem's Codefling Library
You can reach out to me in Discord:  Adem's Discord Profile
Join the Mad Mappers Discord!

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. Two reward systems: post-wipe awards that give actual items, kits, and money to top players when they connect, plus an optional companion plugin UltimateLeaderboardTop for real-time privilege management based on current rankings. Custom Titles system that automatically displays achievement-based chat titles for top performers (requires BetterChat plugin). 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 - Allows players to hide themselves from the leaderboard (requires ultimateleaderboard.hide.self permission). leaderboard.manage 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). leaderboard.find.short.prefab <search_term>  - Console command to search for prefabs containing the specified search term (server console only). Useful for finding correct prefab names for configuration. leaderboard.manage  - Console command to manage player statistics (server console only). Use leaderboard.manage help for detailed usage information.  
🛡️ Permissions
ultimateleaderboard.use - grants players access to leaderboard commands and interface. ultimateleaderboard.profile  - allows players to view other players' profiles using the leaderboard command. ultimateleaderboard.hide.self  - allows players to hide themselves from the leaderboard using the /leaderboard.hide 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.
Q: What's the difference between UltimateLeaderboard awards and UltimateLeaderboardTop?
A: UltimateLeaderboardTop is a companion plugin that automatically manages player privileges based on leaderboard positions.
Main Plugin Awards: Gives actual rewards (kits, money, commands) to top players after wipe - rewards are given once when player connects. UltimateLeaderboardTop: Continuously manages privileges (VIP groups, permissions) as players enter/exit top positions in real-time. To display awards in UI while using UltimateLeaderboardTop:
Configure awards in UltimateLeaderboard config Configure awards in UltimateLeaderboardTop config Set "Wipe data on new save": false Q: Can UltimateLeaderboardTop give items/kits to players?
A: No, UltimateLeaderboardTop is designed only for reversible actions (permissions, groups, etc.). Since items can't be taken back from players when they leave top positions, item rewards are not supported. Use the main plugin's awards system for item rewards instead.
Q: How do I configure rewards for top players?
A: There are two reward systems available:
UltimateLeaderboard Awards (Post-Wipe Rewards):
Configure in the main plugin's config file under "Awards Settings":
Set award categories (e.g., "Most Kills", "Top Gatherer") Define criteria: loot type, prefab, and minimum amount required Set rewards: commands to execute (give items, kits, money, etc.) Awards are given once when top players connect after a wipe UltimateLeaderboardTop (Real-time Privileges):
Configure in UltimateLeaderboardTop.json:
Set leaderboard types to monitor (kills, points, playtime, etc.) Define top positions (1st, 2nd, 3rd, etc.) Configure "Enter place commands" (given when player reaches position) Configure "Exit place commands" (executed when player loses position) Use for permissions, groups, temporary privileges Example UltimateLeaderboardTop configuration:
{   "Loot type": "Kill",   "Prefab": "kills",   "Places settings": {     "1": {       "Enter place commands": ["o.usergroup add %steamid% vip"],       "Exit place commands": ["o.usergroup remove %steamid% vip"]     }   } } Q: What are Custom Titles and how do they work?
A: Custom Titles automatically display achievement-based titles in chat for top players. For example, top killers get "[Killer]" title, top builders get "[Builder]" title, etc. Requires BetterChat plugin to work. Titles are updated automatically based on leaderboard positions and can be configured with priority system and limits.
Q: Why don't I see my statistics updated immediately on the leaderboard?
A: The leaderboard is cached and refreshes periodically (configurable interval) to minimize server load and ensure optimal performance. This means statistics may take a few minutes to appear on the leaderboard after the action is performed. The caching system helps maintain smooth server operation even with large player bases and extensive statistics tracking.
Q: How can I track multiple similar items or entities with one statistic?
A: You can combine multiple prefabs using the pipe symbol | in the prefab field. For example, to track all types of scientists as one "NPC Kills" statistic, use: npc_tunneldweller|npc_underwaterdweller|scientistnpc_arena|scientistnpc_bradley. This is useful for grouping similar items, resources, or entities into a single tracked category.
Q: How do I find the correct prefab names for items, entities, or events?
A: There are several ways to find prefab names:
In-game console command: Use leaderboard.find.short.prefab <search_term> in the server console to search for prefabs containing your search term. For example: leaderboard.find.short.prefab scientist will show all prefabs containing "scientist". F1 console spawn command: In-game, open F1 console and use the spawn command to see available entity prefabs. Type spawn followed by part of the name to see matching options. Item shortnames: For items, use their shortname (e.g., "stones", "metal.ore", "wood"). You can find these by examining items in your inventory or using item-related commands. Plugin documentation: Check the "Custom Prefabs" and "Available Loot Types" sections in this plugin's description for comprehensive lists of supported prefabs and loot types. Q: How can I output the sum of all values by type of statistics (for example, all kills, all loot collected)?
A: Use the prefab total_sum for the desired LootType. For example, to show the total number of all player kills, specify the LootType Kill and the prefab total_sum in the column or block settings. It works for any type: Kill, Gather, Craft, Event, and others.
 
💻 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 formatted_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 total_sum - Sum of all values for the selected LootType. For example, using total_sum with LootType Kill will show the total number of all kills for the player (across all kill categories). Works for any LootType: Kill, Gather, Craft, Event, etc.  
📊 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 PaintballTeam PaintballFFA GunGame ZombieInfection TugboatPirates SpaceEvent AbandonedBase DungeonEvent FlyingCargoEvent Gather Kill
Available custom prefabs: helisignals_{skin} - Tracks helicopter kills from HeliSignals (e.g., "helisignals_2920175997") bradleydrops_{skin} - Tracks bradley kills from BradleyDrops (e.g., "bradleydrops_2905355269") roadbradley_{profile} - Tracks bradley kills from RoadBradley (e.g., "roadbradley_easy") 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
Available custom prefabs: 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.) 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 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 Trivia  
📡 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.