<\/p>\n
WantedPlayers is a Paper plugin that adds a **Wanted Level system** based on player killstreaks.
\nIt rewards bounty hunters with **money via Vault** and displays Wanted stars using PlaceholderAPI. <\/p>\n
—<\/p>\n
## \ud83d\udd0c Dependencies<\/p>\n
– Vault \u2013 economy handling
\n– PlaceholderAPI \u2013 placeholders
\n– LuckPerms \u2013 groups and permissions (optionnal)
\n– PvPStats Plugin \u2013 or other killstreak tracking plugin for plugin version 1.2+
\n– MythicMobs – for MythicMobs reward sources (optional)<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration (`config.yml`)<\/p>\n
“`yaml
\n# ============================
\n# WantedPlayers Configuration
\n# ============================<\/p>\n
# Killstreak placeholder used to get player killstreak.
\n# Change it with a valid killstreak placeholder from any plugin or expansion.
\nkillstreak-placeholder: “%pvpstats_killstreak%”<\/p>\n
# Killstreak thresholds for each Wanted level.
\n# Example: level 1 requires 1 killstreak, level 2 requires 3, etc.
\nwanted-levels:
\n 1: 1
\n 2: 3
\n 3: 5
\n 4: 10
\n 5: 20<\/p>\n
# Symbols used to display stars in placeholders or messages.
\nstars:
\n full: “\u2605” # Full star for achieved level
\n empty: “\u2606” # Empty star for levels not reached<\/p>\n
rewards:
\n # Base reward ranges for each Wanted level.
\n # A random value between min and max will be chosen.
\n ranges:
\n 1:
\n min: 5
\n max: 10
\n 2:
\n min: 10
\n max: 20
\n 3:
\n min: 20
\n max: 40
\n 4:
\n min: 40
\n max: 80
\n 5:
\n min: 80
\n max: 150<\/p>\n
# Reward sources for entities.
\n # Add a mob here to make it give a reward.
\n # Example: killing a player multiplies reward by 3.
\n # Multiplier is optional, defaults is 1.
\n reward-sources:
\n player: 3
\n zombie: 1
\n iron_golem: 2
\n # fire_dragon: 5 #Example MythicMobs entity reward source<\/p>\n
# Multipliers applied based on Wanted level.
\n # Example: level 3 multiplies the base reward by 2.0.
\n level-multipliers:
\n 1: 1.0
\n 2: 1.5
\n 3: 2.0
\n 4: 2.5
\n 5: 3.0<\/p>\n
# Multipliers applied based on LuckPerms primary group.
\n # Example: vip group multiplies the reward by 2.5.
\n group-multipliers:
\n default: 1.0
\n vip: 2.5
\n vip_plus: 3<\/p>\n
#Reward commands
\n #Available placeholders are: %player% -> return player username, %amount% -> return reward amount in decimal.
\n #Add as many as you want !
\n reward-command:
\n – ‘eco give %player% %amount%’<\/p>\n
messages:
\n # Message sent to the killer when they receive coins.
\n # Placeholders:
\n # %amount% = final reward amount
\n # %stars% = star display for Wanted level
\n # %group% = LuckPerms group name
\n kill-reward: “&aYou earned %amount% coins thanks to your Wanted level (%stars%) and your group (%group%)!”<\/p>\n
# Message sent when the config is reloaded with \/wantedreload.
\n reload: “&aConfig reloaded successfully.”
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udcdc Commands<\/p>\n
– `\/wantedreload` \u2192 reloads the configuration (`config.yml`)
\n – Permission: `wanted.reload` <\/p>\n
—<\/p>\n
## \ud83e\udea7 Placeholders (via PlaceholderAPI)
\n### 1.0 and 1.1
\n– `%wanted_level%` \u2192 current Wanted level (1\u20135)
\n– `%wanted_stars%` \u2192 star display (\u2605\/\u2606)
\n– `%wanted_multiplier%` \u2192 total multiplier (Wanted \u00d7 group)<\/p>\n
### 1.1.1+
\n– `%wantedplayers_level%` \u2192 current Wanted level (1\u20135)
\n– `%wantedplayers_stars%` \u2192 star display (\u2605\/\u2606)
\n– `%wantedplayers_multiplier%` \u2192 total multiplier (Wanted \u00d7 group) <\/p>\n
—<\/p>\n
## \ud83c\udfae How it works<\/p>\n
1. Each kill increases your **killstreak** (via PvPStats Plugin).
\n2. Your **Wanted level** is calculated based on thresholds.
\n3. On each kill, you receive a random reward (min\u2013max) \u00d7 Wanted multiplier \u00d7 group multiplier.
\n4. Coins are added directly to your balance via Vault.
\n5. A custom message is sent with the amount, stars, and group. <\/p>\n","protected":false},"excerpt":{"rendered":"
Add wanted stars like gta based on killstreak and gain money depends of your wanted level<\/p>\n","protected":false},"featured_media":168473,"template":"","meta":{"_minecraft_slug":"wanted-players","_minecraft_project_id":"7RmyWIhV","_minecraft_author":"Toni_4819","_minecraft_license":"MIT","_minecraft_downloads":99,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"wanted-players.zip","_minecraft_size_bytes":232059,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-15T19:41:51.058920Z","_minecraft_date_created":"2026-01-25T22:00:21.636940Z","_minecraft_date_modified":"2026-02-07T20:35:14.771804Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/wanted-players","_minecraft_icon_attachment_id":168473,"_minecraft_imported_at":"2026-06-09T19:40:28+00:00","_minecraft_import_hash":"b25fb6f05c4a90f1d4b7c79a3321cec8","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,89,866,127],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-168472","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n