More Colors v1.2.0

Overview

More Colors is a lightweight extension library for YapYap that adds support for custom costume colors, skins, and materials. It provides a clean no-code system that allows other mods to register their own textures or AssetBundle materials using a simple text file. This mod is intended to be used as a base dependency for color and costume packs.

What it provides

• Runtime registration of additional costume colors
• External texture loading from other mods
• Support for custom AssetBundle materials and shaders
• No scripting required to add new skins
• Simple text-based configuration format
• Built-in localization support via YapLocalizer

Dependencies

• YapLocalizer (com.github.darmuh.yaplocalizer)
• BepInEx (BepInEx-BepInExPack-5.4.2304)

Who needs this

All players need this mod if everyone wants to see the custom colors and costumes.

Adding your own costumes

Any mod can define new colors by supplying a PNG texture or an AssetBundle containing a Material.

1) Prepare your asset

• Texture route: Save your costume texture as a PNG file (example: myskin.png)
• Material route: Build an AssetBundle in Unity that contains your custom Material.

2) Place the file

Put the PNG or AssetBundle file inside your own mod plugin folder.

3) Create the config

Create a text file named konami_code.txt in the same folder as your assets.

Configuration format

The config file uses Key: Value lines and is read top to bottom.

Blank lines separate entries.

Supported keys

• Author: Sets the creator name and applies to all entries below it until changed.
• Name: Display name of the costume or color.
• FileName: Exact PNG file name including the .png extension (used for texture swaps).
• AssetBundle: The name of the AssetBundle file containing your material.
• Material: The exact name of the Material inside the AssetBundle to apply.
• Language-Local: Optional localized display names. Any key containing -Local is treated as localization and routed through YapLocalizer (examples: English-Local, French-Local).

Examples

Example with Textures

Author: Omniscye
Name: Lava
English-Local: Lava
French-Local: Lave
FileName: omnilava.png

Example with AssetBundles (Custom Shaders)

Author: Omniscye
Name: Tron Red
English-Local: Tron Red
AssetBundle: empressshaders
Material: tronred

Preparing a color pack for upload

If you are distributing a color or costume pack that depends on More Colors, include the following and list More Colors as a dependency:

• konami_code.txt
• All referenced PNG textures and/or AssetBundles
• manifest.json
• README.md
• icon.png

Credits

• Made by Omniscye / Empress
• Thanks to darmuh for the localization changes and keeping the system clean and easy to use