Thanks to visit codestin.com
Credit goes to github.com

Skip to content

CS2 Modded Server Egg for Pterodactyl is a Docker image that deploys a fully modded Counter-Strike 2 server and auto-updates the game/csgo, addons, and cfg directories on startup. It features built-in updaters for cs2-modded-server (kus), CounterStrikeSharp (roflmuffin), and Metamod, based on work by kus, K4ryuu, and the CSS/Metamod teams.

License

Notifications You must be signed in to change notification settings

sebastianspicker/cs2-modded-server-egg

 
 

Repository files navigation

CS2 Modded Server Egg

This repository is a fork of K4ryuu/CS2-Egg, modified to allow advanced plugin management and admin role automation for Counter-Strike 2 servers via Pterodactyl Panel.

Key Features & Differences

  • Automatic updates for CounterStrikeSharp, MetaMod, and CS2 Modded Server (from kus/cs2-modded-server) on every startup.
  • Plugin Management:
    • Enable/disable plugins individually via environment variables at install time or via the panel.
    • Plugin activation/deactivation is reflected by moving plugin folders in/out of the disabled directory – changes survive updates!
    • The full plugin list is always generated dynamically from the actual directory structure.
  • Custom variables:
    • Hostname and RCON password can be set through the Pterodactyl UI.
    • All relevant server settings (map, player count, Steam token, custom params, etc.) remain configurable.
  • Admin/Moderator Roles Management:
    • Server roles (admins.json for CounterStrikeSharp) are fully configurable via four panel fields:
      • CSS_ADMIN_FLAGS – Comma-separated admin group flags
      • CSS_MOD_FLAGS – Comma-separated moderator group flags
      • CSS_ADMINS – Comma-separated admin users in username:steamid format
      • CSS_MODS – Comma-separated moderator users in username:steamid format
    • The script set_css_roles.sh automatically generates a valid admins.json from these variables at install/startup.
    • Example:
      • CSS_ADMIN_FLAGS: @css/reservation,@css/kick,@css/root
      • CSS_MOD_FLAGS: @css/generic,@css/kick
      • CSS_ADMINS: admin1:76561190000000001,admin2:76561190000000002
      • CSS_MODS: mod1:76561190000000003,mod2:76561190000000004
    • Roles can be changed any time from the panel UI.
  • Robust update script:
    • Full error handling for downloads, extraction, and updates.
    • Version file management for each addon.
    • Clean separation of enabled and disabled plugins based on user selection.

Major Changes Compared to Upstream

  • The update logic in update.sh has been extended and made more robust:
    • All plugins are dynamically managed – you can enable/disable plugins via an environment variable (ENABLED_PLUGINS), and the script will move folders accordingly between /plugins and /plugins/disabled.
    • Plugin list is always up-to-date with the actual state on disk, not hardcoded.
    • Additional environment variables for hostname and RCON password, safely injected into the startup command with proper escaping.
    • Automated roles/config: set_css_roles.sh creates your admins.json based on four new variables.
    • Improved error handling and clearer logging throughout the update process.
    • Supports future plugin changes without further scripting.

Example: Plugin Management

Default enabled plugins:
(Examples – actual list is maintained in the egg)
CS2-CustomVotes, CS2AnnouncementBroadcaster, CS2Rcon, CS2_ExecAfter, FixRandomSpawn, GameModeManager, MatchZy, OpenPrefirePrac, MapConfigurator, Deathmatch, WASDMenuAPI, RetakesAllocator, RetakesPlugin, RollTheDice, ExecutesPlugin, FunMatchPlugin, GG2, STFixes, SharpTimer, GameModifiers, MutualScoringPlayers, InstadefusePlugin, cs2-OneInTheChamber, WarcraftPlugin, BotsNoKnife

Default disabled plugins:
Advertisement, CS2-Remove-Map-Weapons, DeathrunManager, InventorySimulator, K4-Arenas, K4-Arenas-Bots, K4-DamageInfo, QuakeSounds, STFixes, SharpTimer, WeaponSpeed, WhiteList, cs2-advanced-weapon-system
You can adjust which plugins are enabled in the panel at install/startup time.

License

This project remains under the license of the upstream repositories unless otherwise noted.

About

CS2 Modded Server Egg for Pterodactyl is a Docker image that deploys a fully modded Counter-Strike 2 server and auto-updates the game/csgo, addons, and cfg directories on startup. It features built-in updaters for cs2-modded-server (kus), CounterStrikeSharp (roflmuffin), and Metamod, based on work by kus, K4ryuu, and the CSS/Metamod teams.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%