Skip to main content

Modules Introduction

Extend CS2-SimpleAdmin functionality with powerful modules.

What are Modules?​

Modules are extensions that add new features to CS2-SimpleAdmin. They use the CS2-SimpleAdmin API to integrate seamlessly with the core plugin.

Official Modules​

Fun Commands Module​

Adds entertainment and player manipulation commands like god mode, noclip, freeze, and more.

Learn more →

Benefits of Modules​

🔌 Easy Integration​

  • Built on CS2-SimpleAdmin API
  • Automatic menu registration
  • Command system integration

🎨 Feature Separation​

  • Keep core plugin lightweight
  • Add only features you need
  • Easy to enable/disable

🔧 Customizable​

  • Configure each module independently
  • Disable unwanted commands
  • Customize permissions

📦 Simple Installation​

  • Drop module files in folder
  • Restart server
  • Module auto-loads

Installing Modules​

Standard Installation​

  1. Download the module from releases or build from source

  2. Extract to plugins folder:

    game/csgo/addons/counterstrikesharp/plugins/ModuleName/

  3. Restart server or reload plugins:

    css_plugins reload

  4. Configure (if needed):

    addons/counterstrikesharp/configs/plugins/ModuleName/

Module Structure​

Typical module structure:

plugins/
└── CS2-SimpleAdmin_ModuleName/
    ├── CS2-SimpleAdmin_ModuleName.dll
    ├── CS2-SimpleAdmin_ModuleName.json  (config)
    └── lang/                             (translations)
        ├── en.json
        ├── pl.json
        └── ...

Module Configuration​

Each module has its own configuration file:

addons/counterstrikesharp/configs/plugins/ModuleName/ModuleName.json

Common Configuration Pattern​

{
  "Version": 1,
  "CommandName": ["css_command", "css_alias"],
  "OtherSettings": {
    "EnableFeature": true
  }
}

Key Features:

  • Command lists allow multiple aliases
  • Empty command list = feature disabled
  • Module-specific settings

Available Modules​

Core Modules​

ModuleDescriptionStatus
Fun CommandsGod mode, noclip, freeze, speed, gravity✅ Official

Community Modules​

Check the GitHub repository for community-contributed modules.

Developing Modules​

Want to create your own module?

See Module Development Guide →

See Developer Documentation →

Module vs Core Plugin​

When to use Core Plugin:​

  • Essential admin functions
  • Punishment system
  • Permission management
  • Database operations

When to use Modules:​

  • Optional features
  • Server-specific functionality
  • Experimental features
  • Custom integrations

Module Dependencies​

Required for All Modules:​

  • CS2-SimpleAdmin (core plugin)
  • CS2-SimpleAdminApi.dll

Module-Specific:​

Check each module's documentation for specific requirements.

Troubleshooting Modules​

Module doesn't load​

Check:

  1. Is CS2-SimpleAdmin loaded?
  2. Is CS2-SimpleAdminApi.dll in shared folder?
  3. Check server console for errors
  4. Verify module files are complete

Module commands not working​

Check:

  1. Is command enabled in module config?
  2. Do you have required permissions?
  3. Check Commands.json for conflicts
  4. Verify module loaded successfully

Module conflicts​

Check:

  • Multiple modules providing same command
  • Check server console for warnings
  • Disable conflicting module

Best Practices​

Module Management​

  1. Use only needed modules - Don't overload server
  2. Keep modules updated - Check for updates regularly
  3. Test before production - Test modules on dev server first
  4. Review permissions - Understand what each module can do

Performance​

  1. Monitor resource usage - Some modules may impact performance
  2. Configure wisely - Disable unused features
  3. Check logs - Monitor for errors

Module Updates​

Updating Modules​

  1. Backup current version
  2. Download new version
  3. Replace files in plugins folder
  4. Check configuration - New config options may exist
  5. Restart server

Breaking Changes​

Some updates may have breaking changes:

  • Check module changelog
  • Review new configuration options
  • Test thoroughly

Community Contributions​

Sharing Modules​

Created a module? Share it with the community!

  1. Publish on GitHub
  2. Document thoroughly
  3. Provide examples
  4. Include README

Using Community Modules​

  1. Review code - Ensure it's safe
  2. Check compatibility - Verify CS2-SimpleAdmin version
  3. Test thoroughly - Don't trust blindly
  4. Report issues - Help improve modules

Next Steps​

Need Help?​