Supported Operating Systems (for VPK Sync & Centralized Updates)

The centralized update script automatically detects your OS version and installs appropriate dependencies.

(back to top)

Multi-Framework Support → Enable multiple frameworks simultaneously with independent boolean toggles. The egg automatically handles framework dependencies, load order, and gameinfo.gi configuration.

• MetaMod:Source → Core plugin framework (required for CSS)
• CounterStrikeSharp → C# plugin framework with .NET 8 runtime
• SwiftlyS2 → Standalone C# framework v2
• ModSharp → Standalone C# platform with .NET 9 runtime

Each framework can be enabled/disabled independently via Pterodactyl panel. Auto-updates on server restart while enabled.

• Auto-Updaters → MetaMod, CounterStrikeSharp, SwiftlyS2, ModSharp automatically update on server restart
• Centralized Update Script → Auto-restart on CS2 updates with version tracking (misc/update-cs2-centralized.sh)

• VPK Sync → 80% storage & bandwidth reduction via centralized file sharing
• Junk Cleaner → Automatic cleanup (backups, logs, demos)

• Console Filter → Block unwanted messages (inspired by Poggu's CleanerCS2)
• JSON Configs → FTP-editable configuration files
• Colored Logging → Enhanced console output
• Custom Parameters → Safe user-configurable startup options
• Tokenless Servers → Run servers without GSLT token requirement

(back to top)

Comprehensive documentation is available:

• Installation Guide → Install and configure the egg
• Quick Start → Get running quickly
• Updating → Update guide

• VPK Sync & Centralized Updates → 80% storage savings + auto-restart on CS2 updates
• Auto-Updaters → Plugin auto-updates (MetaMod, CSS, SwiftlyS2, ModSharp)
• Console Filter → Message filtering
• Junk Cleaner → Automatic cleanup

• Building from Source → Build your own image
• Troubleshooting → Common issues

View Full Documentation →

(back to top)

Build your own Docker image using the included build script:

# Build with custom tag
./build.sh latest

# Build and publish to Docker Hub
./build.sh latest --publish

Note: Edit build.sh to change the registry from sples1/k4ryuu-cs2 to your own.

Full Building Guide → - Customization, multi-arch builds, CI/CD integration

(back to top)

• CS2 Pterodactyl from 1zc: The base of the image is maximally based on this image and if you don't want to use the custom scripts, you can use this image instead. Appreciate the work of 1zc and give him a star.

• Improve bad SFTP client compatibility against stating symbolic links
• GDC optional connection to automatically detect unreliable gamedatas(?)
• Optimize and add more automated tests for update scripts

(back to top)

Distributed under the GPL-3.0 License. See LICENSE.md for more information.

(back to top)