binary-knight/usurper-reborn v0.6

Alpha v0.6 BBS Door Compatability

on GitHub

Usurper Reloaded Alpha v0.6 release notes

Major Feature: BBS Door Mode Support

Usurper Reborn can now run as a traditional BBS door game! This release brings full compatibility with modern BBS software like Synchronet and Mystic, allowing sysops to offer the game to their users over telnet/SSH.

BBS Features

• DOOR32.SYS Support - Modern 11-line drop file format with socket handle for direct telnet I/O
• DOOR.SYS Support - Legacy 52-line format for older BBS systems (uses console I/O)
• Socket-Based I/O - Direct communication via inherited socket handles from BBS software
• Automatic Fallback - Falls back to console I/O when socket communication fails
• Multi-Node Support - Each BBS node gets isolated session handling via drop file
• BBS-Isolated Saves - Player saves stored in per-BBS subdirectories to prevent conflicts
• Character Name Locking - In door mode, character names match BBS usernames for consistency

Command Line Options

UsurperRemake --door <dropfile>    # Auto-detect DOOR32.SYS or DOOR.SYS
UsurperRemake --door32 <path>      # Explicitly use DOOR32.SYS format
UsurperRemake --doorsys <path>     # Explicitly use DOOR.SYS format
UsurperRemake --node <directory>   # Search directory for drop files
UsurperRemake --local              # Local testing mode (no BBS)

Sysop Setup

A comprehensive setup guide is included at DOCS/BBS_DOOR_SETUP.md with instructions for:

• Synchronet BBS configuration
• Mystic BBS configuration
• Example drop files for testing
• Troubleshooting common issues
• Platform-specific notes for Windows, Linux, and macOS

New Build Targets

• Linux ARM64 - Added support for Raspberry Pi and ARM servers
• CI/CD now builds for 5 platforms:
  • Windows x64
  • Windows x86
  • Linux x64
  • Linux ARM64
  • macOS x64

New Files

• Scripts/BBS/DoorMode.cs - Entry point and command line parsing
• Scripts/BBS/DropFileParser.cs - DOOR32.SYS and DOOR.SYS parsing
• Scripts/BBS/SocketTerminal.cs - Socket-based terminal I/O
• Scripts/BBS/BBSTerminalAdapter.cs - Terminal adapter for door mode
• DOCS/BBS_DOOR_SETUP.md - Comprehensive sysop setup guide
• DOCS/examples/door32.sys - Example DOOR32.SYS for testing
• DOCS/examples/door.sys - Example DOOR.SYS for testing

Technical Details

• Save files are now namespaced by BBS name (e.g., saves/Synchronet_BBS/)
• Socket handles are inherited from BBS using .NET's SafeSocketHandle
• ANSI color codes are translated for telnet clients
• Telnet IAC negotiation is handled for proper terminal communication
• Graceful exit handling prevents "emergency save" warnings in door mode

Upgrade Notes

• Single-player mode is unaffected by these changes
• Save files from v0.5 are fully compatible
• BBS mode requires the BBS software to generate appropriate drop files

Testing

Tested with:

• Synchronet BBS on Windows (socket I/O mode)
• Local testing mode on Windows and Linux