How ramosblk/--hidden-way--- works
Hidden Way is a single-player 2D platform-adventure game. The player starts in a tutorial/menu area, enters the first map to collect a key and open a chest/cave route, then progresses through configured platform phases by collecting keys, avoiding hazards and reaching exits; death offers a restart or menu return. The graph separates states, gameplay entities, and supporting systems. Relationships reflect the README and shown source/index references; unsampled modules are represented only where the tree or index supports them.
Main entry points: mapa1_state.py First map · fase_state.py Platform phases · inicio_state.py Start and tutorial · player.py Player
Components 27
Game states
- First map
classes/states/mapa1_state.py - Platform phases
classes/states/fase_state.py - Start and tutorial
classes/states/inicio_state.py - State interface
classes/states/game_state.py - Phase-complete state
classes/states/fase_completa_state.py - Game-over state
classes/states/game_over_state.py
Gameplay
- Player
classes/entities/player.py - Key collectible
classes/entities/chave.py - Enemies and hazards
classes/entities/inimigo.py - Chest and cave
classes/entities - Exit door
classes/entities/porta.py
Game systems
- Phase definitions
classes/systems/fases.py - State manager
classes/systems/game_manager.py - Collision physics
classes/systems/colisao.py - Scene rendering
classes/systems/cenario.py - HUD
classes/systems/hud.py - Fall transition
classes/systems/queda.py - Screen transition
classes/systems/transicao.py - Particles
classes/systems/particulas.py - Synthesized audio
classes/systems/audio.py - Image assets
classes/systems/assets.py - Player animation
classes/systems/sprites_player.py - Tutorial prompts
classes/systems/tutorial.py
Result screens
- Completion screen
classes/fase_completa.py - Game-over screen
classes/game_over.py - Shared UI
classes/ui.py
Other components
- Player
Connections 44
- Player → Start and tutorial: starts game
README.md - Start and tutorial → Player: updates movement
classes/states/inicio_state.py - Start and tutorial → Scene rendering: moves and draws
classes/states/inicio_state.py - Start and tutorial → Tutorial prompts: updates and draws
classes/states/inicio_state.py - Start and tutorial → First map: enters map
classes/states/inicio_state.py - First map → Player: updates movement
classes/states/mapa1_state.py - First map → Key collectible: checks collection
classes/states/mapa1_state.py - First map → Chest and cave: handles interaction
classes/states/mapa1_state.py - First map → Scene rendering: draws scene
classes/states/mapa1_state.py - First map → HUD: updates notices
classes/states/mapa1_state.py - First map → Particles: starts fall effects
classes/states/mapa1_state.py - First map → Fall transition: starts and updates
classes/states/mapa1_state.py - First map → Screen transition: fades between scenes
classes/states/mapa1_state.py - First map → Phase definitions: requests next phase
classes/states/mapa1_state.py - First map → Phase-complete state: switches on completion
classes/states/mapa1_state.py - Phase definitions → Platform phases: creates configured phase
classes/systems/fases.py - Platform phases → Player: updates movement
classes/states/fase_state.py - Platform phases → Key collectible: checks collection
classes/states/fase_state.py - Platform phases → Enemies and hazards: checks collisions
classes/states/fase_state.py - Platform phases → Exit door: handles exit
classes/states/fase_state.py - Platform phases → Scene rendering: draws scene
classes/states/fase_state.py - Platform phases → HUD: updates notices
classes/states/fase_state.py - Platform phases → Fall transition: handles death fall
classes/states/fase_state.py - Platform phases → Screen transition: fades transitions
classes/states/fase_state.py - Platform phases → Particles: starts fall effects
classes/states/fase_state.py - Platform phases → Game-over state: switches on death
classes/states/fase_state.py - Platform phases → Phase-complete state: switches on exit
classes/states/fase_state.py - Player → Collision physics: delegates collision
classes/entities/player.py - Player → Player animation: uses animations
classes/entities/player.py - Player → Synthesized audio: plays jump sound
classes/entities/player.py - First map → Synthesized audio: plays game sounds
classes/states/mapa1_state.py - Platform phases → Synthesized audio: plays game sounds
classes/states/fase_state.py - Start and tutorial → State manager: changes state
classes/states/inicio_state.py - First map → State manager: changes state
classes/states/mapa1_state.py - Phase-complete state → Completion screen: updates and draws
classes/states/fase_completa_state.py - Phase-complete state → State manager: continues or returns
classes/states/fase_completa_state.py - Phase-complete state → Synthesized audio: plays victory sound
classes/states/fase_completa_state.py - Game-over state → Game-over screen: handles and draws
classes/states/game_over_state.py - Game-over state → State manager: restarts or returns
classes/states/game_over_state.py - Game-over state → Synthesized audio: plays game-over sound
classes/states/game_over_state.py - Game-over screen → Shared UI: uses shared UI
classes/game_over.py - Completion screen → Shared UI: uses shared UI
classes/fase_completa.py - HUD → Shared UI: uses shared UI
classes/systems/hud.py - First map → Image assets: loads entity images