harmonyhoney/rota

Purpose and Runtime

ROTA: Bend Gravity is a gravity-bending puzzle platformer built in Godot 3.6.1. It targets Linux, Windows, macOS, Web, and Android, with Steam distribution/integration. Godot project and export entry configuration are in project.godot and export_presets.cfg.

Application Entry and Global Services

Godot starts from the scene configured in project.godot; persistent cross-scene behavior is organized as autoload scene/scripts. These provide shared game state, UI, camera, audio/music, transitions, touch input, and cheat handling:

• src/autoload/Shared.gd

• src/autoload/UI.gd

• src/autoload/Cam.gd

• src/autoload/Audio.gd

• src/autoload/Wipe.gd

This is the principal boundary between level-local nodes and application-wide state/presentation services.

Game Flow: Menu, Save Slots, and Options

The menu subsystem owns boot/title flow, file selection/deletion/opening, pause state, attract/demo behavior, player makeover, and input/display/audio settings. Save-oriented data abstractions are centered on src/class/SaveDict.gd, while menu screens operate through:

• src/menu/MenuBoot.gd

• src/menu/MenuTitle.gd

• src/menu/MenuFile.gd

• src/menu/MenuPause.gd

• src/menu/options/MenuOptions.gd

Control transitions from menus into a selected game world/level; pause/options return control to the active play state.

World and Level Composition

Playable content is scene-driven. World directories contain hub scenes and numbered stages, allowing door-based navigation among a large campaign:

• src/map/worlds/0/0_hub.tscn

• src/map/worlds/1/0_hub.tscn

• src/map/worlds/3B/8.tscn

Levels compose reusable actors, environmental details, tile maps, and shaders. Collision/solid terrain and hazard layout are encapsulated in:

• src/stage/SolidTileMap.gd

• src/stage/SpikeMap.gd

• src/stage/tileset/TileSet0.tres

Core Puzzle Gameplay Actors

The player and interactive objects implement the gravity-platforming puzzle loop: movement/gravity control, pushable boxes, hazards, collectibles/goals, NPC guidance/chat, and doors. Door nodes form the main level/world transition boundary:

• src/actor/Player.gd

• src/actor/Box.gd

• src/actor/Spike.gd

• src/actor/Goal.gd

• src/actor/door/Door.gd

Cutscenes coordinate milestone effects such as game start, gem collection, door unlocks, and goal presentation rather than embedding those sequences in level scenes:

• src/cutscene/Cutscene.gd

• src/cutscene/GemCollect.gd

• src/cutscene/DoorUnlock.gd

Arcade Subgame Boundary

A distinct arcade subsystem has its own wrapper, player, game logic, cabinet/screen presentation, audio behavior, and map set. It is embedded into the broader game but maintains separate gameplay scenes:

• src/arcade/Arcade.gd

• src/arcade/ArcadeGame.gd

• src/arcade/Wrapper.gd

• src/arcade/maps/0.tscn

Rendering, Assets, and Platform Integrations

Godot scenes consume packaged sprites, audio, fonts, tile textures, and custom shaders from media/ and src/shader/; audio buses are defined by default_bus_layout.tres. Steam is a native GDNative addon with macOS dynamic libraries and Steam-facing scripts:

• addons/steam_api/plugin.gd

• addons/steam_api/steam.gd

• addons/steam_api/libsteamsdk-godot.dylib

Distribution automation includes Godot and Flatpak GitHub workflows, Linux desktop/metainfo packaging, and platform export helper scripts:

• .github/workflows/godot.yml

• .github/workflows/flatpak.yml

• linux/net.hhoney.rota.yml