FFACore

!Version !Paper !Java !License

Run, fight, die, repeat — and every kill counts. FFACore punishes combat loggers, drops red Kill Tokens, celebrates kill streaks and ranks your players. One jar, zero dependencies.

FFACore is the lightweight core for Free-For-All (FFA) PvP servers. It's built around the four things an FFA server needs to feel alive: no one escapes a fight, kills leave proof behind, streaks get loud, and the best players get bragging rights.

📸 Screenshots

• Banner — the FFACore banner
• Combat log system — the combat-tag HUD, logout punishment and streak broadcast
• Kill tokens — the red Nether Star Kill Token drop, name tag and pickup
• Stats & leaderboards — /stats and /top in action

:zap: Features

:stopwatch: Combat log — nobody escapes

• The moment a fight starts, you're tagged — a red countdown burns in your action bar
• Log out while tagged and you die: your items drop where you stood
• Your killer still gets the kill — token, streak and all
• Flight is blocked mid-combat; check yourself anytime with /combatlog

:star2: Kill tokens — proof of every kill

• Every PvP kill drops a red Nether Star: "Kill Token"
• They're physical items — collect them, hoard them, trade them, flex them
• /tokens shows your balance; admins can give or take any amount

:fire: Kill streaks — get loud

• Consecutive kills build a streak; milestones like 5, 10, 20, 30 get broadcast server-wide
• Each milestone can reward real items via console commands — diamonds, effects, titles, you decide
• Your best streak is saved forever; death resets the current one

:chart_with_upwards_trend: Stats & leaderboards — permanent bragging rights

• Kills, deaths, K/D, current & best killstreak, tokens earned — all saved in stats.yml
• /stats [player] for anyone's record
• /top kills | deaths | tokens | streak ranks the server

:shield: Spawn protection — no spawn camping

• Fresh respawns get a shield so they're not instantly farmed
• Protected players can't take damage and can't deal it (both togglable), with a countdown HUD

🚀 Quick Start

1. Drop FFACore.jar into plugins/
2. Restart the server
3. That's it — sensible defaults, fully working out of the box

Tune everything in plugins/FFACore/config.yaml and apply live with /ffa reload.

🎮 Commands

Command	What it does
/ffa status	Live status of every system
/ffa reload	Apply config without restart
/combatlog (/cl)	Am I in combat?
/tokens	Your Kill Token balance
/tokens give <player> <amount>	Give tokens (admin)
/tokens take <player> <amount>	Take tokens (admin)
/stats [player]	Your (or anyone's) record
`/top kills	deaths

⚙️ Configuration

Section	Key highlights	Default
combat-tag	duration-seconds, block-fly	15, true
kill-tokens	amount, name, lore	1, red "Kill Token"
kill-streaks	announce-at, rewards (console cmds)	5/10/20/30
stats	top-size	10
spawn-protection	duration-seconds, prevent-*	10, true
messages	every HUD and chat message	pre-formatted

Color codes (&c, &6, …) work everywhere — messages, HUD, item names.

🛟 Support

• 🐛 Bugs or feature ideas? Open an issue on GitHub
• 💬 Questions? Join the Discord server

📦 Changelog

v1.0.0

• Combat log system: tag HUD, kill-on-logout, attacker kill credit, fly block
• Kill Tokens: red Nether Star drops, /tokens balance + admin give/take
• Kill streaks: server broadcasts + console-command rewards per milestone
• Permanent stats: kills, deaths, K/D, best streak, tokens + /stats + /top
• Spawn protection with damage rules and countdown
• /ffa status & reload, fully configurable config.yaml

🛠️ Build from source

JDK 21+ and the included Gradle wrapper:

./gradlew build   →   build/libs/FFACore.jar

📄 License

MIT — free to use, modify and share, just keep the license notice.