About King & Mercenary PVP Event
King and Mercenary - Dynamic PvP Event Plugin for Rust
Take your Rust server to the next level with King and Mercenary, an immersive PvP event system that introduces a competitive battlefield where players fight to claim dominance. This plugin enhances player engagement by rewarding skill, survival, and strategy.
Two Unique Roles: King & Mercenary
-
King: Gains extra health and periodic rewards while holding the throne. Location is periodically revealed, challenging them to defend their title.
-
Mercenary: Deals extra damage and earns rewards for hunting down the King and other opponents.
Key Features:
Dynamic Role System – Players fight to become the King or Mercenary, each with unique buffs and rewards.
Automated Events – Set custom intervals and conditions for role rotation, cooldowns, and eligibility.
Killstreak Bonuses – Players earn extra rewards for consecutive eliminations.
Live Map & Location Broadcasts – The King’s position is periodically revealed to intensify the hunt.
Death Markers - The king's or mercenary's death location will be displayed on the map using a vending machine marker.
Customizable Rewards – Configure item rewards, time intervals, and kill-based bonuses.
Discord Integration – Send automated updates when players claim or lose a role.
Full Admin Control – Set permissions, debug settings, and event restrictions.
Zone Management & Compatibility – Fully compatible with Zone Manager, allowing servers to restrict the event to specific areas. All Zone Flags from Zone Manager can be applied for complete control over event rules and mechanics.
Perfect for high-action Rust servers looking to add competitive, role-based combat with real incentives. Get King and Mercenary today and create legendary battles on your server!
Available Commands
-
/kam set <king | mercenary | all> <SteamID64> – Manually assigns a player the King or Mercenary role using their SteamID64. Use all to assign both roles at once.
-
/kam reset <king | mercenary | all> – Resets the specified role, removing the King, Mercenary, or both from the server.
-
/kam info – Displays current event details, including who holds the King and Mercenary roles.
-
/kam stats – Shows player statistics related to the event, such as kill counts, survival time, and streaks.
Available Placeholders for Discord Embed
- {victim} – Displays the name of the player who was defeated.
- {role} – Shows the role of the defeated player (e.g., King or Mercenary).
- {attacker} – Displays the name of the player who eliminated the victim.
- {kills} – Shows the total number of kills the victim had before dying.
- {killStreak} – Indicates the victim's current kill streak before they were eliminated.
- {duration} – Represents the total time the victim held their role before being defeated.
- {attribute} – Displays the special attribute of the role (e.g., extra health for King or damage multiplier for Mercenary).
- {position} – Shows the location where the battle took place.
- {hp} – Displays the remaining health of the attacker after defeating the victim.
API For Developers
/* * Returns true if the specified user has the King role, otherwise false. */ public bool HasKingRole(string userID) /* * Returns true if the specified user has the Mercenary role, otherwise false. */ public bool HasMercenaryRole(string userID)
Default Configuration
{ "General Settings": { "Minimum players needed for event": 5, "Cooldown hours between becoming king/mercenary": 6, "Can have both roles": true, "Enable debug messages": false, "Update info interval (minutes)": 1, "Exclude admins": true, "Chat command": "kam", "Permissions": { "Admin": "kingandmercenary.admin", "BypassCooldown": "kingandmercenary.bypasscooldown" } }, "Messages Settings": { "Display Name for Chat Messages": "King and Mercenary", "Display Name Color for Chat Messages": "#FF0000", "SteamID Avatar for Chat Messages": 0 }, "Role Settings": { "King": { "Extra Attribute (Extra Life for King, Damage Multiplier for Mercenary [ 1.5 = 50% ])": 1.5, "Automatic role change time (in minutes)": 60, "Can become while wounded?": false, "BetterChat Prefix": "[<color=#FF8000>King</color>]", "Location broadcast interval in minutes (0 = disabled)": 5, "Location broadcast error radius": 100.0, "Only broadcast location when outside building privilege": true, "Send message on Discord when there is a new user with this role?": false, "Rewards": { "Enable periodic rewards": true, "Rewards (shortname,amount)": [ "scrap,100", "metal.refined,10", "supply.signal,1" ], "Reward interval (minutes)": 30, "Bonus rewards for killstreaks": true, "Killstreak threshold for bonus": 5 }, "Death Marker Settings": { "Enable": true, "Display Name": "King Death", "Flag ('0' for Green or '1' for Red)": 1, "Duration (in minutes)": 1 }, "Simple Status Settings": { "Enable": true, "Title": "King", "Title Color (RGB Hexadecimal format)": "#FFFFFF", "Text Color (RGB Hexadecimal format)": "#FFFFFF", "Background Color (RGB Hexadecimal format)": "#FF8000", "Icon URL": "https://i.postimg.cc/Gt6JDc0G/icons8-fairytale-64-1.png", "Icon Color (RGB Hexadecimal format)": "#FFFFFF" }, "Embed for Discord": { "Content": "**{victim}** has fallen! **{attacker}** now reigns as the new **{role}**.", "Title": "
**{victim}** fought bravely as a **{role}**, but was ultimately defeated at **{position}**.\n\n
**Kills:** {kills}\n
**Kill Streak:** {killStreak}\n
**Time Survived:** {duration}\n
**Health Boost:** {attribute}", "Icon URL": "https://your-icon-url.com/image.png", "Color (RGB Hexadecimal format)": "#FFD700", "Footer Text": "Codefling.com", "Footer Icon URL": "https://your-footer-icon-url.com/image.png", "Thumbnail URL": "https://your-thumbnail-url.com/image.png", "Image URL": "https://your-image-url.com/image.png", "Timestamp": true, "Fields": [ { "Name": "
Role", "Value": "**{role}**", "Inline": true }, { "Name": "
Role Bonus", "Value": "**{attribute}**", "Inline": true }, { "Name": "
**Damage Boost:** {attribute}", "Icon URL": "https://your-icon-url.com/image.png", "Color (RGB Hexadecimal format)": "#FF4500", "Footer Text": "Codefling.com", "Footer Icon URL": "https://your-footer-icon-url.com/image.png", "Thumbnail URL": "https://your-thumbnail-url.com/image.png", "Image URL": "https://your-image-url.com/image.png", "Timestamp": true, "Fields": [ { "Name": "
Role", "Value": "**{role}**", "Inline": true }, { "Name": "
Damage Bonus", "Value": "**{attribute} Extra Damage**", "Inline": true }, { "Name": "
Default Localization
{ "NoLongerAKing": "You are no longer a <color=#C27D00>King</color>. Your benefits have been deactivated.", "YouAreTheKing": "You have become the <color=#C27D00>King</color>.\nYour maximum health has been increased to <color=#C27D00>{0}</color> and has also been fully restored.", "GlobalKing": "<color=#C27D00>{0}</color> has become the new <color=#C27D00>King</color>! The previous ruler, <color=#C27D00>{1}</color>, was slain by <color=#FF5500>{2}</color> in <color=#00AAFF>{3}</color>. Will the new king prove to be stronger?", "GlobalKingWithoutInfo": "<color=#C27D00>{0}</color> has become the <color=#C27D00>King</color>. Will they be better than the previous one?", "NoLongerAMercenary": "You are no longer a <color=#FF5500>Mercenary</color>. Your benefits have been deactivated.", "YouAreAMercenary": "You have become a <color=#FF5500>Mercenary</color>.\nAll damage dealt to players/NPCs is now increased by <color=#FF5500>{0}%</color>.", "GlobalMercenary": "<color=#FF5500>{0}</color> has become the new <color=#FF5500>Mercenary</color>! The previous mercenary, <color=#FF5500>{1}</color>, was eliminated by <color=#FF5500>{2}</color> in <color=#00AAFF>{3}</color>. Will the new one surpass them?", "GlobalMercenaryWithoutInfo": "<color=#FF5500>{0}</color> has become the <color=#FF5500>Mercenary</color>. Will they kill more than the previous one?", "King": "<color=#C27D00>King</color>", "Mercenary": "<color=#FF5500>Mercenary</color>", "CooldownActive": "You must wait <color=#00AAFF>{0}</color> hours before becoming <color=#C27D00>{1}</color> again.", "RewardReceived": "You received rewards for maintaining your position as <color=#C27D00>{0}</color>!", "NotEnoughPlayers": "Not enough players online for the event (minimum <color=#FF0000>{0}</color> required).", "Stats": "<color=#00FF00>{0}</color>'s Stats:\nKills: <color=#FF0000>{1}</color>\nTime in position: <color=#FFFF00>{2}</color> minutes\nKillstreak: <color=#FF5500>{3}</color>", "NoStats": "You don't have any <color=#888888>info</color> yet.", "KillstreakReward": "You received a bonus reward for reaching a <color=#FF5500>{0}</color> killstreak!", "PowersDisabledSafeZone": "Your powers are <color=#FF0000>disabled</color> in safe zones.", "PowersActiveInZone": "Your powers are now <color=#00FF00>active</color> in this zone.", "PowersDisabledOutsideZone": "Your powers are <color=#FF0000>disabled</color> outside event zones.", "KingLocation": "The <color=#C27D00>King</color> was last seen around grid <color=#00AAFF>{0}</color>.", "MercenaryLocation": "The <color=#FF5500>Mercenary</color> was last seen around grid <color=#00AAFF>{0}</color>.", "InfoCommandUsage": "Incorrect command usage. Use <color=#00AAFF>/{0} info</color>.", "StatsCommandUsage": "Incorrect command usage. Use <color=#00AAFF>/{0} info</color>.", "ResetCommandUsage": "Incorrect command usage. Use <color=#00AAFF>/{0} reset <king | mercenary | all></color>.", "SetCommandUsage": "Incorrect command usage. Use <color=#00AAFF>/{0} set <king | mercenary | all> <SteamID64></color>.", "AdminSetCommandSuccessful": "You have successfully set <color=#C27D00>{1}</color> to the <color=#C27D00>{0}</color> role.", "AdminResetCommandSuccessful": "You have successfully reset the role <color=#C27D00>{0}</color>.", "PlayerNotFound": "The player you entered could not be found. Please remember to use their <color=#00AAFF>SteamID64</color>.", "NoKingLocation": "The <color=#C27D00>King</color>'s location is unknown.", "NoMercenaryLocation": "The <color=#FF5500>Mercenary</color>'s location is unknown.", "KingMercenaryTitle": "King and Mercenary", "None": "<color=#888888>None</color>", "HealthBonus": "<color=#00FF00>Health Bonus</color>", "DamageBonus": "<color=#FF5500>Damage Bonus</color>", "Kills": "<color=#FF0000>Kills</color>", "Time": "<color=#FFFF00>Time</color>", "KillStreak": "<color=#FF5500>Kill Streak</color>", "Minutes": "minutes", "LastLocation": "<color=#FFFF00>Last known location</color>", "RewardsInfo": "<color=#00AAFF>{2}</color> Rewards every <color=#00AAFF>{0}</color> minutes | Streak bonus at <color=#FF5500>{1}</color> kills. | <color=#00AAFF>{3}</color> players are needed to start the event", "CommandError": "<color=#FF0000>An error occurred while processing the command.</color>", "InvalidCommandGeneral": "The available options are:\n- <color=#00AAFF>/{0} info</color>\n- <color=#00AAFF>/{0} info</color>\n- <color=#00AAFF>/{0} set</color>\n- <color=#00AAFF>/{0} reset</color>", "AdminCannotHaveBothRoles": "You cannot assign both roles to a user." }
