How bachhungcb/lthdt.20241-04 works
Project type and purpose
• This is a Java-based desktop puzzle game (an OOP coursework project) built with JavaFX.
• It follows an MVC-style separation between the core game logic (model), the UI views (FXML files), and controllers that mediate user interaction.
File structure
Top-level packages under sourcecode/:
• game – entry point (Game.java) and game loop setup
• model – domain objects (Cell, GameBoard, Player, Square, HalfCircle) and interfaces (Pickable)
• gem – concrete gem types (Gem, BigGem, SmallGem) used by the model
• screen
– application – JavaFX screens (IntroScreen, PlayScreen, HelpScreen, EndScreen) and shared data
– controller – controllers for each screen, implementing user-driven logic
– view – FXML layout files for each screen
– images, music – static resources
README
• Confirms this is a team assignment for an OOP class.
Detailed capture of essential elements
• Do not just list packages; show how data flows from user input in the View, through Controller, into Model, and back to the View.
• Screen/application classes that manage scene transitions and hold shared game state.
• Game loop or event-driven nature of PlayScreenController invoking model updates on user actions or timers.