Docs: add note for stage_assert_generate to settings api (#2885)

This commit is contained in:
black-sliver
2024-03-03 17:00:32 +01:00
committed by GitHub
parent ef37ee81f9
commit 57d1fe6d79

View File

@@ -121,6 +121,10 @@ Path to a single file. Automatically resolves as user_path:
Source folder or AP install path on Windows. ~/Archipelago for the AppImage. Source folder or AP install path on Windows. ~/Archipelago for the AppImage.
Will open a file browser if the file is missing when in GUI mode. Will open a file browser if the file is missing when in GUI mode.
If the file is used in the world's `generate_output`, make sure to add a `stage_assert_generate` that checks if the
file is available, otherwise generation may fail at the very end.
See also [world api.md](https://github.com/ArchipelagoMW/Archipelago/blob/main/docs/world%20api.md#generation).
#### class method validate(cls, path: str) #### class method validate(cls, path: str)
Override this and raise ValueError if validation fails. Override this and raise ValueError if validation fails.