prevnext   » SZS: Wiimms SZS Toolset » SZS Change Log

SZS Change Log


1.   szs v1.54a r7393 - 2017-08-14

 - Some KCL flags renamed.

 - wkmpt draw --draw AREA: Areas of KMP are drawn as yellow arrows and as
   transparent yellow cuboids.

 - Support for RKC (competition) files added:
   RKC files are handled like other archives. Tool wszst is able to detect,
   list, extract or create a RKC file, also recursive. Direct creation and
   optimation of the included SZS is not implemented yet.

 - New keyword for option --kmp: MAX-LAPS: Keyword MAX-LAPS has only impact,
   if one of 1LAP,...,9LAPS is set too. Then, the number of laps is only
   decreased to the specified number, but never increased.

 - New keyword for option --kmp: RM-EMPTY: After creating a new KMP, all empty
   KMP sections are removed to make the KMP as small as possible. Use this
   option only for compettitions!

 - New command: YAZDUMP: Prints an info dump about the YAZ0/YAZ1 compression
   details for analysis.

 - New compression methods: 10 (=ULTRA) and 100-150: They need much more time
   than BEST (=9) but create smaller SZS files than Nintendo did. It is
   dedicated to competitions with strict size limitations.

 - There is a new option: --tiny=level: It tries to minimize SZS and also the
   included KCL and KMP by different technics (rounding values, sorting and
   compression methods 100-150). It is not fully documentd yet.
   See for details.

 - New keyword for option --kcl: WEAK-WALLS: Set the most significant bit
   (bit 15, 0x8000) of KCL flag of all walls. It stops hard bumping at the
   edges and has similar effects like lowering the walls.

 - Windows only: Cygwin update to v2.8.1, 2017-07-03.

 - Apple Mac is no longer supported because I no longer have access to a Mac.

2.   szs v1.53a r7308 - 2016-12-09

 - Bug fix: Occasional a "Segmentation fault" occured, if reading an empty file.

 - Option --draw supports the new keyword DECORATION: Draw unsolid objects
   without any route as a magenta cuboid.

3.   szs v1.52a r7164 - 2016-06-29

 - Bug fix for wkclt: Since v1.49a, the transformation was executed twice,
   but only for commands DECODE and ENCODE. Command COPY works correct and
   transforms only once.

 - wstrt: Wiimmfi patching excludes now 3 patch positions for competitions.
   It's now the job of the competition patcher to patch these 3 URLs.

 - wkclt CFF: If creating a new flag file, the new function i(type,z,index)
   is defined as support for fall boundaries (idea by Wexos).

 - New tool: wmdlt: The tool wmdlt exists since v0.26a (2012), but was always
   hidden, because it was useless. But now I started with MDL analysis and
   plan to modifiy MDL data.
    - wmdlt CAT/DECODE: Print a MDL file as text. It is incomplete, but can be
      used for analysing.
    - wmdlt STRINGS: Print all strings of a MDL.

 - For slot 42 (moonview highway) the content of the 12 needed materials
   is checked.

4.   szs v1.51a r7107 - 2016-06-01

 - wstrt is able to patch DOL files of other games and not only of MKWii.

 - The CHECK for slot 4.2 will be more exact now because it looks for the
   needed materials. The presence flags of objects 'car_body' and 'kart_truck'
   is also tested. If option --OLD is set, the old polygon test will be used.

 - Option --kmp=list supports now the keyword REVERSE as `backwards| support:
   Reverse KMP sections ENPH, ENPT, ITPH, ITPT, POTI. The implementation is
   not finished yet and more section (CKPH, CKTP, KTPT, JGPT) will follow.

 - Different small fixes.

5.   szs v1.50a r7053 - 2016-04-08

 - Improved cheat code handling.

 - Three new options: --gct-move & --gct-addr & --gct-space
   With these 3 options it is possible to support a very large cheat code
   table. Therefor a temporary section is created that runs at the very
   beginning and takes space from the game heap to establish a code section
   before the FST table.

 - Tool wctct: Update of the internal CT-CODE (mod1). The new code allows to
   select original tracks in regions. Here you can find old CT-CODE versions:
   Visit for more details.

6.   szs v1.49a r6974 - 2016-03-05

 - The BMG is rewritten as independent source code lib. It can be used by
   other tools (e.g. mkw-ana) now.

 - BMG text output contains now more comments about message ID groups.

 - Option --patch-bmg supports 2 new modes:
    - UNICODE: Replace Unicode-escapes ('\u{xx}') with 16-bit codes by related
      unicode character.
    - RM-ESCAPE: Remove all 0x1a-escapes from all strings.

 - KCL script 'lower-walls.txt' updated to support different gradients.

 - New option: --mipmap-size=num: Define the minimal width and minimal height
   of a generated mipmap. The default is 16. Tools before v1.49 used 1 as not
   alterable value. --mm-size is a short cut.

 - Option --kcl RM-FACEDOWN: Remove all road with face direction >30 degree
   toward bottom. Before it was >0 degree.

 - New keyword for option --kcl: RM-FACEUP: Remove all walls with a face
   direction >80 degree towards the sky.

 - New keyword for option --kcl: CONV-FACEUP: Convert all walls with a face
   direction >80 degree towards the sky into a simple road.

 - New keyword for option --kcl: SCRIPT: If set, KCL scripts are executed
   before cleaning and transforming the KCL.

7.   szs v1.48a r6675 - 2015-12-11

 - Tools wctct and wstrt support now Korean CT-CODE. Therefor external CT-CODE
   files are needed. Use --ct-dir=path to declare at least one search path.

 - Bug fix: wctct disables the hard coded region patch of the CT-CODE. Now
   region patches in StaticR.rel are possible like before v1.45a.

 - Bug fix: On CT-CODE text export wctct encloses the track names by quote
   signs. This feature was accidentally lost with v1.38a.

 - New option: wctct --allow-slots: Activate reserved slots for automatic
   slot assigning. Example: --allow-slots ARENAS,SPECIAL

8.   szs v1.47a r6650 - 2015-11-27

 - Tool wctct: Update of the internal CT-CODE (mod2). The new code improves
   the modes "in order" and "random" for offline versus races. Here you can
   find old CT-CODE version:
   Visit for more details.

9.   szs v1.46a r6626 - 2015-11-08

 - New option: --compatible=version: The option accpets a version number
   (format '#.##' or 'v#.##') or a revision number (format 'r#') as parameter.
   If set, the tools try to create BMG and KMP text files, that are compatible 
   to the entered version. This may override other legacy options.

 - wkmpt DECODE: If creating a KMP text file, a new macro section is included.
   The only yet provided macro is ITEMBOX: It help to setup a row of items
   and supports automatic height correction. See the macro definition for more
   details. The macro itself is very old and works also with old versions of
   the tools, but they don't create it.

 - wkmpt DRAW: Draw objects 'kinoko_*' and 'DKturibashiGC' as recognizable
   polygons. These objects can also be used to stop fall-down on automatic
   height evaluation, if the new parameter 'KCL-FALL-ADD-ROAD' is set to '1'.

 - New: Post processing flags for KMP sections ENPT, ITPT and JGPT. To disable
   the new flags column on text output, use option --compatible=v1.45.

 - wkmpt DRAW: If drawing check point connection lines, red is used for the
   left and green for the right side (like navigation lights).

 - wkmpt DRAW: Option --draw supports now object filtering by presence flag.
   The new keywords are: 1OFFLINE .. 3OFFLINE and  1ONLINE .. 3ONLINE.

10.   szs v1.45a r6602 - 2015-10-31

 - Option --patch-bmg=id: Better detection of the source file type (Race,
   Event, MenuOther, ... ) especially in SZS files.

 - The KMP compiler can now automatically create respawn points and/or
   automatically connect check points to the nearest respawn point. Both
   together make an initial respawn setup much easier.
   Read for details.

 - Tool wctct: It is now possible to define hidden tracks (don't appear in
   any cup) by using control letter 'H' instead of 'T'.

 - New option: wctct/wstrt --ct-dir: Define a search directory for CT-CODE
   parts and use the internal copies only, if no valid file is found. Use
   this option multiple times to define more than one search directory.
    - wctct --ct-dir: Search files rmc?/mod1.bin, rmc?/mod2.bin, rmc?/ovr1.bin
      and rmc?/bad1code.bin.
    - wstrt --ct-dir: Search files rmc?/boot_code.bin and rmc?/boot_data.bin
      if option --add-ctcode is used.

 - Tools wctct and wstrt use now the most current CT-CODE version provided by (a fork of Chadderz code with support
   of the SZS Tools). To use the old code of year 2013 download the zip file and use the base
   directory as parameter for the new option --ct-dir (see above).

 - wstrt --add-ctcode: The first free DOL sections are used now. Before only
   sections T2 and D8 were added if not already in use.

 - New option: wstrt --meno: Patch some 'MenuSingle' and 'MenuMulti' strings
   of file StaticR.rel for online usage to 'MenO*' to distinguish between
   offline and online.

11.   szs v1.44a r6558 - 2015-10-17

 - BMG: The `inline mode' for attributes is now enabled by default. It can be
   disabled by option --no-bmg-inline.

 - BMG message id 0 is allowed now.

 - BMG: Support of 1A escapes with up to 254 bytes (before 12 bytes).

 - BMG: Escape sequences \x{}, \u{} and \z{} can now handle comma separated
   lists of parameters. See for details.

 - New option: --x-escapes: Use \x{} escapes instead of \z{} escapes.

 - New option: --old-escapes: To be compatible with v1.43 and earlier, print
   1A escape sequences with total size of >12 bytes as single words. Also
   don't use \x{} and \u{} with parameter lists.

 - BMG supports now attribute vectors up to 20 bytes. MKWii uses only 4 bytes
   for attributes. 

 - New option: --bmg-inf-size (also --inf-size for tool wbmgt):
   Defines the size of section 'INF0'. For MKW it is usually 8.

 - New option: --force-attrib=attrib: Override all BMG attributes with the
   entered value. See for the syntax.

 - New option: --def-attrib=attrib: Define alternative default attributes for
   new BMG text files. See for the syntax.

 - New option: --no-attrib: Suppress the output of string attributes at new
   BMG text files.

12.   szs v1.43a r6536 - 2015-10-09

 - Option --add-section supports now GCT files as input. In this case,
   code-handler-only is added automatically.