YappersHQ.CallAdmin.Shared 1.0.1

<div align="center"> <h1>📣 <strong>CallAdmin</strong></h1> <p>In-game player report system for CS2 ModSharp servers — players <code>!report</code> cheaters, admins claim and resolve them.</p> </div>

<p align="center"> <a href="https://github.com/Kxnrl/modsharp-public"><img src="https://img.shields.io/badge/framework-ModSharp-5865F2?logo=github" alt="ModSharp"></a> <img src="https://img.shields.io/badge/game-CS2-orange" alt="CS2"> <img src="https://img.shields.io/gitlab/license/cs2-server-plugins/cs2-calladmin?gitlab_url=https%3A%2F%2Fgitlab.com" alt="License"> <img src="https://img.shields.io/gitlab/stars/cs2-server-plugins/cs2-calladmin?gitlab_url=https%3A%2F%2Fgitlab.com" alt="Stars"> </p>

CallAdmin lets players report rule-breakers from chat and gives admins a claim/handle/dismiss workflow, with persistence (LiteDB / MySQL / PostgreSQL) and an optional Discord webhook notifier that posts an embed and edits it in place as the report progresses. It is a from-scratch ModSharp rewrite inspired by Impact123/CallAdmin (SourceMod) and 1Mack/CS2-CallAdmin (CounterStrikeSharp).

The plugin ships as several projects so you can run only what you need:

🚀 Install

Copy the build output into your ModSharp install (<sharp> = your sharp directory):

CallAdmin.Core writes a default configs/calladmin.json on first run if none exists. Restart the server (or change map) to load. CallAdmin uses ModSharp's CommandCenter, AdminManager and LocalizerManager, which ship with the framework. CallAdmin.Discord is optional — install it only if you want Discord notifications.

⌨️ Commands

All commands are chat-triggered (also usable from console).

Admin permissions are registered via MountAdminManifest under the CallAdmin table:

⚙️ Configuration

configs/calladmin.json

Auto-generated on first run. Report reasons, cooldowns and anti-abuse gates:

configs/calladmin.database.jsonc

Selects the persistence backend. Type is litedb (zero-config single file at sharp/data/calladmin.db), mysql, or postgresql. For MySQL/PostgreSQL, fill Host / Port / Database / User / Password.

configs/calladmin.discord.json (optional)

Used by CallAdmin.Discord. Set webhookUrl to enable; leave it empty to disable posting. Other keys cover the embed title/footer, an optional role mention, and the connect/lookup links shown in the embed.

🔧 How it works

A player runs !report <target> <reason>; Core resolves the target via ModSharp targeting, applies the cooldown / duplicate / immunity checks, then persists a Report through the database backend and fires the lifecycle events. Admins with @calladmin/handle see pending reports (!calls) and move each through claim → handled or dismiss. After persistence each transition raises a Report event on ICallAdminShared; CallAdmin.Discord subscribes to those events to POST a webhook embed on submit and PATCH it in place as the report is claimed, handled, dismissed or cancelled. If AdminPanel is installed, Core also surfaces the list/claim/handle/dismiss actions inside the in-game admin menu (resolved with a null-guard, so it stays standalone-safe).

🧩 Public API

Other plugins consume ICallAdminShared (resolve in OnAllSharpModulesLoaded) to subscribe to the report lifecycle or drive reports programmatically:

var callAdmin = sharpModuleManager
    .GetOptionalSharpModuleInterface<ICallAdminShared>(ICallAdminShared.Identity)?.Instance;

callAdmin.OnReportSubmitted += report => { /* react */ };
// also: OnReportClaimed, OnReportHandled, OnReportDismissed, OnReportCancelled

The interface also exposes SubmitReportAsync / ClaimReportAsync / MarkHandledAsync / DismissReportAsync / CancelReportAsync, lookups (GetReportAsync, GetPendingReportsAsync, GetReasons), RegisterTargetFilter (hide players from the target list), and SetExternalMessageIdAsync (store an external message id alongside a report). Handlers run synchronously on the publishing thread — offload network/DB work with _ = Task.Run(...).

📦 Build

dotnet build -c Release

Outputs:

• Modules → .build/modules/CallAdmin.{Core,Database,Discord}/
• Shared contracts → .build/shared/CallAdmin.{Shared,Database.Shared}/
• Locales → .build/locales/calladmin.json
• Example configs → .assets/configs.example/

🙏 Credits

• Concept and inspiration: Impact123/CallAdmin (SourceMod), 1Mack/CS2-CallAdmin (CounterStrikeSharp)
• ModSharp framework: Kxnrl/modsharp-public

<div align="center"> <p>Made with ❤️ by <a href="https://gitlab.com/cs2-server-plugins">yappershq</a></p> <p>⭐ Star this repo if you find it useful!</p> </div>