FFAStreaks

A comprehensive Free-For-All (FFA) plugin for Paper/Spigot servers that adds killstreak tracking, healing on kill, kit management, and teleport systems.

Features

Core Features

Killstreak Tracking: Tracks player killstreaks and resets on death
Highest Streak: Records each player's best killstreak ever
Heal on Kill: Automatically heals and feeds players when they get a kill
Streak Rewards: Configurable rewards (broadcasts, potion effects) at specific streak milestones
Anti-Farm Protection: Prevents players from farming the same victim repeatedly
No Drops: Prevents inventory and XP drops on death
World Whitelist: Enable/disable the plugin in specific worlds

Kit System

Create, delete, and manage kits
Simple /kit <name> command for players
Full inventory, armor, and offhand support
Admin kit management commands

Teleport System

Set teleport points for FFA arenas
Link kits to teleport points (auto-given on teleport)
Full heal and feed on teleport
Simple /ffago go <type> command

PlaceholderAPI Integration

%ffastreaks_streak% - Current killstreak
%ffastreaks_highest_streak% - Best killstreak ever
%ffastreaks_kills% - Total kills
%ffastreaks_enabled% - Whether FFA is enabled in current world

Requirements

Paper 1.21.x or compatible
Java 21
PlaceholderAPI (optional, for placeholders)

Installation

Download the latest JAR from the releases page
Place FFAStreaks-1.0.0.jar in your server's plugins/ folder
Start or restart your server
Configure plugins/FFAStreaks/config.yml to your preferences
Reload with /ffastreaks reload or restart the server

Configuration

config.yml

enabled_worlds:
  enabled: true
  worlds:
    - world
    - arena

heal_on_kill:
  enabled: true
  amount: 6.0  # 1.0 = half-heart, 20.0 = 10 hearts

anti_farm:
  enabled: true
  same_victim_cooldown_seconds: 20

messages:
  prefix: "&d[FFA]&f "
  disabled_world: "&cFFAStreaks is disabled in this world."
  streak_self: "&aYour current streak: &e%streak%"
  streak_other: "&a%player%'s streak: &e%streak%"
  top_header: "&6Top killstreaks:"

rewards:
  "3":
    broadcast: "&e%killer% &fhas a &a3&f kill streak!"
    effects:
      - "SPEED 10 0"
  "5":
    broadcast: "&e%killer% &fhas a &a5&f kill streak!"
    effects:
      - "STRENGTH 8 0"
  "10":
    broadcast: "&e%killer% &fis on a &c10&f kill streak!"
    effects:
      - "RESISTANCE 10 0"
      - "REGENERATION 4 1"

Configuration Options

enabled_worlds

enabled: Enable world whitelist (false = all worlds)
worlds: List of world names where FFA features are active

heal_on_kill

enabled: Enable healing and feeding on kill
amount: Health amount to restore (1.0 = half heart)

anti_farm

enabled: Enable anti-farm protection
same_victim_cooldown_seconds: Cooldown before same victim can be farmed again

rewards

Configure rewards at specific streak milestones
Format: "streak_number": { broadcast: "message", effects: ["EFFECT seconds amplifier"] }
Effects format: "EFFECT_NAME seconds amplifier" (e.g., "SPEED 10 0")

Commands

Player Commands

/streak [top|player]

View your current killstreak
/streak top - View top 10 killstreaks
/streak <player> - View another player's streak

/kit

Get a kit by name
Example: /kit warrior

/ffakits list

List all available kits

/ffakits give

Get a kit for yourself
Example: /ffakits give warrior

/ffago go

Teleport to a teleport point
Automatically gives linked kit if configured
Fully heals and feeds player
Example: /ffago go spawn

/ffago list

List all available teleport points

Admin Commands

/ffastreaks reload

Reload the plugin configuration
Permission: ffastreaks.admin

/ffakits create

Create a kit from your current inventory
Permission: ffastreaks.admin

/ffakits delete

Delete a kit
Permission: ffastreaks.admin

/ffakits give [player]

Give a kit to yourself or another player
Permission: ffastreaks.admin (to give to others)

/ffago set

Set a teleport point at your current location
Permission: ffastreaks.admin

/ffago link

Link a kit to a teleport point
Permission: ffastreaks.admin

Permissions

ffastreaks.kit

Allows players to get kits using /kit or /ffakits give
Default: true (all players)

ffastreaks.go

Allows players to use /ffago go and /ffago list
Default: true (all players)

ffastreaks.admin

Full admin access to all FFA commands
Default: op (operators only)

Usage Examples

Setting Up an FFA Arena

Create a kit:
```
/ffakits create warrior
```
Set a spawn point:
```
/ffago set spawn
```
Link the kit to spawn:
```
/ffago link spawn warrior
```
Players can now use:
```
/ffago go spawn
```
This will teleport them, give them the warrior kit, and fully heal/feed them.

Creating Streak Rewards

Edit config.yml to add rewards at specific streaks:

rewards:
  "5":
    broadcast: "&e%killer% &fhas a &a5&f kill streak!"
    effects:
      - "STRENGTH 8 0"
      - "SPEED 10 0"

The %killer% placeholder is automatically replaced with the player's name.

PlaceholderAPI

If PlaceholderAPI is installed, the following placeholders are available:

%ffastreaks_streak% - Current killstreak
%ffastreaks_highest_streak% - Highest killstreak ever achieved
%ffastreaks_kills% - Total kills
%ffastreaks_enabled% - Whether FFA is enabled in current world (true/false)

Example Usage in Scoreboards

&eKill Streak: &f%ffastreaks_streak%
&eBest Streak: &f%ffastreaks_highest_streak%
&eTotal Kills: &f%ffastreaks_kills%

How It Works

On Player Death

Inventory is kept (no drops)
XP level is kept (no XP drops)
Killstreak is reset to 0
If killed by a player:
- Killer's streak increments
- Killer is healed and fed (if enabled)
- Streak rewards are applied (if configured)
- Anti-farm protection is checked

On Kill

Health restored by configured amount
Food level set to 20
Saturation set to 20.0
Exhaustion reset to 0
Kill count increments
Streak increments
Highest streak updated if new record

Anti-Farm System

Tracks last kill time for each killer-victim pair
Prevents rewards if same victim is killed within cooldown period
Configurable cooldown in seconds

File Structure

plugins/FFAStreaks/
├── config.yml          # Main configuration
└── kits.yml            # Kit and teleport storage (auto-generated)

Troubleshooting

Plugin not working in a world:

Check enabled_worlds in config.yml
Ensure world name matches exactly (case-sensitive)

Kits not saving:

Check file permissions in plugins/FFAStreaks/
Ensure server has write access

Placeholders not working:

Install PlaceholderAPI plugin
Use /papi reload after installing FFAStreaks
Check placeholder syntax: %ffastreaks_streak%

Commands not working:

Check permissions with /lp user <player> permission info
Default permissions should be true for players
Admin commands require ffastreaks.admin permission

API

Public Methods

// Get current streak
int getStreak(UUID uuid)

// Get total kills
int getKills(UUID uuid)

// Get highest streak ever
int getHighestStreak(UUID uuid)

// Check if enabled in world
boolean isEnabledInWorld(World world)

Version

Current Version: 1.0.0

Support

For issues, feature requests, or questions, please open an issue on the project repository.

License

This plugin is provided as-is for use on Minecraft servers.

Credits

Developed for Paper 1.21.x servers with support for PlaceholderAPI integration.

FFA Streaks