This guide covers server administration, plugin support, updates, and troubleshooting for your Hogwarp server. Hogwarp is a multiplayer mod for Hogwarts Legacy. For initial setup, API key configuration, and connection instructions, see Hogwarp Server Setup Guide.

1. Server Administration

Hogwarp server administration is primarily done through the config.json file and the GPanel console. The server runs via Wine (Windows compatibility layer on Linux).

GPanel Console

Use the GPanel Console tab to monitor server activity and view connection logs. The server outputs player join/leave events and any errors to the console.

2. Plugin Support

Hogwarp supports server-side plugins. Place plugin files in:

plugins/

Upload plugins via SFTP and restart the server. Check the Hogwarp Discord for available plugins and compatibility information.

3. Server Settings

Edit config.json directly for advanced configuration. Stop the server before making changes.

4. Updating the Server

Hogwarp updates frequently. To update:

1. Stop the server.
2. Check the Hogwarp Discord for the latest server files.
3. Download the new server files and upload via SFTP, replacing existing files.
4. Back up your config.json and plugins/ directory first.
5. Start the server.

5. Troubleshooting

Server Fails to Start

• "API Key" error: Ensure API_KEY is set to a valid key from presence.hogwarp.com, not the default CHANGEME.
• Wine errors: The server runs under Wine. Check the GPanel console for Wine-related errors. These usually resolve with a server reinstall.
• Missing files: If HogWarpServer.exe is missing, reinstall the server from GPanel Settings.

Players Cannot Connect

• Verify the server shows Server started on port in the console.
• Ensure the API key is valid and active.
• Check that all players have the correct Hogwarp client mod version.
• The server should appear in the Hogwarp multiplayer list automatically if the API key is valid.

Server Not Appearing in List

• Double-check your API key is correct and active.
• Verify the server has fully started (check console for the startup message).
• The Hogwarp master server may be temporarily down -- check the Hogwarp Discord for status updates.

Related Articles

• Hogwarp Server Setup Guide
• How to Find Your Server IP and Port
• How to Upload Files via SFTP

Need Help?

If you run into issues with your Hogwarp server that are not covered here, open a support ticket and include your server IP, a description of the problem, and any relevant error messages from the GPanel console.