This guide covers how to set up your Hogwarp server on Legion Hosting, configure the API key, set server details, and connect to your server. Hogwarp is a multiplayer mod for Hogwarts Legacy that enables cooperative play in the wizarding world. For admin commands, plugin support, and troubleshooting, see Hogwarp Admin Commands.
Important: Hogwarp requires an API key from presence.hogwarp.com. You must obtain this key before starting your server. Without it, the server will fail to boot.
1. Prerequisites
- All players need a legitimate copy of Hogwarts Legacy.
- All players need the Hogwarp client mod installed.
- You need a Hogwarp API key from presence.hogwarp.com.
2. First Start
- Log in to GPanel and select your Hogwarp server.
- Go to the Startup tab and set your API_KEY (see Section 3).
- Configure your SERV_NAME and MAX_PLAYERS.
- Return to the Console tab and click Start.
- Wait for
Server started on portin the console, confirming startup.
Ports are randomly assigned unless you have a private IP. Check the Network tab in GPanel for your assigned port. See How to Find Your Server IP and Port.
3. GPanel Startup Variables
| Variable | Default | Description |
|---|---|---|
API_KEY | CHANGEME | Required. Hogwarp API key from presence.hogwarp.com. |
SERV_NAME | Ptero Hogwarp Server | Server name displayed on the Hogwarp multiplayer list. |
MAX_PLAYERS | 4 | Maximum players. Depends on your Hogwarp Patreon tier (4, 8, 16, or unlimited). |
SERV_DESC | (empty) | Description shown on the multiplayer list. |
SERV_ICON | (empty) | URL to a server icon image for the multiplayer listing. |
Set your API key before starting. The default value
CHANGEME will cause the server to fail. Get your key from presence.hogwarp.com.
4. Server Configuration (config.json)
The server uses config.json for its settings. These are automatically populated from startup variables, but you can also edit the file directly via SFTP.
File Location
config.jsonConfig Structure
{
"ApiKey": "your-api-key-here",
"Name": "My Hogwarp Server",
"Port": 25565,
"Description": "A friendly wizarding server",
"MaxPlayer": 4,
"IconUrl": ""
}
Max player limits: Hogwarp uses a Patreon-based tier system. Your max player setting is limited by your Patreon level: 4, 8, 16, or unlimited. See Tilted Phoques Patreon for details.
5. How to Connect
- Install the Hogwarp client mod for Hogwarts Legacy.
- Launch Hogwarts Legacy with the Hogwarp mod active.
- Open the Hogwarp multiplayer menu.
- Your server should appear in the server list if the API key is valid.
- Select your server and connect.
Related Articles
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.
