About Kill Bonus
Video - Link
KillBonus provides a variety of rewards to players each time they kill an enemy player. This can include health recovery, metabolism recovery, ammo reloading, or the execution of pre-defined custom commands. It supports a range of commands. Furthermore, it records the kill counts of both players and clans, allowing the execution of custom commands upon achieving certain kill milestones. The KillBonus plugin is highly useful for various events and offers a high degree of versatility depending on the user's customization.
[Features]
1. Dynamic Reward System: It offers a variety of rewards each time a player defeats an enemy, including health recovery, metabolism recovery, ammo reloading, or executing pre-defined custom commands.
2. Kill Count Tracking: The plugin tracks the kill counts of both individual players and clans, thereby providing a comprehensive performance analysis.
3. Custom Command Execution: Upon achieving certain kill milestones, the plugin allows for the execution of custom commands, offering an exciting reward system for players.
4. Player and Clan Kill Data Reset: The plugin supports data reset functionality for both individual players and clans, ensuring the gameplay remains fresh and engaging.
5. Localization: KillBonus offers multi-language support, ensuring seamless integration and interaction with the game, regardless of the player's language.
6. Console and Chat Command: Offers a wide range of commands for customization and game management, accessible through both the game console and chat.
7. Customizable Settings: With the configuration file, you can easily customize the game settings to suit your needs.
8. Advanced Data Management: All player and clan kill data is managed using a dedicated data management system, ensuring accurate tracking and storage.
9. Event Trigger System: This feature enables custom commands to be executed when certain conditions are met, such as after a specific number of kills.
10. Integration: KillBonus has been designed to be compatible with a variety of gaming setups, offering compatibility with other plugins and systems.
11. Remember that the maximum value of the KillBonus plugin lies in its flexibility and adaptability, providing server owners with a tool that can be customized to suit their unique gameplay and reward systems.
[Permissions]
killbonus.default - Required to use default settings
killbonus.vip - Required to use vip settings
killbonus.vvip - Required to use vvip settings
killbonus.admin - Required to use commands
[Config]
{
"Wipe Data on new map save": true, // Whether to wipe data when a new map is saved
"ChatMessage Enabled": true, // Whether chat messaging is enabled
"UI Enabled(Required - Notify.cs/notify.see)": false, // Whether the UI is enabled (Notify.cs/notify.see is required for this)
"Is logging enabled?": true, // Whether logging is enabled
"Player kill settings": {
"Are player kill bonus enabled?": true, // Whether bonuses for killing players are enabled
// Following settings specify the default recovery amount and limit for health, thirst, hunger and whether auto-reload and ammo consumption are enabled
"Default player settings": {
"Is HP recovery enabled?": true,
"HP recovery amount": 10.0,
"Maximum HP for recovery": 100.0,
"Is thirst recovery enabled?": true,
"Thirst recovery amount": 10.0,
"Maximum thirst for recovery": 250.0,
"Is hunger recovery enabled?": true,
"Hunger recovery amount": 10.0,
"Maximum hunger for recovery": 500.0,
"Is auto-reload enabled?": true,
"Is ammo consumption enabled?": true,
"How many custom commands will be executed?(-1 : All)": -1,
"Custom commands": [ // The custom commands to be executed
"giveto $player.id scrap 100",
"giveto $player.id wood 100"
],
"Every X kill bonus commands": [
{
"Kill count for command trigger": 5, // Execute commands for every X kills achieved
"How many Every Xkill Bonus commands will be executed?(-1 : All)": -1,
"Commands to execute": [
"giveto $player.id scrap 500",
"giveto $player.id wood 500"
]
}
]
}, // Similar settings for VIP players
"VIP player settings": {
"Is HP recovery enabled?": true,
"HP recovery amount": 20.0,
"Maximum HP for recovery": 100.0,
"Is thirst recovery enabled?": true,
"Thirst recovery amount": 20.0,
"Maximum thirst for recovery": 250.0,
"Is hunger recovery enabled?": true,
"Hunger recovery amount": 20.0,
"Maximum hunger for recovery": 500.0,
"Is auto-reload enabled?": true,
"Is ammo consumption enabled?": true,
"How many custom commands will be executed?(-1 : All)": -1,
"Custom commands": [ // The custom commands to be executed
"giveto $player.id scrap 300",
"giveto $player.id wood 300"
],
"Every X kill bonus commands": [
{
"Kill count for command trigger": 5,
"How many Every Xkill Bonus commands will be executed?(-1 : All)": -1,
"Commands to execute": [
"giveto $player.id scrap 500",
"giveto $player.id wood 500"
]
}
]
}, // Similar settings for VVIP players
"VVIP player settings": {
"Is HP recovery enabled?": true,
"HP recovery amount": 30.0,
"Maximum HP for recovery": 100.0,
"Is thirst recovery enabled?": true,
"Thirst recovery amount": 30.0,
"Maximum thirst for recovery": 250.0,
"Is hunger recovery enabled?": true,
"Hunger recovery amount": 30.0,
"Maximum hunger for recovery": 500.0,
"Is auto-reload enabled?": true,
"Is ammo consumption enabled?": true,
"How many custom commands will be executed?(-1 : All)": -1,
"Custom commands": [ // The custom commands to be executed
"giveto $player.id scrap 500",
"giveto $player.id wood 500"
],
"Every X kill bonus commands": [
{
"Kill count for command trigger": 5,
"How many Every Xkill Bonus commands will be executed?(-1 : All)": -1,
"Commands to execute": [
"giveto $player.id scrap 500",
"giveto $player.id wood 500"
]
}
]
}, // Custom commands based on kill count
"Custom kill bonus commands": [
{
"Kill count for command trigger": 10, // The kill count required to trigger the command
"How many Achieved custom commands will be executed?(-1 : All)": -1,
"Commands to execute": [ // The commands to be executed
"giveto $player.id scrap 500",
"giveto $player.id wood 500"
]
},
{
"Kill count for command trigger": 20,
"How many Achieved custom commands will be executed?(-1 : All)": -1,
"Commands to execute": [
"giveto $player.id scrap 500",
"giveto $player.id wood 500"
]
}
]
},
"Clan kill settings (Required - Clans)": {
"Are clan kill rewards enabled?": false, // Whether rewards for clan kills are enabled
"Custom clan kill reward commands": [ // Custom commands for clan kill rewards
{
"Kill count for command trigger": 10, // The kill count required to trigger the command
"How many ClanKill Clan commands will be executed?(-1 : All)": -1,
"Clan commands to execute": [ // 'Clan commands to execute' will be executed as many times as there are clan members.
"giveto $clanmembers scrap 500", // Here, the variable "$clanmembers" will only be active.
"giveto $clanmembers wood 500"
],
"How many ClanKill Player commands will be executed?(-1 : All)": -1,
"Player commands to execute": [ // The commands to be executed for the player
"giveto $player.id scrap 500",
"giveto $player.id wood 500"
]
},
{
"Kill count for command trigger": 20, // The kill count required to trigger the command
"How many ClanKill Clan commands will be executed?(-1 : All)": -1,
"Clan commands to execute": [ // The commands to be executed for the clan
"giveto $clanmembers scrap 500",
"giveto $clanmembers wood 500"
],
"How many ClanKill Player commands will be executed?(-1 : All)": -1,
"Player commands to execute": [ // The commands to be executed for the player
"giveto $player.id scrap 500",
"giveto $player.id wood 500"
]
}
],
"Every X kill bonus commands": [
{
"Kill count for command trigger": 5, // Execute commands for every X kills achieved
"How many ClanEvery X Kill Clan commands will be executed?(-1 : All)": -1,
"Clan commands to execute": [
"giveto $clanmembers scrap 500",
"giveto $clanmembers wood 500"
],
"How many ClanEvery X Kill Player commands will be executed?(-1 : All)": -1,
"Player commands to execute": [
"giveto $player.id scrap 500",
"giveto $player.id wood 500"
]
}
]
},
"version": "1.1.1" // The version of this configuration
}
[Command]
For chat or console(not /) commands: /kb addpk <playernameorid> <amount>: Adds kills for a specific player. /kb removepk <playernameorid> <amount>: Removes kills for a specific player. /kb addpa <playernameorid> <achievementname>: Adds an achievement for a specific player. /kb removepa <playernameorid> <achievementname>: Removes an achievement for a specific player. /kb addck <playernameorid> <amount>: Adds kills for the clan. /kb removeck <playernameorid> <amount>: Removes kills for the clan. /kb addca <playernameorid> <achievementname>: Adds an achievement for the clan. /kb removeca <playernameorid> <achievementname>: Removes an achievement for the clan. /kbreset all: Resets all kill data and clan kill data. /kbreset player: Resets only the kill data for players. /kbreset clan: Resets only the clan kill data.
[Placeholders]
$player.clanname
$player.clankilldata
$player.clankillachievedata
$clanmembers
$player.killdata
$player.killachievedata
$player.id
$player.name
$player.ip
$player.ping
$player.position
$player.health
[Localization]
{ "KillReward": "{0}<color=red>Kill</color> {1} {2} {3} {4}", "KillRewardWithClan": "{0}<color=red>Kill</color> {1}<color=red>ClanKill</color> {2} {3} {4} {5}", "HPRecovery": "<color=green>HP</color>+{0} ", "ThirstRecovery": "<color=#45BCFF>Hydration</color>+{0} ", "HungerRecovery": "<color=orange>Calories</color>+{0} ", "AmmoRefill": "<color=purple>Ammo</color>+{0} ", "Achieved": "<color=#45BCFF>You achieved</color> {0}<color=red>Kill</color>!", "ClanAchieved": "<color=#45BCFF>Your clan achieved</color> {0}<color=red>Kill</color>!", "anounceAchieved": "<color=green>[{0}]</color> {1}<color=red>Kill</color> Achieved!", "anounceClanAchieved": "<color=green>[{0}]Clan</color> {1}<color=red>Kill</color> Achieved!", "EveryXkill": "<color=#FF009B>Every</color> {0}<color=red>Kill Bonus</color>!", "ClanEveryXkill": "<color=#FF009B>Every</color> {0}<color=red>ClanKill Bonus</color>!", "UsagePlayerAmount": "Usage: /kb addpk or /kb removepk <playerNameOrId> <amount>", "AmountMustBeInteger": "Amount must be an integer.", "PlayerKillsAdded": "Player kills has been added.", "PlayerKillsRemoved": "Player kills has been removed.", "KillDataReset": "Player Kill data has been reset.", "ClanKillDataReset": "Clan kill data has been reset.", "AllDataReset": "All data has been reset.", "PlayerAchievementAdded": "Player achievement has been added.", "PlayerAchievementRemoved": "Player achievement has been removed.", "ClanKillsAdded": "Clan kills have been added.", "ClanKillsRemoved": "Clan kills have been removed.", "ClanAchievementAdded": "Clan achievement has been added.", "ClanAchievementRemoved": "Clan achievement has been removed.", "Amountpositivenumber": "Amount must be an positive number.", "InvalidKbCommand": "Invalid command. Usage: /kb(kb) <command> <target> <amount>", "FailedCommand": "Failed command.", "InvalidResetCommand": "Invalid command. Usage: /kbreset | kbreset <player | clan>", "Noperm": "You don't have permission to do this." }
[API]
private string GetPlayerKills(string playerNameOrId) // Retrieves the kill count of a specific player. private Dictionary<int, bool> GetPlayerAchievements(string playerNameOrId) // Retrieves the achievement information of a specific player. private string GetClanKills(string clanID) // Retrieves the kill count of a specific clan. private Dictionary<int, bool> GetClanAchievements(string clanID) // Retrieves the achievement information of a specific clan. private bool PlayerHasAchievement(string playerNameOrId, int achievementID) // Checks if a specific player has a particular achievement. private bool ClanHasAchievement(string clanID, int achievementID) // Checks if a specific clan has a particular achievement. private void AddPlayerKills(string playerNameOrId, int amount, BasePlayer playermsg = null, string message = null) // Adds kills to a specific player. private void RemovePlayerKills(string playerNameOrId, int amount, BasePlayer playermsg = null, string message = null) // Removes kills from a specific player. private void AddPlayerAchievement(string playerNameOrId, int achievementID, BasePlayer playermsg = null, string message = null) // Adds an achievement to a specific player. private void RemovePlayerAchievement(string playerNameOrId, int achievementID, BasePlayer playermsg = null, string message = null) // Removes an achievement from a specific player. private void AddClanKills(string clanTag, int amount, BasePlayer playermsg = null, string message = null) // Adds kills to a specific clan. private void RemoveClanKills(string clanTag, int amount, BasePlayer playermsg = null, string message = null) // Removes kills from a specific clan. private void AddClanAchievement(string clanTag, int achievementID, BasePlayer playermsg = null, string message = null) // Adds an achievement to a specific clan. private void RemoveClanAchievement(string clanTag, int achievementID, BasePlayer playermsg = null, string message = null) // Removes an achievement from a specific clan. private void ResetKillData() // Resets all kill data. private void ResetClanKillData() // Resets all clan kill data.
