CS2-SimpleAdmin/CS2-SimpleAdmin-docs/docs/modules/intro.md

sidebar_position

sidebar_position
1

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

Module	Description	Status
Fun Commands	God 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

• Explore Fun Commands Module - Add entertainment features
• Learn Module Development - Create your own modules
• Read API Documentation - Understand the API

---

Need Help?

• Issues - GitHub Issues
• Discussions - GitHub Discussions
• Examples - Check official modules for reference