What is FactionApi?
FactionApi (mod id factionapi) is a standalone NeoForge library mod that provides a complete
faction framework for Minecraft: joinable factions, per-faction player levels and lord levels,
skill trees and activatable actions, a task/quest system, accessory "refinements", minions and
faction-controlled villages.
It is developed and maintained by the Vampirism team (maxanier, cheaterpaul, gridexpert) as part of
the Vampirism monorepo (projects/faction-api and
projects/faction), and is licensed under LGPL-3.0.
What it gives you
| System | Summary |
|---|---|
| Factions | A shared registry of factions plus a built-in NEUTRAL faction. Any entity resolves to a faction. |
| Player progression | Each playable faction has its own level track and an optional lord level track with titles. |
| Skills & actions | Data-driven skill trees, skill segments and cooldown/duration based player actions. |
| Tasks | A quest board system with data-pack-defined requirements, rewards and unlock conditions. |
| Refinements | Rollable accessory items that grant attribute modifiers, grouped into rarity-tiered sets. |
| Minions | Per-faction minion entities with assignable tasks and the /factions minion commands. |
| Villages | Faction capture mechanics, totems, guards, banners and bad-omen raids. |
| Cross-mod glue | Faction tags, faction-aware targeting predicates and item data components (slayer, restriction). |
Relationship to Vampirism
Vampirism's vampire/hunter gameplay is built entirely on top of FactionApi – the two factions,
their skill trees, tasks and lord titles are just FactionApi content shipped by Vampirism. Because of
that, Vampirism declares factionapi as a required dependency: installing Vampirism means you
must also install FactionApi (see Installation).
Another mod can use the same framework to add its own factions without pulling in any of Vampirism's content.
Where to start
| You are … | Start here |
|---|---|
| A player or modpack author | Installation, then Commands, permissions & config |
| A server admin | Commands, permissions & config |
| A mod developer who wants a new faction | Concepts → Your first faction |
| A mod developer who only reads factions (e.g. checks a player's faction) | Object model and Overview |
| A data pack maker | Data packs |
Where to get it
-
Players / modpacks: download from Modrinth (project
factionapi). See Installation. -
Mod developers: add it as a Gradle dependency, see Depending on FactionApi. To create your own faction follow Your first faction; the API documentation and data pack documentation are the reference.
-
Server admins: commands, permissions and config options are listed in Commands, permissions & config.