Resources Manual     Reference     Scripting  
Scripting > Runtime Classes > Resources
Resources

The Resources class allows you to Find and Load Objects by their path name.

All assets that are in a folder named "Resources" anywhere in the Assets folder can be accessed via the Resources.Load functions. Multiple "Resources" folders may exist and when loading objects each will be examined.

In Unity you usually don't use path names to access assets, instead you expose a reference to an asset by declaring a member-variable, and then assign it in the inspector. When using this technique Unity can automatically calculate which assets are used when building a player. This radically minimizes the size of your players to the assets that you actually use in the built game. When you place assets in "Resources" folders this can not be done, thus all assets in the "Resources" folders will be included in a build.

Another disadvantage of using path names is that it leads to less reusable code since scripts will have specific hard coded requirements on where the used assets are placed. On the other hand using references that are exposed in the inspector are self-documenting and immediately obvious to the user of your script.

However there are situations where it is more convenient to fetch an asset by its name instead of linking to it in the inspector. Essentially whenever it is inconvenient to assign the reference to the object in the inspector. For example you might want to create a game object procedurally from a script and for example assign a texture to a procedurally generated mesh.

var go = new GameObject.CreatePrimitive(PrimitiveType.Plane);
go.renderer.material.mainTexture = Resources.Load("glass");

Class Functions
FindObjectsOfTypeAll

Returns a list of all objects of Type type.

Load

Loads an asset stored at path in a Resources folder.

LoadAll

Loads all assets in a folder or file at path in a Resources folder.

LoadAssetAtPath

Returns a resource at an asset path (Editor Only).

UnloadUnusedAssets

Unloads assets that are not used.