================================================================================
C.E.T.A.S. - v0.9.2 BETA
An underwater shooter for the MAD-65
Release date: 2026-08-21
visit: https://mad65.codepainters.com/software/cetas.html
================================================================================

ABOUT THIS RELEASE

CETAS is a complete game. Everything that was planned is in it: 6 levels with
6 bosses, the full enemy roster, all weapons and pickups, five music tracks,
a level-by-level story, a hall of fame and two ways to finish the game.

This is a BETA release. It is meant for testing and feedback: balance, timing
and presentation may still be adjusted before 1.0. It is not a demo and nothing
has been cut - the whole game is here and can be played through to the end.


AUTHORS

  Rafal Dudek       - concept and graphics
  Mateusz Matysiak  - game design, mechanics and code
  Maro Szczerski    - music


PACKAGE CONTENTS

  madsim.exe        MAD-65 simulator v1.0.1 - the machine CETAS runs on
  roms\cpu_os.bin   MAD-65 firmware (CPU)
  roms\gpu_os.bin   MAD-65 firmware (GPU)
  roms\cart.bin     CETAS cartridge image - the game itself
  README.txt        this file


RUNNING THE GAME

  Windows. No installation. Unpack the archive and run madsim.exe.

  Run it from the folder it was unpacked into: it looks for the roms\ folder
  next to itself and loads the firmware and the cartridge automatically.
  The simulation runs at the true MAD-65 frame rate (60.317 Hz), independent of
  your monitor's refresh rate. Set monitor refresh rate to 60Hz for best results.


CONTROLS

  Either joystick port can play. The pad that presses FIRE on the title screen
  owns the game until it ends.

  Joystick 1:  Arrow keys      move
               Right Ctrl      FIRE      - shoot, or hold to charge LFAS
               Right Shift     2ND FIRE  - switch weapon

  Joystick 2:  W A S D         move
               Left Shift      FIRE      - shoot, or hold to charge LFAS
               Left Ctrl       2ND FIRE  - switch weapon

  Title screen        FIRE starts the game.
  In game             FIRE shoots. HOLD FIRE to charge the LFAS sonar burst
                      (when you carry it) - the whale locks in place and shakes
                      while charging; release to cancel.
                      2ND FIRE cycles the armed weapon (front gun / laser /
                      side guns) among the ones you own.
  Game over           2ND FIRE within 10 seconds continues from the same level
                      (your score restarts). Let the countdown run out to end
                      the run and submit your score to the hall of fame.
  Hall of fame        Up/Right and Down/Left pick a letter, FIRE confirms it,
                      2ND FIRE steps back.


GAMEPLAY NOTES

  - You start with 3 lives and 100 HP. One extra life every 10,000 points.
  - Weapons and pickups: LFAS sonar (charged special), laser and side guns
    (limited ammo, armed with 2ND FIRE), medkit, shield (30 s, cuts damage by
    75%), energy boost (30 s of higher speed and faster shots), extra life.
  - Some waves are announced on the bottom line - destroy every enemy in such
    a wave for a bonus.
  - Rocks are solid: hitting terrain hurts.


MADSIM KEYS

  Esc          quit
  Space / P    pause / resume
  F5           reset (restarts the machine)
  F8           cycle the display filter:
               plain -> B/W CRT -> green phosphor -> amber -> blue phosphor
  F11          borderless fullscreen
  F12          rotate the screen 90 degrees clockwise
  M            mute / unmute audio
  -  and  =    music/SFX mixer knob: '-' turns toward music, '=' toward sound
               effects, centre is an equal mix
  F3           toggle the CPU/GPU utilisation meter (developer info)
  F2           dump machine state to the dumps\ folder (developer info)


GAMEPADS

  New in this package. Plug in a USB gamepad and play - no configuration and
  no flags. The first pad connected drives joystick port 1, a second one
  port 2; unplug it and that port falls back to the keyboard. Both work at
  once, and you can plug a pad in while the game is running.

    D-pad and left analogue stick        move
    A/Cross or Y/Triangle                FIRE     - shoot / charge LFAS
    X/Square or B/Circle                 2ND FIRE - switch weapon

  Each fire line answers to both buttons of its pair, so it does not matter
  which one your thumb finds. The right stick is ignored.

  A PS1/PS2-to-USB adapter must be in ANALOGUE mode - press the pad ANALOG
  button, LED on. In digital mode the pad reports its right stick as the face
  buttons, so the right stick appears to fire.


KNOWN LIMITATIONS AND PLANNED CHANGES

  - Audio needs a working output device; use M or --audio off if it causes
    trouble.
  - Balance and level pacing are still under review - this is what the beta is
    for. Feedback welcome.


RELEASE NOTES

  v0.9.2 beta - 2026-08-21
    - Torpedo turrets tweak and new enemy jellyfish introduced.
    - Fixes the torpedo turret misalignment reported against the
      2026-08-19 build.

  v0.9.1 beta - repackaged 2026-08-19
    - Bundled madsim updated to v1.0.1, which adds USB GAMEPAD SUPPORT, F11
      borderless fullscreen and F12 screen rotation.
    - The game itself is unchanged from the 2026-08-16 build - same version,
      same cartridge.

  v0.9.1 beta - 2026-08-16
    - minor bugfixes, logo tuning.
  v0.9.0 beta - 2026-08-15
    - First public beta release.
    - Feature-complete: 6 levels, 6 bosses (the final one a two-part fight),
      full enemy roster, all weapons and pickups.
    - Five music tracks (title, gameplay, boss, level summary, game over) and
      the full sound-effect set.
    - Attract cycle: title, enemy gallery, weapon rundown, hall of fame.
    - Story text between levels, level summary screen, continue system and
      session hall of fame with initials sign-up.
    - Bundled with madsim including CRT display filters and the music/SFX
      mixer knob.

================================================================================
