comparison README.txt @ 536:7fd6ecb72fd7

Add some stuff about the level editor
author Neil Muller <drnlmuller@gmail.com>
date Sun, 18 Sep 2011 01:18:48 +0200
parents 2bc856561333
children e12a4ebeccfc
comparison
equal deleted inserted replaced
535:463434711e53 536:7fd6ecb72fd7
36 Move the snake around the screen with the arrow keys. Get to the exit without 36 Move the snake around the screen with the arrow keys. Get to the exit without
37 crashing into anything. Collect interesting and exciting mutations along the 37 crashing into anything. Collect interesting and exciting mutations along the
38 way. Make your own levels and share them with the world. 38 way. Make your own levels and share them with the world.
39 39
40 40
41 Level Editor
42 ------------
43
44 The level editor is available from the main menu. Levels are saved as
45 user levels, and stored in $XDG_DATA_HOME/.mamba/user_levels
46 or $APPDATA/.mamba/user_levels.
47
48 A new level can be created from one of the existing templates using new.
49 Level properties, such as the name, filename and background music track
50 can be changed using the "Edit Level Metaddata" button.
51
52 The level editor has 3 modes: placing tiles, placing things and editing
53 sprites.
54
55 Tiles are level geography, such as floors, walls and so forth.
56 Things are items that the snake can eat, such as rats.
57 Sprites are special elements with more complex items which require
58 extra confiugration information, such as tunnels.
59
60 To place tiles and things, select the desired element and click on the map to
61 place the tile or thing. Deleting anything replaces the space with a floor
62 tile. The selection of tiles can be scrolled using the arrow buttons.
63
64 Sprites can be placed as well. Sprites require parameters. Each sprite
65 needs a unique id tag, which can be any string without spaces, and
66 then additional parameters that depend on the type of sprite, usually
67 the id of another sprite. Sprites can be added, edited and deleted.
68 Look at existing maps to see how the parameters can be used.
69
70 Levels can be saved, and uploaded to be shared with other people. Shared
71 levels only become available after the levels have been curated.
72
41 Development notes 73 Development notes
42 ----------------- 74 -----------------
43 75
44 Creating a source distribution with:: 76 Creating a source distribution with::
45 77
46 ./scripts/build_unix.sh 78 ./scripts/build_unix.sh
47 79
48 You may also generate Windows executables and OS X applications:: 80 You may also generate Windows executables and OS X applications::
49 81
50 ./scripts/wine-py2exe 82 Windows:
51 ./scripts/darwin-py2app.sh 83 ./scripts/wine-py2exe
84 ./scripts/makensis
52 85
53 Upload files to PyWeek with:: 86 OS X:
87 ./scripts/darwin-py2app.sh
54 88
55 python pyweek_upload.py
56