ParagonPaths

Static path registry providing strongly-typed access to all standard workspace, project, and asset folder paths. Uses a nested Folder class hierarchy with implicit string conversion for seamless use in file I/O operations.

Definition

Namespace: Paragon Assembly: Paragon.dll

[RuntimeInitializeOnLoad]
public static class ParagonPaths

Attributes: [RuntimeInitializeOnLoad], [InitializeOnLoad] (Editor)

Remarks

ParagonPaths is the single source of truth for file system paths in the Paragon framework. Rather than scattering string literals like "Assets/Paragon/Core" throughout the codebase, all paths are accessed through a strongly-typed Folder hierarchy that mirrors the project's directory structure.

Initialization

The class is marked with [RuntimeInitializeOnLoad] (Paragon's custom attribute), which forces its static constructor to run at application startup. In the Editor, [InitializeOnLoad] provides the same guarantee. The static constructor:

1. Detects the OS platform (Unix vs Windows)

2. Resolves the user's Documents folder

3. Builds the full folder hierarchy: Documents/Paragon Entertainment/[ProjectName]/...

Folder Hierarchy

Documents/
└── Paragon Entertainment/          ← Workspace
    └── [ProjectName]/              ← Project
        ├── Assets/                 ← Assets
        │   ├── Paragon/            ← ParagonFolder
        │   │   ├── Core/
        │   │   └── Editor/
        │   ├── Build/              ← BuildFolder
        │   │   └── Resources/
        │   ├── Third-Party/
        │   └── [ProductName]/      ← Game
        ├── Packages/
        ├── Build/
        ├── Third-Party/
        ├── ProjectSettings/
        ├── Library/
        └── Temp/

Implicit String Conversion

Every Folder instance implicitly converts to string, so paths can be passed directly to any API expecting a path string:

string path = ParagonPaths.Assets.Paragon.Core;  // Implicit conversion
File.Exists(ParagonPaths.Project.Combine("config.json"));  // Works in IO calls

Quick Lookup

Goal	How
Get workspace root	ParagonPaths.Workspace
Get project root	ParagonPaths.Project
Get Assets folder	ParagonPaths.Assets
Get Paragon Core folder	ParagonPaths.Assets.Paragon.Core
Get Paragon Editor folder	ParagonPaths.Assets.Paragon.Editor
Get Build/Resources	ParagonPaths.Assets.Build.Resources
Get game-specific folder	ParagonPaths.Assets.Game
Combine with child path	ParagonPaths.Assets.Combine("MyFolder/file.txt")
Get full system path	ParagonPaths.Project.GetFullPath()
Get folder name only	ParagonPaths.Assets.GetFolderName() → "Assets"

Properties

Property	Type	Access	Description
Workspace	WorkspaceFolder	public static	Root workspace folder (Documents/Paragon Entertainment)
Project	ProjectFolder	public static	Project root (workspace + project directory name)
Assets	AssetsFolder	public static	Unity Assets folder

Nested Classes

Folder

Base class for all folder types. Stores a path string and provides utility methods.

public class Folder

Member	Type	Description
path	string	Protected path string
Folder(string name)	Constructor	Creates from a name (relative path)
Folder(string directory, string name)	Constructor	Creates from parent directory + name
implicit operator string	Operator	Returns the path string
GetFolderName()	string	Returns just the folder name
GetFullPath()	string	Returns the absolute path
Combine(string childPath)	string	Joins with a child path
ToString()	string	Returns the path string

WorkspaceFolder : Folder

public class WorkspaceFolder : Folder

Member	Type	Description
Project	ProjectFolder	The project folder within this workspace

ProjectFolder : Folder

public class ProjectFolder : Folder

Member	Type	Description
Assets	AssetsFolder	Unity Assets folder
Packages	Folder	Unity Packages folder
Build	Folder	Build output folder
ThirdParty	Folder	Third-party dependencies
ProjectSettings	Folder	Unity ProjectSettings
Library	Folder	Unity Library (cache)
Temp	Folder	Unity Temp folder

AssetsFolder : Folder

public class AssetsFolder : Folder

Member	Type	Description
Paragon	ParagonFolder	Assets/Paragon folder
Build	BuildFolder	Assets/Build folder
ThirdParty	Folder	Assets/Third-Party folder
Game	Folder	Assets/[ProductName] folder (uses Application.productName)

ParagonFolder : Folder

public class ParagonFolder : Folder

Member	Type	Description
Core	Folder	Assets/Paragon/Core
Editor	Folder	Assets/Paragon/Editor

BuildFolder : Folder

public class BuildFolder : Folder

Member	Type	Description
Resources	Folder	Assets/Build/Resources

Common Pitfalls

Cross-platform path resolution On Unix/macOS, the Documents path is resolved as $HOME/Documents. On Windows, it uses Environment.SpecialFolder.MyDocuments. Paths use System.IO.Path.Combine for correct separators, but be aware of platform differences when logging or comparing paths.

Workspace name is hardcoded The workspace folder name is the constant "Paragon Entertainment". If the workspace directory is renamed, ParagonPaths will point to a nonexistent folder.

Game folder uses Application.productName AssetsFolder.Game is initialized with Application.productName, which is set in Unity's Player Settings. If the product name changes, the path changes accordingly.

Folders do not create directories The Folder class only stores path strings — it does not create physical directories. Ensure directories exist before writing files to paths obtained from ParagonPaths.

Examples

Accessing Common Paths

using Paragon;

// Workspace root
string workspace = ParagonPaths.Workspace; // "C:/Users/.../Documents/Paragon Entertainment"

// Project root
string project = ParagonPaths.Project; // "C:/Users/.../Documents/Paragon Entertainment/Townskeep"

// Assets
string assets = ParagonPaths.Assets; // "Assets"

// Paragon Core
string core = ParagonPaths.Assets.Paragon.Core; // "Assets/Paragon/Core"

Combining Paths

using Paragon;

// Build a path to a specific file
string configPath = ParagonPaths.Project.Combine("config.json");

// Build a path within Assets
string prefabPath = ParagonPaths.Assets.Game.Combine("Prefabs/Player.prefab");

// Get full system path
string fullPath = ParagonPaths.Project.GetFullPath();

Using in File Operations

using Paragon;
using System.IO;

// Implicit string conversion works with IO APIs
if (Directory.Exists(ParagonPaths.Assets.Build.Resources))
{
    string[] files = Directory.GetFiles(ParagonPaths.Assets.Build.Resources);
}

// Combine for specific files
string savePath = ParagonPaths.Workspace.Combine("saves/game.sav");
File.WriteAllText(savePath, saveData);

See Also

• RuntimeInitializeOnLoad — attribute that triggers static constructor execution

• Utility Overview — system overview