🔗 Path Helper
Short Description
Utilities to convert between Absolute and Gorgeous-relative plugin paths.
Long Description
GorgeousPathHelper contains helpers to locate the Gorgeous plugin base directory, convert absolute filesystem paths into plugin-relative (Gorgeous) paths, and to resolve plugin-relative paths back into absolute filesystem locations. It supports Unreal package paths and plugin-prefixed paths.
🚀 Features
- Resolve Gorgeous plugin base directory.
- Relativize absolute paths to the Gorgeous plugin schema.
- Resolve plugin-relative paths and package names to absolute filesystem paths.
GetGorgeousPluginBaseDir
Attempts to find the filesystem base directory for the Gorgeous plugin ecosystem. Prefers the GorgeousCore plugin as anchor, falls back to the first discovered plugin that starts with Gorgeous, and finally to the project's Plugins/GorgeousThings folder.
This function takes no parameters.
FString BaseDir = GetGorgeousPluginBaseDir();GorgeousPathToRelativePath
Converts an absolute file path to a gorgeous-relative path by trimming the discovered plugin base directory. Useful for storing compact plugin-relative references.
| Parameter Name | Type | Description |
|---|---|---|
FilePath |
FString |
Absolute filesystem path to convert. |
FString Relative = GorgeousPathToRelativePath(AbsolutePath);RelativePathToGorgeousPath
Resolves a plugin-relative path into an absolute filesystem path. Supports Unreal package paths (long package names), plugin-prefixed paths ("PluginName/..."), and fallback to the Gorgeous ecosystem base dir.
| Parameter Name | Type | Description |
|---|---|---|
RelativePath |
FString |
Plugin-relative, package, or plugin-prefixed path. |
FString Absolute = RelativePathToGorgeousPath(TEXT("GorgeousInventory/Content/Config/Tags/MyTags.ini"));