Files
Quadrapassel/docs/manual/QUADRAPASSEL.md
T

43 KiB
Raw Blame History

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.

How to use this manual

For a first game, follow Starting the game, then Reading the play screen. Keep Keyboard controls or Joystick controls nearby. Read Modern and Classic scoring before comparing records, and 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:

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 real title screen, with Start, Settings, Controls, Scores, Credits, and Quit

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

Gameplay showing the complete board, score, level, lines, next piece, and scoring mode

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.

Gameplay with a reserved piece and the landing shadow enabled

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

Controls screen with keyboard help and right/left joystick readings

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

Paused actions menu with Resume, Hold, Rotate Other Way, Settings, New Game, Quit, and Back

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.

New Game confirmation, with Cancel selected by default

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 confirmation, with Cancel selected by default

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

Settings showing all fourteen options and the immediate/next-game reminders

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.

Clean style with light piece edging, Hold, and landing shadow

Plain style with flat pieces; the reserved piece and shadow remain available

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.

Eight-digit hexadecimal seed editor with the current digit marked

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

High-score browser for difficulty 0, Normal selection, initially empty

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.

New High Score screen with three initials and Save to Disk

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.

A real earned high score saved in its category, with its scoring-rule marker

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

Scoring change offers Keep High Scores, Erase All High Scores, or Cancel

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

Game Over actions screen with unavailable Hold and Rotate commands

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.

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 CoCo Credits screen preserving original and component acknowledgements

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 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.