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

Drop FFACore.jar into plugins/
Restart the server
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.