Files
GGJ26/addons/maaacks_game_template/docs/MovingFiles.md
minimata 44f251ed66
All checks were successful
Create tag and build when new code gets to main / BumpTag (push) Successful in 6s
Create tag and build when new code gets to main / Export (push) Successful in 1m1s
Basic game template addon
2026-01-30 19:45:56 +01:00

34 lines
1.5 KiB
Markdown

# Moving Files
This page covers some tips for rearranging files to an individual developer's preference.
> [!WARNING]
> Backup your project before attempting to rearrange files.
> You assume any risk.
## Move Files in the Editor
Use the editor to move files around, as this makes sure that `.uid` files get moved with `.gd` files, external resource references will get updated in `.tscn` files, and paths in project settings get updated.
UIDs do help with moving files outside of the editor, but not all scenes will have UIDs set if they've just recently been copied from the examples.
## Update File Paths
The flow of scenes in the template by default goes `Opening -> Main Menu -> Game Scene -> Ending Scene`.
The `Opening` is referenced in the project settings, and will get automatically update if moved in the editor.
The rest have their default paths stored in the `AppConfig` autoload. These do not get automatically updated, so the developer must update these paths if they change.
Alternatively, the developer can specify paths in the scenes that reference the other scenes by path. These include:
* `opening.tscn`
* `main_menu.tscn`
* `main_menu_with_animations.tscn`
* `pause_menu.tscn`
* `game_ui.tscn` (`level_manager.gd`)
* `end_credits.tscn`
## Internal Details
File paths, stored as strings, do not get automatically updated by the editor when their target moves. Paths are used when asynchronous loading of scenes (ie. using `SceneLoader`) is preferred, primarily for memory management.