Raid Stats

Raid Stats is a Java 8 expansion for Factions Kore 1.7 and the included MassiveCraft/Saber-style Factions build. It uses Factions Kore's native RaidStartEvent and RaidEndEvent when the raid-claim feature is active. A fallback detector follows primed TNT from the cannon/source faction into enemy territory when Kore does not create a native raid.

Tracked metrics

• Per-player and per-faction blocks placed, patch blocks, TNT shots caught, damage dealt, kills, deaths, explosion blocks destroyed, and raid participation
• Raid duration, total kills, kills per minute, TNT shots, defending-territory explosion damage, faction-value change, and MVP
• Seasonal top lists and records: fastest/longest raid, most kills, highest KPM, most TNT shots, blocks placed/patched/destroyed, damage dealt, deaths, and raid wins
• Public raid-start notification and a configurable public summary when a raid ends

Commands

The expansion registers raidstats with Factions Kore (alias rstats).

• /raidstats - your seasonal overview
• /raidstats player <name> - player statistics
• /raidstats faction <tag> - faction statistics
• /raidstats top <stat> [page] - seasonal leaderboard
• /raidstats active - current raids and live totals
• /raidstats reload - reload configuration (admin)
• /raidstats resetseason <new-id> - switch to a fresh season (admin)

Top stat names: kills, deaths, damage, placed, patched, caught, destroyed, raids, and wins.

Viewing statistics is public and requires no permission. Only reload and resetseason require factionskore.admin.raidstats.

Build and installation

Run mvn clean package. The project includes compile-only local API jars in lib so it builds without a private Maven repository. Put target/RaidStats-1.0.1.jar into plugins/FactionsKore/expansions/, then restart. On first enable, the expansion copies raidstats.yml into plugins/FactionsKore/.

Season data is stored in plugins/FactionsKore/raid-stats/seasons/<season-id>.yml.