FoKillstreak

FoKillstreak is a lightweight PvP progression plugin for servers that want killstreak competition without bulky setup. Players build current and best streaks, admins can configure anti-farming protection and rewards in-game, and PlaceholderAPI support makes streak stats easy to show across the server.

Features

• Track both current killstreaks and all-time best streaks.
• Show players a clean /killstreak leaderboard with current and best rankings.
• Broadcast configurable milestone streaks like 5, 10, 15, 20, 25, and 50 kills.
• Run reward commands at exact streak milestones from console or as the player.
• Use {player}, %player%, {uuid}, {streak}, and {best_streak} in reward commands.
• Prevent farming the same victim repeatedly with a configurable cooldown.

Admin Tools

• Edit core settings from /fokillstreakadmin editor.
• Manage reward commands through a searchable reward GUI.
• Choose whether natural deaths reset streaks or only PvP deaths do.
• Edit milestone broadcasts and same-victim cooldown seconds without touching the jar.
• Reload config.yml, messages.yml, guis/, and dialogs/ live.
• Manually set a player's current or best streak when staff need to correct data.

Configuration

• config.yml controls death resets, same-victim cooldowns, milestone broadcasts, native dialogs, and reward commands.
• messages.yml controls player messages, admin messages, GUI text, color tokens, and update notices.
• guis/leaderboard.yml lets server owners edit the public leaderboard GUI layout.
• dialogs/ controls native dialog text for supported Paper servers.
• SQLite storage is included in the jar, so no external database setup is required.

Dependencies

• Optional: PlaceholderAPI for streak placeholders.
• Native dialogs are used when supported by the server. Older or unsupported servers fall back to chat/inventory input.

Commands

• /killstreak - Open the player leaderboard.
• /ks - Alias for /killstreak.
• /fokillstreakadmin version - Check the plugin version and Modrinth update status.
• /fokillstreakadmin reload - Reload config, messages, GUI files, and dialog files.
• /fokillstreakadmin editor - Open the admin editor GUI.
• /fokillstreakadmin set <player> <streak> <best|current> - Set a player's stored streak.
• /killstreakadmin and /ksadmin - Admin command aliases.

Permissions

• fokillstreak.use - Allows players to open the leaderboard. Default: everyone.
• fokillstreak.admin - Allows access to admin tools. Default: operators.

Placeholders

Requires PlaceholderAPI.

• %fokillstreak_killstreak% - Current killstreak.
• %fokillstreak_best% - Best stored killstreak.
• %fokillstreak_rank% - Current-streak leaderboard rank, or blank if unranked.

<dependency>
  <groupId>me.foesio</groupId>
  <artifactId>FoKillstreak</artifactId>
  <version>2.1</version>
  <scope>provided</scope>
</dependency>

import me.foesio.foKillstreak.api.KillstreakService;
import me.foesio.foKillstreak.api.event.KillCreditPreEvent;

KillstreakService api = Bukkit.getServicesManager().load(KillstreakService.class);
if (api != null) api.getStreak(player.getUniqueId());

@EventHandler
public void onKillCreditPreEvent(KillCreditPreEvent event) {
    Bukkit.getLogger().info(event.getClass().getSimpleName());
}