YappersHQ.HitMark.Shared 1.0.1

<div align="center"> <h1><strong>HitMark</strong></h1> <p>Attacker-only hitmarkers, floating damage numbers, and hitsounds for CS2 — a ModSharp port of cs2-HitMark.</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-hitmark?gitlab_url=https%3A%2F%2Fgitlab.com" alt="License"> <img src="https://img.shields.io/gitlab/stars/cs2-server-plugins/cs2-hitmark?gitlab_url=https%3A%2F%2Fgitlab.com" alt="Stars"> </p>

HitMark spawns a particle hitmarker at the bullet impact point, floating per-digit damage numbers, and an optional hitsound — all rendered only for the attacker on each hit, with separate styling for headshots vs bodyshots. It's a ModSharp port of DearCrazyLeaf/cs2-HitMark.

🚀 Install

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

Restart the server (or change map) to load. Requires the LocalizerManager module (ships with ModSharp).

The repo does not bundle .vpcf particle assets — the upstream plugin doesn't ship them publicly. Damage numbers default to the particles/digits_x/digits_x.vpcf atlas; supply your own hitmark particles and point hm_headshot_particle / hm_bodyshot_particle at them.

⌨️ Commands

Per-player toggles, stored client-side:

⚙️ Configuration

ConVars are written to <sharp>/configs/hitmark.cfg on first run (one // help line per setting); edit values there and they're re-applied on every load.

🔧 How it works

On each damage event the plugin spawns view-anchored particle systems for the attacker only — the hitmark and damage digits are driven by control points on the digits_x atlas (CP16 color, CP32 atlas frame, CP34 scale, DataCP33 placement). Headshots and bodyshots use independent particle, color, sound, and lifetime settings, and a per-player cap limits how many hitmark particles can exist at once.

🧩 Public API

Other plugins consume IHitMarkShared (resolve in OnAllModulesLoaded) to veto rendering for specific clients via the CanShowFor event:

var api = sharpModuleManager
    .GetOptionalSharpModuleInterface<IHitMarkShared>(IHitMarkShared.Identity)?.Instance;

// Return false to suppress HitMark visuals for this client.
api!.CanShowFor += client => /* your condition */ true;

📦 Build

dotnet build -c Release

Outputs .build/modules/HitMark/HitMark.dll, .build/shared/HitMark.Shared.dll, and .build/locales/hitmark.json.

🙏 Credits

Port of DearCrazyLeaf/cs2-HitMark by DearCrazyLeaf — all credit for the original concept, particle design, and feature set belongs to them. Licensed under MIT.

<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>