Reputation and factions
Standing, witnesses, protected containers, wanted factions and report bands.
Each faction records your standing separately, from −1000 to +1000, with an initial value of 0. A faction considers you wanted at −100 or below; changes are evaluated against that faction’s own standing.
What changes your standing
| Event | Base change | Conditions |
|---|---|---|
| Caught taking protected items | −10 to −20 | −(10 + 2 × max(0, witnesses − 1)), capped at −20; witnesses within 16 blocks. |
| Hurting a faction member | −2 to −12 | −clamp(2 + floor(damage × 0.5), 2, 12); no witness required. Invalid/nonpositive damage gives no penalty. |
| Witnessed faction-member kill | −45 to −70 | −clamp(40 + 5 × witnesses, 40, 70); witnesses within 32 blocks. |
| Villager witnesses a hostile kill | +8 | An awake, unobscured villager within the 24-block search box sees the killer and victim. Applies once per kill; stronger defence rewards replace this value. |
| Kill a monster a protector is targeting | +12 | A living protector is in the 32-block search box and targets that monster. |
| Rescue villagers by killing a monster | +20 | The monster targets a villager, or a villager in the 24-block search box is panicking with a matching threat memory. |
| Both defence conditions | +32 | The rewards add once per kill, not once per protected entity. |
Theft has a cooldown of 100 ticks (5 seconds) per player, container position and dimension. Injury has a cooldown of 200 ticks (10 seconds) per player, victim and dimension. Creative and spectator players are excluded from these theft and combat incidents; quest rewards have their own entry point.
Witnesses and affected factions
At most 6 witnesses count. They must be alive, awake and free of Blindness, Darkness and Charm. Theft witnesses must share a protected faction and see the player with an unobstructed eye-to-eye ray. Kill witnesses must share a victim faction, see the killer and have an unobstructed ray to the victim.
Theft affects the container’s protected factions plus the witnesses’ affiliations. Killing a faction member affects only factions shared by the victim and witnesses. Injury affects the victim’s affiliations directly. Defence rewards go to the affiliations of protectors, rescued villagers and eligible villager witnesses, including the human side where configured.
Combat penalties for isekaiexpansion:side/monster and isekaiexpansion:side/undead apply while that side’s standing is positive. At 0 they apply only if civilisation is not hostile to that side; below 0 they are filtered out. This exception applies to injury and witnessed-kill penalties, not every reputation change.
Protected containers
Taking items through a container screen can trigger theft; merely opening it does not. A player-placed inventory block is exempt for every player, regardless of who placed it. Generated containers can retain faction ownership from loot filling. An unmarked container falls back to local city and village factions.
For a double inventory, the side holding the removed slot supplies the position and ownership. A player chest placed in a village does not become village property during loot filling. Without an eligible witness, taking protected items does not incur this theft penalty.
Factions and relations
Entity affiliations combine explicit assignments, NPC configuration and matching data rules. A rule can also include saved structure-origin factions. Walking into a settlement does not itself add its faction to an entity.
Relations resolve from persistent runtime overrides, then data-pack rules, then shared-faction friendly or otherwise neutral. Higher rule priority wins; equal-priority conflicts resolve hostile before friendly before neutral. These relations are separate from your numeric standing.
For targeting only, a hostile or monster-category entity without an explicit provider, NPC configuration or matching identity rule receives isekaiexpansion:side/monster. The fallback does not make every monster kill a reputation incident.
A relation steers who fights whom. A friendly relation stops a mob attacking you or another member, a hostile one lets it attack even where its own AI would not, and a neutral one leaves the choice to that AI. A proactive hostile relation also sends a mob after the other side on its own, once a second within its follow range. Tamed mobs and mounts you are riding never start such a hunt.
You belong to no faction unless a power enrols you, so by default every fight with you is left to vanilla AI. A creature that is friendly to you still fights back: the friendship lapses for 100 ticks (5 seconds) after you last hurt it.
Allies avenge each other
Members of the same authored faction stand together. When one is hurt or killed, nearby fighters that share one of its factions, are friendly with it and saw the attacker do it turn on that attacker, whether you or another mob struck the blow. Kill one illager in front of its patrol and the rest come for you.
| Incident | Who answers | Limit |
|---|---|---|
| Hurt | Idle fighters within 16 blocks | Once every 40 ticks (2 seconds) per victim |
| Killed | Fighters within 24 blocks not already chasing the killer | Up to 8 per kill |
A witness must see the attacker and have a clear line to the victim. A fighter is a mob that can deal melee damage, or a custom NPC, which then decides through its own combat AI. Tamed mobs stay with their owner. The implicit monster side and affinity factions never rally, so killing a skeleton does not turn endermen or zombified piglins against you, and sea creatures do not avenge one another. Allies do not turn on each other over a stray blow between them, but a player who attacks a faction’s ally is treated as having provoked every witness, even one that was friendly.
Bundled factions
| Faction | Members | Stands with | Hostile to |
|---|---|---|---|
isekaiexpansion:side/civilization | Villagers, guards, iron golems, wandering traders and red merchants | Each other | Monsters, raiders, undead and demons |
isekaiexpansion:side/raider | Pillagers, vindicators, evokers, illusioners, ravagers, witches, vexes and the illagers of Illager Invasion and Takes a Pillage | Raiders only | Civilization and undead; hunts dragons |
isekaiexpansion:side/undead | Members of #isekaiexpansion:undead; the bundled tag is empty and data packs supply members | Undead only | Civilization and raiders |
isekaiexpansion:side/piglin | Piglins and piglin brutes | Piglins only | Civilization |
isekaiexpansion:side/draconian_swarm | The Saints Dragons latcher, whettled and winged | The swarm only | Civilization |
isekaiexpansion:side/goblin | Goblin Traders goblins | Each other | None |
Raiders, undead, piglins and the swarm also carry isekaiexpansion:side/monster, which is how civilization knows to fight them. That side is neutral to itself: common monsters do not stand together, so a zombie never avenges a pillager or a creeper, and monsters that hit each other by accident may fight. Every other hostile mob counts as a monster for targeting only and has no community to rally. Third-party members apply only when their mod is installed.
| Bundled relation | Who | Effect |
|---|---|---|
| Sea kinship | Mermaid players and mermaid citizens, toward aquatic mobs and Myths of the Sea creatures | Friendly. Guardians, krakens and other sea creatures leave you alone, a pufferfish puffs up but does not sting you, and an elder guardian does not curse you with Mining Fatigue. |
| Sea predation | Sea creatures toward each other | Neutral, so guardians still hunt squid and axolotls still hunt fish. |
| Raider and dragon feud | Raiders toward dragons from Saints Dragons, Useless Reptile and Mythic Mounts | Hostile and proactive. Raiders attack dragons on sight and a dragon fights back through its own AI. Raiders treat you as a dragon while you wear a dragon form. |
Mermaid kinship comes from Aquatic Kinship, alongside the origin’s water abilities. The sea and dragon sides are affinities: hurting or killing those creatures never changes your standing. The Myths of the Sea and Saints Dragons rows apply only when those third-party mods are installed.
Wanted factions and Fate Balance
The Fate Balance countenance choices modify a change only if the affected faction already considers you wanted.
| Choice | Positive change | Negative change |
|---|---|---|
kind_countenance — Kind Countenance | ×1.25 | ×0.80 |
fierce_countenance — Grim Visage | ×0.80 | ×1.25 |
Results round to the nearest integer using the runtime’s rounding rule, keeping a nonzero result at least +1 or −1. Each faction is adjusted separately before the final standing clamps to its bounds. A change that first crosses −100 is not retroactively modified.
Village-related changes also feed minor positive or negative vanilla gossip. This bridge processes at most 12 villagers, prioritises direct participants, then searches a 48-block box, with gossip magnitude capped at 25. It does not replace the faction ledger.
Reading the report
The report includes the default factions and your recorded dynamic affiliations. Settlement names are deterministic from their faction IDs, but are not unique identifiers. Their description gives a bearing relative to your position when the report is requested; other dimensions are labelled separately.
| Standing label | Range |
|---|---|
| Revered | 750–1000 |
| Honored | 400–749 |
| Friendly | 100–399 |
| Neutral | −99–99 |
| Wary | −399–−100 |
| Hostile | −749–−400 |
| Hated | −1000–−750 |
These are display bands; the wanted threshold remains −100. Names and descriptions are composed by the server and sent with the current values.
Where the data lives
Entity membership and faction relations live under data/<namespace>/reputation/. Reputation data gives the complete authoring tables; Reputation runtime covers persistence, hooks and report composition.