Modding WebLiero

WebLiero is modifiable via two carefully crafted files:

• sprites.wlsprt
• mod.json5

Custom mods can be loaded in-game as the server-admin, using the following chat command:

/loadmod

The browser will present a file dialog from which the mod files can be selected together or loaded/reloaded seperately as needed. WebLiero also supports direct loading of zipped mods containing both files, named as above.

sprites.wlsprt

WLSPRT is a custom format used to describe WebLiero sprite sets.

I created a CLI utility wltools to convert WLSPRT to a folder of indexed PNGs and vice versa.

mod.json5

The mod.json5 file contains definitions for weapons, game entities, and game physics among other things. The schema can be initially overwhelming, but it is where the bulk of the magic happens. Master it to bring your dream mod to life!

Levels

WebLiero supports LEV files from the original Liero. LEV files have fixed dimensions of 504x350 pixels.

Alternatively, arbitrarily-sized indexed PNG files can be loaded as levels in WebLiero.

See the materials guide to better understand how the palette maps to Liero level materials.