Skip to main content

Common tasks

Short recipes which combine several pages of the panel. Each step links to the page with the details.

Change the experience rate​

  1. Go to Configuration → General (Game configuration).
  2. Change Experience rate (and Master experience rate if you want).
  3. Save.
  4. Click Reload configuration and restart all game servers on the Servers page.

The rate can also be set per game server, which is how you run one server with different rates: open the game server on the Servers page and change its experience rate there.

Add a game server​

  1. Servers page → + Game server.
  2. Fill in server id, description, experience rate, PvP, server configuration, client and network port.
  3. Save, then start it in the server list.
  4. Open the new port in your firewall/router and, in a docker deployment, publish it in the compose file. See Ports.

Ban a player​

  1. If the player is online: disconnect them on the Online accounts page — or use Temporarily ban on the live map, which does both at once.
  2. Open the account on the Accounts page with Edit.
  3. Set the state to Banned or TemporarilyBanned and save.

Make somebody a game master​

  1. Accounts page → Edit the account.
  2. Set the state to GameMaster (or GameMasterInvisible).
  3. Save. The account can now use the game master chat commands.

Add a monster spawn​

  1. Go to Configuration → Map editor (Map editor).
  2. Select the map.
  3. Click + Monster spawn area and draw the area.
  4. Set the monster, the quantity and the details of the focused object.
  5. Save, then reload the configuration on the Servers page.

Change a drop​

  1. Go to Configuration → Drop item groups (Game configuration).
  2. Edit the group — or duplicate an existing one and adapt the copy.
  3. Assign the group where it should apply: globally, on a map, or on a monster (Monsters).
  4. Save and reload the configuration.

Switch to another game version​

  1. Go to the Setup page.
  2. Click Reinstall, pick the game version, the number of game servers and whether test accounts should be created.
  3. Click Install and wait.
This deletes your data

Reinstalling drops the existing database contents — accounts, characters and all configuration changes. Back up your PostgreSQL database first.

Update OpenMU to a newer version​

  1. Pull the new docker image (or build the new source) and restart the server.
  2. Open the Setup page — if it says Update required, run the schema update.
  3. Open the Configuration updates page and apply the available updates.
  4. Restart the server process so the updates take effect.

Fix "players get disconnected after selecting a server"​

This is almost always the IP resolver reporting an address the client cannot reach.

  1. Go to Configuration → System (System configuration).
  2. Set the IP resolver:
    • server and client on the same machine → Loopback
    • server in your LAN → Local
    • public server → Public, or Custom with your domain/IP
  3. Save and restart the server process.

See Connect a game client.

Turn a feature off​

  • A chat command → deactivate it on the Chat commands page.
  • A game mechanic implemented as a plugin → deactivate it on the Plugins page.

Reset the database​

  1. Setup page → Reinstall.
  2. Alternatively, start the server with the -reinit start parameter.

For a throwaway test server, -demo starts the server with in-memory data which is recreated at each start and never persisted.