Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/octcarp/sustech-cs209a-linkgame

(JavaFX 23 + Java socket) A Linking Game (a.k.a. '连连看') with simple online multiplayer functionality. SUSTech CS209A 2024 Fall Assignment 2.
https://github.com/octcarp/sustech-cs209a-linkgame

cs209a javafx socket-programming sustech

Last synced: 13 days ago
JSON representation

(JavaFX 23 + Java socket) A Linking Game (a.k.a. '连连看') with simple online multiplayer functionality. SUSTech CS209A 2024 Fall Assignment 2.

Host: GitHub
URL: https://github.com/octcarp/sustech-cs209a-linkgame
Owner: OctCarp
License: mit
Created: 2024-10-28T10:59:18.000Z (4 months ago)
Default Branch: main
Last Pushed: 2024-11-28T11:02:38.000Z (3 months ago)
Last Synced: 2024-11-28T12:19:07.806Z (3 months ago)
Topics: cs209a, javafx, socket-programming, sustech
Language: Kotlin
Homepage:
Size: 4.66 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # SUSTech-CS209A-Linking-Game

(JavaFX 23 + Java socket) A Linking Game (a.k.a. '连连看') with simple online multiplayer functionality.

SUSTech CS209A 2024 Fall Assignment 2.

### Versions

- Main branch ( `main` ): Kotlin implementation version

- [Java implementation version](https://github.com/OctCarp/SUSTech-CS209A-LinkGame/tree/java-backup) ( `java-backup` branch), you can check this for Java native implementation.

For documentation, it is recommended to first refer to the `main` branch, as the documentation for the backup branch is no longer being updated, and there may be some minor errors in it.

### About

A toy game. I wrote it in a short time span, and by the end the project structure was a little messy. 

There may be some minor bugs that have not been addressed. 

After completing the Java version, I refactored the project into Kotlin with the help of JetBrains Intellij IDEA and LLM, exploring Kotlin's syntactic sugar.

Kotlin version may have more bugs (due to rewrites) or fewer bugs (as some issues from the Java version were addressed during refactoring).

It is not a native Kotlin project, and does not use features such as `coroutines`.

### Documentation

- [requirement.pdf](docs/requirement.pdf)

- [grading_criteria.xlsx](docs/grading_criteria.xlsx) or [grading_criteria_CHS.xlsx](docs/grading_criteria_CHS.xlsx)

I completed both the basic and bonus features.

### Modules

- [game-common](game-common/): Shared model components used by both the client and the server.

    - `model` : Different models for C/S transmission through `ObjectI/OStream` .

    - `packet` : General `Request` / `Response` model.

- [game-client](game-client/): JavaFX game client application.

    - `controller` : Controllers for JavaFX `.fxml` files.

    - `net` : Singletons for managing various types of client-side data.

- [game-server](game-server/): Java socket game server.

    - `net` : Singletons for managing different kinds of data for all clients.

### Login / Register

![login](docs/img/login.png)

There are 3 pre-define users:

- "1" , "1"

- "2" , "2"

- "2" , "2"

### Main Menu

![main_menu](docs/img/main_menu.png)

### Start Matching (Lobby)

![lobby](docs/img/lobby.png)

### Choose Size

A random player to choose size.

![select_board](docs/img/select_board.png)

### Link!

Lines key frame animation for both players.

You can shuffle for a new shape of grids.

![link](docs/img/link.png)

### Game Result

![end](docs/img/end.png)

### Match Record

No beautification.

![record](docs/img/record.png)