TicTacToe Project

This project contains a TCP Game Server, a Java Swing Client, and a Spring Boot Web Client.

Structure

server/: Java TCP Server (Port 1870). Includes Anticheat logic (validates turns, moves, wins).
client/: Standalone Java Swing Client. Defaults to dokploy.lona-development.org:1870 but allows custom host/port.
web-client/: Spring Boot Web Application. Acts as a proxy to the TCP Server via WebSocket.

Running with Docker Compose

To start the Server and Web Client:

docker-compose up --build

Server runs on port 1870 (exposed).
Web Client runs on http://localhost:8080.

Building and Running the Standalone Java Client

Go to the client directory and run the build script:

cd client
chmod +x build.sh
./build.sh

Usage

By default, the client attempts to connect to dokploy.lona-development.org:1870.

java -jar target/client-1.0-SNAPSHOT.jar

Custom Host/Port (Local Testing): If you want to connect to a local server (e.g., running via Docker Compose), pass the host and port as arguments:

java -jar target/client-1.0-SNAPSHOT.jar localhost 1870

Game Protocol (TCP 1870)

The server creates game sessions identified by a unique 6-character code.

CREATE: Starts a new game. Server returns GAME_CREATED <CODE>.
JOIN <CODE>: Joins an existing game. Server returns JOIN_SUCCESS or ERROR.
MOVE <ROW> <COL>: Places your symbol (0-2). Validated by server.
SURRENDER: Forfeits the game immediately.
LEAVE: Leaves the current lobby. If empty, the lobby acts as closed.
RESTART: Resets the board for the current lobby so players can play again.

Server Messages:

WIN <SYMBOL> or DRAW
OPPONENT_LEFT: Sent when the other player leaves via the LEAVE command.
RESTART: Sent when the game is restarted.

Troubleshooting

Server Connection Refused? Ensure the server container is running and port 1870 is mapped.
Client stuck connecting? Verify the hostname is reachable. Use localhost if running locally.

2.1 KiB Raw Blame History