No description
Find a file
Astra 4420d41048
Some checks failed
Build and Publish / build (push) Has been cancelled
Build and Publish / publish (push) Has been cancelled
zio fork 1.8.2b-zio17: no startup version check or banner
Removes upstream's PluginInfo: CheckVersion, which fetched upstream's
VERSION from GitHub on every load, and ShowAd, the console banner with
two encoded lines of personal messages. EnableUpdateCheck stays in the
config so existing files load, and does nothing.
2026-10-07 09:47:58 +01:00
.github Update build.yml 2026-06-17 02:47:31 +02:00
CS2-SimpleAdmin zio fork 1.8.2b-zio17: no startup version check or banner 2026-10-07 09:47:58 +01:00
CS2-SimpleAdmin-docs zio fork 1.8.2b-zio16: backport unban, rename and css_history from upstream 1.9.0 2026-10-03 12:08:45 +01:00
CS2-SimpleAdminApi .NET10, version bump 2026-06-17 02:21:51 +02:00
Modules .NET10, version bump 2026-06-17 02:21:51 +02:00
.gitattributes Initial commit 2023-12-02 19:22:01 +01:00
.gitignore zio fork 1.8.2b-zio16: backport unban, rename and css_history from upstream 1.9.0 2026-10-03 12:08:45 +01:00
CS2-SimpleAdmin.sln 1.6.0a 2024-09-28 18:03:03 +02:00
LICENSE 1.6.0a 2024-09-28 18:03:03 +02:00
README.md zio fork 1.8.2b-zio17: no startup version check or banner 2026-10-07 09:47:58 +01:00
release.sh release.sh: read the Forgejo token from ../../.forgejo-token when FORGEJO_TOKEN isn't set 2026-10-04 18:34:10 +01:00

zio.sh fork

This is zio.sh's fork of CS2-SimpleAdmin 1.8.2b (upstream is daffyyyy/CS2-SimpleAdmin, branched from the build-1.8.2b tag). Changes, all marked zio: in the code:

  • A gagged or silenced player can still send @message in team chat to reach online staff.
  • The gag/silence chat message says how long is left (or that it's permanent) and the reason, in place of "Your chat is blocked to: ". New lang keys sa_player_penalty_gag_active, ..._gag_active_perm, ..._silence_active, ..._silence_active_perm and sa_player_penalty_no_reason, in lang/en.json only (other languages fall back to it).
  • Moving to spectators doesn't unhide a hidden admin; only joining T or CT does.
  • A banned player is let in long enough to be told the reason and time left, then kicked after KickTime, instead of seeing only "Your client is not allowed to join this server".
  • New permission @css/bypassipban, for players or groups: IP bans, and bans on other accounts that share their IP, don't apply to them; a ban on their own SteamID still does. @css/root has it, as it has every @css flag.
  • Staff chat shows the sender's rank, from their highest #rank/... group (O, S.Admin, Admin, T.Admin, Mod, T.Mod, Helper, Guardian, the same as CS2-Tags' chat prefixes): @message in team chat and css_asay read >[STAFF][RANK] name: message, and @message in all chat and css_say from a player read [RANK] name: message (name: message if they have no rank group). A non-staff player's @message in team chat reads >[STAFF] name: message, all in purple. Console's css_say/css_asay are unchanged. New lang keys sa_staffchat_template, sa_staffsay_template, their _norank variants and sa_staffchat_template_player, in lang/en.json only.
  • css_psay from a player reads (PM) [RANK] name: message ((PM) name: message without a rank group); console's is unchanged. Lang keys sa_psay_template and sa_psay_template_norank.
  • admin_overrides.json reaches the admin menu too: every player and server entry names its command, and an overridden entry is checked with the override's check_type (any passes with one flag), as CSS checks the typed command. Upstream required every flag in the override.
  • css_penalties <player> (someone else's penalties) needs @zio/penalties or @css/root instead of @css/kick.
  • css_addadmin, css_deladmin and the admin menu's add/remove log rank changes (the player's highest-immunity group, and who changed it) to sa_rank_log, the table simpleadmin-web creates and lists as the public promotions/demotions log. If the table is missing, it warns once in the log and the admin change goes ahead.
  • With TimeMode 0 (online time only), a gag, mute or silence given in game now ends when its database row expires. Upstream matched the two by exact end time, which never matched for one given in game (the database stores the time to the second), so it lasted until the player reconnected. A penalty marked passed also stops applying at once, not on the next 61-second tick.
  • Targeting by part of a name: when several names contain it, one that is exactly it (any case) is picked, and otherwise the reply lists the matches. css_ungag, css_unmute and css_unsilence match online players by part of the name too (upstream needed the full name), falling back to the offline search only when no one online matches.
  • No startup version check or banner: upstream's PluginInfo (CheckVersion, which asked upstream's GitHub for its VERSION on every load, and ShowAd, the console banner with two encoded lines of personal messages) is removed. EnableUpdateCheck stays in the config, so existing files still load, and does nothing.

Backported from upstream 1.9.0 (commit 530f603), not marked zio::

  • css_unban applies at once: the ban cache is updated straight away instead of on the next 61-second refresh, and removeid clears the engine ban when UnlockedCommands is on.
  • css_prename survives restarts: renames are stored in the new sa_renames table (migration 017) and re-applied on connect and name change. css_rename from a hidden admin renames again.
  • New css_history <#userid|name|steamid64> [bans|gags|mutes|silences|warns] (@css/kick), and Players > History in the admin menu. Commands missing from an existing Commands.json are registered under their default name.
  • Left out: upstream's admin-loading changes (ours differ, see 1.8.2b-zio11), its css_say change and its css_penalties fix.

Publish with FORGEJO_TOKEN=... ./release.sh v<ModuleVersion> (ModuleVersion is 1.8.2b-zioN). It rebuilds from the committed source and uploads SimpleAdmin-<tag>.tar.gz to git.zio.sh (cs2/SimpleAdmin), laid out like game/csgo/. It holds the whole plugin (its libraries, all lang files and migrations) and shared/CS2-SimpleAdminApi, as upstream's own release does, so nothing from upstream needs installing first. It leaves out the optional FunCommands and StealthModule modules and configs/. The NickFox007 dependencies (AnyBaseLib, PlayerSettings, MenuManager) aren't in it either; the server's pre.sh installs them from their own releases.


Build and Publish GitHub Release Made with a lot of tea 🍵

Join the support Discord

CS2-SimpleAdmin


Manage your Counter-Strike 2 server with simple commands!
CS2-SimpleAdmin is a plugin designed to help you easily manage your Counter-Strike 2 server with user-friendly commands. Whether you're banning players, managing teams, or configuring server settings, CS2-SimpleAdmin has you covered.


🚀 Features

  • 🎮 Simple, Intuitive Commands: Manage players, teams, bans, and server settings using an easy command system.
  • 🗄 Full Database Integration: Reliable MySQL backend with optional experimental SQLite support for persistent data storage.
  • ⚡ Efficient and Lightweight: Designed to minimize server resource usage while maintaining robust functionality.
  • 🚨 Real-time Notifications: Instant in-game and Discord notifications to keep admins and players informed.
  • 🎛 User-Friendly Admin Interface: Plugin menus for quick and efficient management without complex commands.
  • 🔄 Multi-Server Compatibility: Manage and sync data across multiple servers seamlessly.
  • 🧩 Modular and Extensible: Tailor the plugin with API access to add custom commands and automation.
  • 📜 Complete Auditing Logs: Track all administrative actions rigorously for accountability.
  • 🌐 Discord Integration: Stream logs and alerts to your Discord channels for centralized monitoring.
  • 🤝 Community Driven: Open-source with ongoing contributions from a passionate community.

⚙️ Requirements

Ensure all the following dependencies are installed before proceeding


🚀 Getting Started

  1. Clone or Download the Repository:
    Download or clone the repository and publish to your addons/counterstrikesharp/plugins/ directory.

  2. First Launch Configuration:
    On the first launch, a configuration file will be generated at:

    addons/counterstrikesharp/configs/plugins/CS2-SimpleAdmin/CS2-SimpleAdmin.json
    

    Edit this file to customize the plugin settings according to your server needs.

  3. Enjoy Managing Your Server!
    Use the commands provided by the plugin to easily manage your server.


📁 Configuration

The configuration file (CS2-SimpleAdmin.json) will be auto-generated after the first launch. It contains settings for MySQL connections, command permissions, and other plugin-specific configurations.


📚 Documentation & Support

Access full documentation, guides, tutorials, and developer API references here:
CS2-SimpleAdmin Wiki


🛠️ Development

This project started as a base for other plugins but has grown into a standalone admin management tool. Contributions are welcome! If you'd like to help with development or have ideas for new features, feel free to submit a pull request or open an issue.


🤝 Contributing & Feedback

Help improve CS2-SimpleAdmin by:

  • Reporting bugs or requesting features on GitHub
  • Submitting pull requests with improvements
  • Participating in discussions and sharing ideas

💡 Credits

This project is inspired by the work of Hackmastr. Thanks for laying the groundwork!


☕ Support Development

If you find CS2-SimpleAdmin useful, consider supporting the ongoing development:
Buy me a coffee


📄 License

This project is licensed under the GPL-3.0 license - see the LICENSE file for details.