ReportMe

"Go ahead. Report me."

ReportMe turns Rust's F7 report system into a VIP perk engine and admin intelligence platform. VIPs get notified when someone reports them. Reporters get real, data-backed reassurance that their reports matter. Admins get auto-escalating alerts with trust scores powered by Steam and BattleMetrics data.

Every other report plugin is admin-only. ReportMe is the first one built for three audiences at once.

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) — 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-escalation pipeline — 3 unique reporters in 24h triggers NOTIFY, 5 triggers WARNING, 8 triggers CRITICAL (all configurable)
• Discord webhooks — every report to one channel, escalations to another, with formatted embeds showing trust data, Steam hours, 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 (top reported), reportme player (full history), reportme trust (score breakdown), reportme clear
• In-game settings panel — toggle data sources, Discord options, and change the chat command directly from the CUI — no file editing
• @mention on escalation — WARNING and CRITICAL escalations ping your Discord channel with @here

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)

Each tier is additive. No APIs required — but 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 — 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 and Discord options, 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 — reporter, target, reason, subject, detail, trust score, Steam hours, account age, playtime. Steam profile links included.
• Escalation channel: Threshold alerts with color-coded severity (orange NOTIFY / red-orange ESCALATION / red CRITICAL), @here mentions on WARNING and CRITICAL

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.
• Lazy enrichment: API data is only fetched when a report comes in, not on player connect. No connect-storm batching needed.
• 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():

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

Permissions

Chat Commands

Console Commands

Support

• For all questions and feedback, dm me (1928tommygun) on my discord at discord.gg/tommygun

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.