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. |
||
|---|---|---|
| .github | ||
| CS2-SimpleAdmin | ||
| CS2-SimpleAdmin-docs | ||
| CS2-SimpleAdminApi | ||
| Modules | ||
| .gitattributes | ||
| .gitignore | ||
| CS2-SimpleAdmin.sln | ||
| LICENSE | ||
| README.md | ||
| release.sh | ||
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
@messagein 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_permandsa_player_penalty_no_reason, inlang/en.jsononly (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/roothas it, as it has every@cssflag. - 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):@messagein team chat andcss_asayread>[STAFF][RANK] name: message, and@messagein all chat andcss_sayfrom a player read[RANK] name: message(name: messageif they have no rank group). A non-staff player's@messagein team chat reads>[STAFF] name: message, all in purple. Console'scss_say/css_asayare unchanged. New lang keyssa_staffchat_template,sa_staffsay_template, their_norankvariants andsa_staffchat_template_player, inlang/en.jsononly. css_psayfrom a player reads(PM) [RANK] name: message((PM) name: messagewithout a rank group); console's is unchanged. Lang keyssa_psay_templateandsa_psay_template_norank.admin_overrides.jsonreaches the admin menu too: every player and server entry names its command, and an overridden entry is checked with the override'scheck_type(anypasses 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/penaltiesor@css/rootinstead of@css/kick.css_addadmin,css_deladminand the admin menu's add/remove log rank changes (the player's highest-immunity group, and who changed it) tosa_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
TimeMode0 (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_unmuteandcss_unsilencematch 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 itsVERSIONon every load, andShowAd, the console banner with two encoded lines of personal messages) is removed.EnableUpdateCheckstays in the config, so existing files still load, and does nothing.
Backported from upstream 1.9.0 (commit 530f603), not marked zio::
css_unbanapplies at once: the ban cache is updated straight away instead of on the next 61-second refresh, andremoveidclears the engine ban whenUnlockedCommandsis on.css_prenamesurvives restarts: renames are stored in the newsa_renamestable (migration 017) and re-applied on connect and name change.css_renamefrom 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 existingCommands.jsonare registered under their default name. - Left out: upstream's admin-loading changes (ours differ, see
1.8.2b-zio11), itscss_saychange and itscss_penaltiesfix.
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.
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
- CounterStrikeSharp
- PlayerSettings - Required by MenuManagerCS2
- AnyBaseLibCS2 - Required by PlayerSettings
- MenuManagerCS2
- MySQL database / SQLite
🚀 Getting Started
-
Clone or Download the Repository:
Download or clone the repository and publish to youraddons/counterstrikesharp/plugins/directory. -
First Launch Configuration:
On the first launch, a configuration file will be generated at:addons/counterstrikesharp/configs/plugins/CS2-SimpleAdmin/CS2-SimpleAdmin.jsonEdit this file to customize the plugin settings according to your server needs.
-
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:
📄 License
This project is licensed under the GPL-3.0 license - see the LICENSE file for details.