ENVIMIX scripts

1. Docker Compose with ManiaServerManager and Envimix Control

Use ManiaServerManager to download/update the dedicated server, title pack, and ENVIMIX scripts when the container starts. The Compose file also runs Envimix Control, which submits record replays, validation replays, and session replays to Envimania.

1. Sign in, open your profile, and register the ManiaPlanet dedicated server account you will use. This will enable Envimania for your server.
2. Open the registered server page, select Generate controller code, and replace your_controller_code below. Treat the code like a password.
3. Replace your_server_login, your_server_password, and the server name, then run docker compose up -d.

services:
  envimix:
    image: bigbang1112/mania-server-manager:alpine
    restart: unless-stopped
    environment:
      MSM_SERVER_TYPE: ManiaPlanet
      MSM_SERVER_IDENTIFIER: ManiaPlanet_Latest
      MSM_SERVER_NAME: My ENVIMIX server
      MSM_ACCOUNT_LOGIN: your_server_login
      MSM_ACCOUNT_PASSWORD: your_server_password
      MSM_TITLE: TM2U_Island@adamkooo
      MSM_USERDATA_DOWNLOAD_URLS: https://envimix.gbx.tools/tm2/scripts/download/TM2U_Island@adamkooo/latest
      MSM_MATCH_SETTINGS_BASE: EnvimixTimeAttack.TM2U_Island@adamkooo.txt
      MSM_MATCH_SETTINGS: MapList.txt
      MSM_CFG_SERVER_CALLVOTE_RATIOS: Ban=-1;SetModeScriptSettingsAndCommands=-1
      MSM_CFG_CONFIG_SERVER_PORT: 2350
      MSM_CFG_CONFIG_SERVER_P2P_PORT: 3450
      MSM_CFG_CONFIG_XMLRPC_ALLOW_REMOTE: controller
    ports:
      - "2350:2350/tcp"
      - "2350:2350/udp"
      - "3450:3450/tcp"
      - "3450:3450/udp"
    volumes:
      - ./servers:/app/data/servers
      - msm_archives:/app/data/archives
  controller:
    image: bigbang1112/envimix-control:latest
    restart: unless-stopped
    depends_on:
    - envimix
    environment:
      EMC_SERVER_IP: envimix
      EMC_SERVER_PORT: 5000
      EMC_CONTROLLER_CODE: your_controller_code
    volumes:
      - ./servers/ManiaPlanet_Latest/UserData:/app/UserData
volumes:
  msm_archives:

The server and controller share the UserData directory so the controller can read generated replay files. Successfully submitted local replays are deleted and failed submissions remain in place for a later retry.

See full list of environment variables and options in the ManiaServerManager documentation.

Envimix Control is not a required component for running the server. Records driven without replays may still be accepted on Envimania, but there is no guarantee of their validity.

2. Manual dedicated server

1. Download ENVIMIX.TM2U_Island@adamkooo.2026-09-16-00_52.zip.
2. Install or prepare ManiaPlanet dedicated server with the TM² Island title pack.
3. Extract UserData folder from the ZIP into dedicated server directory and merge it.
4. Run ./ManiaPlanetServer /title=TM2U_Island@adamkooo /dedicated_cfg=dedicated_cfg.txt /game_settings=MatchSettings/EnvimixTimeAttack.TM2U_Island@adamkooo.txt

Adding Envimix Control to a manually managed dedicated server is not supported yet, so this setup does not track and submit replays to Envimania.

3. ManiaPlanet client

1. Download ENVIMIX.TM2U_Island@adamkooo.2026-09-16-00_52.zip.
2. Extract contents of the ZIP's UserData folder into Documents\ManiaPlanet.
3. Start ManiaPlanet and TM² Island.
4. Create a server and choose one of the gamemodes and the EnvimixTimeAttack.TM2U_Island@adamkooo.txt MatchSettings.

Adding Envimix Control to a ManiaPlanet client setup is not supported yet, so this setup does not track and submit replays to Envimania.