WECCL
Wrestling Empire Custom Content Loader
Loads custom content for Wrestling Empire.
Current Features
It is currently possible to add:
- Custom music (themes)
- Custom costume textures
It is currently possible to override:
- All music (themes)
- All costume textures
- Most sound effects
- Most world textures
Additional features:
- Automatic remapping of custom content
- Exporting characters as JSON files
Experimental features:
- Importing characters from JSON files (very experimental, likely to cause issues)
Getting Started
Installation (Automatic)
This is the recommended way to install the mods.
- Download and install Thunderstore Mod Manager or r2modman
- Click the
Install with Mod Manager button on top of the page (or install it through the mod manager directly)
- Run the game via the mod manager
Installation (Manual)
To install this mod manually, you first need to install BepInEx 5.4.21 as a mod loader for Wrestling Empire. A guide for this
can be found here.
Wrestling Empire needs the x64 Mono version.
To install WECCL, you simply need to copy WECCL.dll from releases to Wrestling Empire/BepInEx/plugins.
Adding Content
You can add content by inserting images and audio files into Wrestling Empire/BepInEx/plugins/Assets. Any audio file
here will be considered a theme. Image files must either be in a subfolder or prefixed by the costume texture name.
Example: body_material_abc.png or body_material/abc.png (_ before 01 is not required; abc can be anything)
| Supported Texture Names |
| arms_elbow_pad |
| arms_flesh |
| arms_glove |
| arms_material |
| arms_wristband |
| body_collar |
| body_flesh_female |
| body_flesh_male |
| body_material |
| body_pattern |
| face_beard |
| face_female |
| face_male |
| face_mask |
| hair_shave |
| hair_texture_solid |
| hair_texture_transparent |
| legs_flesh |
| legs_footwear |
| legs_kneepad |
| legs_laces |
| legs_material |
| legs_pattern |
Metadata
Metadata files can be used to add additional information to assets, e.g. skin tone. Metadata files must be named the same as the asset, but with the .meta extension.
Example: abc.png and abc.meta.
Meta files must be a newline-separated list of key-value pairs in the format key: value (space is optional).
The following keys are supported:
| Key |
Description |
| skin_tone |
The skin tone of the character. Must be formatted as r,g,b (e.g. 1.0, 0.0, 0.0) or an HTML string (e.g. #FF0000 or red). 1.0, 1.0, 1.0 is the default skin tone (white). 0.75, 0.75, 0.75 and 0.5, 0.45, 0.3 are the two other skin tones used in the vanilla game. |
Meshes
As with textures, meshes can be added by placing them in Wrestling Empire/BepInEx/plugins/Assets. Meshes must be in a subfolder by the mesh name.
Example: body_mesh/abc. The extension must be .mesh or no extension at all.
Meshes should be inside an asset bundle with it being the only mesh in the bundle. The first submesh will be the one affected by the game's mesh color setting. Others can be manually set in the metadata file.
| Supported Mesh Names |
| arms_shape |
| body_shape |
| face_headwear |
| face_shape |
| hair_extension |
| hair_hairstyle_solid |
| hair_hairstyle_transparent |
| legs_shape |
Metadata
Metadata files can be used to add additional information to meshes, e.g. mesh color. Metadata files must be named the same as the mesh, but with the .meta extension.
Example: abc and abc.meta.
Meta files must be a newline-separated list of key-value pairs in the format key: value (space is optional).
The following keys are supported:
| Key |
Description |
| scale |
The scale of the mesh. Must be formatted as x,y,z (e.g. 1.0, 1.0, 1.0). 1.0, 1.0, 1.0 is the default scale. |
| position |
The position of the mesh. Must be formatted as x,y,z (e.g. 0.0, 0.0, 0.0). 0.0, 0.0, 0.0 is the default position. |
| rotation |
The rotation of the mesh. Must be formatted as x,y,z (e.g. 0.0, 0.0, 0.0). 0.0, 0.0, 0.0 is the default rotation. |
| submeshXcolor |
The color of submesh X. Must be formatted as r,g,b (e.g. 1,0, 0.0, 0.0) or an HTML string (e.g. #FF0000 or red). Overriding submesh 0 is not supported, as it is affected by the game's mesh color setting. |
Overriding content
You can override content by placing any image or audio file inside Wrestling Empire/BepInEx/plugins/Overrides
referenced by the internal name. A zip file containing all the overridable files can be found in
the Modding Discord
Exporting Characters
Characters are automatically exported to Wrestling Empire/BepInEx/plugins/Export when the game is saved.
Importing Characters
Characters can be imported by placing a JSON file inside Wrestling Empire/BepInEx/plugins/Import. Make sure to set
the overrideMode property to the desired mode.
append will add the imported character.
override will override the character with the same id.
merge will replace all non-default values of the character referenced by the id.
Imported JSON files will be automatically deleted after the game is saved (unless the config
option DeleteImportedCharacters is set to false).
Uploading mods
You can upload your mods on Thunderstore. In order to do this, you first need to connect either your Discord or GitHub account to Thunderstore and create a team in your account settings (if you haven't already).
Thunderstore uses the following format:
📁ModName.zip
┣📂plugins (required if you want your mod to actually do something)
┃ ┣📂Assets
┃ ┃ ┣📂face_male
┃ ┃ ┃ ┗🖼️face.png
┃ ┃ ┗🔊theme.mp3
┃ ┗📂Overrides
┃ ┣🖼️Fed01.jpg
┃ ┗🔊Theme00.ogg
┣🖼️icon.png (required, 256x256)
┣📃manifest.json (required)
┣📃README.md (required)
┗📃CHANGELOG.md (optional)
* The files in Assets and Overrides are just examples. You can have any number of files with any name and valid extension in these folders. Neither of them is required.
plugins is a folder which contains all the files that your mod needs to function.
icon.png is a 256x256 PNG file which will be used as the icon for your mod on Thunderstore.
manifest.json is a JSON file which must contain the following:
{
"namespace": "IngoH",
"name": "NameOfMod",
"description": "This is a description of the mod.",
"version_number": "1.0.0",
"dependencies": [
"BepInEx-BepInExPack-5.4.2100",
"IngoH-WECCL-(LatestVersion)"
],
"website_url": "(Add GitHub link here, or leave empty)"
}
namespace must be your team name on Thunderstore.
name may only contain alphanumeric characters and underscores (A-Z, a-z, 0-9, _).
version_number must be in semver (semantic versioning) format.
dependencies is a list of dependencies. You can find the dependencies of mod on the Thunderstore page of the mod, listed under "Dependency string".
website_url should be empty, or a link to the GitHub page of the mod or any other page where users can find more information about the mod.
README.md is a Markdown file that will be displayed on the mod page. It should contain the description of the mod, and any additional information that might be useful.
CHANGELOG.md is also a Markdown file that will be displayed on the mod page if it exists. It should contain a list of changes for each version of the mod.
Modding Discord
Join the modding Discord to receive support and talk with other modders and content
creators!
Donations
Donations are always appreciated. You can donate on my Ko-fi page.
Special Thanks
Mat Dickie for generously donating €1,000
All the Discord Testers
Everyone who published mods using WECCL
