ReportMe

Anti-cheat that auto-bans on connect and F7 reports, with VIP alerts and trust scoring.

$20.00
Version: 1.4.1
Last updated Jul 4, 2026
admin anti-cheat monetization

Instant digital download — delivered to your email after purchase
Documentation

Description

"Go ahead. Report me."

ReportMe started as a VIP perk built on Rust's F7 report system. It's now a working anti-cheat: it turns F7 reports and BattleMetrics data into automatic bans. It catches cheaters as they connect and shuts down the ones your players report, without banning your regulars.

It's still the only report plugin built for three audiences at once (VIPs, reporters, and admins), but now the admin side actually pulls the trigger.

Now a Working Anti-Cheat

ReportMe doesn't just surface reports anymore. It bans cheaters automatically, on two independent fronts:

  • At connect: known-bad accounts are caught and banned as they join. No admin online required.
  • From reports: sustained F7 report pressure results in a ban, weighted by evidence so the clear cases go down fast.

No kernel driver, no client-side anti-cheat, nothing for players to install. It runs on the BattleMetrics API. A free API token gets you started, and connect-time detection is strongest on servers already running BattleMetrics RCON.

It gets stronger with your network. The more organizations you share player data with on BattleMetrics, the more alt accounts and ban history the system can see, and the more cheaters it catches the moment they connect.

Won't Ban Your Regulars

The usual reason admins won't automate bans is fear of nuking legit players. ReportMe is tuned so your established regulars are protected from false bans and report brigades. It's automated enforcement you can actually leave running.

Ships Safe

Installs inert and runs in shadow mode by default, logging exactly what it would ban, with the full evidence, without touching a soul. Watch it for a few days, then flip one setting to go live when you trust it.

Bans, Alerts & Appeals

  • Local + BattleMetrics ban in a single action, with the full evidence bundle on the ban record.
  • Discord alert on every ban. Searchable the moment an appeal lands.
  • One-command reversal. reportme unban <steamid> clears the local and BattleMetrics ban together, so resolving a ticket is a single action.
  • Appeal route in the ban message. Players are pointed to your Discord to contest it.

For VIP Players

When a VIP gets F7 reported, they get a styled in-game notification:

"PlayerName reported you for cheating. Must be doing something right."

  • Real-time CUI notification: color-coded banner by report type (red for cheating, orange for griefing, yellow for abuse)
  • Sound effect alert: configurable sound on report
  • Report history panel: /reportme opens a full tabbed CUI with scrollable report list, timestamps, reporter names, and trust score
  • Trust score display: VIPs see their trust rating (High / Moderate / Below Average / Low), which gamifies good behavior
  • Sell it as a VIP perk: grant reportme.vip to your VIP group and you have a new perk that costs nothing to maintain

For Reporters

When a player files an F7 report, they get instant feedback, not silence:

  • "Thank you. This player has 2,400 hours in Rust and their account is 8 years old. We take all reports seriously."
  • Feedback is personalized based on the reported player's trust data: hours, account age, server playtime, BattleMetrics cross-server hours
  • If no data is available, they still get acknowledgment: "We will review it."
  • Low-trust targets get flagged: "This player has been flagged and is under review."
  • Duplicate reports within 24 hours are quietly filtered: no spam, no false escalation
  • Optional VIP transparency warning: "Note: the player you reported is a VIP and can see your report info."

This makes reporters feel heard. That's a player retention signal: "this server takes cheating seriously."

For Admins

  • Auto-ban pipeline: the connect gate and the report path both funnel through one unified ban flow with shared Discord and admin alerts
  • Auto-escalation alerts: NOTIFY / WARNING / CRITICAL tiers with @here pings on the high-pressure targets, even before a ban fires
  • Discord webhooks: every report to one channel, escalations and bans to another, with formatted embeds showing trust data, Steam hours, alt evidence, and profile links
  • In-game CUI dashboard: /reportme <player> opens a 5-tab panel (Overview, Reports, Trust breakdown, Info, and Settings)
  • Console commands: reportme list, reportme player, reportme trust, reportme why, reportme check, reportme ban, reportme unban, reportme clear
  • In-game settings panel: toggle data sources, Discord options, auto-ban switches, and the chat command directly from the CUI, no file editing

Trust Scoring Engine

ReportMe computes a 0.0–1.0 trust score for every player using all available data:

  • Server playtime (always available, self-tracked or via PlaytimeTracker if installed)
  • Steam Rust hours and account age (with Steam API key, free)
  • BattleMetrics hours across all servers (with BM API token, free tier)
  • Report density: reports per 100 hours played in a 30-day window
  • Private profile as a negative signal

The scoring algorithm dynamically rebalances weights based on which data sources are available. Works with zero configuration (server playtime + report density only), and gets smarter as you add API keys.

Data Enrichment (Layered)

Tier Source What You Get Cost
0 Built-in Server playtime, report density, first seen date Free (always on)
0.5 PlaytimeTracker Lifetime playtime (survives wipes), AFK filtering Free plugin (optional)
1 Steam Web API Rust hours, account age, profile visibility Free API key
2 BattleMetrics Cross-server hours, Rust-ban history, server count Free API token

Each tier is additive. The report side works with no APIs at all. The anti-cheat needs a BattleMetrics token for enrichment and ban issuance, and its connect-time alt detection is strongest on servers already running BattleMetrics RCON. The more you connect, the smarter the system gets.

Full CUI Panel

Dark-themed, blurred background, tabbed interface with sidebar navigation:

  • Overview: Player avatar, name, total reports, trust score with progress bar, 24h stats, server playtime, first seen date, and enrichment data
  • Reports: Scrollable history (up to 30 entries), color-coded accent stripe by type, subject, reporter name, relative timestamps, and report detail text
  • Trust (admin): Full score breakdown of positive factors (server time, Rust hours, account age, BM hours) and negative factors (report frequency, private profile), each with progress bars showing contribution
  • Info (admin): Command reference, permission reference, and setup guide
  • Settings (admin): Live toggles for data sources, Discord options, and auto-ban switches, API key status, webhook status, chat command input, all editable in-game without touching config files

Discord Webhooks

Two configurable webhook URLs:

  • Report channel: Every F7 report gets a formatted embed with reporter, target, reason, subject, detail, trust score, Steam hours, account age, and playtime. Steam profile links included.
  • Escalation channel: Threshold alerts and bans with color-coded severity, @here mentions on WARNING and CRITICAL, and the full ban evidence bundle on every auto-ban

Smart Features

  • Deduplication: Same reporter + same target within 24 hours = silently dropped. No duplicate notifications, no inflated escalation counts.
  • Self-report blocking: Players can't report themselves.
  • Crash-safe persistence: Async saves with atomic file writes. Session time flushed every 5 minutes. Max data loss on crash: 5 minutes.
  • Auto-pruning: Reports older than 90 days (configurable) are automatically cleaned up on load.
  • History cap: 100 reports per player (configurable). Oldest entries trimmed automatically.
  • Configurable chat command: Change from /reportme to anything via config or the in-game settings panel.

Plugin API (for developers)

Other plugins can query trust scores, report counts, and playtime via plugins.Call():

Method Returns Description
API_GetTrustScore(ulong steamid) float Computed trust score (0.0–1.0). Returns 0.5 (baseline) if no profile exists.
API_GetTrustLabel(ulong steamid) string Trust label: "High", "Moderate", "Below Average", or "Low"
API_GetReportCount(ulong steamid) int Total deduplicated report count (lifetime)
API_GetRecentReportCount(ulong steamid, int days) int Number of reports received in the last N days
API_GetUniqueReporterCount24h(ulong steamid) int Number of unique reporters in the last 24 hours
API_GetPlaytimeSeconds(ulong steamid) double Total tracked server playtime in seconds (PlaytimeTracker or self-tracked)

Use cases: queue priority systems, loot table adjustments, VIP tier plugins, custom admin dashboards, third-party Discord bots.


Permissions

Permission Default Description
reportme.vip Manual grant Receive in-game notification when reported. Access /reportme to view own report history and trust score.
reportme.admin Manual grant Full access: view any player's reports, console commands (including ban/unban), escalation alerts, admin CUI tabs (Trust breakdown, Info, Settings).
reportme.notify.reporter All players (auto-granted) Reporter receives acknowledgment CUI with data-backed feedback after filing an F7 report.

Chat Commands

Command Permission Description
/reportme reportme.vip or reportme.admin Open the report panel showing your own report history, trust score, and stats
/reportme <name or steamid> reportme.admin Open the report panel for any player: full admin view with trust breakdown, enrichment data, and settings

Console Commands

Command Permission Description
reportme list reportme.admin / server console List top 20 most reported players, sorted by 24h report count then lifetime total.
reportme player <steamid> reportme.admin / server console Full report history for a player: total received/filed, 24h count, unique 24h reporters, recent reports with timestamps and details.
reportme trust <steamid> reportme.admin / server console Detailed trust score breakdown: final score, baseline, each positive/negative factor with its weight, data sources.
reportme why <steamid> reportme.admin / server console Print the full rationale behind a player's ban: every signal that contributed. The go-to for handling an appeal.
reportme check <steamid> reportme.admin / server console Run the anti-cheat risk assessment for a player on demand and print the result.
reportme ban <steamid> [reason] reportme.admin / server console Manually issue a local + BattleMetrics ban with the same context bundle and Discord alert as an auto-ban.
reportme unban <steamid> reportme.admin / server console Clear the local ban and delete the BattleMetrics ban list entry. Single-action appeal reversal.
reportme clear <steamid> reportme.admin / server console Clear all reports for a player. Logged to server console.

Support

License

TOMMYGUN'S EULA – BY USING THIS PLUGIN YOU AGREE TO THE FOLLOWING!

  • Code contained in this file is not licensed to be copied, shared, resold, or modified in any way.
  • You may copy the plugin freely to each server instance that your organization owns.
  • Do not share this plugin with other server organizations; they must purchase their own licenses.

Customer Reviews


Discussion

Be the first to start the discussion!

Leave a Comment

0/2000