FrontierReputation
Wild West reputation, bounties, wanted posters and daily login rewards.
What it does
Every player is in one of four states: Pacifist (the default — cannot die from PvP, gets knocked out at 1 HP and robbed instead), Lawman (a five-tier ladder from Citizen to Marshal, entered by killing an outlaw and taking the badge), Outlaw (Drifter to Legend of the Frontier, listed on /wanted and bounty-able) or Retired.
Rep is never negative — three independent pools (outlaw / peaceful / violence) grow from actions, and the lawman ladder needs *both* peaceful and violence rep plus a number of unique commenders, so a pure builder and a pure killer both cap at Citizen. Self-defense is free (a kill within 30 s of being hit by the victim earns no outlaw rep), outlaw-on-outlaw kills are neutral rivalry by default, and there is deliberately no revenge timer — revenge is served through the existing bounty, report, badge and hot-revenge paths.
Bounties are cash: anyone but an Outlaw can put their own money on an outlaw with /bounty place <player> <amount>, and the killer collects the total. It only moves money between players, so it cannot mint any. The /donate reward pool is separate and pays the automatic item reward drops Lawmen get for outlaw kills, under weekly server-wide caps. Players run justice themselves through reports, commendations, denouncements, restitution and pardons, each with anti-abuse caps. A streak-based daily login reward (money + item kits) rounds it out. Tuned for a friend-group server of roughly 10–20 active players.
Season 2 guardrails: combat-logging leaves a lootable logout body for 5 minutes instead of killing you on return; clean-hour rep and outlaw decay only count real activity; spawn is no-PvP and lava, fire, TNT and beds can’t be used near other players; an outlaw who dies to a Lawman sheds rep scaled by the gear they carried; and rep-trusted spawn builders get build access in the Spawn land. It can also post to the Frontier Gazette and run a weekly commend shoutout (both through FrontierAnnouncements).
Requires & integrates with
- Required
- Paper 26.3+, Java 25+, FrontierTab — hard dependency, provides the tab/chat tier prefixes. The plugin will not load without it.
- Optional
- Vault + an economy (daily-reward money and rep-reward payouts; skipped without it) · FrontierMail (daily-reward overflow items go to
/mailboxinstead of dropping at your feet) · FrontierEvents (arena/event combat is exempt from all reputation effects) · mcMMO (XP boost while PvP-effective) · FrontierBorder (itsserver-timezonesets the "midnight" used by daily/weekly resets) · FrontierAnnouncements (Gazette posts and the weekly commend shoutout) · Lands (own-land exception to the hazard rule; spawn-builder access to the Spawn land) · any claim plugin that cancels PvP damage (Lands, WorldGuard, GriefPrevention — inside PvP-denied claims the rep system does nothing) - Used by
- FrontierStatsAPI (reads
data.dbfor leaderboards, wanted posters, profiles, economy and streaks) · FrontierTab (displays the tier prefixes)
Heads up: this plugin will not enable without FrontierTabinstalled. Everything else listed as optional is genuinely optional — the feature simply doesn't appear.
Commands
Tier gates (Deputy+, Sheriff+, Senior Sheriff+, Marshal) are enforced in code by lawman tier — the permission nodes below are all granted to everyone except the three op nodes.
| Command | Who | What it does |
|---|---|---|
| /rep [help] | Everyone | Rules summary (states, redemption paths, key commands); shown automatically on first join |
| /rep title <hide|show> | Everyone | Hide or show your reputation title |
| /whois <player> | Everyone | Full reputation lookup — state, rep pools, tiers, recent crimes; self-view while Outlaw appends the redemption path |
| /wanted [player] | Everyone | Top-5 outlaws by tier, or one player’s wanted poster |
| /badge <yes|no> | Everyone | Accept or decline the Deputy badge after your first outlaw kill |
| /commend <player> <reason> | Everyone | Award peaceful rep (uses a charge; charges accrue from playtime; 6 h cooldown per recipient) |
| /commend list [player] | Everyone | Commendations you (or another player) received — commender, reason, date |
| /denounce <player> <reason> | Everyone (not Outlaws) | Flag a player to staff. Costs a commend charge and needs 5 h of non-AFK play; max 3 a day, once per target per week. When 2+ players on different connections denounce the same player within 7 days it goes to the staff queue, and staff can take −10 (minor) or −25 (serious) peaceful rep |
| /donate | Everyone | Open the donation chest; items fund the reward pool behind Lawmen's automatic reward drops, donors earn capped peaceful rep |
| /donate log [count] | pool | top | Everyone | Donation ledger, current pool contents, top donors |
| /report <player> <reason> | Everyone | File a complaint (needs reports.reporter_min_playtime_hours playtime; 24 h cooldown per target) |
| /report list|view|approve|deny|reverse … | Deputy+ | Adjudicate reports; false reports cost the reporter peaceful rep |
| /bounty [list] | Everyone | One line per Outlaw with a bounty: total cash and number of posters |
| /bounty track <player> | Everyone | Tracking compass toward an Outlaw (position fuzzed ±100 blocks, 10-min cooldown) |
| /bounty treasury | Everyone | Read-only Sheriff’s Office reward pool (donated items behind the automatic reward drops; separate from posted bounties) |
| /bounty place <player> <amount> | Everyone but Outlaws | Post a cash bounty from your own balance (2500, 2,500 or 2.5k; $250 minimum, no maximum). Pacifists and Retired wait 48h between posts (persisted), Lawmen have no cooldown. Bounties stack; the killer gets every bounty on the target as cash, a poster who kills their own target gets their money back, and a pardon, 30 days of target inactivity or a shared-IP void refunds the poster (offline too) |
| /daily | Everyone | Daily login streak status (current/best streak, claimed today?, tomorrow’s payout); the reward itself is granted automatically once you’ve played 10 minutes that day, for at most 2 accounts per connection |
| /pvp [on|off|status] | Pacifist / Retired | Opt into PvP ("warmode"); default off, needs 5 h of playtime, 30-min toggle cooldown, refused while combat-tagged; Outlaws and Lawmen are always on |
| /restitution <victim> | Outlaws only | 27-slot UI to return stolen items (online victim → inventory, offline → mailbox). Earns no peaceful rep: it pays down the outlaw rep charged for crimes against that victim, and only raw diamonds, emeralds, netherite and their blocks give credit (gear counts 0) |
| /pardon <player> | Sheriff+ | Reduce outlaw rep — Sheriff −25 %, Senior Sheriff −50 %, Marshal −100 %; refunds active bounties; one pardon per target per 7 days across all pardoners; murder rep is floored (see pardon_unforgivable_floor_pct) |
| /marshal grant-rep <player> <amount> <reason> | Marshal / Admin | Admin-light rep adjustment |
| /marshal audit <player> | audit-by <player> | Marshal / Admin | Corruption-detection trail of lawman actions |
| /repadmin reload | Admin | Re-read config.yml live |
| /repadmin setrep <player> <outlaw|peaceful|violence> <amount> | Admin | Manually set a rep pool |
| /repadmin state <player> <PACIFIST|LAWMAN|OUTLAW|RETIRED> | Admin | Manually set a state |
| /repadmin reset-rep <player> confirm | Admin | Emergency full wipe to new-player state (refunds bounties, deletes crimes/reports/commendations against the target; audit logs kept) |
| /repadmin spawnbuilders | spawnbuilder … | Admin | Spawn builders — the rep-trusted players who get build access in the Spawn land |
| /repadmin shoutout [status|preview|now] | Admin | The weekly commend shoutout: status, a preview, or post it now |
| /repadmin commendflags | Admin | Commendations flagged by the anti-abuse checks |
| /repadmin bodies | Admin | Logout bodies (combat-log stand-ins) |
| /repadmin afkflags | Admin | Players flagged by the activity/AFK checks |
| /repadmin denounces | Admin | The denouncement queue |
| /repadmin denounce confirm|dismiss … | Admin | Uphold or dismiss a queued denouncement |
Permissions
Player features default to true, staff features to op. Every node follows frontier.<plugin>.<action>, so a LuckPerms setup is e.g. lp group default permission set frontier.shop.use true. Wildcards work: frontier.reputation.*.
| Node | Default | Grants |
|---|---|---|
| frontier.reputation.rep | true | /rep |
| frontier.reputation.whois | true | /whois |
| frontier.reputation.wanted | true | /wanted |
| frontier.reputation.badge | true | /badge |
| frontier.reputation.commend | true | /commend (award + list) |
| frontier.reputation.donate | true | /donate (UI + log/pool/top) |
| frontier.reputation.report | true | /report — filing; adjudication gated by lawman tier in code |
| frontier.reputation.denounce | true | /denounce — Outlaws refused in code |
| frontier.reputation.bounty | true | /bounty — placement open to everyone but Outlaws |
| frontier.reputation.daily | true | /daily |
| frontier.reputation.pvp | true | /pvp opt-in toggle |
| frontier.reputation.restitution | true | /restitution — outlaws only, checked in code |
| frontier.reputation.pardon | true | /pardon — Sheriff+ checked in code |
| frontier.reputation.marshal | true | /marshal — Marshal tier or admin, checked in code |
| frontier.reputation.admin | op | /repadmin, plus admin bypass of the tier gate on /marshal |
| frontier.reputation.combat.bypass | op | Bypass the combat-tag teleport-command block |
| frontier.reputation.hazard.bypass | op | Bypass the rule against lava, fire, TNT and beds near other players |
Legacy pireputation.* nodes are still declared, but children only resolve downward: holding pireputation.x does not grant frontier.reputation.x. Old grants appear to keep working only because every player node defaults to true.
Config reference
File
plugins/FrontierReputation/config.yml
To apply changes
/repadmin reload — never use Bukkit /reload, it wipes in-memory knockout and provocation state
Good to know
- +All state lives in
plugins/FrontierReputation/data.db(SQLite, WAL mode; schema auto-migrates on boot). Never use Bukkit/reload— restart instead./repadmin reloadis safe for config. - +Inside any claim where PvP is denied the plugin does nothing (no knockout, no rep) — except Outlaw victims, who lose claim protection when
outlaw_land_protection_bypassis on. Keep claim-plugin "war" modes off; they create the two-factions dynamic the design rejects. - +Daily and weekly resets roll at midnight in the server’s JVM timezone; set FrontierBorder’s
server-timezoneif your host clock is UTC. - +The config table quotes shipped defaults; where mc.pvpers.us runs a different value, the row says so.
- +Only plain PvP damage is seen — environmental kills (lava pushes, traps) earn no rep. Multi-attacker assist credit and friend-farmed commendations are known open items.
- +Most-tweaked knobs:
ladders.lawmanthresholds (scale unique-commenders to your player count),states.pacifist.knockout_*,redemption.*, and thedaily_rewardmoney curve.
Looking for something specific? Search the whole suite.