FujiNet BATTLESHIP! - BASIC 10Liner Contest 2025
====================================

Author:   Eric Carr
Language: FastBasic 4.7
Platform: Atari 8-bit XL/XE
Category: EXTREM-256

Video: https://youtu.be/wS-gzZTV-04

Requirements:
  - 2 Atari 8-bit XL/XE computers with Joysticks
  - A FujiNet attached to each computer

Emulator: 
  - Altirra + FujiNet-PC running on a computer


About FujiNet Battleship
========================
Battleship is fun, tactical guessing game, but it is difficult for two people to play each other on the same screen.

So, I am submitting a game designed to be played on two Ataris connected to the same local Wifi network via FujiNet.

In the real world, a game client would connect to an internet server, but I wanted to keep this 10-liner completely self contained, so it acts as both host and client.

Enjoy, and may the best captain win!

Starting the game
=================
1. Start the game by booting BSHIP.ATR or BSHIP.XEX
2. As a convenience, you can also boot FujiNet config and mount: ec.tnfs.io/10-LINER/BSHIP.XEX

Emulator note - as this game technically needs TWO Atari+FujiNet systems, one can setup their computer to emulate two Altirra+FujiNet-PC instances by following this guide:
https://github.com/FujiNetWIFI/fujinet-firmware/wiki/Run-FujiNet-with-Altirra-for-Atari


Connecting two systems
======================

Assuming the game is running on two systems:

1. System 1 -> Simply press RETURN. The game will listen on port 8888 on the displayed IP, waiting for a connection.
2. System 2 -> Type the IP displayed on system 1, and press RETURN. It will join and start a new game.


Gameplay
========
1. Ship Setup - Each player uses their joystick to position their ships, pressing fire to accept the position. They may press space to rotate as desired. 
2. Game Loop - Players alternate turns of choosing a location to attack with joystick/fire button.
3. Winning - The first player to first sink their opposing player's 5 ships wins!


Tools Used
==========

- FujiNet Device & FujiNet-PC Build of firmware w/ Python connector
  https://fujinet.online/

- FastBasic 4.7 Cross Compiler - Compile BASIC to XEX
  https://github.com/dmsc/fastbasic/releases/tag/v4.7

- Visual Studio Code - Editing the .BAS file
  https://code.visualstudio.com/download

- FastBasic Debugger for VSCode Extension (I wrote it to help debug FastBasic)
  https://marketplace.visualstudio.com/items?itemName=EricCarr.fastbasic-debugger

- Atari FontMaker - Defining chars as block sprites
  http://matosimi.websupport.sk/atari/atari-fontmaker/

- Altirra
  https://www.virtualdub.org/altirra.html