YappersHQ.WeaponMenu.Shared 1.0.1

<div align="center"> <h1><strong>WeaponMenu</strong></h1> <p>Let players pick their primary/secondary loadout from a menu (or chat command) each round — for CS2 servers running ModSharp.</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/stars/cs2-server-plugins/cs2-weaponmenu?gitlab_url=https%3A%2F%2Fgitlab.com" alt="Stars"> </p>

WeaponMenu gives players a !guns menu to choose a weapon, optionally exposes one chat/console command per weapon (!ak47, !awp, …), remembers the last choice and auto-gives it on spawn, and gates everything behind a configurable starting round and per-round budget. It is a ModSharp port of asapverneri/CS2-Gunsmenu.

🚀 Install

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

Restart the server (or change map) to load. Requires the ModSharp MenuManager, LocalizerManager, AdminManager, and ClientPreferences modules.

⌨️ Commands

All commands work from both chat (!guns) and console (guns).

Commands are blocked unless the player is alive, has the configured permission (if set), and the live round is at least minRound.

⚙️ Configuration

configs/weaponmenu.json:

🔧 How it works

Commands are installed through ModSharp's client-command system, so each one responds to both chat and console. Picking a weapon from the menu (or via a direct command) calls a weapon giver and, when rememberLastChoice is on, stores the choice in ClientPreferences cookies. On spawn the auto-give module reads those cookies and re-equips the saved loadout. A round tracker counts live rounds (optionally including warmup) so the minRound gate and per-round budget reset correctly across round transitions.

🧩 Public API

Other plugins can veto access per client by subscribing to IWeaponMenuShared (resolve in OnAllModulesLoaded):

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

// Return false to block a client from using the menu/commands.
api.CanUseFor += client => client.Team == CStrikeTeam.CT;

📦 Build

dotnet build -c Release

Outputs .build/modules/WeaponMenu.Core/WeaponMenu.Core.dll and .build/shared/WeaponMenu.Shared/WeaponMenu.Shared.dll.

🙏 Credits

Port of asapverneri/CS2-Gunsmenu.

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