You are viewing a potentially older version of this package. View all versions.
cjayride-CustomTextures-3.4.1 icon

CustomTextures

Fork of aedenthorn's CustomTextures for v0.217.46+ Allows you to replace instances of game textures with custom png files.

Date uploaded 6 months ago
Version 3.4.1
Download link cjayride-CustomTextures-3.4.1.zip
Downloads 2828
Dependency string cjayride-CustomTextures-3.4.1

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2202 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2202

README

CustomTextures

Patched for Valheim v0.217.46+

A fork of aedenthorn/CustomTextures

ThunderStore | GitHub

Replace game textures with custom png files.

This mod should allow you to replace the following:

  • player model textures
  • item inventory icons
  • equipment textures like armor, weapons, and tools
  • terrain and water textures
  • environmental textures
  • special location textures (villages, crypts, rune stones, etc.)
  • world object textures, almost everything else in the game world

It also now supports layers, so you can apply multiple textures to the same vanilla texture.

EXAMPLE

  • https://imgur.com/a/Jsgxrms

  • Take the image above for a Karve sail, save it as "renderer_sail_full_MainTex.png"

  • Put it in the folder cjayride-CustomTextures/CustomTextures

The next time you run the game, it will replace the Karve sail with this image.

Basic Usage

To extract the vanilla textures for reference, I use Asset Studio. The textures are in the valheim_Data/sharedassets files.

To replace a texture, you simply add a png file to the folder BepInEx/plugins/CustomTextures with the proper name format explained below, and then load the game.

You can also organize textures into subfolders! If you are publishing a texture pack I encourage you to do this, to allow easy install and removal.

Also, if you are publishing a texture pack, putting your textures in a CustomTextures folder before creating the zip file will allow Vortex to install them automatically!

To reload world textures while in game, there is a hotkey (default Page Down). Note: this doesn't reload any vanilla textures, so if you remove a custom texture file, you'll have to restart the game to see the vanilla texture again.

Here's some kind person's video on how to use this mod with premade texture packs.

Filter Mode

Valheim textures use point filtering, which makes them look pixelated up close. If you want to use bilinear or trilinear filtering for higher-res textures, place your textures in a subfolder named bilinear or trilinear and the mod will change the filter mode for those textures (they can still be in sub-subfolders if you choose).

File Naming Summary

File names are made up of up to four parts, prefixes, identifiers, property names, and layer names. To get most of this information, use the scene dump (see Scene Dump below)

You create file names starting with a prefix, usually followed by an underscore, then an identifier, then the property name (and optionally an underscore followed by a layer name, as explained under Layers), i.e. for a complete texture replacement:

<prefix>_<identifier><propertyName>.png

or for a layer:

<prefix><identifier><propertyName><layerName>.png

You end up with a file name like this, and you place it somewhere in the CustomTextures folder.

DETAILED INFORMATION

Prefixes

Property names are usually prefixed by an underscore, so don't forget that too. Also, if you have Windows hiding your file extensions, don't add .png to the end or you'll end up with a file called <prefix>_<identifier><propertyName>.png.png which won't work. Seriously, just have Windows show file extensions, it's dumb that it doesn't.

Here's an explanation of each of the four parts:

The following prefixes are implemented, based on the type of thing being modified:

  • player_model for player textures
  • atlas_item_icons for inventory icons
  • object for object textures
  • armor for armor textures
  • zone for water textures
  • terrain for terrain textures
  • environment for environment textures
  • location for special locations

For objects, water, terrain, environment, and location textures, the prefix can be further modified as follows:

  • <prefix>renderer - for replacing textures on specific named renderers on specific named things
  • <prefix>mat - for replacing textures on specific named materials on specific named things
  • <prefix>renderermat - for replacing textures on specific named materials on specific named renderers on specific named things
  • <prefix>texture - for replacing specific named textures on specific named things

e.g.:

environmentrenderermat_branch_yggdrasil_branch (Instance)_MainTex.png

will replace the main texture on the yggdrasil_branch material on the branch renderer on the YggdrasilBranch environment object.

You can also use the following prefixes based on the name of the component:

  • texture for universally replacing a texture (where supported)
  • renderer for replacing the texture on any named renderer
  • mat for replacing the texture on any named material******:******

So, an easier way to do the above is just:

texture_yggbark_d_MainTex.png

which replaces the texture yggbark_d texture anywhere if it is the main texture.

Identifiers

You can find the identifiers used with the above prefixes in the scene dump. More on this in each detailed section below.

Property Names

You can find the property names in the scene dump as well. Mostly you'll want to replace _MainTex and maybe _BumpMap or _SkinBumpMap.

Layer Names:

See Layers below.

Replacement Types

Here's the details on each type of replacement:

Player Textures

For the base player character texture, use the following syntax:
player_model_<modelNumber><suffix>.png

Replace <modelNumber> with either 0 for male or 1 for female. E.g.:

player_model_1_MainTex.png

Item Inventory Icons

These are the little images that show up in your inventory to represent an in game item. They are all on a single graphic called sactx-2048x2048-Uncompressed-IconAtlas-61238c20 #845.

To replace the inventory icon sheet create an equivalent sheet called:

** atlas_item_icons.png**

You can use any resolution, as it will be scaled to fit.

You can also replace a single item icon using a layer (see Layers below).

Object and Armor Textures Note: Equipment and world objects are now all considered objects. The mod will still recognize the **items** prefix, just for backwards compatibility.

Besides player models and inventory icons, everything else this mod affects is considered an object.

For example:

  • Resources like coal and wood
  • Tools like hammers and cultivators
  • Plants, trees, bushes
  • Building blocks
  • Enemies

Armor is for what the object looks like when you're wearing it (as opposed to throwing it on the ground with the rest of your crap).

The general filename syntax for all of these things is:

<prefix>_<identifier><suffix>.png

Prefixes:

The following prefixes for objects and armor are now implemented:

  • object - used to change all textures of the type <suffix> on a specific world object type. <identifier> should be the object spawn name

  • objectrenderer (objectmesh also works, but is depreciated) - used to change all textures of the type <suffix> on a specific renderer on a specific object. The <identifier> (see Identifiers) should be the object name and the renderer name, separated by underscore: <objectName>_<rendererName>

  • objecttexture - used to change a specific named texture of the type <suffix> on every renderer on a specific object. The <identifier> (see Identifiers) should be the object name and the texture name, separated by underscore: <objectName>_<textureName>

  • objectmat - used to change textures on all specifically named materials on a specific object. The <identifier> (see Identifiers) should be the object name and the material name, separated by underscore: <objectName>_<materialName>

  • objectrenderermat - used to change textures on a specifically named material on a specifically named renderer on a specific object. The <identifier> (see Identifiers) should be the object name and the material name, separated by underscore: <objectName><rendererName><materialName>

  • texture - used to change all instances of a specific texture of the type <suffix> on all objects and items that use that texture. The <identifier> (see Identifiers) should be the texture name (not necessarily the exported file name!)

  • renderer - used to change textures of the type <suffix> on all instances of a specific renderer on all objects and items. The <identifier> (see Identifiers) should be the renderer name.

  • mat - used to change textures of the type <suffix> on all instances of a specific material on all objects and items. The <identifier> (see Identifiers) should be the material name.

  • armor - used to change the chest or legs of armor items - note that the rest of the armor's parts are affected by object rather than this.

Suffixes:

Note: Suffixes have been overhauled. Old suffixes of _texture and _bump are still recognized but should be replaced with the actual property name.

Suffixes tell the mod which texture you want to replace, called "properties".

The scene dump gives a list of properties for each material on an object, e.g.:

object ArmorIronChest has 1 SkinnedMeshRenderers:
SkinnedMeshRenderer name: IronArmor
smr IronArmor has 1 materials
IronArmorChest_mat (Instance):
properties:
_MainTex IronArmorChest_d
_BumpMap IronArmorChest_n
_EmissionMap
_MetallicGlossMap IronArmorChest_m
_StyleTex
armor ArmorIronChest has Material:
Armor name: IronArmorPlayer_chest
properties:
_MainTex
_ChestBumpMap IronArmorChestPlayer_n
_ChestMetal IronArmorChestPlayer_m
_ChestTex IronArmorChestPlayer_d
_LegsBumpMap
_LegsMetal
_LegsTex
_SkinBumpMap

This object has both a skinned mesh renderer and an armor material. They are separate.

The object is all the fancy bits that get stuck on the player.

The armor is the texture that gets pasted onto the player's legs and chest.

Each property is shown with its texture name (if there is one), e.g. the name of the object's _MainTex is IronArmorChest_d.

_MainTex refers to the main texture. Mostly that's the one you want to replace. For armor, however, replacing _MainTex may not do anything - replacing it with a transparent texture seems to work best. To change the actual armor, you need to use _ChestTex and / or _LegsTex and make sure it's only covering the area of the actual armor (see the exported IronArmorChestPlayer_m**.png** for example). So, you would want to create the following:

object_ArmorIronChest_MainTex.png
armor
_ArmorIronChest_ChestTex.png

Armoris complicated, best to experiment!

Identifiers

To get identifiers for objects, use names on the spawn list here:

https://www.reddit.com/r/valheim/comments/lig8ml/spawn_item_command_list/

They will also be in the scene dump mentioned above.

Water and Terrain Textures

Water and terrain textures use a similar syntax to objects, i.e.:

<prefix>_<identifier><suffix>.png

Water

Water textures are inside of zone objects, so in the scene dump you'll now see:

zone _GameMain has 2 MeshRenderers:
MeshRenderer name: WaterSurface
mr WaterSurface has 1 materials
water (Instance):
properties:
_FoamTex foam
_Normal nRHPu
_FoamHighTex foam_highres
_NormalFine normalmap2
_RandomFoamTex random_foam
MeshRenderer name: sub_water_opak_thingyu
mr sub_water_opak_thingyu has 1 materials
water_bottomplane (Instance):
properties:

The prefix here is zone, So use, e.g.:

zone__GameMain_FoamTex.png (note the double underscore!)

Terrain

Right after the zone entry, you'll see:

terrain _GameMain, prefab _Zone (UnityEngine.GameObject)
properties:
_MainTex grass
_NoiseTex Noise
_ClearedMaskTex
_CliffNormal gouacherock_big_n
_CultivatedNormal cultivated_n
_DiffuseTex0 diffuse0
_DirtNormal dirt_normal_generated
_ForestNormal forest_n
_GrassNormal grass_normal_generated
_PavedNormal paved_n
_RockNormal gouacherock_n
_SnowNormal snow_normal

The prefix here is terrain, so use, e.g.:

terrain__GameMain_DiffuseTex0.png

The diffuse0 texture appears to have sixteen tiles with different terrain types on it. You can see an example of its use in the screenshots.

Environment Textures

Environment textures are things like rain, clouds, fog, and that big-assed tree thing in the sky.

The scene dump shows, e.g.:

environment YggdrasilBranch has 1 MeshRenderers:
MeshRenderer name: branch
mr branch has 2 materials
yggdrasil_branch (Instance):
properties:
_MainTex yggbark_d
_BumpMap yggbark_n
_EmissiveTex yggdrasil_emissive
_MossTex ygg_moss
_EmissiveMaskTex yggdrasil_emissivmask
_RefractionNormal
yggdrasil_branch_leafs (Instance):
properties:
_MainTex ygg_leaf_d
_BumpMap ygg_leaf_n
_EmissiveTex
_MossTex
_EmissiveMaskTex
_RefractionNormal

So, as mentioned above:

environmentrenderermat_branch_yggdrasil_branch (Instance)_MainTex.png

will replace the main texture on the yggdrasil_branch (Instance) material on the branch renderer, on the YggdrasilBranch environment object.

Special Locations

Location prefabs are separate from the rest of the game models, so must be handled separately. They have a lot of renderers, so they can take a lot of time to iterate through. For this reason, you can disable location replacement in the config. Also, locations must use the location prefix (texture_ will have no effect).

Layers

Layers allow you to apply a partial texture on top of an existing or modified texture. For everything but sprites, this works in the same way:

Texture Layers

To add a layer to anything but a sprite sheet, use the same syntax as if you were replacing that type of texture in the appropriate section above and add _<YourLayerName> to the end. So, for player eye texture of a mod called RealEyes, it would be:

player_model_0_MainTex_RealEyes.png

<YourLayerName> can be set to whatever you want, as long as it is unique and does not contain any underscores.

Sprite Layers

Sprite layers for the item icons sheet work differently, overwriting a patch of the sprite sheet completely. As a result, the sprite layer png should only be the size of the patch you want to replace. The file format for item icons layers is as follows:

atlas_item_icons_<startX><startY><sheetWidth>_<sheetHeight>.png

This is because you may be working with upscaled textures, so you need to let the mod know how big the theoretical sheet you are working with is. The mod will compare it to the existing sheet (or sheet replaced by another texture) and figure out the scale of your layer texture from that. So, to replace the wooden shield texture, for example, I use a 64x64 pixel png called:

atlas_item_icons_1224_1840_2048_2048.png

This tells it that my png is from a sheet 2048x2048 pixels big (equal to the vanilla sheet size) and to replace the existing sheet with my 64x64 pixel png starting with pixel 1224x1840 as the top left corner.

Examples

Let's take an example from the scene dump:

object VikingShip has 1 SkinnedMeshRenderers:
SkinnedMeshRenderer name: sail_full
smr sail_full has 1 materials
sail (Instance):
properties:
_MainTex sail_diffuse
_BumpMap sail_normal
_EmissiveTex
_MossTex

You can choose which prefix and identifier to use, based on what you want to do:

1. Set All Textures on an Object Type

object_VikingShip_MainTex.png

This replaces the main texture of every material in the object, so if an object uses multiple textures it probably won't work well. This wouldn't work well for our example, as there are a bunch of MeshRenderers on the ship as well. If we want to change the bump map, we can use:

object_VikingShip_BumpMap.png

2. Set All Instances of a Texture

texture_sail_diffuse_MainTex.png

This replaces all textures that have the name sail_diffuse, so every object that uses that texture should be affected. For our example it would replace the
sails on other ship types as well if they use that texture.

3. Set a Texture for a Single Mesh On an Object Type

objectrenderer_VikingShip_sail_full_MainTex.png

This will replace the texture of any renderer named sail_full on all VikingShip objects.

4. Set a Texture By Name On an Object Type

objecttexture_VikingShip_sail_diffuse_MainTex.png

This will replace any texture named sail_diffuse on all VikingShip objects.

4. Set a Partial Texture Layer

Any of the above examples could alternatively be added as a partial layer by adding a layer name on to the end. So if you just want to add a decal onto the sail of the viking ship, you could do:

objecttexture_VikingShip_sail_diffuse_MainTex_CoolSkullAndCrossBones.png

Config

A config file BepInEx/config/aedenthorn.CustomTextures.cfg is created after running the game once with this mod).

You can adjust the config values by editing this file using a text editor or in-game using the Config Manager.

Scene Dump

To get all the information you need to make the names above, set the config option DumpSceneTextures to true, then run the game and load into your world once. A file BepInEx/plugins/CustomTextures/scene_dump.txt should be created. You can set it back to false after you've dumped the textures, otherwise it will recreate the file every time you run the game.

This mod is still a work in progress.

Known Issues

Code was commented out to prevent the previous game error, unknown if this affects textures for clutter.

Line 59 of TextureReplacement.cs

foreach (ClutterSystem.Clutter clutter in ClutterSystem.instance.m_clutter) { if (!gos.Contains(clutter.m_prefab)) gos.Add(clutter.m_prefab); }

Configuration

  • A config file BepInEx/config/cjayride.CustomTextures.cfg is created after running the game once with this mod.

CHANGELOG

v3.4.1

  • Re-added debug mode, so you can troubleshoot in the console

v3.4.0

  • Fixed error on game launch:

[Error : Unity Log] NullReferenceException Stack trace: UnityEngine.Object.get_name () (at <ab14d35a27c043688812ae199c64b5aa>:0) CustomTextures.BepInExPlugin.ReplaceZNetSceneTextures () (at <4f58ae4f8c024c99aa4fe665f2805126>:0) CustomTextures.BepInExPlugin+ZNetScene_Awake_Patch.Postfix (ZNetScene __instance, System.Collections.Generic.Dictionary`2[TKey,TValue] ___m_namedPrefabs) (at <4f58ae4f8c024c99aa4fe665f2805126>:0) (wrapper dynamic-method) ZNetScene.DMDZNetScene::Awake(ZNetScene)

v3.3.4

  • Fixed the MonoMod assemblies error

v3.3.3

  • Attempt to fix MonoMod bug

v3.3.2

  • Missed an update from "aedenthorn" in file TextureReplacement.cs

v3.3.1

  • 2 changes (commits) by "aedenthorn" on Aug 22, 2023 and Aug 23, 2023