How moise7000/codename-java-clone works
Project type and purpose
• This is a desktop full-stack Java application built with JavaFX.
• Purpose: Implement a “Codenames”-style word/image guessing game with multiple modes (normal, images, blitz, duo, AI-assisted), with customizable decks, persistence (saved games, custom lists) and basic AI integration (LLM).
File structure
• Top-level:
• build.gradle, gradlew wrappers (build & run)
• data/ (SQLite DBs)
• release/ (final jar)
• src/main/java:
– gameInterface: MainApp (entry point)
– controllers: one controller per FXML view (handles user events, calls model/services)
– model: game domain objects, business logic, animations, LLMClient, Observer interfaces
– common: shared utilities (AiStrategy, JSON validation, popup, SceneLoader), DAO layer (DataManager, services, annotations)
– views: Java classes representing programmatic views (rare)
• src/main/resources:
– fxml views, CSS, assets (images, sounds), .env, saved_games folder
• Configuration & build scripts: Gradle files, INSTRUCTIONS.
README for additional insights
• Lists game modes, features, persistence, AI mode.
• Indicates use of JavaFX (javafx.controls, javafx.fxml), SQLite (data/data.db), JSON for deck files, LLM integration.
• UI Layer (controllers/views) – e.g., blue
• Domain Layer (models, AI) – e.g., green
• Persistence Layer (DAOs, DB) – e.g., orange
• External Services (LLM endpoint) – e.g., gray