diff --git a/tutorials/io/runtime_file_loading_and_saving.rst b/tutorials/io/runtime_file_loading_and_saving.rst index 23e201d9d7e..7495a89155d 100644 --- a/tutorials/io/runtime_file_loading_and_saving.rst +++ b/tutorials/io/runtime_file_loading_and_saving.rst @@ -198,6 +198,20 @@ Example of loading a glTF scene and appending its root node to the scene: # `GLTFDocument.generate_buffer()` is also available for saving to memory. gltf_document_save.write_to_filesystem(gltf_state_save, path) +.. note:: + + When loading a glTF scene, a *base path* must be set so that external + resources like textures can be loaded correctly. When loading from a file, + the base path is automatically set to the folder containing the file. When + loading from a buffer, this base path must be manually set as there is no + way for Godot to infer this path. + + To set the base path, set + :ref:`GLTFState.base_path ` on your + GLTFState instance *before* calling + :ref:`GLTFDocument.append_from_buffer ` + or :ref:`GLTFDocument.append_from_file `. + .. _doc_runtime_file_loading_and_saving_fonts: Fonts