NexusContracts - Escrow Quest System v1.1.0

NexusContracts v1.1.0
Auctions, Bounties, Insurance & a Faction Cold War

The biggest update yet — twelve new systems that turn the contract board into a full player-driven market, plus the infrastructure to keep it honest at scale.
​

New: Auction House

• Sealed-bid auctions: bids stay hidden until the window closes — highest bid wins, earliest bid breaks a tie. Re-bidding can be locked per server.
• Instant buyout: set a buy-it-now price (gated to a configurable multiple of the minimum bid) so a buyer can end the auction early. Displaced bidders are refunded in full.
• Auction bundles: sell several item stacks as a single lot. The held items are delivered to the winner automatically, or returned to you if nothing sells.

New: PvP Bounties

• Place a bounty on any player with /contracts bounty place. Multiple placements pool together — a single valid PvP kill pays the whole pool to the killer.
• Fair-play guards: optional PvP-flag requirement, self-claim blocking, a per-target cap, and a proportional refund to every placer if a bounty expires unclaimed.

New: Insurance Policies

• Buy coverage against death or contract failure with /contracts insurance buy. Premiums feed a pool; payouts come back out of it when a trigger fires.
• Recurring premiums with a grace period before a policy lapses, a configurable claim limit, and an under-funded fallback (deny or partial payout) so the pool can never go negative.

New: Faction Diplomacy

• Alliances & wars between your config-defined factions. Allies share a fraction of reputation gains; working for a faction at war with another docks reputation with the enemy.
• Runtime control via /nexuscontracts faction relation set, with an anti-flicker cooldown so relations can't be flipped back and forth instantly.

New: Leaderboards

• Ranked boards for per-faction reputation, contracts completed, and total trade volume. Rebuilt on a timer and cached, so reads are instant.
• New PAPI placeholders: %nexus_lb_<faction><rank>name% / _value% and %nexus_lb_global<category><rank>_name% for scoreboards and holograms.

🛠 New: Admin & Anti-Abuse Tooling

• Audit log: an append-only, exportable record of every money- and admin-relevant action. Query by player or contract, or export to CSV with /nexuscontracts audit.
• Rate limiting: per-player, per-action token-bucket limits on posting, bidding, and offers, with a bypass permission for staff.
• Pairing heuristic: flags suspicious repeat-trading pairs into an admin review list (/nexuscontracts antiabuse review) — detection only, never an automatic punishment.
• Reputation decay v2: choose linear or percentage decay, with a grace period and a configurable floor.

⚙ Engine & Safety

• Schema versioning: the database is version-checked on startup and automatically backed up before any migration runs — file copy for SQLite/H2, dump for MySQL/MariaDB. A failed backup aborts the migration rather than risking your data.
• Migration tool: import reputation from a CSV with configurable column mapping via /nexuscontracts import. Dry-run by default; add --commit to apply.
• Discord embeds for buyouts, bounties, insurance payouts, alliances, wars, and anti-abuse alerts — each individually toggleable.

Drop-in update. New tables and columns migrate automatically on first start (with an automatic pre-migration backup). All new systems ship disabled by default — enable what you want in config.yml.
​