Configuration

NeroFactions uses Neroland Core's config framework. The file is config/nerofactions.properties, created on first launch and hot-reloadable with /neroland config reload. Every key below is server-authoritative (the server's value rules, whatever a client has set) except telemetryEnabled, which is deliberately client-local — anonymous crash reporting is each player's own choice and a server must never force it on or off.

Telemetry

KeyTypeDefaultRangeMeaning
telemetryEnabledbooleantrue—Send anonymous, NeroFactions-only crash reports (Sentry, EU servers): stack trace, mod/MC/loader/OS/Java versions, the list of other installed mods, this mod's config and anonymous stability data — never IPs, usernames, UUIDs, world data, faction membership, reputation values or chat; file paths are scrubbed of your account name. false opts out of all of it; nothing is sent while disabled, and nothing is ever sent before your config choice has loaded. See Privacy.
KeyTypeDefaultRangeMeaning
linkModuleEnabledbooleantrue—Whether the NeroLink companion module is registered. Snapshots are per-player scoped and never enumerate other players. false removes NeroFactions from companion apps entirely. See Link module.

Factions, tiers and membership

KeyTypeDefaultRangeMeaning
allowMultipleFactionsbooleanfalse—Whether a player may belong to more than one faction at once. Off (the default) is the single-allegiance rule: joining a second faction is refused until the first is left.
joinCooldownMinutesint300–10080Real-time minutes a player must wait after leaving a faction before joining any faction again. 0 disables the cooldown. Max one week.
switchPenaltyPointsint500–100000Reputation points lost with a faction the moment a player leaves it (0 disables). The remainder then decays per decayPointsPerDay.
decayPointsPerDayint250–100000How many reputation points a left faction's standing moves toward 0 per whole real-time day after leaving. Standing is never wiped or frozen by leaving; it erodes at this rate and stops at 0. 0 disables decay.
enemyBleedRatiodouble0.50.0–1.0When a source award grants reputation with a faction, each faction on its enemies list loses round(award × this ratio). Applies only to source awards — never to decay or admin writes. 0.0 disables enemy bleed entirely.

Reputation sources — weights and daily caps

Weights multiply the base award; caps are per player, per faction, per source, per real-time day. Admin grants have neither.

KeyTypeDefaultRangeMeaning
questSourceWeightdouble1.00.0–10.0Multiplier applied to reputation awarded from quests.
questDailyCapint3000–1000000Max reputation a player can earn per faction per day from quests.
eventSourceWeightdouble1.00.0–10.0Multiplier applied to reputation awarded from server events (reserved — nothing fires this source yet).
eventDailyCapint3000–1000000Max reputation a player can earn per faction per day from server events.
combatSourceWeightdouble0.60.0–10.0Multiplier applied to reputation awarded from combat.
combatDailyCapint1500–1000000Max reputation a player can earn per faction per day from combat.
tradeSourceWeightdouble0.30.0–10.0Multiplier applied to reputation awarded from trading.
tradeDailyCapint1000–1000000Max reputation a player can earn per faction per day from trading.

Internal triggers and trade

KeyTypeDefaultRangeMeaning
combatAwardBaseint20–1000Base reputation awarded (before the combat weight and daily cap) with each faction the player is a member of when they kill a hostile monster. 0 disables the internal combat trigger entirely.
tradeAwardBaseint20–100Base reputation awarded (before the trade weight and daily cap) with a faction each time the player completes a trade at its trade terminal. 0 disables the terminal's reputation earning entirely.

Market pricing (with NeroEconomy installed)

These two keys also clamp the trade terminal's own exchange rates, so one pair of knobs bounds faction pricing everywhere.

KeyTypeDefaultRangeMeaning
discountCapPercentint150–50The largest total market discount (percent) faction standing can ever grant a buyer, regardless of datapack trade multipliers.
surchargeCapPercentint250–100The total market surcharge (percent) applied when a listing's aligned faction lists one of the buyer's factions as an enemy — this single knob is both the surcharge and its cap.

Data retention

KeyTypeDefaultRangeMeaning
retentionDaysint3650–3650Days of player inactivity (per Neroland Core's shared last-seen record) after which this mod's own daily sweep purges that player's NeroFactions data — standing, memberships, cooldown, decay bookkeeping, accrual counters, reward watermarks and the recovery backups. Complements Core's ecosystem-wide dataRetentionDays sweep (opt-in, default 0, driven by /neroland data purge-inactive), which already erases NeroFactions data through the shared erasure hook; this key lets faction data expire on its own schedule even when Core's sweep is off. 0 disables this mod's sweep. Players with no Core activity record are never auto-purged (their inactivity cannot be established).

Search across every Nero mod wiki.