Counter-Strike 2 Addons
by Ericran
Description
Adds a Plugins tab to Counter-Strike 2 servers for managing Metamod:Source and CounterStrikeSharp - without SSH, and without hand-editing files.
What it does
- Installs both platforms in one click, from their latest release, downloaded and unpacked on the node - with an update button when a newer one ships.
- Lists every plugin found on disk, merged with live runtime state from the server console: Running, Enabled, Stopped, Awaiting load, Error or Files missing.
- Enable and disable persistently (the plugin folder moves in and out of
plugins/disabled/), or load and unload immediately over RCON without a restart. - Installs plugins from a zip - release archive layouts are detected and
unpacked to the right place, including the
shared/contract assemblies some plugins need in order to load at all. - A curated catalog - MatchZy, CS2-SimpleAdmin, Retakes, WeaponPaints, K4-System - installable straight from their GitHub releases, with update badges on installed rows.
- Snapshots of
plugins/,configs/plugins/andshared/, taken automatically before anything overwrites files and restorable in one click. They double as the transfer format for copying a setup between servers. - Config, admins and log editing - per-plugin JSON configs with
validation, a structured editor for
admins.jsonandadmin_groups.json, and a filterable log viewer. - A Doctor dialog that runs every health check in one pass: launch
parameters, RCON,
gameinfo.giwiring, folder placement and layout, shared assemblies, manifest orphans, ambiguous.vdfaliases, plugins that failed to load, and leftover downloads.
Why the diagnostics matter
CounterStrikeSharp gives very little away when a plugin fails to load, and a
single failure is contagious: a plugin that throws during load leaves CSS
holding a context with no instance, and every later css_plugins load then
fails on it - so one broken plugin stops hot-loading for all of them. This
tab reads the CounterStrikeSharp log and names the plugin and the assembly it
could not find, instead of leaving you with a red icon.
Also included
gameinfo.girepair - CS2 updates keep stripping the Metamod search path. There is a Fix button, and a 6-hour sweep that re-wires every CS2 server automatically.- A CS2-tolerant RCON protocol replacing the panel's built-in Source
client for
cs2servers: multi-packet replies, oversized packets, both auth response shapes and CS2's unsolicited console output are handled rather than erroring out. - An audit history of panel actions, and a restart banner when changes are genuinely waiting for one.
Requirements
- A GameAP panel with the
gameap-netandgameap-schedulerhost modules (4.4.0 or newer). - A Counter-Strike 2 server created with the stock
cs2game; the tab is shown on Source 2 servers only. - Platform installs and snapshots run
curl,tarandunzipon a linux node. - An RCON password on the server - GameAP generates one automatically when the server is created, so this is normally already set. It is what powers live statuses and hot load/unload; without it the tab still works, everything file-based keeps working, and a hint explains what is unavailable.
Credits
Based on gameap/plugin-goldsrc-addons by the GameAP project, the equivalent panel plugin for GoldSource servers. The architecture, route design and much of the structure come from it. MIT licensed, as is the original.
It pairs with cs2-addons-manager, a server-side CounterStrikeSharp plugin
offering the same management from the game console - both maintain the same
plugins_meta.json, so comments and groups stay in sync. Neither requires the
other.