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, and there is deliberately no revenge timer — revenge is served through the existing bounty, report, badge and hot-revenge paths.
Bounties are item-escrow placed by Senior Sheriffs, funded by a /donate treasury; players run justice themselves through reports, commendations, 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.
Requires & integrates with
- Required
- Paper 26.2+, 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) · 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 two admin nodes.
| Command | Who | What it does |
|---|---|---|
| /rep [help] | Everyone | Rules summary (states, redemption paths, key commands); shown automatically on first join |
| /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 |
| /donate | Everyone | Open the donation chest; items fund the bounty treasury, 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 | Active bounties |
| /bounty track <player> | Everyone | Tracking compass toward a wanted outlaw (cooldown + accuracy fuzz from config) |
| /bounty treasury | Everyone | Read-only Sheriff’s Office treasury (pool value / reserved / available) |
| /bounty place <player> | Senior Sheriff+ | 9-slot item-escrow GUI on an outlaw; closing commits, closing empty cancels; pays the killer, refunds on pardon or 30-day inactivity |
| /daily | Everyone | Daily login streak status (current/best streak, claimed today?, tomorrow’s payout); the reward itself is granted automatically ~3 s after your first join each day |
| /pvp [on|off|status] | Pacifist / Retired | Opt into PvP ("warmode"); default off, 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); +peaceful rep per stack, gated on a logged crime |
| /pardon <player> | Sheriff+ | Reduce outlaw rep — Sheriff −25 %, Senior Sheriff −50 %, Marshal −100 %; refunds active bounties; pacifist-kill rep is floored |
| /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) |
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.bounty | true | /bounty — placement gated Senior Sheriff+ in code |
| 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 |
Legacy pireputation.* nodes are declared as children of the matching frontier.reputation.* nodes, so old permission grants keep working.
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. - +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.