How rasyidrizky/nangor-valley works
Nangor Valley is a Java 2D farming-life simulation. The player-facing loop runs from keyboard input into the game panel and player, where movement and world interactions enable farming, inventory/tool use, travel, NPC relationships, fishing, and cooking; time and season/weather shape the simulation. The graph groups rendering/runtime coordination, world navigation, farming, player activities, and social/economic systems. README capabilities are retained, but several links are dashed because their implementation was not sampled; edges with evidence cite the README or an indexed excerpt showing the relationship.
Main entry points: Player.java Player · GamePanel.java Game Panel · TileActionHandler.java Farm Tile Actions · KeyHandler.java Keyboard Input
Components 21
Game Runtime
- Keyboard Input
src/main/KeyHandler.java - Game Panel
src/main/GamePanel.java - Time & Seasons
src/main/GameTime.java - Time Thread
src/main/TimeThread.java - Game UI
src/main/UI.java
World Navigation
- Tile & Map Manager
src/tile/TileManager.java - World Travel
src/main/EventHandler.java - Entity Model
src/entity/Entity.java
Farming
- Farm Tile Actions
src/tile/TileActionHandler.java - Growing Crops
src/tile/PlantedCrop.java - Crop Items
src/object/Crops - Seed Items
src/object/Seeds
Player Activities
- Player
src/entity/Player.java - Inventory & Tools
src/entity/Inventory.java - Fishing
src/object/OBJ_FishingArea.java - Recipe Catalog
src/recipe/RecipeRegistry.java - Cooking
src/recipe/CookingManager.java
Community & Economy
- NPC Characters
src/entity/Abigail.java - NPC Interactions
src/main/NPCHandler.java - Prices & Selling
src/main/PriceBook.java
Other components
- Player
Connections 30
- Player → Keyboard Input: presses keys
- Keyboard Input → Player: controls
src/main/KeyHandler.java - Keyboard Input → World Travel: chooses destination
src/main/KeyHandler.java - Game Panel → Keyboard Input: registers input
src/main/GamePanel.java - Game Panel → Time Thread: starts clock
src/main/GamePanel.java - Game Panel → Time & Seasons: owns time state
src/main/GamePanel.java - Game Panel → Tile & Map Manager: owns map manager
src/main/GamePanel.java - Game Panel → Farm Tile Actions: owns tile handler
src/main/GamePanel.java - Game Panel → Recipe Catalog: loads recipes
src/main/GamePanel.java - Game Panel → Game UI: renders interface
- Player → Entity Model: extends model
src/entity/Player.java - Entity Model → Player: checks collision
src/entity/Entity.java - World Travel → Player: teleports
src/main/EventHandler.java - Player → Farm Tile Actions: uses farm tiles
src/tile/TileActionHandler.java - Farm Tile Actions → Growing Crops: creates crop state
src/tile/TileActionHandler.java - Farm Tile Actions → Crop Items: creates harvest item
src/tile/TileActionHandler.java - Farm Tile Actions → Seed Items: handles planting
src/tile/TileActionHandler.java - Player → Inventory & Tools: manages items
src/entity/Player.java - Player → Fishing: uses fishing areas
src/object/OBJ_FishingArea.java - Recipe Catalog → Cooking: provides recipes
- Cooking → Player: consumes ingredients
src/recipe/CookingManager.java - Cooking → Entity Model: creates output item
src/recipe/CookingManager.java - Player → NPC Interactions: gifts items
- NPC Interactions → NPC Characters: updates relationships
src/main/NPCHandler.java - NPC Characters → Player: interacts with
src/entity/Abigail.java - Player → Prices & Selling: sells harvest
- Player → Player: farms and explores
- Player → NPC Characters: meets characters
- Player → Fishing: fishes
- Player → Cooking: cooks food