Report

用户5061

用户9501

用户9153

用户9377

4月26日修改

Team Name:	Kotava
Team Members:	Qinjian Luo 2717366 / Zhehan Lin 2717301 / Lirong Zeng 2717396 / Hongyi Guo 2717623

1 Introduction

1.1 Overview of Scrabble

Scrabble is a classic word game in which players form connected words on a board using letter tiles, with each letter carrying a different score value. The game combines vocabulary knowledge, spelling ability, strategic thinking, and score management, making it both educational and entertaining. Because of its balance between language learning and competition, Scrabble has remained popular among students, families, and word-game enthusiasts for many years.​

1.2 Purpose of Project and Report

As a traditional table game, however, Scrabble still has some limitations, such as difficulty in checking valid words, a monotonous form of entertainment, and limitations of the venue and setting. Hence, the target of his project is not only to create a digital version of the Scrabble game, but also to improve the overall gameplay experience. By turning the traditional board game into software, the system can provide more convenient interaction and automatically handle rule checking, score calculation, and other management tasks. Moreover, the addition of LAN multiplayer and AI gameplay further enhances the game by making it more flexible, interactive, and suitable for different users and playing situations.​

Moreover, from an educational perspective, this project is intended to provide students with an opportunity to apply theoretical knowledge of Java programming language to a practical software development task. Through the design and implementation of this system, team members are able to strengthen their understanding of basic concepts of Java, software architecture, modular design, user interaction, error handling, testing, and teamwork. The project also encourages students to explore unfamiliar technical areas, thereby improving their problem-solving and self-learning abilities.​

This report aims to give a detailed and structured presentation of the whole project about the development process and technical design of the Scrabble game system. It provides a structured explanation of the system architecture, implementation details, and key functionalities. It also presents the challenges encountered during development, the solutions adopted, and an objective and comprehensive evaluation, along with identified directions for future work.​

1.3 Target Users and Application Scenarios

The target users of this software include casual players who enjoy word games for entertainment, students who want to improve their vocabulary and spelling skills, and groups of players who would like to play together in different modes. The software is applicable in a variety of scenarios, such as personal entertainment, practice of spelling and vocabulary, face-to-face or LAN multiplayer gaming with friends, and small group recreational activities. Therefore, the system is designed to support both recreational and educational use, while also providing flexibility for personalized user needs and playing environments.​

1.4 System Overview and Features

The software is a Java-based Scrabble game with a graphical user interface. It allows players to play Scrabble in different modes, including local multiplayer, human-versus-AI, and LAN-based multiplayer. The system is designed to manage the complete game process, from game setup to scoring and final settlement.​

Its main functions include creating a game, selecting settings such as player count, dictionary, time control, and game mode, placing and recalling tiles, validating words, calculating scores, switching turns, and ending the game when the required conditions are met. The software also includes an AI module that enables human-versus-AI gameplay, allowing single players to play against a computer-controlled opponent. In LAN mode, the software further supports room discovery, lobby waiting, and synchronized multiplayer gameplay over a local network.​

1.5 Organization of the Report

The rest of this report is organized as follows. The next section presents the build and compilation instructions, including the development environment, required dependencies, and the procedures for building and running the system. This is followed by a user guide, which explains the interface layout, game settings, and core gameplay procedures. The report then provides a code overview, covering the repository structure, system architecture, key classes, and the main data flow of the application. A critical evaluation section follows, where the major challenges encountered during development and the corresponding solutions are discussed. The subsequent section reviews the project requirements and their implementation status. Finally, the conclusion summarizes the overall project outcomes, team contributions, and AI declaration.​

2 Compiling Instruction

2.1 Build Tool Chain

1.
JDK: JDK 25.0.2​

2.
LLVM/Clang: clang++ 21.1.8 ​

3.
mingw-w64: 15.2.0 ​

4.
Maven: 3.9.14 ​

5.
CMake: 3.10+  ​

6.
OS: ​
a.
MacOS (Recommended): Can build MacOS and Windows native library.​
b.
Windows: Can only build Windows native library.​

2.2 Dependencies

1.
 JavaFX: 25​

Java dependencies will be automatically managed and installed by Maven, so it should not be installed manually.​

2.3 Build Step

2.3.1 Build Native Library

Build scripts(Bash sctript) are provided in the folder /scrabblohhhhh/scripts/. Run scripts to easily build native libraries for MacOS and Windows, and compiled libraries will be located at /scrabblohhhhh/target/native.​

Sample commands are as follows:

Native Library

# Open the project root folder first​
cd scripts​
bash build-quackle-ffm-win.sh​
bash build-quackle-ffm-mac.sh​

2.3.2 Build Java Project

This project uses the Maven build tool to manage building, therefore please make sure Maven is installed in computer. The compile and launch command are as follow:​

Java Project

# Open the project root folder first​
​
# Build command​
mvn clean​
mvn clean package -DskipTests​
# Run Command​
mvn javafx:run​

Report ​

Report