Resources & loading screen

Everything under game-server/resources/ is a resource file. At start-up the server walks the folder recursively and builds a manifest with each file's path, size and sha256. Players download the files into %USERPROFILE%\WildM\cache\<host>_<httpPort>\ before the game starts.

game-server/
└── resources/
    ├── loadscreen/
    │   └── index.html        ← your loading screen
    └── wildm-base/
        └── resource.json     ← spawn, rules, message of the day

Server-only files

Files declared as server_scripts, server_files or server_host in a resource.json are not in the manifest: players never download them. See Scripting (Lua).

Restart after changing resources

The manifest is built once, at start-up. After adding, changing or removing files, restart the server. Only files in the manifest can be downloaded.

How players receive them

• Files already in the player's cache with the same size and sha256 are not downloaded again.
• Files that are no longer in your manifest are deleted from the player's cache on the next join. Do not expect players to keep anything you removed.
• Up to 4 files download in parallel; each is verified before being kept.
• File paths must be valid on Windows: no < > : " \ | ? *, no segment ending with a dot or space, no . / .. segments, 240 characters max. A manifest with an invalid path makes the join fail with manifeste invalide.

The loading screen

If your resources contain loadscreen/index.html, the launcher displays it full screen behind its progress panel as soon as the download step is finished, for the rest of the connect sequence.

• It is opened from the local cache (file:// URL), so reference images, fonts and scripts with relative paths inside loadscreen/.
• Keep the bottom-left area readable: the launcher draws its progress panel over the page.
• The example shipped with the server uses the WildM colours (#111 background, #FFB800 accent).

See Custom loading screen for a step-by-step example.

resource.json

wildm-base/resource.json is the base resource shipped with the server:

{
  "name": "wildm-base",
  "version": "0.1.0",
  "description": "Ressource de base du serveur : point d'apparition, règles et messages.",
  "spawn": { "x": -3112.6, "y": 5535.8, "z": 956.0 },
  "rules": ["Respecte les autres joueurs.", "…"],
  "motd": "Bienvenue sur le serveur WildM LAN !"
}

Today only spawn is read by the launcher (the first */resource.json, in path order, with a valid spawn provides the spawn written to wildm_connect.json). rules and motd are delivered to players but not displayed by the current client.