PyRobbo 0.5.0__tar.gz → 1.0.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.vscode/launch.json +2 -2
- pyrobbo-1.0.0/PKG-INFO +175 -0
- pyrobbo-1.0.0/PyRobbo.egg-info/PKG-INFO +175 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/PyRobbo.egg-info/SOURCES.txt +10 -1
- pyrobbo-1.0.0/PyRobbo.egg-info/scm_file_list.json +75 -0
- pyrobbo-1.0.0/PyRobbo.egg-info/scm_version.json +8 -0
- pyrobbo-1.0.0/README.md +152 -0
- pyrobbo-1.0.0/docs/images/level-editor.png +0 -0
- pyrobbo-1.0.0/docs/images/original-level-01.png +0 -0
- pyrobbo-1.0.0/robbo/__init__.py +151 -0
- pyrobbo-1.0.0/robbo/__version__.py +24 -0
- pyrobbo-1.0.0/robbo/editor.py +536 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/game.py +41 -53
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/images.py +8 -1
- pyrobbo-1.0.0/robbo/level_document.py +180 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/levels.py +54 -9
- pyrobbo-1.0.0/robbo/menu.py +254 -0
- pyrobbo-1.0.0/tests/test_editor.py +79 -0
- pyrobbo-1.0.0/tests/test_level_document.py +92 -0
- pyrobbo-0.5.0/PKG-INFO +0 -35
- pyrobbo-0.5.0/PyRobbo.egg-info/PKG-INFO +0 -35
- pyrobbo-0.5.0/README.md +0 -13
- pyrobbo-0.5.0/robbo/__init__.py +0 -200
- pyrobbo-0.5.0/robbo/__version__.py +0 -16
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.github/workflows/main.yml +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.gitignore +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/encodings.xml +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/fileColors.xml +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/fileTemplates/internal/Python Script.py +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/inspectionProfiles/Project_Default.xml +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/markdown-exported-files.xml +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/markdown-navigator/profiles_settings.xml +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/markdown-navigator.xml +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/misc.xml +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/modules.xml +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/runConfigurations/pyrobbo.xml +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/scopes/robbo.xml +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/scopes/sprites.xml +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/vcs.xml +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.vscode/settings.json +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/LICENSE +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/PyRobbo.egg-info/dependency_links.txt +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/PyRobbo.egg-info/entry_points.txt +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/PyRobbo.egg-info/requires.txt +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/PyRobbo.egg-info/top_level.txt +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/pyproject.toml +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/pyrobbo.py +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/board.py +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/defs.py +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/levels/ala.dat +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/levels/forever.dat +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/levels/original.dat +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/levels/test.dat +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/skins/default/digits.png +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/skins/default/icons.png +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/skins/oily/digits.png +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/skins/oily/icons.png +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/skins/tronic/ciphers32.bmp +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/skins/tronic/digits.png +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/skins/tronic/icons.png +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/blaster.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/bomb.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/bullet.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/die.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/door.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/finish.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/key.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/lastscrew.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/life.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/push.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/screw.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/shoot.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/spawn.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/teleport.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/wallshoot.wav +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds.py +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sprites/__init__.py +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sprites/guns.py +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sprites/items.py +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sprites/mobs.py +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sprites/robbo.py +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sprites/static.py +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sprites/teleport.py +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/status.py +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo.ico +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo.svg +0 -0
- {pyrobbo-0.5.0 → pyrobbo-1.0.0}/setup.cfg +0 -0
pyrobbo-1.0.0/PKG-INFO
ADDED
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: PyRobbo
|
|
3
|
+
Version: 1.0.0
|
|
4
|
+
Summary: Clone of an old 8-bit Atari game Robbo
|
|
5
|
+
Author-email: Maciej Dems <macdems@gmail.com>
|
|
6
|
+
License: GPL3
|
|
7
|
+
Project-URL: Homepage, http://github.com/macdems/pyrobbo
|
|
8
|
+
Keywords: game,pygame,robbo,atari,clone
|
|
9
|
+
Classifier: Development Status :: 4 - Beta
|
|
10
|
+
Classifier: Intended Audience :: End Users/Desktop
|
|
11
|
+
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
|
|
12
|
+
Classifier: Natural Language :: English
|
|
13
|
+
Classifier: Operating System :: OS Independent
|
|
14
|
+
Classifier: Topic :: Games/Entertainment :: Arcade
|
|
15
|
+
Classifier: Topic :: Games/Entertainment :: Puzzle Games
|
|
16
|
+
Requires-Python: >=3
|
|
17
|
+
Description-Content-Type: text/markdown
|
|
18
|
+
License-File: LICENSE
|
|
19
|
+
Requires-Dist: pygame>=2.0.0
|
|
20
|
+
Requires-Dist: PyYAML>=5.3.1
|
|
21
|
+
Requires-Dist: appdirs>=1.4.4
|
|
22
|
+
Dynamic: license-file
|
|
23
|
+
|
|
24
|
+
# PyRobbo
|
|
25
|
+
|
|
26
|
+
PyRobbo is a Pygame remake of *Robbo*, the puzzle game for 8-bit Atari
|
|
27
|
+
computers. Guide a small robot across hostile planets, collecting the screws
|
|
28
|
+
needed to repair its escape capsule. When the screw counter reaches zero, the
|
|
29
|
+
capsule starts to blink. Walk into it to reach the next planet.
|
|
30
|
+
|
|
31
|
+
![Robbo on the first planet, with nine screws left to collect][first-planet]
|
|
32
|
+
|
|
33
|
+
## Install and play
|
|
34
|
+
|
|
35
|
+
To play the version in this repository, clone it and create a Python 3 virtual
|
|
36
|
+
environment.
|
|
37
|
+
|
|
38
|
+
```sh
|
|
39
|
+
git clone https://github.com/macdems/pyrobbo.git
|
|
40
|
+
cd pyrobbo
|
|
41
|
+
python -m venv .venv
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Activate the environment with `. .venv/bin/activate` on Linux or macOS, or
|
|
45
|
+
`.\.venv\Scripts\Activate.ps1` in Windows PowerShell. Then install and launch
|
|
46
|
+
the game in a window.
|
|
47
|
+
|
|
48
|
+
```sh
|
|
49
|
+
python -m pip install "setuptools<81" .
|
|
50
|
+
pyrobbo --window
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
The setuptools pin supplies `pkg_resources`, which the game uses to load its
|
|
54
|
+
assets. For published releases, see [PyRobbo on PyPI][pypi].
|
|
55
|
+
|
|
56
|
+
## Choose a planet
|
|
57
|
+
|
|
58
|
+
For a first game, select **original**, **level 1**, and press **Enter**. On this
|
|
59
|
+
board the ammunition clip is two squares to Robbo's right. Pick it up for nine
|
|
60
|
+
shots. The counters along the bottom show screws remaining, keys held,
|
|
61
|
+
ammunition, and the current level, from left to right.
|
|
62
|
+
|
|
63
|
+
| Level set | Levels | What to expect |
|
|
64
|
+
| --- | ---: | --- |
|
|
65
|
+
| `original` | 58 | The classic campaign. |
|
|
66
|
+
| `forever` | 59 | A longer, tougher set of puzzles. |
|
|
67
|
+
|
|
68
|
+
In the menu, use **Up/Down** to select a row and **Left/Right** to change its
|
|
69
|
+
value. The **Theme** row switches between `default`, `oily`, and `tronic`. The
|
|
70
|
+
robot and board preview update as you browse. You can also click the arrows
|
|
71
|
+
and **Start Level**, or navigate with a joystick's stick or D-pad and press its
|
|
72
|
+
first button to start.
|
|
73
|
+
|
|
74
|
+
PyRobbo remembers your theme and the last level played in each set. Returning
|
|
75
|
+
to a level starts the puzzle from its initial layout.
|
|
76
|
+
|
|
77
|
+
## Controls
|
|
78
|
+
|
|
79
|
+
| During play | Keyboard |
|
|
80
|
+
| --- | --- |
|
|
81
|
+
| Move | Arrow keys or **WASD** |
|
|
82
|
+
| Fire | Hold **Shift** and press a direction |
|
|
83
|
+
| Scroll a tall board | Hold **Ctrl** and press **Up/Down** or **W/S** |
|
|
84
|
+
| Restart the level | **Ctrl+R** or **Ctrl+X** |
|
|
85
|
+
| Jump to a level in this set | **Ctrl+L**, then two digits, e.g. **07** |
|
|
86
|
+
| Adjust speed | **+** or **=** to speed up, **-** to slow down |
|
|
87
|
+
| Toggle sound | **Ctrl+M** |
|
|
88
|
+
| Toggle clever bear movement | **Ctrl+B** |
|
|
89
|
+
| Toggle fullscreen | **F** (also works in the menu) |
|
|
90
|
+
| Return to the menu | **Esc** |
|
|
91
|
+
| Quit | **Ctrl+Q**, or **Esc** from the menu |
|
|
92
|
+
|
|
93
|
+
With a joystick, move with the stick. Hold the first button and push the stick
|
|
94
|
+
in the direction you want to fire. Hold the second button and move the stick
|
|
95
|
+
up or down to look ahead on a tall board.
|
|
96
|
+
|
|
97
|
+
## Make a level set
|
|
98
|
+
|
|
99
|
+
Choose a set and level in the front menu, then click **Level editor** or press
|
|
100
|
+
**E**. The editor opens that board. Click the set name to open another set,
|
|
101
|
+
or choose **New set** to start with a room containing Robbo, a screw, and an
|
|
102
|
+
escape capsule.
|
|
103
|
+
|
|
104
|
+
![Editing a board with the tile palette alongside the map][editor]
|
|
105
|
+
|
|
106
|
+
| To | In the editor |
|
|
107
|
+
| --- | --- |
|
|
108
|
+
| Paint or erase | Left-drag to paint a tile. Right-drag to erase. |
|
|
109
|
+
| Pick a tile and its settings | Middle-click it on the board. |
|
|
110
|
+
| Scroll | Use the mouse wheel, arrow keys, or buttons below the map. |
|
|
111
|
+
| Configure a tile | Change **Tile options**, then paint. |
|
|
112
|
+
| Manage levels | Use **+ Level**, **Copy**, or **Remove**. |
|
|
113
|
+
| Reorder or resize | Set the position or dimensions in **Board settings**. |
|
|
114
|
+
| Undo an edit | Click **Undo** or press **Ctrl+Z**. |
|
|
115
|
+
|
|
116
|
+
Switch boards with the arrows beside the level number. In a dialog, use
|
|
117
|
+
**Tab** to move between fields and **Enter** to apply your changes.
|
|
118
|
+
|
|
119
|
+
For a teleport pair, paint two teleports with the same link group. The editor
|
|
120
|
+
assigns their endpoints automatically. Board settings also let you change the
|
|
121
|
+
background colour, author, and required screw count.
|
|
122
|
+
|
|
123
|
+
**Save** or **Ctrl+S** writes the whole set to your user level directory.
|
|
124
|
+
Saving edits to a bundled set creates a personal copy that takes precedence
|
|
125
|
+
in the game. Use **Save as** to give a copy its own entry in the menu. To play
|
|
126
|
+
the edited board, choose **Done** and then **Start Level**.
|
|
127
|
+
|
|
128
|
+
### Edit the text format
|
|
129
|
+
|
|
130
|
+
A level set is a plain-text `.dat` file. To try a one-room puzzle, save this as
|
|
131
|
+
`first-orbit.dat`.
|
|
132
|
+
|
|
133
|
+
```text
|
|
134
|
+
[level]
|
|
135
|
+
1
|
|
136
|
+
[data]
|
|
137
|
+
OOOOOOOOO
|
|
138
|
+
OR.%D.T!O
|
|
139
|
+
OOOOOOOOO
|
|
140
|
+
[end]
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
Move right from Robbo (`R`), collect the key (`%`), and use it to open the door
|
|
144
|
+
(`D`). The screw (`T`) activates the capsule (`!`). The outer walls are the
|
|
145
|
+
letter `O`, and dots mark empty squares.
|
|
146
|
+
|
|
147
|
+
```sh
|
|
148
|
+
pyrobbo first-orbit.dat
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
This copies the file into your user level directory and selects **first-orbit**
|
|
152
|
+
in the menu. Add another `[level]` through `[end]` block to extend the set.
|
|
153
|
+
For examples with teleports, enemies, and moving guns, see the
|
|
154
|
+
[bundled level files][level-files].
|
|
155
|
+
|
|
156
|
+
On Linux, the default locations are `~/.local/share/pyrobbo/levels/` for
|
|
157
|
+
installed sets and `~/.config/pyrobbo.yml` for settings. To start with a
|
|
158
|
+
particular theme or display mode, use a command such as
|
|
159
|
+
`pyrobbo --fullscreen --skin tronic`. Run `pyrobbo --help` for all options.
|
|
160
|
+
|
|
161
|
+
## Credits and license
|
|
162
|
+
|
|
163
|
+
Janusz Pelc wrote the original *Robbo* for the Atari XE/XL, published by
|
|
164
|
+
L.K. Avalon. Maciej Dems developed this Pygame remake. Graphics and level data
|
|
165
|
+
come from [GNU Robbo][gnu-robbo].
|
|
166
|
+
|
|
167
|
+
PyRobbo is free software under the [GNU General Public License][license],
|
|
168
|
+
version 3 or later.
|
|
169
|
+
|
|
170
|
+
[editor]: docs/images/level-editor.png
|
|
171
|
+
[first-planet]: docs/images/original-level-01.png
|
|
172
|
+
[pypi]: https://pypi.org/project/PyRobbo/
|
|
173
|
+
[level-files]: robbo/levels/
|
|
174
|
+
[gnu-robbo]: https://sourceforge.net/projects/gnurobbo/
|
|
175
|
+
[license]: LICENSE
|
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: PyRobbo
|
|
3
|
+
Version: 1.0.0
|
|
4
|
+
Summary: Clone of an old 8-bit Atari game Robbo
|
|
5
|
+
Author-email: Maciej Dems <macdems@gmail.com>
|
|
6
|
+
License: GPL3
|
|
7
|
+
Project-URL: Homepage, http://github.com/macdems/pyrobbo
|
|
8
|
+
Keywords: game,pygame,robbo,atari,clone
|
|
9
|
+
Classifier: Development Status :: 4 - Beta
|
|
10
|
+
Classifier: Intended Audience :: End Users/Desktop
|
|
11
|
+
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
|
|
12
|
+
Classifier: Natural Language :: English
|
|
13
|
+
Classifier: Operating System :: OS Independent
|
|
14
|
+
Classifier: Topic :: Games/Entertainment :: Arcade
|
|
15
|
+
Classifier: Topic :: Games/Entertainment :: Puzzle Games
|
|
16
|
+
Requires-Python: >=3
|
|
17
|
+
Description-Content-Type: text/markdown
|
|
18
|
+
License-File: LICENSE
|
|
19
|
+
Requires-Dist: pygame>=2.0.0
|
|
20
|
+
Requires-Dist: PyYAML>=5.3.1
|
|
21
|
+
Requires-Dist: appdirs>=1.4.4
|
|
22
|
+
Dynamic: license-file
|
|
23
|
+
|
|
24
|
+
# PyRobbo
|
|
25
|
+
|
|
26
|
+
PyRobbo is a Pygame remake of *Robbo*, the puzzle game for 8-bit Atari
|
|
27
|
+
computers. Guide a small robot across hostile planets, collecting the screws
|
|
28
|
+
needed to repair its escape capsule. When the screw counter reaches zero, the
|
|
29
|
+
capsule starts to blink. Walk into it to reach the next planet.
|
|
30
|
+
|
|
31
|
+
![Robbo on the first planet, with nine screws left to collect][first-planet]
|
|
32
|
+
|
|
33
|
+
## Install and play
|
|
34
|
+
|
|
35
|
+
To play the version in this repository, clone it and create a Python 3 virtual
|
|
36
|
+
environment.
|
|
37
|
+
|
|
38
|
+
```sh
|
|
39
|
+
git clone https://github.com/macdems/pyrobbo.git
|
|
40
|
+
cd pyrobbo
|
|
41
|
+
python -m venv .venv
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Activate the environment with `. .venv/bin/activate` on Linux or macOS, or
|
|
45
|
+
`.\.venv\Scripts\Activate.ps1` in Windows PowerShell. Then install and launch
|
|
46
|
+
the game in a window.
|
|
47
|
+
|
|
48
|
+
```sh
|
|
49
|
+
python -m pip install "setuptools<81" .
|
|
50
|
+
pyrobbo --window
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
The setuptools pin supplies `pkg_resources`, which the game uses to load its
|
|
54
|
+
assets. For published releases, see [PyRobbo on PyPI][pypi].
|
|
55
|
+
|
|
56
|
+
## Choose a planet
|
|
57
|
+
|
|
58
|
+
For a first game, select **original**, **level 1**, and press **Enter**. On this
|
|
59
|
+
board the ammunition clip is two squares to Robbo's right. Pick it up for nine
|
|
60
|
+
shots. The counters along the bottom show screws remaining, keys held,
|
|
61
|
+
ammunition, and the current level, from left to right.
|
|
62
|
+
|
|
63
|
+
| Level set | Levels | What to expect |
|
|
64
|
+
| --- | ---: | --- |
|
|
65
|
+
| `original` | 58 | The classic campaign. |
|
|
66
|
+
| `forever` | 59 | A longer, tougher set of puzzles. |
|
|
67
|
+
|
|
68
|
+
In the menu, use **Up/Down** to select a row and **Left/Right** to change its
|
|
69
|
+
value. The **Theme** row switches between `default`, `oily`, and `tronic`. The
|
|
70
|
+
robot and board preview update as you browse. You can also click the arrows
|
|
71
|
+
and **Start Level**, or navigate with a joystick's stick or D-pad and press its
|
|
72
|
+
first button to start.
|
|
73
|
+
|
|
74
|
+
PyRobbo remembers your theme and the last level played in each set. Returning
|
|
75
|
+
to a level starts the puzzle from its initial layout.
|
|
76
|
+
|
|
77
|
+
## Controls
|
|
78
|
+
|
|
79
|
+
| During play | Keyboard |
|
|
80
|
+
| --- | --- |
|
|
81
|
+
| Move | Arrow keys or **WASD** |
|
|
82
|
+
| Fire | Hold **Shift** and press a direction |
|
|
83
|
+
| Scroll a tall board | Hold **Ctrl** and press **Up/Down** or **W/S** |
|
|
84
|
+
| Restart the level | **Ctrl+R** or **Ctrl+X** |
|
|
85
|
+
| Jump to a level in this set | **Ctrl+L**, then two digits, e.g. **07** |
|
|
86
|
+
| Adjust speed | **+** or **=** to speed up, **-** to slow down |
|
|
87
|
+
| Toggle sound | **Ctrl+M** |
|
|
88
|
+
| Toggle clever bear movement | **Ctrl+B** |
|
|
89
|
+
| Toggle fullscreen | **F** (also works in the menu) |
|
|
90
|
+
| Return to the menu | **Esc** |
|
|
91
|
+
| Quit | **Ctrl+Q**, or **Esc** from the menu |
|
|
92
|
+
|
|
93
|
+
With a joystick, move with the stick. Hold the first button and push the stick
|
|
94
|
+
in the direction you want to fire. Hold the second button and move the stick
|
|
95
|
+
up or down to look ahead on a tall board.
|
|
96
|
+
|
|
97
|
+
## Make a level set
|
|
98
|
+
|
|
99
|
+
Choose a set and level in the front menu, then click **Level editor** or press
|
|
100
|
+
**E**. The editor opens that board. Click the set name to open another set,
|
|
101
|
+
or choose **New set** to start with a room containing Robbo, a screw, and an
|
|
102
|
+
escape capsule.
|
|
103
|
+
|
|
104
|
+
![Editing a board with the tile palette alongside the map][editor]
|
|
105
|
+
|
|
106
|
+
| To | In the editor |
|
|
107
|
+
| --- | --- |
|
|
108
|
+
| Paint or erase | Left-drag to paint a tile. Right-drag to erase. |
|
|
109
|
+
| Pick a tile and its settings | Middle-click it on the board. |
|
|
110
|
+
| Scroll | Use the mouse wheel, arrow keys, or buttons below the map. |
|
|
111
|
+
| Configure a tile | Change **Tile options**, then paint. |
|
|
112
|
+
| Manage levels | Use **+ Level**, **Copy**, or **Remove**. |
|
|
113
|
+
| Reorder or resize | Set the position or dimensions in **Board settings**. |
|
|
114
|
+
| Undo an edit | Click **Undo** or press **Ctrl+Z**. |
|
|
115
|
+
|
|
116
|
+
Switch boards with the arrows beside the level number. In a dialog, use
|
|
117
|
+
**Tab** to move between fields and **Enter** to apply your changes.
|
|
118
|
+
|
|
119
|
+
For a teleport pair, paint two teleports with the same link group. The editor
|
|
120
|
+
assigns their endpoints automatically. Board settings also let you change the
|
|
121
|
+
background colour, author, and required screw count.
|
|
122
|
+
|
|
123
|
+
**Save** or **Ctrl+S** writes the whole set to your user level directory.
|
|
124
|
+
Saving edits to a bundled set creates a personal copy that takes precedence
|
|
125
|
+
in the game. Use **Save as** to give a copy its own entry in the menu. To play
|
|
126
|
+
the edited board, choose **Done** and then **Start Level**.
|
|
127
|
+
|
|
128
|
+
### Edit the text format
|
|
129
|
+
|
|
130
|
+
A level set is a plain-text `.dat` file. To try a one-room puzzle, save this as
|
|
131
|
+
`first-orbit.dat`.
|
|
132
|
+
|
|
133
|
+
```text
|
|
134
|
+
[level]
|
|
135
|
+
1
|
|
136
|
+
[data]
|
|
137
|
+
OOOOOOOOO
|
|
138
|
+
OR.%D.T!O
|
|
139
|
+
OOOOOOOOO
|
|
140
|
+
[end]
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
Move right from Robbo (`R`), collect the key (`%`), and use it to open the door
|
|
144
|
+
(`D`). The screw (`T`) activates the capsule (`!`). The outer walls are the
|
|
145
|
+
letter `O`, and dots mark empty squares.
|
|
146
|
+
|
|
147
|
+
```sh
|
|
148
|
+
pyrobbo first-orbit.dat
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
This copies the file into your user level directory and selects **first-orbit**
|
|
152
|
+
in the menu. Add another `[level]` through `[end]` block to extend the set.
|
|
153
|
+
For examples with teleports, enemies, and moving guns, see the
|
|
154
|
+
[bundled level files][level-files].
|
|
155
|
+
|
|
156
|
+
On Linux, the default locations are `~/.local/share/pyrobbo/levels/` for
|
|
157
|
+
installed sets and `~/.config/pyrobbo.yml` for settings. To start with a
|
|
158
|
+
particular theme or display mode, use a command such as
|
|
159
|
+
`pyrobbo --fullscreen --skin tronic`. Run `pyrobbo --help` for all options.
|
|
160
|
+
|
|
161
|
+
## Credits and license
|
|
162
|
+
|
|
163
|
+
Janusz Pelc wrote the original *Robbo* for the Atari XE/XL, published by
|
|
164
|
+
L.K. Avalon. Maciej Dems developed this Pygame remake. Graphics and level data
|
|
165
|
+
come from [GNU Robbo][gnu-robbo].
|
|
166
|
+
|
|
167
|
+
PyRobbo is free software under the [GNU General Public License][license],
|
|
168
|
+
version 3 or later.
|
|
169
|
+
|
|
170
|
+
[editor]: docs/images/level-editor.png
|
|
171
|
+
[first-planet]: docs/images/original-level-01.png
|
|
172
|
+
[pypi]: https://pypi.org/project/PyRobbo/
|
|
173
|
+
[level-files]: robbo/levels/
|
|
174
|
+
[gnu-robbo]: https://sourceforge.net/projects/gnurobbo/
|
|
175
|
+
[license]: LICENSE
|
|
@@ -26,14 +26,21 @@ PyRobbo.egg-info/SOURCES.txt
|
|
|
26
26
|
PyRobbo.egg-info/dependency_links.txt
|
|
27
27
|
PyRobbo.egg-info/entry_points.txt
|
|
28
28
|
PyRobbo.egg-info/requires.txt
|
|
29
|
+
PyRobbo.egg-info/scm_file_list.json
|
|
30
|
+
PyRobbo.egg-info/scm_version.json
|
|
29
31
|
PyRobbo.egg-info/top_level.txt
|
|
32
|
+
docs/images/level-editor.png
|
|
33
|
+
docs/images/original-level-01.png
|
|
30
34
|
robbo/__init__.py
|
|
31
35
|
robbo/__version__.py
|
|
32
36
|
robbo/board.py
|
|
33
37
|
robbo/defs.py
|
|
38
|
+
robbo/editor.py
|
|
34
39
|
robbo/game.py
|
|
35
40
|
robbo/images.py
|
|
41
|
+
robbo/level_document.py
|
|
36
42
|
robbo/levels.py
|
|
43
|
+
robbo/menu.py
|
|
37
44
|
robbo/sounds.py
|
|
38
45
|
robbo/status.py
|
|
39
46
|
robbo/levels/ala.dat
|
|
@@ -68,4 +75,6 @@ robbo/sprites/items.py
|
|
|
68
75
|
robbo/sprites/mobs.py
|
|
69
76
|
robbo/sprites/robbo.py
|
|
70
77
|
robbo/sprites/static.py
|
|
71
|
-
robbo/sprites/teleport.py
|
|
78
|
+
robbo/sprites/teleport.py
|
|
79
|
+
tests/test_editor.py
|
|
80
|
+
tests/test_level_document.py
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
{
|
|
2
|
+
"files": [
|
|
3
|
+
".github/workflows/main.yml",
|
|
4
|
+
".gitignore",
|
|
5
|
+
".idea/encodings.xml",
|
|
6
|
+
".idea/fileColors.xml",
|
|
7
|
+
".idea/fileTemplates/internal/Python Script.py",
|
|
8
|
+
".idea/inspectionProfiles/Project_Default.xml",
|
|
9
|
+
".idea/markdown-exported-files.xml",
|
|
10
|
+
".idea/markdown-navigator.xml",
|
|
11
|
+
".idea/markdown-navigator/profiles_settings.xml",
|
|
12
|
+
".idea/misc.xml",
|
|
13
|
+
".idea/modules.xml",
|
|
14
|
+
".idea/runConfigurations/pyrobbo.xml",
|
|
15
|
+
".idea/scopes/robbo.xml",
|
|
16
|
+
".idea/scopes/sprites.xml",
|
|
17
|
+
".idea/vcs.xml",
|
|
18
|
+
".vscode/launch.json",
|
|
19
|
+
".vscode/settings.json",
|
|
20
|
+
"LICENSE",
|
|
21
|
+
"README.md",
|
|
22
|
+
"docs/images/level-editor.png",
|
|
23
|
+
"docs/images/original-level-01.png",
|
|
24
|
+
"pyproject.toml",
|
|
25
|
+
"pyrobbo.py",
|
|
26
|
+
"robbo.ico",
|
|
27
|
+
"robbo.svg",
|
|
28
|
+
"robbo/__init__.py",
|
|
29
|
+
"robbo/board.py",
|
|
30
|
+
"robbo/defs.py",
|
|
31
|
+
"robbo/editor.py",
|
|
32
|
+
"robbo/game.py",
|
|
33
|
+
"robbo/images.py",
|
|
34
|
+
"robbo/level_document.py",
|
|
35
|
+
"robbo/levels.py",
|
|
36
|
+
"robbo/levels/ala.dat",
|
|
37
|
+
"robbo/levels/forever.dat",
|
|
38
|
+
"robbo/levels/original.dat",
|
|
39
|
+
"robbo/levels/test.dat",
|
|
40
|
+
"robbo/menu.py",
|
|
41
|
+
"robbo/skins/default/digits.png",
|
|
42
|
+
"robbo/skins/default/icons.png",
|
|
43
|
+
"robbo/skins/oily/digits.png",
|
|
44
|
+
"robbo/skins/oily/icons.png",
|
|
45
|
+
"robbo/skins/tronic/ciphers32.bmp",
|
|
46
|
+
"robbo/skins/tronic/digits.png",
|
|
47
|
+
"robbo/skins/tronic/icons.png",
|
|
48
|
+
"robbo/sounds.py",
|
|
49
|
+
"robbo/sounds/blaster.wav",
|
|
50
|
+
"robbo/sounds/bomb.wav",
|
|
51
|
+
"robbo/sounds/bullet.wav",
|
|
52
|
+
"robbo/sounds/die.wav",
|
|
53
|
+
"robbo/sounds/door.wav",
|
|
54
|
+
"robbo/sounds/finish.wav",
|
|
55
|
+
"robbo/sounds/key.wav",
|
|
56
|
+
"robbo/sounds/lastscrew.wav",
|
|
57
|
+
"robbo/sounds/life.wav",
|
|
58
|
+
"robbo/sounds/push.wav",
|
|
59
|
+
"robbo/sounds/screw.wav",
|
|
60
|
+
"robbo/sounds/shoot.wav",
|
|
61
|
+
"robbo/sounds/spawn.wav",
|
|
62
|
+
"robbo/sounds/teleport.wav",
|
|
63
|
+
"robbo/sounds/wallshoot.wav",
|
|
64
|
+
"robbo/sprites/__init__.py",
|
|
65
|
+
"robbo/sprites/guns.py",
|
|
66
|
+
"robbo/sprites/items.py",
|
|
67
|
+
"robbo/sprites/mobs.py",
|
|
68
|
+
"robbo/sprites/robbo.py",
|
|
69
|
+
"robbo/sprites/static.py",
|
|
70
|
+
"robbo/sprites/teleport.py",
|
|
71
|
+
"robbo/status.py",
|
|
72
|
+
"tests/test_editor.py",
|
|
73
|
+
"tests/test_level_document.py"
|
|
74
|
+
]
|
|
75
|
+
}
|
pyrobbo-1.0.0/README.md
ADDED
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
# PyRobbo
|
|
2
|
+
|
|
3
|
+
PyRobbo is a Pygame remake of *Robbo*, the puzzle game for 8-bit Atari
|
|
4
|
+
computers. Guide a small robot across hostile planets, collecting the screws
|
|
5
|
+
needed to repair its escape capsule. When the screw counter reaches zero, the
|
|
6
|
+
capsule starts to blink. Walk into it to reach the next planet.
|
|
7
|
+
|
|
8
|
+
![Robbo on the first planet, with nine screws left to collect][first-planet]
|
|
9
|
+
|
|
10
|
+
## Install and play
|
|
11
|
+
|
|
12
|
+
To play the version in this repository, clone it and create a Python 3 virtual
|
|
13
|
+
environment.
|
|
14
|
+
|
|
15
|
+
```sh
|
|
16
|
+
git clone https://github.com/macdems/pyrobbo.git
|
|
17
|
+
cd pyrobbo
|
|
18
|
+
python -m venv .venv
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Activate the environment with `. .venv/bin/activate` on Linux or macOS, or
|
|
22
|
+
`.\.venv\Scripts\Activate.ps1` in Windows PowerShell. Then install and launch
|
|
23
|
+
the game in a window.
|
|
24
|
+
|
|
25
|
+
```sh
|
|
26
|
+
python -m pip install "setuptools<81" .
|
|
27
|
+
pyrobbo --window
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
The setuptools pin supplies `pkg_resources`, which the game uses to load its
|
|
31
|
+
assets. For published releases, see [PyRobbo on PyPI][pypi].
|
|
32
|
+
|
|
33
|
+
## Choose a planet
|
|
34
|
+
|
|
35
|
+
For a first game, select **original**, **level 1**, and press **Enter**. On this
|
|
36
|
+
board the ammunition clip is two squares to Robbo's right. Pick it up for nine
|
|
37
|
+
shots. The counters along the bottom show screws remaining, keys held,
|
|
38
|
+
ammunition, and the current level, from left to right.
|
|
39
|
+
|
|
40
|
+
| Level set | Levels | What to expect |
|
|
41
|
+
| --- | ---: | --- |
|
|
42
|
+
| `original` | 58 | The classic campaign. |
|
|
43
|
+
| `forever` | 59 | A longer, tougher set of puzzles. |
|
|
44
|
+
|
|
45
|
+
In the menu, use **Up/Down** to select a row and **Left/Right** to change its
|
|
46
|
+
value. The **Theme** row switches between `default`, `oily`, and `tronic`. The
|
|
47
|
+
robot and board preview update as you browse. You can also click the arrows
|
|
48
|
+
and **Start Level**, or navigate with a joystick's stick or D-pad and press its
|
|
49
|
+
first button to start.
|
|
50
|
+
|
|
51
|
+
PyRobbo remembers your theme and the last level played in each set. Returning
|
|
52
|
+
to a level starts the puzzle from its initial layout.
|
|
53
|
+
|
|
54
|
+
## Controls
|
|
55
|
+
|
|
56
|
+
| During play | Keyboard |
|
|
57
|
+
| --- | --- |
|
|
58
|
+
| Move | Arrow keys or **WASD** |
|
|
59
|
+
| Fire | Hold **Shift** and press a direction |
|
|
60
|
+
| Scroll a tall board | Hold **Ctrl** and press **Up/Down** or **W/S** |
|
|
61
|
+
| Restart the level | **Ctrl+R** or **Ctrl+X** |
|
|
62
|
+
| Jump to a level in this set | **Ctrl+L**, then two digits, e.g. **07** |
|
|
63
|
+
| Adjust speed | **+** or **=** to speed up, **-** to slow down |
|
|
64
|
+
| Toggle sound | **Ctrl+M** |
|
|
65
|
+
| Toggle clever bear movement | **Ctrl+B** |
|
|
66
|
+
| Toggle fullscreen | **F** (also works in the menu) |
|
|
67
|
+
| Return to the menu | **Esc** |
|
|
68
|
+
| Quit | **Ctrl+Q**, or **Esc** from the menu |
|
|
69
|
+
|
|
70
|
+
With a joystick, move with the stick. Hold the first button and push the stick
|
|
71
|
+
in the direction you want to fire. Hold the second button and move the stick
|
|
72
|
+
up or down to look ahead on a tall board.
|
|
73
|
+
|
|
74
|
+
## Make a level set
|
|
75
|
+
|
|
76
|
+
Choose a set and level in the front menu, then click **Level editor** or press
|
|
77
|
+
**E**. The editor opens that board. Click the set name to open another set,
|
|
78
|
+
or choose **New set** to start with a room containing Robbo, a screw, and an
|
|
79
|
+
escape capsule.
|
|
80
|
+
|
|
81
|
+
![Editing a board with the tile palette alongside the map][editor]
|
|
82
|
+
|
|
83
|
+
| To | In the editor |
|
|
84
|
+
| --- | --- |
|
|
85
|
+
| Paint or erase | Left-drag to paint a tile. Right-drag to erase. |
|
|
86
|
+
| Pick a tile and its settings | Middle-click it on the board. |
|
|
87
|
+
| Scroll | Use the mouse wheel, arrow keys, or buttons below the map. |
|
|
88
|
+
| Configure a tile | Change **Tile options**, then paint. |
|
|
89
|
+
| Manage levels | Use **+ Level**, **Copy**, or **Remove**. |
|
|
90
|
+
| Reorder or resize | Set the position or dimensions in **Board settings**. |
|
|
91
|
+
| Undo an edit | Click **Undo** or press **Ctrl+Z**. |
|
|
92
|
+
|
|
93
|
+
Switch boards with the arrows beside the level number. In a dialog, use
|
|
94
|
+
**Tab** to move between fields and **Enter** to apply your changes.
|
|
95
|
+
|
|
96
|
+
For a teleport pair, paint two teleports with the same link group. The editor
|
|
97
|
+
assigns their endpoints automatically. Board settings also let you change the
|
|
98
|
+
background colour, author, and required screw count.
|
|
99
|
+
|
|
100
|
+
**Save** or **Ctrl+S** writes the whole set to your user level directory.
|
|
101
|
+
Saving edits to a bundled set creates a personal copy that takes precedence
|
|
102
|
+
in the game. Use **Save as** to give a copy its own entry in the menu. To play
|
|
103
|
+
the edited board, choose **Done** and then **Start Level**.
|
|
104
|
+
|
|
105
|
+
### Edit the text format
|
|
106
|
+
|
|
107
|
+
A level set is a plain-text `.dat` file. To try a one-room puzzle, save this as
|
|
108
|
+
`first-orbit.dat`.
|
|
109
|
+
|
|
110
|
+
```text
|
|
111
|
+
[level]
|
|
112
|
+
1
|
|
113
|
+
[data]
|
|
114
|
+
OOOOOOOOO
|
|
115
|
+
OR.%D.T!O
|
|
116
|
+
OOOOOOOOO
|
|
117
|
+
[end]
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
Move right from Robbo (`R`), collect the key (`%`), and use it to open the door
|
|
121
|
+
(`D`). The screw (`T`) activates the capsule (`!`). The outer walls are the
|
|
122
|
+
letter `O`, and dots mark empty squares.
|
|
123
|
+
|
|
124
|
+
```sh
|
|
125
|
+
pyrobbo first-orbit.dat
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
This copies the file into your user level directory and selects **first-orbit**
|
|
129
|
+
in the menu. Add another `[level]` through `[end]` block to extend the set.
|
|
130
|
+
For examples with teleports, enemies, and moving guns, see the
|
|
131
|
+
[bundled level files][level-files].
|
|
132
|
+
|
|
133
|
+
On Linux, the default locations are `~/.local/share/pyrobbo/levels/` for
|
|
134
|
+
installed sets and `~/.config/pyrobbo.yml` for settings. To start with a
|
|
135
|
+
particular theme or display mode, use a command such as
|
|
136
|
+
`pyrobbo --fullscreen --skin tronic`. Run `pyrobbo --help` for all options.
|
|
137
|
+
|
|
138
|
+
## Credits and license
|
|
139
|
+
|
|
140
|
+
Janusz Pelc wrote the original *Robbo* for the Atari XE/XL, published by
|
|
141
|
+
L.K. Avalon. Maciej Dems developed this Pygame remake. Graphics and level data
|
|
142
|
+
come from [GNU Robbo][gnu-robbo].
|
|
143
|
+
|
|
144
|
+
PyRobbo is free software under the [GNU General Public License][license],
|
|
145
|
+
version 3 or later.
|
|
146
|
+
|
|
147
|
+
[editor]: docs/images/level-editor.png
|
|
148
|
+
[first-planet]: docs/images/original-level-01.png
|
|
149
|
+
[pypi]: https://pypi.org/project/PyRobbo/
|
|
150
|
+
[level-files]: robbo/levels/
|
|
151
|
+
[gnu-robbo]: https://sourceforge.net/projects/gnurobbo/
|
|
152
|
+
[license]: LICENSE
|
|
Binary file
|
|
Binary file
|