PanelSIX Addon - Per-Server Admin Management

This addon extends PanelSIX functionality to enable per-server admin management instead of only global admin assignments. With this addon, you can assign administrators to specific game servers rather than giving them access to all servers.

🚀 Features

• Per-Server Admin Assignment: Assign admins to specific servers instead of globally
• Server Identification: Each server has a unique identifier for easy management
• Backward Compatibility: Works alongside existing global admin system
• Web Interface: Manage admins through PanelSIX web panel
• Database Integration: Seamless integration with existing PanelSIX database

📁 Package Contents

PanelSIX ADDON - Admins per server/
├── Images/                     # Screenshots and documentation images
├── PanelSIX Files/            # Web panel files
│   ├── SQL/
│   │   └── admin_servers_update.sql    # Database schema updates
│   ├── admin/
│   │   ├── add_admin.php              # Add new admin interface
│   │   ├── control_admins.php         # Admin management interface
│   │   └── edit_admin.php             # Edit admin interface
│   └── admins_list.php                # List all admins with server assignments
├── Server Plugin/
│   └── admin_sql.sma                  # AMX Mod X plugin source code
├── Important information.txt           # Installation notes
└── README.md                          # This file

⚠️ IMPORTANT INSTALLATION NOTICE

CRITICAL: Before installing the plugin, you MUST modify the server identifier in the plugin source code.

1. Open Server Plugin/admin_sql.sma in a text editor
2. Find this line (around line 78):

   amx_server_identifier = register_cvar("amx_server_identifier", "main_server", FCVAR_PROTECTED)

3. Change "main_server" to a unique, descriptive name for your server
4. Use a different identifier for each server so you can distinguish them in the panel

Example Server Identifiers:

• "dm_server_1" for Deathmatch Server 1
• "jb_server_main" for Jailbreak Main Server
• "surf_server_eu" for Surf Server Europe
• "zombie_server_1" for Zombie Server 1

🛠️ Installation Instructions

Step 1: Database Setup

1. Import the SQL schema updates:

   -- Run the contents of PanelSIX Files/SQL/admin_servers_update.sql

Step 2: Web Panel Files

1. Upload all files from PanelSIX Files/ to your PanelSIX web directory
2. Ensure proper file permissions are set

Step 3: Server Plugin Installation

1. IMPORTANT: Edit admin_sql.sma and change the server identifier (see above)
2. Compile the plugin using AMX Mod X compiler:

   amxxpc admin_sql.sma

3. Upload the compiled admin_sql.amxx to your server's addons/amxmodx/plugins/ directory
4. Add the plugin to your plugins.ini file:

   admin_sql.amxx

5. Restart your game server

Step 4: Configuration

1. Configure your database connection in addons/amxmodx/configs/sql.cfg
2. Set the server identifier cvar in your server configuration:

   amx_server_identifier "your_unique_server_name"

🎮 How It Works

Global vs Per-Server Admins

• Global Admins (server_specific = 0): Have access to ALL servers
• Per-Server Admins (server_specific = 1): Only have access to assigned servers

Server Registration

• Servers automatically register themselves in the database when they start
• Each server is identified by its unique server_identifier
• The web panel shows which servers each admin has access to

Admin Assignment Process

1. Add a new admin through the web panel
2. Choose whether the admin should be global or server-specific
3. If server-specific, select which servers the admin should have access to
4. The plugin automatically loads the correct admins for each server

🌐 Web Interface Features

• Admin List: View all admins with their server assignments
• Add Admin: Create new admin accounts with server selection
• Edit Admin: Modify existing admin permissions and server access
• Server Management: View and manage registered game servers

🔧 Technical Details

Database Schema

The addon adds the following tables/columns:

• game_servers: Stores server information and identifiers
• admin_game_servers: Links admins to specific servers
• diveban_admins.server_specific: Flag indicating if admin is server-specific

Plugin Features

• Automatic server registration
• Per-server admin loading
• Backward compatibility with existing admin systems
• Support for both MySQL and SQLite databases

🐛 Troubleshooting

Common Issues

Admins not loading on server:

• Check that the server identifier is correctly set
• Verify database connection in sql.cfg
• Ensure the server is registered in the game_servers table

Web panel not showing servers:

• Run the SQL update script
• Check file permissions on uploaded PHP files
• Verify database connection in PanelSIX configuration

Plugin compilation errors:

• Ensure you have the latest AMX Mod X includes
• Check that all required modules are loaded

📞 Support

If you encounter any issues:

1. Check the server console for error messages
2. Verify all installation steps were completed
3. Ensure database permissions are correct
4. Check that the server identifier is unique and properly set