# FFAStreaks<\/p>\n
A comprehensive Free-For-All (FFA) plugin for Paper\/Spigot servers that adds killstreak tracking, healing on kill, kit management, and teleport systems.<\/p>\n
## Features<\/p>\n
### Core Features
\n– **Killstreak Tracking**: Tracks player killstreaks and resets on death
\n– **Highest Streak**: Records each player’s best killstreak ever
\n– **Heal on Kill**: Automatically heals and feeds players when they get a kill
\n– **Streak Rewards**: Configurable rewards (broadcasts, potion effects) at specific streak milestones
\n– **Anti-Farm Protection**: Prevents players from farming the same victim repeatedly
\n– **No Drops**: Prevents inventory and XP drops on death
\n– **World Whitelist**: Enable\/disable the plugin in specific worlds<\/p>\n
### Kit System ### Teleport System ### PlaceholderAPI Integration ## Requirements<\/p>\n – Paper 1.21.x or compatible ## Installation<\/p>\n 1. Download the latest JAR from the releases page ## Configuration<\/p>\n ### config.yml<\/p>\n “`yaml heal_on_kill: anti_farm: messages: rewards: ### Configuration Options<\/p>\n **enabled_worlds** **heal_on_kill** **anti_farm** **rewards** ## Commands<\/p>\n ### Player Commands<\/p>\n **\/streak [top|player]** **\/kit **\/ffakits list** **\/ffakits give **\/ffago go **\/ffago list** ### Admin Commands<\/p>\n **\/ffastreaks reload** **\/ffakits create **\/ffakits delete **\/ffakits give **\/ffago set **\/ffago link ## Permissions<\/p>\n **ffastreaks.kit** **ffastreaks.go** **ffastreaks.admin** ## Usage Examples<\/p>\n ### Setting Up an FFA Arena<\/p>\n 1. Create a kit: 2. Set a spawn point: 3. Link the kit to spawn: 4. Players can now use: ### Creating Streak Rewards<\/p>\n Edit `config.yml` to add rewards at specific streaks:<\/p>\n “`yaml The `%killer%` placeholder is automatically replaced with the player’s name.<\/p>\n ## PlaceholderAPI<\/p>\n If PlaceholderAPI is installed, the following placeholders are available:<\/p>\n – `%ffastreaks_streak%` – Current killstreak ### Example Usage in Scoreboards<\/p>\n “` ## How It Works<\/p>\n ### On Player Death ### On Kill ### Anti-Farm System ## File Structure<\/p>\n “` ## Troubleshooting<\/p>\n **Plugin not working in a world:** **Kits not saving:** **Placeholders not working:** **Commands not working:** ## API<\/p>\n ### Public Methods<\/p>\n “`java \/\/ Get total kills \/\/ Get highest streak ever \/\/ Check if enabled in world ## Version<\/p>\n Current Version: 1.0.0<\/p>\n ## Support<\/p>\n For issues, feature requests, or questions, please open an issue on the project repository.<\/p>\n ## License<\/p>\n This plugin is provided as-is for use on Minecraft servers.<\/p>\n ## Credits<\/p>\n Developed for Paper 1.21.x servers with support for PlaceholderAPI integration.<\/p>\n","protected":false},"excerpt":{"rendered":" A simple plugin to automate FFA healing, kits, teleporting and streaks.<\/p>\n","protected":false},"featured_media":69954,"template":"","meta":{"_minecraft_slug":"ffa-streaks","_minecraft_project_id":"MJkzY6Ml","_minecraft_author":"sidastuff","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":280,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ffa-streaks.zip","_minecraft_size_bytes":14000,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:00:10.657898Z","_minecraft_date_created":"2025-12-13T07:08:55.580633Z","_minecraft_date_modified":"2025-12-07T21:35:27.467827Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ffa-streaks","_minecraft_icon_attachment_id":69954,"_minecraft_imported_at":"2026-06-03T23:35:43+00:00","_minecraft_import_hash":"0cb4ee1dec438d7f382ee9a3e3c77825","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,129,869,92],"mod_loader":[130,132,134],"minecraft_version":[40,41,38,78,79,80,81,82],"class_list":["post-69953","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-spigot","mod_category-transportation","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21-10","minecraft_version-1-21-11","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
\n– Create, delete, and manage kits
\n– Simple `\/kit
\n– Full inventory, armor, and offhand support
\n– Admin kit management commands<\/p>\n
\n– Set teleport points for FFA arenas
\n– Link kits to teleport points (auto-given on teleport)
\n– Full heal and feed on teleport
\n– Simple `\/ffago go
\n– `%ffastreaks_streak%` – Current killstreak
\n– `%ffastreaks_highest_streak%` – Best killstreak ever
\n– `%ffastreaks_kills%` – Total kills
\n– `%ffastreaks_enabled%` – Whether FFA is enabled in current world<\/p>\n
\n– Java 21
\n– PlaceholderAPI (optional, for placeholders)<\/p>\n
\n2. Place `FFAStreaks-1.0.0.jar` in your server’s `plugins\/` folder
\n3. Start or restart your server
\n4. Configure `plugins\/FFAStreaks\/config.yml` to your preferences
\n5. Reload with `\/ffastreaks reload` or restart the server<\/p>\n
\nenabled_worlds:
\n enabled: true
\n worlds:
\n – world
\n – arena<\/p>\n
\n enabled: true
\n amount: 6.0 # 1.0 = half-heart, 20.0 = 10 hearts<\/p>\n
\n enabled: true
\n same_victim_cooldown_seconds: 20<\/p>\n
\n prefix: “&d[FFA]&f ”
\n disabled_world: “&cFFAStreaks is disabled in this world.”
\n streak_self: “&aYour current streak: &e%streak%”
\n streak_other: “&a%player%’s streak: &e%streak%”
\n top_header: “&6Top killstreaks:”<\/p>\n
\n “3”:
\n broadcast: “&e%killer% &fhas a &a3&f kill streak!”
\n effects:
\n – “SPEED 10 0”
\n “5”:
\n broadcast: “&e%killer% &fhas a &a5&f kill streak!”
\n effects:
\n – “STRENGTH 8 0”
\n “10”:
\n broadcast: “&e%killer% &fis on a &c10&f kill streak!”
\n effects:
\n – “RESISTANCE 10 0”
\n – “REGENERATION 4 1″
\n“`<\/p>\n
\n– `enabled`: Enable world whitelist (false = all worlds)
\n– `worlds`: List of world names where FFA features are active<\/p>\n
\n– `enabled`: Enable healing and feeding on kill
\n– `amount`: Health amount to restore (1.0 = half heart)<\/p>\n
\n– `enabled`: Enable anti-farm protection
\n– `same_victim_cooldown_seconds`: Cooldown before same victim can be farmed again<\/p>\n
\n– Configure rewards at specific streak milestones
\n– Format: `”streak_number”: { broadcast: “message”, effects: [“EFFECT seconds amplifier”] }`
\n– Effects format: `”EFFECT_NAME seconds amplifier”` (e.g., “SPEED 10 0”)<\/p>\n
\n– View your current killstreak
\n– `\/streak top` – View top 10 killstreaks
\n– `\/streak
\n– Get a kit by name
\n– Example: `\/kit warrior`<\/p>\n
\n– List all available kits<\/p>\n
\n– Get a kit for yourself
\n– Example: `\/ffakits give warrior`<\/p>\n
\n– Teleport to a teleport point
\n– Automatically gives linked kit if configured
\n– Fully heals and feeds player
\n– Example: `\/ffago go spawn`<\/p>\n
\n– List all available teleport points<\/p>\n
\n– Reload the plugin configuration
\n– Permission: `ffastreaks.admin`<\/p>\n
\n– Create a kit from your current inventory
\n– Permission: `ffastreaks.admin`<\/p>\n
\n– Delete a kit
\n– Permission: `ffastreaks.admin`<\/p>\n
\n– Give a kit to yourself or another player
\n– Permission: `ffastreaks.admin` (to give to others)<\/p>\n
\n– Set a teleport point at your current location
\n– Permission: `ffastreaks.admin`<\/p>\n
\n– Link a kit to a teleport point
\n– Permission: `ffastreaks.admin`<\/p>\n
\n– Allows players to get kits using `\/kit` or `\/ffakits give`
\n– Default: `true` (all players)<\/p>\n
\n– Allows players to use `\/ffago go` and `\/ffago list`
\n– Default: `true` (all players)<\/p>\n
\n– Full admin access to all FFA commands
\n– Default: `op` (operators only)<\/p>\n
\n “`
\n \/ffakits create warrior
\n “`<\/p>\n
\n “`
\n \/ffago set spawn
\n “`<\/p>\n
\n “`
\n \/ffago link spawn warrior
\n “`<\/p>\n
\n “`
\n \/ffago go spawn
\n “`
\n This will teleport them, give them the warrior kit, and fully heal\/feed them.<\/p>\n
\nrewards:
\n “5”:
\n broadcast: “&e%killer% &fhas a &a5&f kill streak!”
\n effects:
\n – “STRENGTH 8 0”
\n – “SPEED 10 0”
\n“`<\/p>\n
\n– `%ffastreaks_highest_streak%` – Highest killstreak ever achieved
\n– `%ffastreaks_kills%` – Total kills
\n– `%ffastreaks_enabled%` – Whether FFA is enabled in current world (true\/false)<\/p>\n
\n&eKill Streak: &f%ffastreaks_streak%
\n&eBest Streak: &f%ffastreaks_highest_streak%
\n&eTotal Kills: &f%ffastreaks_kills%
\n“`<\/p>\n
\n– Inventory is kept (no drops)
\n– XP level is kept (no XP drops)
\n– Killstreak is reset to 0
\n– If killed by a player:
\n – Killer’s streak increments
\n – Killer is healed and fed (if enabled)
\n – Streak rewards are applied (if configured)
\n – Anti-farm protection is checked<\/p>\n
\n– Health restored by configured amount
\n– Food level set to 20
\n– Saturation set to 20.0
\n– Exhaustion reset to 0
\n– Kill count increments
\n– Streak increments
\n– Highest streak updated if new record<\/p>\n
\n– Tracks last kill time for each killer-victim pair
\n– Prevents rewards if same victim is killed within cooldown period
\n– Configurable cooldown in seconds<\/p>\n
\nplugins\/FFAStreaks\/
\n\u251c\u2500\u2500 config.yml # Main configuration
\n\u2514\u2500\u2500 kits.yml # Kit and teleport storage (auto-generated)
\n“`<\/p>\n
\n– Check `enabled_worlds` in config.yml
\n– Ensure world name matches exactly (case-sensitive)<\/p>\n
\n– Check file permissions in `plugins\/FFAStreaks\/`
\n– Ensure server has write access<\/p>\n
\n– Install PlaceholderAPI plugin
\n– Use `\/papi reload` after installing FFAStreaks
\n– Check placeholder syntax: `%ffastreaks_streak%`<\/p>\n
\n– Check permissions with `\/lp user
\n– Default permissions should be `true` for players
\n– Admin commands require `ffastreaks.admin` permission<\/p>\n
\n\/\/ Get current streak
\nint getStreak(UUID uuid)<\/p>\n
\nint getKills(UUID uuid)<\/p>\n
\nint getHighestStreak(UUID uuid)<\/p>\n
\nboolean isEnabledInWorld(World world)
\n“`<\/p>\n