AddOn Template

From BlinkenSisters

After you've done your own first Simple Level and maybe learned a bit about Scripting, you may want to create your own AddOn. The easiest way is to download MZ_Template using the ingame-download-section and edit this Template for new AddOns.

Contents

Change Name

You may skip this step or do it later

For changing the name of the new AddOn from MZ_Template to MyNewAddOn, rename the directory C:\Dokumente und Einstellungen\Username\Eigene Dateien\BlinkenSisters\V0.5.1\ADDON\MZ_Template to C:\Dokumente und Einstellungen\Username\Eigene Dateien\BlinkenSisters\V0.5.1\ADDON\MyNewAddOn and replace

MZ Template|MoveZig AddOn Template|MZ_Template

with

My AddOn|My brand new AddOn|MyNewAddOn

to C:\Dokumente und Einstellungen\Username\Eigene Dateien\BlinkenSisters\V0.5.1\addons.dat.


"My AddOn" is a short Title for your new AddOn, used in the ingame-menue.

"My brand new AddOn" is a short description of your new AddOn.

"MyNewAddOn" is the name of the your AddOn-Directory.


After you've completed this step you can download MZ_Template again to have a second new Template.


For *nix and Mac, replace C:\Dokumente und Einstellungen\Username\Eigene Dateien\BlinkenSisters\V0.5.1\ADDON\ with ~/.lostpixles/V0.5.1/; for other Version than V0.5.1, replace V0.5.1 with appropriate string.

List of Files

Within C:\Dokumente und Einstellungen\Username\Eigene Dateien\BlinkenSisters\V0.5.1\ADDON\MZ_Template you'll find the set of minimal needed Files for an AddOn. Edit them at your needs.

Required Files - Part 1

All of the following files must exist with the given names:

  • Some fullscreen images:
    • gameover.jpg
    • gamewon.jpg
    • highscorebg.jpg
    • livelost.jpg
    • loading.jpg

-- ToDo (Talk) -- man kann doch auch videos benutzen... wie sind den da die genauen Regeln? --

  • The Setup for your first level
    • level1.conf

For more than just one Level, add level2.conf, level3.conf, ...

See also Simple Level for a detailed description of levelN.conf.

  • The (Default-)Monsters
    • monster1_left.bmp
    • monster1_right.bmp
    • monster2_left.bmp
    • monster2_right.bmp
    • monster3_left.bmp
    • monster3_right.bmp
    • monster4_left.bmp
    • monster4_right.bmp
    • monster5_left.bmp
    • monster5_right.bmp
  • And finaly of course: Kate herself
    • sister_moveleft.bmp
    • sister_moveright.bmp


Required Files - Part 2

In level1.conf you can choose names for the following files. For renaming one of those files, also edit level1.conf appropriately.

  • level1.dat Level-Layout - see also Simple Level
  • weirdtiles.bmp the Tiles used in your Level
  • level1.jpg Background-Pictue
  • bs_ingame2.ogg Background-Song
  • level1.bsl Optional scripting-file - see also Scripting


Optional Files

  • level2.conf
  • level2.dat
  • level2.bsl
  • ...