HCFCore¶
An open source, fully configurable Hardcore Factions core for Paper. One plugin drives both HCF and Kitmap, and every rule, number and message is yours to change without touching the code.
Everything an HCF server needs, in one plugin¶
-
Teams and territory
Factions with roles, invitations, alliances, a bank, points, focus and rally. Claims drawn block by block with the claiming wand, paid from the team bank, with buffers and connected land, HQ and base, server land for spawn and roads, a warzone, and a claim lock for SOTW.
-
DTR and raids
Deaths Till Raidable on the classic scale, computed from time so it never drifts. A raid opens a team's land to pillage; its protection comes back on its own the moment DTR regenerates. Land never changes hands.
-
Combat
Deathbans with rank tiers, combat tag and combat logging, safe zones, friendly fire rules, loot protection, the strength nerf, ender pearl and item cooldowns.
-
Classes
Diamond, Bard, Archer, Rogue and Miner, chosen by the armour you wear: Bard buffs and energy, the archer tag, the Rogue's backstab. Create your own from scratch in one file.
-
Events
KOTH, Citadel, Conquest, Kill the King, DTC, Last Break, Slide, Totem and Mini Totem, on daily schedules, with holograms above every zone. Mountains that refill on a clock. SOTW, EOTW and the Purge to open and close the map.
-
Kits and items
Kits built from an inventory, refill signs, a layout editor, and 42 partner items built in — Switcher, Ninja Track, Pocket Bard, Grappling Hook… Custom enchants, effect commands such as
/speed, enchantment, potion and effect caps, block limits per claim, and a crowbar for End portal frames. -
Moderation
Staff mode with a configurable toolbar, vanish, freeze, invsee, last inventories, a ticket queue for reports and requests, staff chat, and strikes against teams.
-
Interface
A flicker-free scoreboard built from template lines — each player hiding the sections they want — a tab list, the HCF grid or the classic list with LuckPerms ranks, a chat format with LuckPerms prefixes and kill counts, statistics and leaderboards, holograms, and per-player settings.
-
Integrations
Vault for shops and ranks, LuckPerms for chat prefixes, and Lunar Client through Apollo: waypoints, team view, every cooldown and nametags. All optional.
Built to be trusted with a live server¶
Nothing hardcoded
Every gameplay value — deathban length, DTR scale, claim limits, capture times, rewards — is a setting, and /hcf reload applies it without a restart. Balance decisions (points scale, enchantment caps, killstreak rewards) ship empty or neutral: the plugin never decides your server's balance for you.
Never waits on the database
All data lives in memory and is written to SQLite or MySQL in the background. The main thread never waits on a query, and nobody gets in before every load has finished — a half-loaded server stays closed.
Tested rules
Every rule engine is plain Java, covered by more than 1,000 unit tests — including real round trips on SQLite and checks against MySQL's reserved words — and tried in game on Paper 26.2 with SQLite, MySQL 8.4, LuckPerms, Vault and Lunar Client.
Open and extensible
MIT licensed, with public Bukkit events for other plugins to react to teams, alliances and raids. No required dependency: Vault, LuckPerms and Apollo are used only when present.
Quick start¶
Put the jar in plugins/ of a Paper 26.2 server running Java 25, and start it. It runs out of the box on SQLite.
Claim spawn as a safe zone, set the warzone, move the example events onto your map, create your kits.
Choose the values the plugin leaves to you, switch to MySQL for production, and start the map with a SOTW.
Pre-release
HCFCore compiles against the real Paper 26.2 API, its unit tests pass in CI, and it has been tried in game module by module — but it has not yet run a production map under load. Read the code, and test it on your own setup before deploying it to a server you care about.