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.
Files changed (87) hide show
  1. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.vscode/launch.json +2 -2
  2. pyrobbo-1.0.0/PKG-INFO +175 -0
  3. pyrobbo-1.0.0/PyRobbo.egg-info/PKG-INFO +175 -0
  4. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/PyRobbo.egg-info/SOURCES.txt +10 -1
  5. pyrobbo-1.0.0/PyRobbo.egg-info/scm_file_list.json +75 -0
  6. pyrobbo-1.0.0/PyRobbo.egg-info/scm_version.json +8 -0
  7. pyrobbo-1.0.0/README.md +152 -0
  8. pyrobbo-1.0.0/docs/images/level-editor.png +0 -0
  9. pyrobbo-1.0.0/docs/images/original-level-01.png +0 -0
  10. pyrobbo-1.0.0/robbo/__init__.py +151 -0
  11. pyrobbo-1.0.0/robbo/__version__.py +24 -0
  12. pyrobbo-1.0.0/robbo/editor.py +536 -0
  13. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/game.py +41 -53
  14. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/images.py +8 -1
  15. pyrobbo-1.0.0/robbo/level_document.py +180 -0
  16. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/levels.py +54 -9
  17. pyrobbo-1.0.0/robbo/menu.py +254 -0
  18. pyrobbo-1.0.0/tests/test_editor.py +79 -0
  19. pyrobbo-1.0.0/tests/test_level_document.py +92 -0
  20. pyrobbo-0.5.0/PKG-INFO +0 -35
  21. pyrobbo-0.5.0/PyRobbo.egg-info/PKG-INFO +0 -35
  22. pyrobbo-0.5.0/README.md +0 -13
  23. pyrobbo-0.5.0/robbo/__init__.py +0 -200
  24. pyrobbo-0.5.0/robbo/__version__.py +0 -16
  25. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.github/workflows/main.yml +0 -0
  26. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.gitignore +0 -0
  27. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/encodings.xml +0 -0
  28. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/fileColors.xml +0 -0
  29. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/fileTemplates/internal/Python Script.py +0 -0
  30. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/inspectionProfiles/Project_Default.xml +0 -0
  31. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/markdown-exported-files.xml +0 -0
  32. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/markdown-navigator/profiles_settings.xml +0 -0
  33. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/markdown-navigator.xml +0 -0
  34. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/misc.xml +0 -0
  35. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/modules.xml +0 -0
  36. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/runConfigurations/pyrobbo.xml +0 -0
  37. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/scopes/robbo.xml +0 -0
  38. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/scopes/sprites.xml +0 -0
  39. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.idea/vcs.xml +0 -0
  40. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/.vscode/settings.json +0 -0
  41. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/LICENSE +0 -0
  42. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/PyRobbo.egg-info/dependency_links.txt +0 -0
  43. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/PyRobbo.egg-info/entry_points.txt +0 -0
  44. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/PyRobbo.egg-info/requires.txt +0 -0
  45. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/PyRobbo.egg-info/top_level.txt +0 -0
  46. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/pyproject.toml +0 -0
  47. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/pyrobbo.py +0 -0
  48. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/board.py +0 -0
  49. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/defs.py +0 -0
  50. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/levels/ala.dat +0 -0
  51. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/levels/forever.dat +0 -0
  52. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/levels/original.dat +0 -0
  53. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/levels/test.dat +0 -0
  54. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/skins/default/digits.png +0 -0
  55. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/skins/default/icons.png +0 -0
  56. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/skins/oily/digits.png +0 -0
  57. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/skins/oily/icons.png +0 -0
  58. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/skins/tronic/ciphers32.bmp +0 -0
  59. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/skins/tronic/digits.png +0 -0
  60. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/skins/tronic/icons.png +0 -0
  61. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/blaster.wav +0 -0
  62. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/bomb.wav +0 -0
  63. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/bullet.wav +0 -0
  64. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/die.wav +0 -0
  65. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/door.wav +0 -0
  66. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/finish.wav +0 -0
  67. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/key.wav +0 -0
  68. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/lastscrew.wav +0 -0
  69. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/life.wav +0 -0
  70. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/push.wav +0 -0
  71. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/screw.wav +0 -0
  72. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/shoot.wav +0 -0
  73. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/spawn.wav +0 -0
  74. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/teleport.wav +0 -0
  75. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds/wallshoot.wav +0 -0
  76. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sounds.py +0 -0
  77. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sprites/__init__.py +0 -0
  78. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sprites/guns.py +0 -0
  79. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sprites/items.py +0 -0
  80. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sprites/mobs.py +0 -0
  81. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sprites/robbo.py +0 -0
  82. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sprites/static.py +0 -0
  83. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/sprites/teleport.py +0 -0
  84. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo/status.py +0 -0
  85. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo.ico +0 -0
  86. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/robbo.svg +0 -0
  87. {pyrobbo-0.5.0 → pyrobbo-1.0.0}/setup.cfg +0 -0
@@ -6,10 +6,10 @@
6
6
  "configurations": [
7
7
  {
8
8
  "name": "PyRobbo",
9
- "type": "python",
9
+ "type": "debugpy",
10
10
  "request": "launch",
11
11
  "program": "${workspaceFolder}/pyrobbo.py",
12
12
  "console": "integratedTerminal"
13
13
  }
14
14
  ]
15
- }
15
+ }
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
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "tag": "1.0.0",
3
+ "distance": 0,
4
+ "node": "g6d8b468",
5
+ "dirty": false,
6
+ "branch": "HEAD",
7
+ "node_date": "2026-11-20"
8
+ }
@@ -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