Easy Factions - Unofficial Port

Source: github.com/teamdemivfxfish-dev/easy-factions-unofficial-port

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. Bundled alongside it are two companions that make the land layer whole: the Territory Table, a pannable claim map you paint your borders onto, and the Warborn add-ons, which let a faction at its cap buy more ground with in-game money. One download, one install.

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.
• A faction must reach a minimum size before it may claim at all (default 3 members), so nobody founds a throwaway banner purely to fence off chunks. Releasing land is never gated, so a shrinking faction can always let go of what it holds.
• 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.

Paint Your Borders: The Territory Table

Claiming chunk by chunk from where you happen to be standing is how you take one field. It is not how you draw a country. Craft a Territory Table and claim from a map instead.

• A pannable, zoomable claim map of the world around you: drag across it to paint the chunks you want and commit them in one go.
• Every claim is drawn in its owner's colour and labelled with the owner's name, so a glance at the table tells you where your neighbours end and you begin.
• Switch between faction, personal, and admin claim types in the same interface.
• Name your personal territory and pick its colour, so your holdings read as a place rather than a colour blob.
• Buy extra claim capacity for your faction straight from the Faction tab when you have the coin.

Rule Your Ground: Admin Territories

Server-owned land is not one anonymous mass. Spawn, the dungeon approach, and the neutral trade road are different places and should look it.

• Give each admin region its own name and its own colour, typed in before you paint it.
• Colours are staged per region, so two admin territories can sit side by side and read as separate places.
• Operator only. Whether the claimer must also be in creative mode is a config switch, off by default.

Take It by Force

Borders that only move when somebody presses a button are not borders. Kill a member of a rival faction and their ground answers for it.

• A qualifying kill costs the victim's faction claim capacity, and half of what they lose is paid into the killer's faction pool. Land is contested, not simply destroyed.
• The pool belongs to the faction, not the player who swung, so a good war funds the whole banner.
• Capacity falls before chunks do. A faction with room to spare only loses ceiling; real chunks start coming off the map once the ceiling drops below what they actually hold, and the chunks that fall are the ones nearest where the victim died.
• Losses heal over time (one slot back every ten minutes by default), so a bad night bleeds a faction without ending it. Servers can make losses permanent instead.
• The whole system is one config switch if you would rather run a builder server.

Buy More Land

Sometimes you have the coin but not the claim cap. Two paid routes exist, and both are overflow valves rather than shortcuts.

• Faction owners and officers use /factionbuy to purchase the chunk they are standing on with in-game money.
• The Territory Table's Buy Claims button instead raises the faction's cap permanently, in fixed sets of ten slots.
• Payment runs through SDM Economy when that mod is installed. Without it, /factionbuy reports paid claims as unavailable, and the Territory Table falls back to charging emeralds.
• If a claim fails after you are charged, the money is refunded.
• Price, currency, set size, and the at-cap requirement are all 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.
• Claims are drawn in full on the Territory Table, which is where this build expects you to read the 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 bundled mods each add one of their own.

• 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.
• 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).
• territory-server.toml: the Buy Claims price and set size, minFactionMembers (default 3), the conquest values (claimsLostPerKill, killerSharePercent, penaltyRegenSeconds), and the admin claim colour and permissions.

Required setting: set pointsPerKill = 0 in easy_factions-server.toml. Easy Factions has its own kill-takes-land rule, and left on it doubles up with the one above and removes chunks near world spawn rather than near the fight. The server logs a warning at startup if it is still set.

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

Do not also install a standalone MineTerritory / Territory jar. This download already contains it. A second copy is a duplicate mod id, which fails at mod discovery and stops the game from starting.

Supported Versions

All three ship bundled in the port jar, so the download is a single file that lists three mods. Neither companion injects code into the port's classes; each registers its own content and reads the port's public state.

Credits & License

This is an unofficial port and is not affiliated with or endorsed by the original authors.

Easy Factions was created by OverWatter (GitHub kard3n/easy_factions; Easy Factions on CurseForge) and released under the Mozilla Public License 2.0. It was ported to NeoForge 1.21.1 with permission and keeps the same MPL-2.0 license.

MineTerritory (the Territory Table) was created by Leon (leon_mout) with cnlimiter, and is released under the GNU General Public License v3.0. The NeoForge 1.21.1 revival and the Easy Factions integration are by NewtL and carry the same GPL-3.0 license. The two mods are bundled in one jar for a single install but remain separate mods under separate licenses.

If you redistribute, please preserve the upstream attribution for both.

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