This guide covers server administration for LeagueSandbox, including managing game content, modifying match settings, and troubleshooting common issues.
Admin Overview
LeagueSandbox is a development-oriented project. Server administration is primarily handled through file-based configuration and the server console rather than traditional in-game admin commands.
Server Console
The GPanel Console tab displays server output including player connections, game events, and errors. The server can be stopped gracefully using GPanel's Stop button (sends Ctrl+C).
Monitor the console for:
- Player connection and disconnection events
- Game state changes (champion select, game start, game end)
- Error messages and stack traces
Content Management
Game content is managed through files in the Content/ directory. This includes champion data, item definitions, map configurations, and game scripts.
Modifying Game Content
- Stop your server from GPanel.
- Navigate to the
Content/directory using the File Manager or SFTP. - Edit the relevant JSON or script files for the content you want to modify.
- Save your changes and restart the server.
Custom Game Rules
LeagueSandbox allows modification of core game parameters through its content system:
- Gold and experience rates: Adjust how quickly players earn gold and level up.
- Cooldown modifiers: Change ability cooldown rates globally.
- Damage scaling: Modify damage formulas for custom gameplay.
- Spawn timers: Adjust minion wave and jungle camp spawn intervals.
Content/ directory before making changes. Invalid configurations can prevent the server from starting.
Adding Custom Scripts
LeagueSandbox supports server-side scripting for custom game logic. Scripts control champion abilities, item effects, map mechanics, and more. Refer to the project documentation for the scripting API.
Rebuilding the Server
If you need to update the server to a newer version or the build becomes corrupted:
- Stop the server from GPanel.
- Use the Reinstall option in GPanel (under Settings) to trigger a fresh clone and build from the GitHub repository.
- Back up any custom
Content/modifications before reinstalling, as they will be overwritten.
Troubleshooting
| Problem | Solution |
|---|---|
| Server fails to start after content changes | Check the console for error messages. Restore the original Content files from backup or reinstall. |
| Client cannot connect | Verify you are using the correct LoL client version. Check that the server shows Game is ready. in the console. |
| Build fails during installation | This usually indicates a .NET 6 SDK issue. Try reinstalling the server from GPanel. If the problem persists, open a support ticket. |
| Game crashes mid-match | Check the console for error output. This is often caused by unsupported champion abilities or incomplete content scripts. |
