Skip to content

Repository files navigation

CustomClothingBase

A mod for ACE, Asheron's Call Emulator, that allows for customized colors and other options through modifying the ClothingTable on the server. Huge thanks to Aquafir for the ACE Mod system and for answering my annoying questions on how to get it work.

Installation and Usage

Place compiled files, or extract Release in the CustomClothingBase folder in your ACE Mods folder, typically C:\ACE\Mods\CustomClothingBase\

If it does not already exist, create a json (C:\ACE\Mods\CustomClothingBase\json\) folder within the CustomClothingBase folder. Place all of your custom clothing base JSON files in this folder.

If a ClothingTable entry already exists with the Id you are using, it will attempt to merge your modifications into this (or replace entirely if appropriate). If it's a new entry, it will be added as such and made available to your server. Additioanlly, if a new ClothingTable entry is added a corresponding bin folder will be placed in the CustomClothingBase/stub/ folder. These stub files are almost empty ClothingTable entries with just a ClothingBaseID to trick the server into loading them properly so we can modify them.

Note that due to how the ClothingTable and the ObjDesc system works, players do not need to download any new files or dat updates for these work. These are completely server side and will be invisble to users except for the new looks!

Commands

The following commands are part of the mod.

@clothingbase-export - Exports a ClothingBase entry to a JSON file in the CustomClothingBase mod folder.
Usage:clothingbase-export <ClothingBaseID>, e.g. clothingbase-export 0x10000001(hex value) or clothingbase-export 268435457(decimal value)

@clear-clothing-cache - Clears the ClothingTable file cache.
This will force the ClothingTable to reload; useful to allow you to make changes on the fly while testing or without reloading the server.

Examples

Please see the Examples folder some ideas and examples on how to use this mod.

Miscellaneous

For reference, these are all the different player parts. Note the Tail, Shoulder, Knee, and Elbow parts (17 - 20, 23 - 28) that are rarely -- if ever -- actually used. Have some fun with these!

PartName
0HUMAN_ABDOMEN
1HUMAN_LEFT_UPPER_LEG
2HUMAN_LEFT_LOWER_LEG
3HUMAN_LEFT_FOOT
4HUMAN_LEFT_TOE
5HUMAN_RIGHT_UPPER_LEG
6HUMAN_RIGHT_LOWER_LEG
7HUMAN_RIGHT_FOOT
8HUMAN_RIGHT_TOE
9HUMAN_CHEST
10HUMAN_LEFT_UPPER_ARM
11HUMAN_LEFT_LOWER_ARM
12HUMAN_LEFT_HAND
13HUMAN_RIGHT_UPPER_ARM
14HUMAN_RIGHT_LOWER_ARM
15HUMAN_RIGHT_HAND
16HUMAN_HEAD
17HUMAN_TAIL_SEG1
18HUMAN_TAIL_SEG2
19HUMAN_TAIL_SEG3
20HUMAN_TAIL_SEG4
21HUMAN_HEAD_HAIR
22HUMAN_HEAD_HELMET
23HUMAN_SHOULDER_LEFT
24HUMAN_SHOULDER_RIGHT
25HUMAN_KNEE_LEFT
26HUMAN_KNEE_RIGHT
27HUMAN_ELBOW_LEFT
28HUMAN_ELBOW_RIGHT
29HUMAN_CLOAK_SEG1
30HUMAN_CLOAK_SEG2
31HUMAN_CLOAK_SEG3
32HUMAN_CLOAK_SEG4
33HUMAN_CLOAK_SEG5

Feedback

Please use or the issues here or join the ACEmulator Discord

About

A mod for ACE, Asheron's Call Emulator, that allows for customized colors and other options in equippable items.

Topics

Resources

Stars

3 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages