Easy Factions - Unofficial Port

Source & full guide: github.com/teamdemivfxfish-dev/easy-factions-warborn-wiki

Found a faction, plant your banner, and fight over every chunk of the map.

Easy Factions is a server-side territory system for NeoForge 1.21.1. Raise a faction, claim the land under your feet, forge alliances, and contest King-of-the-Hill objectives for standing and reward. This is the ground your server stands on: Easy Factions owns who holds what, from the claims and the borders to the allies and the wars over them. It is the land layer the rest of the Warborn Realm builds its politics on.

This build is an unofficial NeoForge 1.21.1 port of Easy Factions, carrying the original faction, alliance, and territory systems forward and reimplementing the King-of-the-Hill objectives. On top of the port, the Warborn add-on contributes one server feature the port could not offer through config alone: /factionbuy, a paid overflow claim that lets a faction at its cap purchase the chunk it is standing on with in-game money.

New here? Open the faction menu with G. A full command and configuration reference is below.

Found Your Faction

A faction is a name, a color, and everyone who answers to it. Start one, bring people in, and give them rank.

• Found a faction, invite players, and organize them with owners, officers, and members.
• Toggle faction-wide friendly fire on or off so your own members stop trading blows.
• Set an optional abbreviation and color that follow your faction everywhere it appears.
• Open the whole faction menu with a keybind (default G); no commands to memorize.
• Prefer typing? Manage everything by slash command as well.

Forge Alliances

No faction stands alone for long. Set your relations, then decide who fights beside you.

• Mark other factions and alliances as friendly, neutral, or hostile.
• Form an alliance to share friendly-fire protection across every member faction.
• Give an alliance its own membership, abbreviation, and relationship set.
• Run it all from the Alliance tab or through alliance commands, from the first pact to the final betrayal.

Claim the Map

Land is won a chunk at a time, and claiming is driven by a point economy rather than a spending free-for-all.

• Factions earn claim points over time (per online member) and from combat, then spend them to take ground.
• Take a chunk off a rival faction and it costs them; you gain points for the capture.
• A faction's claim cap scales with its roster: factionBaseClaimLimit + factionAdditionalClaimLimitPerMember x members.
• Beyond faction land there are core (personal) claims for individual players and admin claims for server-owned ground.
• Each claim type carries a restriction list, so a server can allow visitors to walk through while keeping them from breaking or placing blocks.

Buy More Land

Sometimes you have the coin but not the claim cap. The Warborn add-on gives factions a paid overflow valve.

• Faction owners and officers use /factionbuy to purchase the chunk they are standing on with in-game money.
• It is deliberately an overflow valve, not a shortcut: with requireAtCap on (the default), it only runs once the faction has spent its normal, point-based claims.
• Payment runs through SDM Economy when that mod is installed; without an economy mod, paid claims simply report as unavailable and nothing else changes.
• If a claim fails after you are charged, the money is refunded.
• Price, currency, and the at-cap requirement are all set in config, so every server tunes its own economy of land.

King of the Hill

Claiming is quiet. Objectives are loud. Contest fixed points on the map and hold them under fire.

• Each objective defines a core area to hold and a kill zone around it.
• Factions holding the core are awarded control points on a timer; each point decays, so a score fades unless the objective is held.
• Dying in the kill zone costs your faction a share of its points, and part of that loss transfers to the killer's faction.
• Operators configure item rewards with individual drop chances, and factions and alliances climb the leaderboards.

Know Friend from Foe

In a claimed world, the most important thing to know is who is standing next to you.

• Color-coded name and head tags show each player's relationship to you at a glance: ally green, neutral yellow, enemy red.
• Optional JourneyMap integration paints every claim as an overlay on your map.
• One look tells you whose ground you are on and whether you should have brought friends.

Commands

The in-game menu (default G) is the primary interface; these commands mirror and extend it.

Configuration Highlights

Servers tune the land economy through the port's config files; the add-on adds a small file of its own.

• efwarborn-server.toml: chunkPrice (cost per bought chunk), currencyKey (which SDM Economy currency to charge), and requireAtCap (whether /factionbuy waits until the faction is at its cap).
• easy_factions-server.toml: claim caps and per-member scaling, core chunk counts, point generation and combat rewards, claim restrictions per claim type, dimension limits, abbreviation rules, and the King-of-the-Hill objective tuning.
• easy_factions-client.toml: claim overlay opacity, border width and opacity, claim merge grid size, and whether nameplates show abbreviations.

Recommended Warborn server values: coreChunks = 9, factionBaseClaimLimit = 0 with factionAdditionalClaimLimitPerMember = 100 (three members give a 300 cap), and factionClaimRestrictions = ["BREAK_BLOCK","PLACE_BLOCK"] for build-only protection.

Requirements & Compatibility

Supported Versions

The add-on ships bundled into the port jar, so the download is a single file that lists both mods. The add-on injects no code into the port's classes; it registers its own command and reads the port's public state.

Credits & License

This is an unofficial port and add-on and is not affiliated with or endorsed by the original author. Easy Factions was created by Jonathan Michael Preiss (jpreiss; GitHub kard3n/easy_factions) and released under the Mozilla Public License 2.0. It was ported to NeoForge 1.21.1 with permission, and this repository keeps the same MPL-2.0 license. If you redistribute, please preserve the upstream attribution.

Found it. Claim it. Hold it. Find the rest of the Warborn Realm suite on barunn's CurseForge page.

Part of The Warborn Realm, by barunn