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 a /minion command. |
| 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 get it
- Players / modpacks: download from Modrinth (project
factionapi). See Installation. - Mod developers: add it as a Gradle dependency. See Depending on FactionApi, then the API documentation and data pack documentation.