Texture Asset: Difference between revisions

From Pummel Party Mod Documentation
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
A texture asset is a 2D image that can be used with materials to texture objects.
A texture asset is a 2D image that can be used with materials to change the appearance of objects. They can also be used directly as images, such as for setting the mod's preview image.


See [[Importing Images]] for guidance and settings available when importing texture assets.
See [[Importing Images]] for guidance and settings available when importing texture assets.
Line 6: Line 6:


==Usage ==
==Usage ==
===Materials===
 
Textures are used with materials. The different types of [[Material Asset]]s can take different sets of textures to create the materials look. The main texture that is required by a material is the Albedo. This is the primary visible texture that is displayed when the material is used on an object.
=== Put a Texture on an object===
 
====Using a material====
Textures must be assigned to a custom [[Material Asset]]. In Pummel Party, textures are not applied to objects directly, materials are applied to objects, and the material use a texture to define what they should look like. The different types of [[Material Asset]]s can take different sets of textures to create the material's look. If you just want to display a texture on an object, the texture that should be set is the one named ''Albedo''. This is the primary visible texture that is displayed when the material is used on an object.
 
The other textures that a material can use are for advanced graphical effects, such as [https://en.wikipedia.org/wiki/Normal_mapping Normal Mapping]. See the [[Material Asset]] page for more details on the different texture types.
 
====Props that support custom textures====
[[File:PropsThatSupportTextures.png|thumb|600px|Only some of the provided props can display custom textures correctly.]]
Most of the provided objects that have flat colors aren't [https://en.wikipedia.org/wiki/UV_mapping UV Mapped] to support full textures so trying to use a custom material with a texture on them will just change their colors to some part of your texture, but not show the texture properly.
 
There are some props that do support textures. These are most of the basic primitive shapes.
 
The best props to show textures on are the following. You can search for these when setting the ''Prop'' field of a [[Prop Component]]. You can also find them in the [[Asset Browser]] and drag them into the [[Scene View]] to use them.
* Cube
* Plane
* Sphere
* Capsule
* Cylinder
* LowPolyQuad
* CustomBoardSpace
 
The following work when showing textures, but may not be the best
* LowPolyPyramid
* BevelCube
* BevelCylinder
* LowPolyCapsule
* LowPolyCylinder
 
Any custom meshes that you use should display custom textures correctly as long as the mesh has correct UV mapping. This means if you have a custom model with a matching set of textures, you can import the [[Mesh Asset]], import the textures, create a material to hold the textures and apply them to a prop using the mesh.
 
===Using a custom minigame/board preview image===
You can import a texture and use it for the minigame or board image that appears in the lobby or on the minigame loading scene/ruleset menu. This preview image can be set in the [[Mod Settings]] under ''Minigame Details'' or ''Board Details'' depending on the mod type.


[[Category:Assets]]
[[Category:Assets]]

Latest revision as of 23:56, 15 January 2023

A texture asset is a 2D image that can be used with materials to change the appearance of objects. They can also be used directly as images, such as for setting the mod's preview image.

See Importing Images for guidance and settings available when importing texture assets.

Imported textures can be viewed in the Asset Browser in the Custom > Textures folder.

Usage

Put a Texture on an object

Using a material

Textures must be assigned to a custom Material Asset. In Pummel Party, textures are not applied to objects directly, materials are applied to objects, and the material use a texture to define what they should look like. The different types of Material Assets can take different sets of textures to create the material's look. If you just want to display a texture on an object, the texture that should be set is the one named Albedo. This is the primary visible texture that is displayed when the material is used on an object.

The other textures that a material can use are for advanced graphical effects, such as Normal Mapping. See the Material Asset page for more details on the different texture types.

Props that support custom textures

Only some of the provided props can display custom textures correctly.

Most of the provided objects that have flat colors aren't UV Mapped to support full textures so trying to use a custom material with a texture on them will just change their colors to some part of your texture, but not show the texture properly.

There are some props that do support textures. These are most of the basic primitive shapes.

The best props to show textures on are the following. You can search for these when setting the Prop field of a Prop Component. You can also find them in the Asset Browser and drag them into the Scene View to use them.

  • Cube
  • Plane
  • Sphere
  • Capsule
  • Cylinder
  • LowPolyQuad
  • CustomBoardSpace

The following work when showing textures, but may not be the best

  • LowPolyPyramid
  • BevelCube
  • BevelCylinder
  • LowPolyCapsule
  • LowPolyCylinder

Any custom meshes that you use should display custom textures correctly as long as the mesh has correct UV mapping. This means if you have a custom model with a matching set of textures, you can import the Mesh Asset, import the textures, create a material to hold the textures and apply them to a prop using the mesh.

Using a custom minigame/board preview image

You can import a texture and use it for the minigame or board image that appears in the lobby or on the minigame loading scene/ruleset menu. This preview image can be set in the Mod Settings under Minigame Details or Board Details depending on the mod type.