MoreCosmetics
Adds custom clothing/cosmetics to Gamble With Your Friends. Create cosmetic packs with a simple JSON file - supports custom OBJ models, PNG textures, and vanilla model tinting.
模組介紹 作者原文
More Cosmetics
BepInEx library that adds custom clothing/cosmetics to Gamble With Your Friends. Supports custom OBJ models, PNG textures, and vanilla model tinting - all driven by a simple JSON file. Cosmetic packs auto-discovered from plugin folders.
How It Works
- Install More Cosmetics (the library DLL) and at least one cosmetic pack
- Cosmetic packs are just folders with a cosmetics.json - auto-discovered by the library
- Cosmetics are injected into the game's wardrobe at runtime
- All cosmetics are auto-unlocked by default
Creating a Cosmetic Pack
Drop a folder in BepInEx/plugins/ with:
MyCosmetics/
├── cosmetics.json ← required - defines your cosmetics
├── models/ ← optional -.obj files from Blender
└── textures/ ← optional -.png texture files
cosmetics.json Format
[
{
"name": "Blue Floral Shirt",
"type": "Clothing",
"rarity": "Rare",
"description": "A lovely floral shirt.",
"model": { "vanilla": "Shirt 1" },
"tint": [0.2, 0.5, 1.0]
},
{
"name": "My Custom Hat",
"type": "Hat",
"model": { "obj": "my_hat.obj" },
"texture": "my_hat.png"
}
]
| Field | Default | Description |
|---|---|---|
| name | (required) | Display name in the wardrobe |
| type | (required) | Hat, Hair, Mustache, Beard, Neckwear, Clothing, Facewear |
| model | (required) | { "vanilla": "Name" } to clone a vanilla mesh, { "obj": "file.obj" } for a custom OBJ, or { "bundle": "file.bundle", "asset": "Name" } for an AssetBundle |
| rarity | Common | Common, Uncommon, Rare, Epic, Legendary |
| description | "" | Tooltip text |
| texture | "" | PNG filename in textures/ |
| tint | [1,1,1] | RGB color multiplier (used if no texture) |
| shader | "" | Custom shader name (blank = game default) |
For Mod Creators: Blender Workflow
See tools/README.md for the full workflow: Unity FBX export → Blender UV remap & paint → OBJ/PNG export → JSON entry.
Dependencies
- BepInEx Pack
Config
BepInEx/config/com.morecosmetics.injector.cfg:
| Setting | Default | Description |
|---|---|---|
| Enabled | true | Master toggle |
| AutoDiscover | true | Scan all plugin folders for cosmetics.json |
| AutoUnlockModCosmetics | true | Auto-unlock all loaded cosmetics |
| CosmeticIdStart | 10000 | Starting ID range |
Build
Build library
dotnet build -c Release -p:GameDir="D:\Steam\steamapps\common\Gamble With Your Friends"
Build example pack
dotnet build -c Release ExampleCosmetics/GWYF-ExampleCosmetics.csproj -p:GameDir="..."
License
MIT
安裝與使用 安裝：按包內說明操作
- 解壓本站下載的壓縮包，先讀包內的 readme / 說明檔案。
- 多數模組依賴遊戲的模組載入器：常見做法是用社群模組管理器（如 r2modman）選中本遊戲安裝，由管理器自動處理載入器與依賴。
- 手動安裝時，把模組檔案放進遊戲目錄下對應的 Mod / plugins 資料夾。
- 啟動遊戲確認載入成功；帶「前置依賴」的模組需要把依賴一併安裝。
不同模組的安裝位置差異較大，包內說明是最可靠的依據。
下面這些內容需要先安裝，否則該模組不會生效：