Document Quadrapassel with complete illustrated player manual
No files matched your search
@@ -19,6 +19,15 @@ official 512 KB MC6809 playtest. Brian also reported successful play on a physic
|
|||||||
Deliveries use `QUADPSLxx.DSK`, with a two-digit build number and a convenient
|
Deliveries use `QUADPSLxx.DSK`, with a two-digit build number and a convenient
|
||||||
DOS launcher and a documented manual launch path. RAM sizes above are **KB**.
|
DOS launcher and a documented manual launch path. RAM sizes above are **KB**.
|
||||||
|
|
||||||
|
## Player’s manual
|
||||||
|
|
||||||
|
Read the detailed [online manual](https://vccplus.brianholman.com/games/quadrapassel/)
|
||||||
|
for every screen, keyboard and joystick controls, both scoring rules and all 34
|
||||||
|
scoreboards. Its shared VCC Plus reading edition includes a reviewed PDF download.
|
||||||
|
The authoritative [Markdown and screenshot source](docs/manual/QUADRAPASSEL.md)
|
||||||
|
includes 17 actual emulator captures; [reproduction steps](docs/manual/README.md)
|
||||||
|
use the common VCC Plus documentation process.
|
||||||
|
|
||||||
## Start here
|
## Start here
|
||||||
|
|
||||||
- [START_HERE.md](START_HERE.md): prompt for a separate chat within the existing VCC Plus project.
|
- [START_HERE.md](START_HERE.md): prompt for a separate chat within the existing VCC Plus project.
|
||||||
|
|||||||
@@ -0,0 +1,540 @@
|
|||||||
|
# Quadrapassel for CoCo
|
||||||
|
|
||||||
|
## Welcome to the CoCo edition
|
||||||
|
|
||||||
|
Build a careful stack, leave room for the next piece, and turn a falling-block puzzle into a high-score chase. **Quadrapassel for CoCo** brings a familiar game to the Color Computer 3 with seven distinct piece colors, keyboard and analog joystick controls, two scoring systems, and high scores saved to disk.
|
||||||
|
|
||||||
|
This manual describes **game disk build 05**, `QUADPSL05.DSK`. The game build number is separate from the VCC Plus emulator version. Screenshots are real guest-framebuffer captures of this build running in VCC Plus 3.6.1 (54), using a disposable MC6809 / 512 KB session. They are not mockups, Mac screenshots, or pictures of a proposed interface.
|
||||||
|
|
||||||
|
**© Brian K. Holman 2026**
|
||||||
|
|
||||||
|
### A clean-room CoCo implementation
|
||||||
|
|
||||||
|
The CoCo game was written anew in C from a behavioral specification, with the goal of being functionally similar to Quadrapassel for Linux and Mac. No Linux or Mac application source code is incorporated into the CoCo game. The Quadrapassel name was deliberately retained for branding continuity, and this implementation uses the GNU GPL, like the reference game.
|
||||||
|
|
||||||
|
The behavioral specification and reference piece/scoring data preserve their GPL provenance and the original contributors' acknowledgements. This is an independent CoCo implementation, with deliberate adaptations for its machine, controls, display, and storage. It is not a claim that every behavior, random sequence, visual effect, or platform feature is identical to the Linux or Mac applications. Font and library contributions have their own acknowledgements in [Copyright, license, and credits](#copyright-license-and-credits).
|
||||||
|
|
||||||
|
### How to use this manual
|
||||||
|
|
||||||
|
For a first game, follow [Starting the game](#starting-the-game), then [Reading the play screen](#reading-the-play-screen). Keep [Keyboard controls](#keyboard-controls) or [Joystick controls](#joystick-controls) nearby. Read [Modern and Classic scoring](#modern-and-classic-scoring) before comparing records, and [High scores and skill categories](#high-scores-and-skill-categories) before changing scoring rules or erasing a board.
|
||||||
|
|
||||||
|
The names in this manual match the game's menus. Key-shaped labels represent keyboard keys. A “tap” means press and release. “Hold” means keep the control pressed until the action has happened. Let a new screen finish drawing before making its next selection, and let disk operations finish before resetting or changing disks.
|
||||||
|
|
||||||
|
## Before you play
|
||||||
|
|
||||||
|
### Machine and media
|
||||||
|
|
||||||
|
The current edition is for a **Color Computer 3 with Disk BASIC and a writable game disk**. The design target is 128 KB; the current detailed emulator checks use 512 KB. Brian has also reported successful play on a physical 512 KB CoCo 3. Actual 128 KB qualification remains pending. This manual does not present a 512 KB test as proof of a 128 KB pass.
|
||||||
|
|
||||||
|
A CoCo 2 adaptation is not included in this disk. Additional RAM does not unlock a separate higher-resolution edition of this game: the current CoCo 3 presentation uses its 320 × 192, 16-color graphics mode. Seven colors identify the pieces; other palette entries support text, background, outlines, and shadow.
|
||||||
|
|
||||||
|
You can play with the keyboard, a standard analog joystick in either CoCo port, or a combination. **Right** is the default joystick port. One fire button is enough for all essential actions. A second button adds a convenient hard drop. In an emulator, assign the host controller to the intended CoCo port; a USB controller's physical connector is not itself a CoCo joystick-port selection.
|
||||||
|
|
||||||
|
### Protect your records
|
||||||
|
|
||||||
|
Keep an untouched original of the game disk and play from a writable copy. On real media, keep a separate disk backup. In an emulator, copy the complete disk image when you want a backup of both the game and its scores. Back up after the game has finished saving, not during a write.
|
||||||
|
|
||||||
|
Every new numbered delivery starts with default preferences and empty high scores. Your previous disk retains its own records; a new build does not automatically import them. Do not overwrite your old score disk just because a newer numbered game disk exists.
|
||||||
|
|
||||||
|
## Starting the game
|
||||||
|
|
||||||
|
1. Insert or mount a writable copy of `QUADPSL05.DSK` in drive 0.
|
||||||
|
2. From Disk BASIC, enter `DOS` and press `Enter`.
|
||||||
|
3. Wait for loading and the “READING SCORES” stage to finish.
|
||||||
|
4. At the title, choose **START** and press `Enter`, `Space`, or tap the primary fire button.
|
||||||
|
|
||||||
|
The DOS launcher prepares memory and loads the game. If you need the separately documented manual loading path, use these commands from Disk BASIC:
|
||||||
|
|
||||||
|
```basic
|
||||||
|
PCLEAR1
|
||||||
|
LOADM"QUAD.BIN"
|
||||||
|
EXEC
|
||||||
|
```
|
||||||
|
|
||||||
|
Changing a mounted disk does not replace the program already in RAM. When testing a new build, return to a clean Disk BASIC start and load it again. In an emulator, confirm the newly loaded program as well as the mounted filename. Follow the emulator's normal restart and unsaved-media safeguards.
|
||||||
|
|
||||||
|
### The title screen
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
The title is drawn from the game's own lettering and block shapes. It is the main navigation point:
|
||||||
|
|
||||||
|
| Choice | What it does |
|
||||||
|
| --- | --- |
|
||||||
|
| **START** | Begins a new game using the current next-game settings. |
|
||||||
|
| **SETTINGS** | Opens difficulty, scoring, appearance, sound, seed, joystick, and timing options. |
|
||||||
|
| **CONTROLS** | Shows keyboard/joystick help and sampled joystick readings. |
|
||||||
|
| **SCORES** | Opens the high-score browser for the current difficulty and Normal/Difficult Pieces choice. |
|
||||||
|
| **CREDITS** | Shows the game and component acknowledgements. |
|
||||||
|
| **QUIT** | Leaves the program and returns to BASIC. |
|
||||||
|
|
||||||
|
Use `↑` / `↓` or the joystick to move the pointer. `Enter` and `Space` select in menus; the primary fire button selects when released. Release the control before making another choice. `BREAK` backs out of most secondary screens. In VCC Plus, the Mac `Esc` key acts as the CoCo BREAK key while guest input has focus.
|
||||||
|
|
||||||
|
## Reading the play screen
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
The board has **10 columns and 20 visible rows**. The falling piece is active; the blocks already placed on the board are settled. Fill an entire horizontal row to clear it. Rows above a clear fall together, and empty rows appear at the top. Keep the stack below the spawning area.
|
||||||
|
|
||||||
|
| Area | Meaning |
|
||||||
|
| --- | --- |
|
||||||
|
| **SCORE** | Points earned under this game's fixed scoring rule. Moving and dropping alone do not award points. |
|
||||||
|
| **LEVEL** | The current speed/scoring multiplier. It starts from difficulty and normally rises every ten cleared lines. |
|
||||||
|
| **LINES** | Total rows cleared in this game, not the number of pieces placed. |
|
||||||
|
| **NEXT** | The one-piece preview. Use it to plan a space before the current piece locks. |
|
||||||
|
| **HOLD** | The type reserved for a later swap. It is empty at the start. |
|
||||||
|
| **MODERN / CLASSIC** | The rule fixed when this game began. This is the game's rule, even if the next-game preference is changed while paused. |
|
||||||
|
| **P ACTIONS** | A reminder that `P` opens the pause/actions screen. |
|
||||||
|
|
||||||
|
### Seven pieces
|
||||||
|
|
||||||
|
Each piece contains four squares. The shapes are L, J, T, S, Z, I, and O. Their CoCo colors are respectively red, green, blue, light gray, yellow, purple, and orange. The orange/yellow and other palette colors can look different on RGB, composite, real monitors, and emulator display settings. Learn the shapes as well as the colors.
|
||||||
|
|
||||||
|
The game has four rotation states for each type. Some shapes are symmetric: an O remains square, while an I, S, or Z repeats its visible shape after two turns. Seeing only two distinct pictures for one of those types is normal; a T, L, or J offers four visibly different orientations.
|
||||||
|
|
||||||
|
### Movement, rotation, and locking
|
||||||
|
|
||||||
|
A sideways press moves one column immediately. If held, movement repeats after about 200 ms, then about every 40 ms. If opposite directions are held together, the first held direction stays in control until released.
|
||||||
|
|
||||||
|
Rotation tries the requested orientation, with small horizontal adjustments near a wall or stack. If none fits, the piece stays in its previous position. This edition does not use modern spin bonuses or the modern SRS rotation system. An attempted move that cannot fit does not push settled blocks out of the way.
|
||||||
|
|
||||||
|
Normal gravity moves the piece downward at the current level's pace. When a gravity step cannot move it down, the piece locks. There is no additional modern lock-delay mechanic. A hard drop goes directly to the lowest valid position and locks immediately; a soft drop increases the downward pace while held.
|
||||||
|
|
||||||
|
A game ends if the next piece cannot spawn, or if locking would leave occupied squares above the board. This protects the board boundaries as well as defining the end of play.
|
||||||
|
|
||||||
|
### Next, Hold, and landing shadow
|
||||||
|
|
||||||
|
Press `H`, or use **HOLD** in the actions menu, to reserve or exchange a piece. The first Hold stores the current type and brings in the preview. Later Holds swap the active and reserved types. A nonempty swap keeps the existing preview. A held piece returns in its starting orientation.
|
||||||
|
|
||||||
|
You can Hold **once per locked piece**. You must place the replacement before using Hold again. The actions menu labels the command **HOLD - UNAVAILABLE** when it has already been used or the game is over. Selecting an unavailable action does not consume another piece.
|
||||||
|
|
||||||
|
Landing Shadow is optional and starts Off. When enabled, it indicates where the current piece would land if hard-dropped. It is only a guide; moving or rotating changes the indicated landing position. It never represents already settled blocks.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
## Keyboard controls
|
||||||
|
|
||||||
|
The keyboard stays usable when a joystick is selected. Use whichever method suits the moment; selecting a menu with the keyboard does not switch the joystick off.
|
||||||
|
|
||||||
|
| Keys | During play |
|
||||||
|
| --- | --- |
|
||||||
|
| `←` / `→`, or `A` / `D` | Move left/right; hold to repeat. |
|
||||||
|
| `↓`, or `S` | Soft drop while held; release to restore normal gravity. |
|
||||||
|
| `↑`, or `W` | Rotate in the preferred direction, counterclockwise by default. |
|
||||||
|
| `Q` | Rotate counterclockwise, regardless of the preferred direction. |
|
||||||
|
| `E` | Rotate clockwise, regardless of the preferred direction. |
|
||||||
|
| `Space` | Hard drop and lock, once per press. Release before dropping another piece. |
|
||||||
|
| `H` | Hold or swap, once per locked piece. |
|
||||||
|
| `P` | Pause/open actions; press again to resume. |
|
||||||
|
| `BREAK` | Pause/open actions. |
|
||||||
|
|
||||||
|
### Keyboard in menus
|
||||||
|
|
||||||
|
| Keys | Menu behavior |
|
||||||
|
| --- | --- |
|
||||||
|
| `↑` / `↓` | Choose a menu item. |
|
||||||
|
| `Enter` or `Space` | Select the current choice. |
|
||||||
|
| `←` / `→` | Adjust a highlighted setting; change category in Scores; choose a seed digit. |
|
||||||
|
| `BREAK` | Back/cancel. In Settings, Back retains and attempts to save current changes. |
|
||||||
|
| `P` | Resume from the paused actions menu; acts as a back/pause command elsewhere. |
|
||||||
|
|
||||||
|
**Initials-screen exception:** use `Enter` or primary fire to select there. `Space` is not a selection key on that screen, and `P` enters a name letter rather than acting as Back. `BREAK` is the keyboard cancel/back control.
|
||||||
|
|
||||||
|
Use the arrow keys for menu navigation; the A/D/W/S aliases are primarily gameplay controls. In the seed editor, `↑` / `↓` change the selected hexadecimal digit. In the initials screen, letters enter the name; `←` / `→` cycle the selected letter, while `↑` / `↓` choose the item.
|
||||||
|
|
||||||
|
### Using the keyboard in VCC Plus
|
||||||
|
|
||||||
|
Click the CoCo display, or use VCC Plus's **Focus CoCo Display** command, before typing game controls. Return focus to Mac controls when you want emulator menus. This distinction matters: a Mac shortcut and a CoCo keystroke are different inputs.
|
||||||
|
|
||||||
|
If VCC Plus is configured to emulate a joystick using keyboard keys, those reserved keys are delivered as joystick controls. For example, an Arrows + Z/X joystick mapping uses the arrows for the emulated stick and the assigned letters for its two buttons. Choose and understand that mapping rather than expecting the same reserved key to operate two independent input paths.
|
||||||
|
|
||||||
|
## Joystick controls
|
||||||
|
|
||||||
|
A standard analog joystick in the **right port** is the default. Select Left if your joystick is plugged into the left port. Select Off to use keyboard-only input or to isolate a controller problem. The controller does not need a second fire button to reach Hold, Settings, New Game, or Quit.
|
||||||
|
|
||||||
|
| Joystick input | During play |
|
||||||
|
| --- | --- |
|
||||||
|
| Left / right | Move sideways with repeat. |
|
||||||
|
| Down | Soft drop while held. |
|
||||||
|
| Up | Hard drop once; return to neutral to rearm. |
|
||||||
|
| Primary fire, short tap/release | Rotate once in the preferred direction. The rotation occurs on release. |
|
||||||
|
| Primary fire, held for about 400 ms | Open the actions menu without an additional release rotation. |
|
||||||
|
| Secondary fire, if available | Hard drop once on press, like `Space`; release before another drop. |
|
||||||
|
|
||||||
|
**Up on the joystick is hard drop; Up on the keyboard is rotation.** This is an intentional difference. Do not treat the two Up controls as aliases.
|
||||||
|
|
||||||
|
### One-button play
|
||||||
|
|
||||||
|
Tap fire briefly to rotate. To use Hold or another action, hold fire until the actions screen appears, release it, move the pointer with the stick, and tap fire to select. **HOLD** and **ROTATE OTHER WAY** perform their action and resume play; other choices open the corresponding menu.
|
||||||
|
|
||||||
|
Release fire after changing screens. The release guard prevents the same held press from selecting the next screen's first option accidentally. The two-button hard-drop feature is ignored in menus, so the primary button remains the menu selection control.
|
||||||
|
|
||||||
|
### Centering and calibration
|
||||||
|
|
||||||
|
Let the stick return to its physical center before starting. If the piece drifts with the stick released, open Settings, leave the stick centered, choose **CALIBRATE NEUTRAL**, and select it. Calibration records the current center readings; it is explicit, not automatic during play. Do not hold the stick to one side while calibrating.
|
||||||
|
|
||||||
|
The game uses a center dead zone and hysteresis so small changes around neutral do not cause rapid direction changes. Up-drop is rearmed by returning the vertical axis to neutral. On diagonals, the dominant axis helps prevent a sideways gesture from accidentally triggering an Up hard drop.
|
||||||
|
|
||||||
|
In VCC Plus, configure the controller's host mapping as well as the game's port. Ensure the primary and secondary physical buttons are assigned to the emulator's Fire 1 and Fire 2. A two-button game mapping cannot create a secondary switch on a physical one-button CoCo joystick.
|
||||||
|
|
||||||
|
### Controls and readings screen
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
**RIGHT XY** and **LEFT XY** are sampled axis values in the game's 0–63 range. The center is normally around 31. **BUTTONS** is the raw button bitmask; 15 is the usual fully released value. This screen displays readings sampled when it is drawn; it is not a continuously animated controller diagnostic. Reopen it for a fresh sample.
|
||||||
|
|
||||||
|
## Pause, actions, and confirmations
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
`P`, `BREAK`, or a long primary-fire press opens the actions menu. The game is paused while you make a choice.
|
||||||
|
|
||||||
|
| Choice | Result |
|
||||||
|
| --- | --- |
|
||||||
|
| **RESUME** | Returns to the falling piece. |
|
||||||
|
| **HOLD** | Uses the current piece's remaining Hold allowance, then resumes. |
|
||||||
|
| **ROTATE OTHER WAY** | Attempts rotation opposite to the preferred direction, then resumes. |
|
||||||
|
| **SETTINGS** | Opens settings without discarding the game. |
|
||||||
|
| **NEW GAME** | Opens a confirmation before replacing current play. |
|
||||||
|
| **QUIT** | Opens a confirmation before abandoning the game for the title. |
|
||||||
|
| **BACK** | Returns to the game; after game over, returns to the title. |
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
**START A NEW GAME?** warns that current play will end. **CANCEL** is the initial selection. Choose **YES** only when you want a fresh board using the current next-game settings. An unfinished game's score is not a completed high-score entry.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
**QUIT THIS GAME?** also starts with Cancel selected. Yes abandons this game and returns to the title; it does not erase the saved high-score tables. The title's Quit is the separate command for leaving the program for BASIC.
|
||||||
|
|
||||||
|
## Every setting explained
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Choose an item with `↑` / `↓` or the stick. Use `←` / `→` to change it; `Enter` or primary fire also advances/selects the highlighted item. **BACK** keeps the current changes and attempts to save them to disk. BREAK is a convenient way to take that same back path; it is not a “discard all changes” button.
|
||||||
|
|
||||||
|
| Setting | Values and purpose | When it applies |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| **DIFFICULTY** | Relaxed, then 0–15. Sets initial speed, prefilled rows, and the record category. | Next game. |
|
||||||
|
| **SCORING RULES** | Modern or Classic (40.2). Opens the keep/erase/cancel decision. | Next game; current game's rule stays fixed. |
|
||||||
|
| **STYLE** | Plain, Modern, Clean. Changes block edging without changing rules. | Immediately. |
|
||||||
|
| **GRID** | On/Off. Adds visible cell outlines. | Immediately. |
|
||||||
|
| **LANDING SHADOW** | On/Off. Shows the current piece's hard-drop destination. | Immediately. |
|
||||||
|
| **SOUND** | On/Off. Enables short event effects. There is no required continuous background music. | Immediately. |
|
||||||
|
| **PREFERRED ROTATION** | CCW or CW. Sets keyboard Up/W and primary-fire tap direction. | Immediately. |
|
||||||
|
| **DIFFICULT PIECES** | On/Off. Uses an adversarial, Bastet-inspired selector instead of ordinary weighted balancing. | Next game; also chooses a separate score category. |
|
||||||
|
| **CUSTOM SEED** | On/Off. Uses the stored repeatable CoCo seed instead of a timer-based starting seed. | Next game. |
|
||||||
|
| **EDIT SEED** | Opens the eight-digit hexadecimal editor. | The stored seed is used by the next game with Custom Seed On. |
|
||||||
|
| **JOYSTICK** | Right, Left, Off. Selects the CoCo port. | Immediately. |
|
||||||
|
| **CALIBRATE NEUTRAL** | Captures the four current axis centers. Center the stick first. | Immediately. |
|
||||||
|
| **VIDEO TIMING** | 60 or 50. Selects the game's timing conversion for the target video rate. | Immediately; use the value appropriate to the machine. |
|
||||||
|
| **BACK** | Keeps changes, attempts a disk save, and returns to the title or actions menu. | On selection. |
|
||||||
|
|
||||||
|
### Appearance
|
||||||
|
|
||||||
|
**Plain** uses flat pieces. **Modern**, the default, adds subtle dark-gray borders against the black background. **Clean** uses lighter edging. Grid and Landing Shadow are independent options.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Changing appearance does not move blocks or change your record category.
|
||||||
|
|
||||||
|
### Difficulty, starting rows, and level
|
||||||
|
|
||||||
|
At difficulty 0, the board starts empty and level starts at 1. At difficulty 1–15, that many bottom rows begin with scattered blocks, and the initial level is difficulty + 1. The prefill is not a wall of full rows: each row has a guaranteed empty column, and the other cells are randomly populated.
|
||||||
|
|
||||||
|
For ordinary difficulty, level is:
|
||||||
|
|
||||||
|
`starting difficulty + 1 + whole groups of 10 cleared lines`
|
||||||
|
|
||||||
|
For example, difficulty 3 starts at level 4. Clearing your tenth line raises it to 5. The record remains in the **difficulty 3** category, because the category tracks the starting challenge, not the level reached later.
|
||||||
|
|
||||||
|
**Relaxed** is a separate starting choice. It begins empty at level 1 and stays at level 1 as lines accumulate. Pieces still fall; Relaxed is not a gravity-off construction mode. Its scores have their own Normal and Difficult Pieces categories.
|
||||||
|
|
||||||
|
### Piece selection and repeatable seeds
|
||||||
|
|
||||||
|
Normal selection uses weighted balancing, not a seven-piece bag. Pieces that have appeared less frequently become more likely, but repeats and runs are possible. The preview shows one piece ahead, not a promise that the other six types must appear before another duplicate.
|
||||||
|
|
||||||
|
Difficult Pieces evaluates which types offer poor placements on the settled board and usually chooses one of the less helpful results, with a small randomized element. It can also choose a starting rotation. It is intended to be harder, and its records are separated from Normal selection. It does not alter the two scoring formulas.
|
||||||
|
|
||||||
|
A Custom Seed reproduces the CoCo initial board and piece-selection stream when the same relevant starting options and actions are used. Use the same difficulty and Difficult Pieces choice when comparing runs. Hold changes when the preview is consumed, and Difficult Pieces depends on the board you build, so identical seed text alone does not promise identical later play after different decisions. The CoCo generator is not required to match Linux or Mac random streams.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
The seed is 32 bits, shown as eight hexadecimal digits, `00000000` through `FFFFFFFF`. Use `←` / `→` to choose a digit and `↑` / `↓` to change it through 0–9 and A–F. Select with `Enter` or primary fire when done. BREAK returns to Settings as well. Zero is a valid seed; the generator maps it to a fixed nonzero internal starting state. Set **CUSTOM SEED ON** if you want the edited value to be used.
|
||||||
|
|
||||||
|
## Modern and Classic scoring
|
||||||
|
|
||||||
|
Both systems award points for completed horizontal rows. They share the same regular clear values and level multiplier. Their major difference is the bonus when a clear includes the board's **original bottom row**.
|
||||||
|
|
||||||
|
The game's **SCORING RULES** setting is exactly **Modern** or **Classic (40.2)**. “Classic” refers to the older scoring behavior retained for this game; it is not a claim to reproduce another manufacturer's console scoring system.
|
||||||
|
|
||||||
|
### Choose a rule and stay with it
|
||||||
|
|
||||||
|
For your regular games, **choose one scoring system and stick with it**. Modern
|
||||||
|
is the default. If you played Quadrapassel in the past and particularly enjoyed
|
||||||
|
the older scoring, Classic (40.2) is available for that familiar experience.
|
||||||
|
Neither choice requires routinely switching back and forth.
|
||||||
|
|
||||||
|
The systems award very different bottom-row bonuses. Regularly swapping between
|
||||||
|
them makes your personal progression harder to judge and can mix incomparable
|
||||||
|
numbers in the same high-score category. Choose the rule you want to compete
|
||||||
|
under, keep using it, and compare records with the same M or C marker. The
|
||||||
|
setting remains available if you deliberately decide to change your preferred
|
||||||
|
system later; it is not a mode to alternate merely to obtain larger numbers.
|
||||||
|
|
||||||
|
### Step 1: count the rows cleared together
|
||||||
|
|
||||||
|
A single lock can clear one, two, three, or four rows. The regular values, before multiplying by level, are:
|
||||||
|
|
||||||
|
| Rows cleared by one lock | Regular value |
|
||||||
|
| --- | --- |
|
||||||
|
| 1 | 40 |
|
||||||
|
| 2 | 100 |
|
||||||
|
| 3 | 300 |
|
||||||
|
| 4 | 1,200 |
|
||||||
|
|
||||||
|
If no row clears, no points are awarded. A four-row clear uses 1,200 as one event; it is not scored as four separate single-row clears.
|
||||||
|
|
||||||
|
### Step 2: decide whether the bottom-row bonus applies
|
||||||
|
|
||||||
|
The bottom row means the lowest visible row of the 20-row board **before the clear and compaction**. It is not simply the lowest row that happened to clear, and it is not the current bottom of the stack if there are holes beneath it.
|
||||||
|
|
||||||
|
If that original bottom row is among the rows removed, add one bonus:
|
||||||
|
|
||||||
|
| Rule | Bonus before multiplying by level |
|
||||||
|
| --- | --- |
|
||||||
|
| **Modern** | 100 × the number of rows cleared in that lock. |
|
||||||
|
| **Classic (40.2)** | 10,000 once for that lock. |
|
||||||
|
|
||||||
|
If the bottom row is not removed, neither system adds a bottom-row bonus. Moving another row down into the bottom position after a clear does not itself earn a bonus. Classic's 10,000 is **once per clear event**, not once for every row in a multi-row clear.
|
||||||
|
|
||||||
|
### Step 3: use the level after adding the cleared lines
|
||||||
|
|
||||||
|
Add the new clear to your total Lines, then calculate the new level. Multiply the regular value plus any bonus by **that resulting level**. A clear that crosses a ten-line boundary is already scored at the higher level.
|
||||||
|
|
||||||
|
The complete formulas are:
|
||||||
|
|
||||||
|
- Modern: **(regular value + bottom bonus of 100 × rows) × resulting level**, when the original bottom row clears.
|
||||||
|
- Classic (40.2): **(regular value + bottom bonus of 10,000) × resulting level**, when the original bottom row clears.
|
||||||
|
- Without a bottom-row clear, either rule: **regular value × resulting level**.
|
||||||
|
|
||||||
|
### Level-one comparison
|
||||||
|
|
||||||
|
| Rows in one clear | No bottom row, either rule | Bottom row, Modern | Bottom row, Classic (40.2) |
|
||||||
|
| --- | --- | --- | --- |
|
||||||
|
| 1 | 40 | 140 | 10,040 |
|
||||||
|
| 2 | 100 | 300 | 10,100 |
|
||||||
|
| 3 | 300 | 600 | 10,300 |
|
||||||
|
| 4 | 1,200 | 1,600 | 11,200 |
|
||||||
|
|
||||||
|
### Worked examples
|
||||||
|
|
||||||
|
**A Modern single at level 1, including the bottom:** regular 40 plus bonus 100 = **140 points**.
|
||||||
|
|
||||||
|
**A Classic single at level 1, including the bottom:** regular 40 plus one bonus 10,000 = **10,040 points**. The unusually large result is intentional.
|
||||||
|
|
||||||
|
**A Modern double at level 3, including the bottom:** (100 + 100 × 2) × 3 = **900 points**.
|
||||||
|
|
||||||
|
**A Classic double at level 3, including the bottom:** (100 + 10,000) × 3 = **30,300 points**. There is only one 10,000 bonus before multiplication.
|
||||||
|
|
||||||
|
**A level transition:** at difficulty 0 with 9 lines already cleared, a single that includes the bottom becomes line 10 and raises the level to 2. Modern awards (40 + 100) × 2 = **280**. Classic awards (40 + 10,000) × 2 = **20,080**.
|
||||||
|
|
||||||
|
**A clear above the bottom:** a single at level 2 that leaves the original bottom row in place is 40 × 2 = **80**, under either rule.
|
||||||
|
|
||||||
|
**Relaxed:** its level remains 1. A bottom-row single is therefore 140 Modern or 10,040 Classic, even after many earlier lines.
|
||||||
|
|
||||||
|
### What does not score
|
||||||
|
|
||||||
|
There are no points merely for sideways movement, rotation, soft drop distance, hard drop distance, placing a piece without a clear, or storing/swapping a piece. This edition adds no combo, spin, back-to-back, or separate all-clear award. Clearing the board can still earn the normal row points and bottom bonus; it simply has no additional “perfect clear” bonus.
|
||||||
|
|
||||||
|
Scores use an unsigned 32-bit total. The maximum displayed/stored score is **4,294,967,295**; further awards stop at that limit rather than wrapping to zero or a negative value.
|
||||||
|
|
||||||
|
## High scores and skill categories
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
The game keeps a **top ten for each starting difficulty and piece-selection mode**. There are 17 difficulty choices—Relaxed plus 0 through 15—and two piece-selection choices, giving **34 separate boards** and at most **340 saved entries**.
|
||||||
|
|
||||||
|
The two selection columns below mean **Normal selection** and **Difficult Pieces**, not Modern and Classic scoring. The word “difficulty” in the browser refers to the starting skill setting; the word “Difficult” beside it refers to the adversarial piece selector.
|
||||||
|
|
||||||
|
| Starting difficulty | Initial level | Prefilled bottom rows | Saved boards |
|
||||||
|
| --- | --- | --- | --- |
|
||||||
|
| Relaxed | 1, stays 1 | 0 | Relaxed Normal; Relaxed Difficult |
|
||||||
|
| 0 | 1 | 0 | 0 Normal; 0 Difficult |
|
||||||
|
| 1 | 2 | 1 | 1 Normal; 1 Difficult |
|
||||||
|
| 2 | 3 | 2 | 2 Normal; 2 Difficult |
|
||||||
|
| 3 | 4 | 3 | 3 Normal; 3 Difficult |
|
||||||
|
| 4 | 5 | 4 | 4 Normal; 4 Difficult |
|
||||||
|
| 5 | 6 | 5 | 5 Normal; 5 Difficult |
|
||||||
|
| 6 | 7 | 6 | 6 Normal; 6 Difficult |
|
||||||
|
| 7 | 8 | 7 | 7 Normal; 7 Difficult |
|
||||||
|
| 8 | 9 | 8 | 8 Normal; 8 Difficult |
|
||||||
|
| 9 | 10 | 9 | 9 Normal; 9 Difficult |
|
||||||
|
| 10 | 11 | 10 | 10 Normal; 10 Difficult |
|
||||||
|
| 11 | 12 | 11 | 11 Normal; 11 Difficult |
|
||||||
|
| 12 | 13 | 12 | 12 Normal; 12 Difficult |
|
||||||
|
| 13 | 14 | 13 | 13 Normal; 13 Difficult |
|
||||||
|
| 14 | 15 | 14 | 14 Normal; 14 Difficult |
|
||||||
|
| 15 | 16 | 15 | 15 Normal; 15 Difficult |
|
||||||
|
|
||||||
|
### Which board receives my game?
|
||||||
|
|
||||||
|
A game begun at difficulty 2 with Difficult Pieces Off belongs to **difficulty 2 / Normal**, even if you reach level 8. Turn Difficult Pieces On for the next game and that game belongs to **difficulty 2 / Difficult**. A Relaxed game belongs to a Relaxed board rather than difficulty 0, although both begin at level 1 on an empty board.
|
||||||
|
|
||||||
|
The game remembers its starting difficulty and piece-selection choice. Changing next-game settings while paused does not move the current result into another category. The browser initially chooses the category appropriate to your configured settings; use `←` / `→` to browse all categories. Categories wrap at the ends. The displayed heading tells you which board you are reading.
|
||||||
|
|
||||||
|
Style, sound, rotation direction, grid, shadow, joystick port, and custom seed do **not** create additional scoreboards. There is no separate board for each seed. If you are comparing repeatable challenges with friends, record those choices yourself alongside the score.
|
||||||
|
|
||||||
|
### Modern and Classic share the category
|
||||||
|
|
||||||
|
**There are not 68 boards.** The scoring rule is stored on each entry, rather than being a third category dimension. An **M** identifies Modern; a **C** identifies Classic (40.2). The browser's footer explains those markers.
|
||||||
|
|
||||||
|
Keeping old scores after changing scoring rules can put M and C entries in the same top ten. Ranking is by the raw numeric score; the game does not normalize or convert one rule into the other. Because Classic's bottom bonus is much larger, a Classic score can outrank a much longer Modern game. Compare entries with the same marker for a meaningful like-for-like comparison.
|
||||||
|
|
||||||
|
The rules stay fixed within a game. Changing the preference does not recalculate existing entries or relabel an in-progress game's final score.
|
||||||
|
|
||||||
|
### Earning and entering a record
|
||||||
|
|
||||||
|
When a game ends, a positive score qualifies if there is space in that category's top ten or it exceeds the existing tenth-place score. Zero scores are not recorded. With a full board, merely equalling tenth place is not enough to replace it. Existing equal scores keep their order, and a new tied score is inserted after the earlier equal entries if there is room.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
The **NEW HIGH SCORE** screen shows your score, three initial fields, **SAVE TO DISK**, and **CANCEL**. Enter three letters with the keyboard, or use the controls to choose them:
|
||||||
|
|
||||||
|
1. `↑` / `↓` selects an initial field or command.
|
||||||
|
2. `←` / `→` cycles the selected letter backward/forward.
|
||||||
|
3. `Enter` or primary fire advances the selected letter when an initial field is selected.
|
||||||
|
4. Move to **SAVE TO DISK** and select it to commit the result.
|
||||||
|
|
||||||
|
Letter entry uses A–Z. Type one letter and let the selected field advance and the screen update before typing the next. After typing, check all three initials before selecting Save. Choose Cancel if you do not want to keep that result; cancellation does not erase earlier records. If a save reports an error, do not assume the new record has reached disk. Correct the media problem and retry when possible, or cancel and continue.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
The saved example is an earned result from the disposable capture session. It is demonstration data, not a record installed on your personal disk or included in the pristine build-05 delivery.
|
||||||
|
|
||||||
|
### Changing scoring rules safely
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Changing **SCORING RULES** opens a separate decision screen:
|
||||||
|
|
||||||
|
| Choice | Consequence |
|
||||||
|
| --- | --- |
|
||||||
|
| **KEEP HIGH SCORES** | Changes the next game's rule and preserves every existing record. A category can then contain both M and C entries. |
|
||||||
|
| **ERASE ALL HIGH SCORES** | Changes the next game's rule and clears the records for **all difficulties and both piece-selection modes**, not just the board you last viewed. |
|
||||||
|
| **CANCEL** | Cancels this scoring-rule change and leaves the records alone. Other Settings changes already made are not undone. |
|
||||||
|
|
||||||
|
Erasing scores is a deliberate database action, not a requirement for changing the scoring preference. If you erase while a game is active, that game can continue, but its result is made ineligible for later high-score saving. Start a new game to compete under the new rule. Back up the disk before using Erase if you might want the old boards again.
|
||||||
|
|
||||||
|
There is no automatic migration from the Linux or Mac scoreboard. Records on a different game disk are also separate unless an explicit, supported migration is performed.
|
||||||
|
|
||||||
|
## Game over and starting again
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
When the spawning area is blocked, the game ends. A qualifying positive score opens the initials screen first. A zero or nonqualifying score goes directly to the **GAME OVER** actions screen. After a successful save, select the score screen’s **BACK** command to return to game-over actions. `BREAK` from the score browser goes directly to the title. Cancelling the initials entry returns to game-over actions.
|
||||||
|
|
||||||
|
Hold and Rotate are unavailable after game over. Resume/Back returns to the title rather than restarting the ended piece. Use New Game and confirm Yes when you want another board. Previously saved records remain unless you explicitly erase them.
|
||||||
|
|
||||||
|
## Saving, backups, and disk messages
|
||||||
|
|
||||||
|
The disk stores settings and all score categories in **QPSAVE0.DAT** and **QPSAVE1.DAT**. The game alternates between these two versioned save files, validates their contents, and can use a valid copy when the other one is damaged. The files work as a pair; do not casually delete one while trying to reorganize the disk.
|
||||||
|
|
||||||
|
The clean delivered disk has no QPSAVE files yet. Missing save files mean default settings and empty boards. Normal explicit saves create the storage. The other supplied files—**QUAD.BIN**, **WORDS.DAT**, and **QPTEXT.DAT**, together with the DOS launcher—are game resources, not interchangeable score files. QPTEXT.DAT contains the screen text; a text error can therefore be a disk/resource problem rather than a corrupt score.
|
||||||
|
|
||||||
|
Saving is not a per-frame activity. Settings are saved through explicit changes/back paths, and a new record is committed when you select Save to Disk. Wait until that operation is finished before resetting, ejecting, powering down, copying, or replacing the image. A complete disk-image backup is the simplest way to retain the pair consistently.
|
||||||
|
|
||||||
|
The following status messages can appear along the bottom of menu screens. They are status footers, not additional menu choices:
|
||||||
|
|
||||||
|
| Message | Meaning and response |
|
||||||
|
| --- | --- |
|
||||||
|
| **RECOVERED PREVIOUS SAVE** | A valid save copy was used after the other copy failed validation. Check whether recent progress is missing, then make a fresh backup after a successful save. |
|
||||||
|
| **BAD SAVE - CHECK DISK** | The available save data did not pass validation. Preserve a copy of the disk and check your backup; do not reformat it as a first response. |
|
||||||
|
| **DISK ERROR - NOT SAVED** | The requested operation did not save successfully. Check that the right writable disk is present and that the media is usable. |
|
||||||
|
| **TEXT ERROR** | A menu-text resource could not be read/validated. Check the game disk and QPTEXT.DAT; retain any personal save files when restoring game resources. |
|
||||||
|
|
||||||
|
A read-only or failing disk can allow play while preventing new settings/records from being saved. An on-screen result is not proof of a successful disk commit. Keep a separate backup, particularly before changing disks or trying a newer build.
|
||||||
|
|
||||||
|
## Troubleshooting and common questions
|
||||||
|
|
||||||
|
### I mounted build 05, but the behavior looks like an older build
|
||||||
|
|
||||||
|
The disk filename identifies the mounted media, not the code already in memory. Return through the normal emulator/BASIC safeguards and actually load the intended disk with DOS. Avoid running an old in-memory game against a newly mounted disk's resources.
|
||||||
|
|
||||||
|
### The joystick will not move left, drifts, or stops working after a menu
|
||||||
|
|
||||||
|
Check that the game's Joystick setting matches the physical CoCo port. Center the stick and use Calibrate Neutral if needed. In an emulator, check the host controller assignment, dead zone, and Fire 1/2 mapping too. Release controls after a screen change. Keyboard menu selection is supported and should not disable the joystick in build 05. Select Joystick Off temporarily to distinguish a controller issue from a keyboard/game issue.
|
||||||
|
|
||||||
|
Build 05 includes the earlier input correction as well as secondary-button hard drop. Its emulator checks use actual standard port/axis/button snapshots. Those checks do not substitute for testing your physical controller and real CoCo.
|
||||||
|
|
||||||
|
### Fire seems to rotate late, or holding it opens a menu
|
||||||
|
|
||||||
|
The primary-button short action happens on **release**, so the game can distinguish it from a long press. A hold of about 400 ms opens Actions. For an immediate hard drop, use secondary fire, joystick Up, or `Space`; do not hold primary fire expecting it to repeat rotations.
|
||||||
|
|
||||||
|
### A piece only has two visible orientations
|
||||||
|
|
||||||
|
I, S, and Z are symmetric in two of their four table states, and O remains square. Test a T, L, or J if you want to see four visibly different turns. A successful primary tap should leave the piece rotated after release; it should not cancel a preceding turn.
|
||||||
|
|
||||||
|
### My score seems unexpectedly large
|
||||||
|
|
||||||
|
Look for **CLASSIC** in the active HUD or a **C** beside the saved entry. Classic adds 10,000 before level multiplication when the bottom row clears. It is intentionally much larger than Modern's bonus. Also check whether the clear crossed a ten-line level boundary.
|
||||||
|
|
||||||
|
### Why did a long run not appear on the board I expected?
|
||||||
|
|
||||||
|
The destination is the game's starting difficulty plus Normal/Difficult Pieces setting, not its finishing level. Browse to that category. A zero/nonqualifying score, a cancelled initials screen, a failed disk save, or a game made ineligible by erasing scores will not create the expected new record.
|
||||||
|
|
||||||
|
### Does changing to Classic require erasing scores?
|
||||||
|
|
||||||
|
No. Choose Keep High Scores to retain them. Their M/C markers remain intact, and ranking uses their unconverted numbers. Erase All High Scores is optional and affects every category.
|
||||||
|
|
||||||
|
### Can I use 512 KB for a sharper edition?
|
||||||
|
|
||||||
|
The current game uses the same 320 × 192, 16-color presentation on its supported CoCo 3 configuration. Extra RAM does not select a separate resolution or font. Modern borders and the readable font are already part of the baseline edition.
|
||||||
|
|
||||||
|
### There is a continuous buzz
|
||||||
|
|
||||||
|
The intended audio consists of brief event effects, with silence between them. There is no continuous soundtrack requirement. Try Sound Off and note whether the noise occurs on the title, during play, or only after an action. Brian reported a normal-emulator buzz that was absent on his real CoCo 3; isolated captured audio has been quiet between effects. That does not establish a fix for every normal-window setup. Preserve the machine/controller/audio configuration when reporting it rather than assuming the game should hum continuously.
|
||||||
|
|
||||||
|
## Screen directory
|
||||||
|
|
||||||
|
| Screen or state | How to reach it | Main purpose |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| Title | Finish loading, or quit an active game to title. | Start, settings, help, scores, credits, program exit. |
|
||||||
|
| Gameplay | Title → Start; Actions → Resume. | Falling piece, board, HUD, Next and Hold. |
|
||||||
|
| Paused / Actions | `P`, `BREAK`, or long primary fire during play. | Pause, Hold, opposite rotation, Settings, New Game, Quit. |
|
||||||
|
| Settings | Title or Actions → Settings. | All immediate and next-game preferences. |
|
||||||
|
| Controls | Title → Controls. | Control reference and sampled axis/button values. |
|
||||||
|
| High Scores | Title → Scores; after a successful score save. | Browse top tens by starting difficulty/selection mode. |
|
||||||
|
| Credits | Title → Credits. | Contributor and component acknowledgements. |
|
||||||
|
| New Game confirmation | Actions → New Game. | Cancel or deliberately replace current play. |
|
||||||
|
| Quit Game confirmation | Actions → Quit. | Cancel or return to title without erasing records. |
|
||||||
|
| Scoring change | Settings → Scoring Rules. | Choose Keep, Erase All, or Cancel. |
|
||||||
|
| Seed editor | Settings → Edit Seed. | Edit eight hexadecimal digits. |
|
||||||
|
| New High Score | End a game with a qualifying positive result. | Enter initials and explicitly save/cancel. |
|
||||||
|
| Game Over actions | End without a qualifying result, or finish the record flow. | Start again or return to title; ended-piece actions unavailable. |
|
||||||
|
|
||||||
|
## Copyright, license, and credits
|
||||||
|
|
||||||
|
**Manual: © Brian K. Holman 2026.** This Markdown manual and its authored documentation material are provided under **GNU GPL version 3 or later**, alongside the CoCo project. Third-party notices remain in force for their respective contributions. The real screenshots show the independently written CoCo game; reference images from the Mac application are not used as emulator evidence.
|
||||||
|
|
||||||
|
The CoCo title screen retains its in-game notice, **(c) 2026 Brian Holman**. The manual's author/copyright wording above is intentionally its own notice.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
The game acknowledges GNOME Quadrapassel and the contributors **J. Marcin Gorycki, Lubomir Rintel, Robert Ancell, John Ward, and Will Warner**, together with **Brian Holman — Mac & CoCo**. The difficult-piece algorithm is inspired by **Federico Poloni's Bastet**. Those credits recognize the behavioral lineage; they do not mean Linux/Mac application code is incorporated into this CoCo implementation.
|
||||||
|
|
||||||
|
**Pierre Sarrazin** is credited for the font, CMOC, and supporting libraries. The menu/HUD font uses an unchanged subset of his public-domain CardGame font, also used by Color8; its original notice and source files are retained in the project. Standard CMOC/CardGame/bsound/decbfile APIs and the supplied DOS-loader template have their own component notices. The project preserves these rather than labelling every component with one blanket license. No third-party sound recordings, Mac binaries, private ROMs, or emulator source are part of this manual.
|
||||||
|
|
||||||
|
The game's GPL license permits redistribution and modification under its stated terms and provides the full warranty disclaimer. Keep the license and relevant notices with source distributions. See the project's **COPYING** file for the complete license and the [GNU GPL version 3 text](https://www.gnu.org/licenses/gpl-3.0.html) for an online copy. This manual is a user guide, not a replacement for that license text.
|
||||||
|
|
||||||
|
### Edition and screenshot record
|
||||||
|
|
||||||
|
This edition documents **game disk build 05**. All 17 screenshots are unmodified
|
||||||
|
captures of that CoCo program in VCC Plus 3.6.1 (54), MC6809 / 512 KB. The
|
||||||
|
project’s screenshot manifest retains the source, disk, capture, and image
|
||||||
|
identities. Changed preferences and the earned AAA / 40-point demonstration
|
||||||
|
record belong only to the disposable capture disk; personal records were left
|
||||||
|
alone. These captures do not qualify CoCo 2, actual 128 KB operation, or every
|
||||||
|
physical-controller setup.
|
||||||
@@ -0,0 +1,42 @@
|
|||||||
|
# Quadrapassel player manual source
|
||||||
|
|
||||||
|
`QUADRAPASSEL.md` is the plain GFM source for the online and PDF player guide.
|
||||||
|
`manual.json` supplies its shared cover/hero metadata. `images/` contains 17
|
||||||
|
unchanged guest-framebuffer PNGs; `screenshots.json` records their hashes,
|
||||||
|
configuration and public capture receipts. No Mac/reference screenshots or
|
||||||
|
retouched game states are used. The earned example is AAA / 40 / Modern,
|
||||||
|
difficulty 0 / Normal, on an independently retained disposable disk.
|
||||||
|
|
||||||
|
The manual is © Brian K. Holman 2026, GNU GPL-3.0-or-later. Preserve the exact
|
||||||
|
spaced copyright wording in the manuscript/metadata and component acknowledgements.
|
||||||
|
The game source remains the independent, specification-based CoCo implementation;
|
||||||
|
see ../PROVENANCE.md for its behavioral references and GPL-derived data.
|
||||||
|
|
||||||
|
## Generate and review the PDF
|
||||||
|
|
||||||
|
Use the shared VCCPlus process, not a project-specific PDF generator. From the
|
||||||
|
VCCPlus checkout, substitute the actual selected paths:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
python3 tools/documentation/export_pdf.py prepare /path/to/Quadrapassel/docs/manual/QUADRAPASSEL.md \
|
||||||
|
--metadata /path/to/Quadrapassel/docs/manual/manual.json --toc \
|
||||||
|
--destination /path/to/Quadrapassel/test-output/manual/Quadrapassel-for-CoCo-Manual.pdf
|
||||||
|
```
|
||||||
|
|
||||||
|
Inspect every page PNG in the printed review directory, then use the shared
|
||||||
|
tool's `publish REVIEW_DIRECTORY --reviewed` command. Source, metadata, image
|
||||||
|
and template changes invalidate that review. Generated PDFs/review images stay
|
||||||
|
under ignored output folders. The source Markdown remains authoritative.
|
||||||
|
|
||||||
|
## Import and publish the online edition
|
||||||
|
|
||||||
|
VCCPlusWebsite owns the shared online layout and its authorized static publisher.
|
||||||
|
Use its `scripts/import-project-manual.py` with this selected Markdown/metadata,
|
||||||
|
slug `quadrapassel`, and the fully reviewed final PDF. The imported snapshot
|
||||||
|
makes the website independent of this checkout. Review desktop/narrow layouts,
|
||||||
|
run the website checks and use its existing publish/dry-run/verification flow.
|
||||||
|
No game disk, app binary, update feed, native settings or personal score file
|
||||||
|
is published or modified by these documentation operations.
|
||||||
|
|
||||||
|
Current route: https://vccplus.brianholman.com/games/quadrapassel/ .
|
||||||
|
The game build remains 05; documentation alone does not create build 06.
|
||||||
|
After Width: | Height: | Size: 5.3 KiB |
|
After Width: | Height: | Size: 5.6 KiB |
|
After Width: | Height: | Size: 3.9 KiB |
|
After Width: | Height: | Size: 3.5 KiB |
|
After Width: | Height: | Size: 3.9 KiB |
|
After Width: | Height: | Size: 4.0 KiB |
|
After Width: | Height: | Size: 2.9 KiB |
|
After Width: | Height: | Size: 3.8 KiB |
|
After Width: | Height: | Size: 2.8 KiB |
|
After Width: | Height: | Size: 4.0 KiB |
|
After Width: | Height: | Size: 4.1 KiB |
|
After Width: | Height: | Size: 4.0 KiB |
|
After Width: | Height: | Size: 3.2 KiB |
|
After Width: | Height: | Size: 6.8 KiB |
|
After Width: | Height: | Size: 3.9 KiB |
|
After Width: | Height: | Size: 3.8 KiB |
|
After Width: | Height: | Size: 4.7 KiB |
@@ -0,0 +1,11 @@
|
|||||||
|
{
|
||||||
|
"title": "Quadrapassel for CoCo",
|
||||||
|
"subtitle": "A complete player’s manual: every screen, keyboard and joystick controls, Modern and Classic scoring, and high scores for every skill level.",
|
||||||
|
"author": "Brian K. Holman",
|
||||||
|
"copyright": "© Brian K. Holman 2026",
|
||||||
|
"edition": "Player’s manual · Game build 05 · November 2026",
|
||||||
|
"hero_image": "images/title.png",
|
||||||
|
"hero_caption": "Real CoCo title screen captured in VCC Plus 3.6.1 (54). Game disk build 05.",
|
||||||
|
"running_title": "Quadrapassel for CoCo · Player’s manual",
|
||||||
|
"brand": "VCC Plus Documentation"
|
||||||
|
}
|
||||||
@@ -0,0 +1,215 @@
|
|||||||
|
{
|
||||||
|
"schemaVersion": 1,
|
||||||
|
"gameSourceRevision": "49bc78158a5e17ba717381a3a2cbb4ab35c36dfe",
|
||||||
|
"gameBuild": "05",
|
||||||
|
"artifactDiskSha256": "d05ab25fd90171b048cce54f3af18ca6d0bd81335e138044ff05315e99cbf582",
|
||||||
|
"emulator": "VCC Plus 3.6.1 (54)",
|
||||||
|
"processor": "MC6809",
|
||||||
|
"ramKB": 512,
|
||||||
|
"projectId": "7CF32CE1-C5ED-4741-8EC9-604C11A252EC",
|
||||||
|
"revision": 0,
|
||||||
|
"buildId": "C207A7D8-EAAD-4A92-871C-13B9F4F1746D",
|
||||||
|
"artifactId": "3F9F15A7-EBBF-4924-8E9F-AD042273F03A",
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"captureDate": "2026-11-11",
|
||||||
|
"retainedTestDiskSha256": "7a835b802c59bdfd3d56397afc6d7a416fdaa9aec3047cf9daba8b85149f2ba9",
|
||||||
|
"retainedTestDiskId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"demoScore": {
|
||||||
|
"initials": "AAA",
|
||||||
|
"score": 40,
|
||||||
|
"lines": 1,
|
||||||
|
"rule": "Modern",
|
||||||
|
"startingDifficulty": 0,
|
||||||
|
"difficultPieces": false,
|
||||||
|
"method": "Nine ordinary keyboard placements from custom seed zero, then normal play to game over and explicit Save to Disk."
|
||||||
|
},
|
||||||
|
"images": [
|
||||||
|
{
|
||||||
|
"file": "images/title.png",
|
||||||
|
"sha256": "a41329d2ce491a782b0d050be63b874869443b5b8dcc69f7966841bf548a9374",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "title",
|
||||||
|
"fieldClock": 3360,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/gameplay.png",
|
||||||
|
"sha256": "dd6c5b0e02e3a7c995056a436a4379ab617c7a0c60ddf246ad5ac9163e5239b8",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "gameplay",
|
||||||
|
"fieldClock": 38400,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/hold-shadow.png",
|
||||||
|
"sha256": "2d0e621b91d2263b90f3c0189ecbbfbd0ade1177c27edca14d63f3902abc30f1",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "hold-shadow",
|
||||||
|
"fieldClock": 96804,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/controls.png",
|
||||||
|
"sha256": "76a4cad28b3051c8d1fda32fa9f4423a36d3496ded3564365a60a3f47f4ad918",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "controls",
|
||||||
|
"fieldClock": 14628,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/paused.png",
|
||||||
|
"sha256": "82ee8a1fee185d4ecd607298f4f22e5e966adb60ce42273fb0321e2b2f455bdf",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "paused",
|
||||||
|
"fieldClock": 98652,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/new-game-confirmation.png",
|
||||||
|
"sha256": "54f6023c13715753b3771e30d8a5b0b4c3ec49ad8be660c5999e5e6a14203fe1",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "new-game-confirmation",
|
||||||
|
"fieldClock": 49248,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/settings.png",
|
||||||
|
"sha256": "ab35306daa59a7e3660472f7762254312b4f7d7261861685ef17f0f2d5f756d1",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "settings",
|
||||||
|
"fieldClock": 4578,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/seed-editor.png",
|
||||||
|
"sha256": "2bd4f361181f0e62949cbbed2e1d231031213489263644f412ee5e8505a1d71f",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "seed-editor",
|
||||||
|
"fieldClock": 34356,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/scores-empty.png",
|
||||||
|
"sha256": "29448f1d99048792baac0d1256091753991f3d11eea122a61222a8daa262cfaf",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "scores-empty",
|
||||||
|
"fieldClock": 20748,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/scores-saved.png",
|
||||||
|
"sha256": "d8f51408a3c9fa525f7360783ac18ad9350cbaa094c90ec46a4f2562109065fe",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "scores-saved",
|
||||||
|
"fieldClock": 86808,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/scoring-change.png",
|
||||||
|
"sha256": "5c6bf427711dd142e61cc041e2682624e57b61b17953ddd38cf788e2dbd696ad",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "scoring-change",
|
||||||
|
"fieldClock": 5796,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/credits.png",
|
||||||
|
"sha256": "0aca83d7e85e88fe62affb34d2d6c87d110c06ddd1caf4b77c4533dbfc25a912",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "credits",
|
||||||
|
"fieldClock": 24636,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/style-clean.png",
|
||||||
|
"sha256": "fc4cfacb4c6f2b2ceb86ed74026030afe95d670c69769268c6ab448eb459c868",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "style-clean",
|
||||||
|
"fieldClock": 108720,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/style-plain.png",
|
||||||
|
"sha256": "f6d91b7c66056653dd9fd6eab862d0b1a34e21d985dfc100ef1cad6172814179",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "style-plain",
|
||||||
|
"fieldClock": 116700,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/quit-confirmation.png",
|
||||||
|
"sha256": "97f644bb89d6a6f25b38bcce514d6fb5eb62eb32c273cf7c758b863c44bc27cb",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "quit-live",
|
||||||
|
"fieldClock": 100740,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/initials.png",
|
||||||
|
"sha256": "ba28c6e370f5a44ff59ec32b70a1e52b698c7c05378859b60266d688fb9c800c",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "initials-ready",
|
||||||
|
"fieldClock": 84816,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"file": "images/game-over.png",
|
||||||
|
"sha256": "54046fb4cf670359d079074bf410f8d1dd7a28de19e4d5a01de39f1385bcec75",
|
||||||
|
"width": 320,
|
||||||
|
"height": 192,
|
||||||
|
"capture": "capture_playtest_graphics",
|
||||||
|
"captureLabel": "cancel-new",
|
||||||
|
"fieldClock": 51096,
|
||||||
|
"runId": "CF90649A-31D1-4F7F-9F6E-B23A426DC9B1",
|
||||||
|
"note": "Unmodified guest framebuffer PNG; captured from normal user controls in a disposable run."
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||