wledit {{::version}} changelog · credits · help

• open any webliero mod file, and also liero TC
• quick load from a list of community maintained mods
• merge weapons and objects from different mods
• copy/replace sprites and sounds between open mods
• preserve comments in json5 files
• edit, import & export png sprite compatible with wltools
• build and upload soundpacks with more than 30 sounds
• live edit while playing with extended hack

• wledit & wlkit.js made by Ophi, dsds, wgetch, roo
• png export Robert Eisele
• wav export Ryan Berdeen
• snd file format liero.nl
• properties list adapted from vitu
• exe2wlmod all credits basro
• some code taken from webliero source

• 0.52 fix merging of behaviors SNDID
• 0.51 prevent recursive merge of objects references in scripts
• 0.50 select png as map, export/import map settings json
• 0.49 import any png with best pixel selection from palette
• 0.48 merge behaviors
• 0.47 show impacted weapons for all objects
• 0.46 quickload from webliero-mods git + naive delete weapon feature
• 0.45 offline downloadable version
• 0.44 fix rFrame again (and again) (thx dsds)
• 0.43 fix merge error after renaming mod
• 0.42 fix rFrame sprites not being merged
• 0.41 fix splinterType=-1 and splinterAmount>0 when opening a mod
• 0.40 fix materials displayed when hovering color in sprite editor
• 0.39 fix palette import
• 0.38 fix live edit loading + refresh editor when entering room
• 0.37 fix nObject startFrame=0, add dummy sprite when merging to blank mod
• 0.36 fix merging objects using numFrames or shotType
• 0.35 editor for extended maps settings
• 0.34 embedded tiny pixel art editor
• 0.33 add dummy wid34 if needed when merging
• 0.32 handle zipped liero TC, quick load from liero.nl
• 0.31 references between all objects for navigation
• 0.30 weapons quick list + various improvements
• 0.29 easy select for all object properties
• 0.28 auto download soundpack, if mod contains no sounds
• 0.27 quick-load template elements from extended gitlab
• 0.26 added readme section for description/changelog. saved in zip.
• 0.25 quick-load mods can be updated by their authors, with password
• 0.24 fix merging bugs (nobject startFrame=0, texture rFrame int)
• 0.23 merge weapons and wobjects to blank mod, rename wobjects
• 0.22 easy select for sound properties
• 0.21 weapon copy + initial merge mod implementation
• 0.20 soundpack upload, with optional user hosting url
• 0.19 palette import/export in .png .json and .lpl
• 0.18 colorpicker for color properties
• 0.17 mod versioning + export png filename compatible wltools
• 0.16 import liero TC (exe/chr)
• 0.15 copy/replace sprite/sound between mods
• 0.14 multi-mod edit
• 0.13 palette section
• 0.12 general mod config
• 0.11 PNG sprite export
• 0.10 export/import for sounds (wav/snd), config section
• 0.09 all constants, textures, and complete json export
• 0.08 sprite anchor + PNG replace + correct wlsprt export
• 0.07 ref between objects
• 0.06 hjson for generating and preserving comments
• 0.05 buttons for downloading mod files
• 0.04 refresh on mod change, sound/sprite live preview
• 0.03 added constants
• 0.02 live edit tests
• 0.01 initial readonly

• TODO:
• push mod and element updates to gitlab
• handle lierokit .lwp file
• delete orphaned object feature
• global library for sprites and sounds
• move to different server
• clean and move code to gitlab

• wledit is a simple yet (almost) complete mod editor for webliero.
  it runs fully in the browser and doesn't upload any file to server
  (well, except when you want it to, like for soundpack).
  
  to save your changes, export to zip: it will pack all files and you can use this zip on webliero with /loadmod, or re-open it later with wledit!

• relation between weapons and objects
• considerations about wObject 34

  wid 34 is a special hardcoded object in liero, and hence in webliero:
  it has a specific behavior that will remove the wObject when it collides with a sObject. This can cause issues when merging mods, as any wObject imported in position w34 will inherit this particularity, so be careful.
  
  In extended, a new property removeOnSObject (available in wledit) was added and allows an author to reuse this behavior on other wObjects. Also, we try to set this property on the w34 of all existing mods, so that when the object is copied or merged into another mod, it'll still preserve the hardcoded behavior.

• new object properties in webliero extended

  objects we use on extended maps (platforms, laser gates, lava..) could not have been done without implementing some new properties allowing more complex behaviors
  
  -new bool property "removeOnSObject" for wobject
  -new bool property "immutable" for wobject/nobject
  -new bool property "fixed" for wobject
  -new bool property "detonable" for wobject (allow remote detonation)
  -new int property "teamImmunity" for wobject/nobject (0/1/2)
  -new bool property "platform" for wobject (allow rope hook for now)
  -new int property "platformWidth" for wobject
  -new int property "platformHeight" for wobject
  -new bool property "platformVelocityAuto" for wobject
  -new float property "platformVelocityX" for wobject
  -new float property "platformVelocityY" for wobject
  
  Obviously these properties won't have any effect when the mod is loaded in a normal, non-extended room.

• how to prepare your PNG files for import

  you should use GIMP with custom liero palette,
  and produce a 256 colors PNG liero palette indexed.

• how to prepare your WAV files for import

  you must create a WAVE file in this format:
  PCM mono 8bits unsigned 22050hz
  
  you can use a tool like soundforge to resample and convert your sounds.

• handling soundpack the easy way

  this will work only on extended, as webliero doesn't allow custom soundpacks
  
  the zip export of wledit contains all assets including the soundpack sounds.snd, so the zip itself could be uploaded somewhere and be used as an external soundpack. That's still not practical as you must know in advance the URL of your soundpack to put in the field before exporting zip.
  
  wledit has a handy feature that will upload the soundpack for you on wledit server, and automatically update the soundpack field. your mod is then ready to be zip-exported and loaded instantly with /loadmod to test it!
  
  limited to 3 uploads per day for unregistered mods.

• limitations of live edit on extended

  live edit while playing allows fine tuning of weapons and objects behavior in real situation. It's probably one of the best feature, but it has some limitations:
  - sounds lost their names, so not suitable to build a complete mod zip.
  - some config properties related to wledit are also lost.
  - existing comments in json5 are removed
  - adding or replacing sprites must be followed by a reload of the generated wlsprt via /loadmod, as to avoid crashing the game.

• get your mod listed on wledit and update it

  contact Ophi on discord or webliero, you'll receive a password that you can then use to upload and update your mod via the "config" section.

• merging many mods for testing

  liero.nl has many Total Conversions that are available in one-click. you can open multiple mods and use the merging tool to combine them. It's recommended to open a Classic Liero 1.33 mod too and use it as base mode (without weapons) to have a neutral working setup.
  
  Remember that webliero has a limit of ~250 weapons so merging more will work but you won't be able to test it.
  
  TC often come with new sounds, so don't forget to upload the soundpack via the "config" section before you export the final zip for /loadmod

• what is wlkit.js

  wlkit.js is a javascript library to manipulate mods programmatically with ease. wledit is built on top of wlkit.js, and provides a visual interface to the various operations you can do with wlkit.js
  
  it means you can benefit from the same features in your js projects, and most importantly in headless room script.
  
  wlkit.js is a single js file you can import anywhere.
  
  wlkit.js is not weblierokit, which is a different editor for webliero (not browser based) made by wgetch

• 
  don't forget to check the mod guide to learn more tips and tricks about modding.

	<?php	
		$data = file_get_contents('php://input');    
		$fname = time().'.zip';
		file_put_contents('/uploads/'.$fname, $data);
		echo 'https://mylierohost.example/uploads/'.$fname;
	?>