====================================================================
                         C A R N I V A L
                    SEASONS 1-2-3 RELEASE
====================================================================

A BBS Door Game by Alexander Corris
alexcorris@outlook.com    BlueSky - @bbswordle.com

WELCOME TO THE MIDWAY
--------------------------------------------------------------------
This package contains all three CARNIVAL seasons plus the CARNCFG
configuration utility for DOS, 32-bit Windows, 64-bit Windows,
Linux x86-64, and 64-bit Raspberry Pi / Linux ARM64.

The platform folders are DISTRIBUTION folders.  For installation,
copy the root config/documentation files and the contents of ONE
platform folder into a single Carnival door directory.

QUICK INSTALL
--------------------------------------------------------------------
1. Create a directory for Carnival on your BBS, for example:

      /bbs/doors/carnival

2. Copy these files from the ZIP root into that directory:

      carn.cfg        Season One configuration
      carn2.cfg       Season Two configuration
      carn3.cfg       Season Three configuration
      carnival.doc    complete trilogy/sysop manual
      README.txt      package/install guide
      FILE_ID.DIZ     BBS archive description (optional at runtime)

3. Open the folder matching your operating system and copy ALL FOUR
   files from it into the SAME Carnival directory:

      MSDOS   - DOS / DJGPP go32v2
      Win32   - 32-bit Windows (x86)
      Win64   - 64-bit Windows (x86-64)
      Linux   - 64-bit Linux (x86-64)
      Pi      - 64-bit Linux ARM64 / aarch64 (Raspberry Pi 4/5 etc.)

   Each platform folder contains:

      carnival[.exe]   Season One
      carnval2[.exe]   Season Two: After Hours
      carnval3[.exe]   Season Three: The Island
      carncfg[.exe]    configuration menu for all three seasons

4. Run CARNCFG from the Carnival directory.  Set the BBS name and
   any ticket/music options you want, then choose [S] to save.

5. Add carnival, carnval2, and/or carnval3 to your BBS door menu.
   All three seasons can live together in this same directory.

PACKAGE LAYOUT
--------------------------------------------------------------------
README.txt
FILE_ID.DIZ
carnival.doc
carn.cfg
carn2.cfg
carn3.cfg

MSDOS/
    carnival.exe
    carnval2.exe
    carnval3.exe
    carncfg.exe

Win32/
    carnival.exe
    carnval2.exe
    carnval3.exe
    carncfg.exe

Win64/
    carnival.exe
    carnval2.exe
    carnval3.exe
    carncfg.exe

Linux/
    carnival
    carnval2
    carnval3
    carncfg

Pi/
    carnival
    carnval2
    carnval3
    carncfg

BUILD AVAILABILITY
--------------------------------------------------------------------
                    Season 1   Season 2   Season 3   CARNCFG
    MSDOS              YES       YES        YES        YES
    Win32              YES       YES        YES        YES
    Win64              YES       YES        YES        YES
    Linux x86-64       YES       YES        YES        YES
    Pi ARM64           YES       YES        YES        YES

All 20 platform binaries in this package were checked for architecture:
DOS builds are DJGPP/go32v2 executables; Win32 builds are PE32 x86;
Win64 builds are PE32+ x86-64; Linux builds are ELF x86-64; and Pi
builds are ELF aarch64.

CARNCFG
--------------------------------------------------------------------
CARNCFG edits carn.cfg, carn2.cfg, and carn3.cfg from one menu.
Run it from the directory containing those files:

    carncfg

or on Windows/DOS:

    carncfg.exe

The main menu shows the current BBSNAME, TICKETS, and MUSIC values.
Use [B] to set the BBS name for all seasons, [1]-[3] to edit an
individual season, and [S] to write your changes.  CARNCFG preserves
comments/unknown keys and creates .bak backups when rewriting configs.

Do not save configuration changes while a caller is inside a season;
the games read their config when they start.

DOOR COMMAND LINE
--------------------------------------------------------------------
All three seasons accept the same connection options:

    -Dpath      read DOOR32.SYS, DOOR.SYS, or DORINFO*.DEF
    -Shandle    use a raw socket handle
    -Nn         node number
    (no args)   local console mode

Example, Mystic on Linux:

    carnival -D%path_to_node_dir%/door32.sys

Use carnval2 or carnval3 in place of carnival for later seasons.

LINUX / PI NOTE
--------------------------------------------------------------------
The Linux and Pi executables in this ZIP are marked executable.  If
permissions are lost during transfer or extraction, restore them with:

    chmod +x carnival carnval2 carnval3 carncfg

CONFIG FILES
--------------------------------------------------------------------
carn.cfg, carn2.cfg, and carn3.cfg ship with a placeholder BBS name.
CARNCFG is the easiest way to configure them.  The games also have
sensible defaults for optional settings.

MORE INFORMATION
--------------------------------------------------------------------
See carnival.doc for Season One gameplay, detailed configuration,
ANSI music notes, troubleshooting, credits, and version history.

Season versions represented by the supplied binaries:
    Season One ................. 2026.8.6.2
    Season Two: After Hours .... 2026.8.15.1
    Season Three: The Island ... 2026.9.4.4
    CARNCFG .................... 2026.9.5

Step right up - and thanks for keeping the doors alive!
====================================================================
