Textures¶
Custom textures¶
Allows custom textures to be bound to the available shader units.
Format: texture.<stage>.<name>=<path>
<stage>
:
gbuffers
: gbuffers and shadow programsdeferred
: deferred programscomposite
: composite and final programs
<name>
is the texture unit name.
The textures can be loaded from different places:
- Shader pack
The texture path is relative to the folder
shaders/
:texture.composite.colortex1=textures/noise.png
- Resource pack
The texture path should start with
minecraft:
:texture.composite.colortex2=minecraft:textures/font/ascii.png
- Dynamic (lightmap, texture atlas)
texture.composite.colortex3=minecraft:dynamic/lightmap_1
texture.composite.colortex4=minecraft:textures/atlas/blocks.png
The suffix _n
and _s
can be used to load the normal/specular variant of the texture: minecraft:textures/atlas/blocks_n.png
Raw textures (binary dump) can also be loaded: texture.<stage>.<name>=<path> <type> <internalFormat> <dimensions> <pixelFormat> <pixelType>
Where:
<type>
is one of:TEXTURE_1D
,TEXTURE_2D
,TEXTURE_3D
,TEXTURE_RECTANGLE
<internalFormat>
is the texture format, see Texture formats for the available names<dimensions>
is a list of texture dimensions, depends on the texture type<pixelFormat>
is the pixel format, see Pixel formats for the available names<pixelType>
is the pixel type, see Pixel types for the available names
It is possible to bind several textures with different types to one texture unit.
The shaders can differentiate between them based on the sampler type: sampler1d
, sampler2d
, sampler3d
...
In one program only one sampler type can be used per texture unit.
The suffixes .0
to .9
can be added to <name>
to avoid duplicate property keys.
Wrap and filter modes can be configured by adding standard texture .mcmeta
files, for example: textures/lut_3d.dat.mcmeta
.
GBuffers textures¶
ID |
Name |
Legacy name |
---|---|---|
|
gtexture |
texture |
|
lightmap |
|
|
normals |
|
|
specular |
|
|
shadowtex0 |
shadow, watershadow |
|
shadowtex1 |
shadow (when watershadow used) |
|
depthtex0 |
|
|
gaux1 |
colortex4 <custom texture or output from deferred programs> |
|
gaux2 |
colortex5 <custom texture or output from deferred programs> |
|
gaux3 |
colortex6 <custom texture or output from deferred programs> |
|
gaux4 |
colortex7 <custom texture or output from deferred programs> |
|
depthtex1 |
|
|
shadowcolor0 |
shadowcolor |
|
shadowcolor1 |
|
|
noisetex |
|
|
colortex8 |
<custom texture or output from deferred programs> |
|
colortex9 |
<custom texture or output from deferred programs> |
|
colortex10 |
<custom texture or output from deferred programs> |
|
colortex11 |
<custom texture or output from deferred programs> |
|
colortex12 |
<custom texture or output from deferred programs> |
|
colortex13 |
<custom texture or output from deferred programs> |
|
colortex14 |
<custom texture or output from deferred programs> |
|
colortex15 |
<custom texture or output from deferred programs> |
Shadow textures¶
ID |
Name |
Legacy name |
|
---|---|---|---|
|
gtexture |
texture |
|
|
lightmap |
||
|
normals |
||
|
specular |
||
|
shadowtex0 |
shadow, watershadow |
|
|
shadowtex1 |
shadow (when watershadow used) |
|
|
gaux1 |
colortex4 <custom texture> |
|
|
gaux2 |
colortex5 <custom texture> |
|
|
gaux3 |
colortex6 <custom texture> |
|
|
gaux4 |
colortex7 <custom texture> |
|
|
shadowcolor0 |
shadowcolor |
|
|
shadowcolor1 |
||
|
noisetex |
||
|
colortex8 |
<custom texture> |
|
|
colortex9 |
<custom texture> |
|
|
colortex10 |
<custom texture> |
|
|
colortex11 |
<custom texture> |
|
|
colortex12 |
<custom texture> |
|
|
colortex13 |
<custom texture> |
|
|
colortex14 |
<custom texture> |
|
|
colortex15 |
<custom texture> |
Composite and deferred textures¶
ID |
Name |
Legacy name |
---|---|---|
|
colortex0 |
gcolor |
|
colortex1 |
gdepth |
|
colortex2 |
gnormal |
|
colortex3 |
composite |
|
shadowtex0 |
shadow, watershadow |
|
shadowtex1 |
shadow (when watershadow used) |
|
depthtex0 |
gdepthtex |
|
colortex4 |
gaux1 |
|
colortex5 |
gaux2 |
|
colortex6 |
gaux3 |
|
colortex7 |
gaux4 |
|
depthtex1 |
|
|
depthtex2 |
|
|
shadowcolor0 |
shadowcolor |
|
shadowcolor1 |
|
|
noisetex |
|
|
colortex8 |
|
|
colortex9 |
|
|
colortex10 |
|
|
colortex11 |
|
|
colortex12 |
|
|
colortex13 |
|
|
colortex14 |
|
|
colortex15 |