-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathcss-description.bbcode.txt
More file actions
125 lines (91 loc) · 8.36 KB
/
Copy pathcss-description.bbcode.txt
File metadata and controls
125 lines (91 loc) · 8.36 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
[center][img]https://raw.githubusercontent.com/ngodn/CustomShellSystem/main/docs/media/v0.1.1/css-nexus-header-v2.png[/img][/center]
I built Custom Shell System to let you change your appearance without changing your shell's abilities. Pick an outfit, choose a variant, adjust its colors and save the looks you want to keep.
[b]CSS is the wardrobe system. Install UE4SS and CSS outfit packages separately.[/b] The outfits in the screenshots are not included in this download.
[size=4][b]What you can do[/b][/size]
[list]
[*]Browse your installed outfits in a scrolling list, with mouse and controller support.
[*]Switch outfit variants, use preset palettes or adjust individual parts with RGB sliders.
[*]Mark favorites and save named appearance templates.
[*]Rotate, zoom and frame the character in the game's own Inventory preview.
[*]Restore your original appearance or reset an outfit's colors.
[/list]
Available variants and color controls depend on the outfit package. CSS saves your choices separately from the game save. You do not need to unlock all shells, weapons or seals.
[size=4][b]Install[/b][/size]
[list=1]
[*]Close the game.
[*]Install [url=https://www.nexusmods.com/mortalshell2/mods/45?tab=files]UE4SS for MS2 by Framecore[/url]. CSS uses UE4SS v3.0.1-1028-gd7e7826d, included in the verified main-file bundle version 1.1.
[*]Extract the CustomShellSystem folder from the CSS ZIP into MortalShell2/Binaries/Win64/ue4ss/Mods/.
[*]Install your chosen CSS outfit packages into MortalShell2/Content/Paks/~mods/, following each outfit's instructions.
[*]Enter the game world, open [b]Inventory[/b] (default [b]I[/b]) and select [b]CSS[/b]. Choose an outfit, then Wear.
[/list]
Check that the loader is at [b]ue4ss/Mods/CustomShellSystem/dlls/main.dll[/b], without an extra nested folder. Keep each outfit's .pak, .utoc and .ucas files together, with their _P suffixes intact. Restart the game after adding or replacing outfit packages.
[b]Expected folders after extraction[/b]
Extract the [b]CustomShellSystem[/b] folder into [b]MortalShell2/Binaries/Win64/ue4ss/Mods/[/b].
[code]Sparta/MortalShell2/Binaries/Win64/ue4ss/Mods/
`-- CustomShellSystem/
|-- README.txt
|-- THIRD_PARTY_NOTICES.txt
|-- assets/
| `-- inventory-logo-v1.png
|-- core.json
|-- cores/
| `-- css_core-1.0.0.dll
|-- dlls/
| `-- main.dll
|-- enabled.txt
`-- release.json[/code]
Do not put another CustomShellSystem folder inside it. State, logs and caches are generated when needed and are not included in the ZIP.
[size=4][b]Controls[/b][/size]
CSS now sits between Inventory and Tarstones. [b]The old N menu is removed in 0.2.0.[/b] The page shows the controls for your current input device.
[b]Controller[/b]
[list]
[*]LB/RB: switch the main menu tabs. LT/RT: Shell, Color or Templates.
[*]D-pad up/down: browse the left list. Left/right: change the selected variant or color value on the right.
[*]A: wear an outfit, reset a part or load a template.
[*]X: next RGB channel or replace a template. Y: favorite, reset all colors or delete a template.
[*]Right stick left/right: rotate. Up/down: zoom. Left stick: move framing.
[*]Right-stick click: reset view. B: close.
[/list]
[b]Mouse and keyboard[/b]
[list]
[*]I: open Inventory. Q/E: main tabs. Z/X: Shell, Color or Templates.
[*]W/S: browse. A/D: change variant or color value. Space: confirm.
[*]F: next RGB channel or replace template. C: favorite, reset all colors or delete template.
[*]Click rows and action buttons, use the scrollbar, or drag color sliders.
[*]Over the character: right-drag to rotate, scroll to zoom, left-drag to move framing.
[*]Home or Reset view: reset the camera. Esc: close.
[/list]
[size=4][b]Updating and compatibility[/b][/size]
Close the game and replace the CSS runtime files. [b]Keep CustomShellSystem/state/[/b] to retain favorites, saved looks and colors. The ZIP contains no personal state and only one loader and one core DLL.
Install outfits marked as CSS-compatible. Regular mesh replacements do not appear in the wardrobe automatically. Replacers that overwrite the game's base meshes or materials can affect CSS outfits that use those assets.
[b]Existing CSS outfit ZIPs still work.[/b] Keep your Beaute, HIT2, Seductress and other CSS packages installed. Only replace the CSS runtime.
CSS now uses Inventory's character display and lighting. Animation, physics and clipping still depend on the outfit. If you find a problem, send your CSS and UE4SS versions, outfit, gameplay shell, other installed mods and steps to reproduce it. A screenshot or recording helps me track it down.
To remove CSS, close the game and delete CustomShellSystem from ue4ss/Mods/. Outfit packages are separate and can be removed from ~mods if no longer needed.
[size=4][b]For modders: source and converter[/b][/size]
I've made the [url=https://github.com/ngodn/CustomShellSystem]CSS source[/url] and [url=https://github.com/ngodn/CustomShellSystem/blob/main/tools/css_convert.py]Python converter[/url] available on GitHub. The converter accepts cooked Mortal Shell II .pak/.utoc/.ucas files and builds a CSS package with metadata, a thumbnail and optional color recipes.
Clone the repository and use Python 3.14, retoc, repak and your local game files. From the repository folder:
[code]python3 tools/css_convert.py "/path/to/original-mod" --name "My Outfit" --author "YourName" --id yourname.myoutfit --thumbnail "/path/to/thumbnail.png" --game "/path/to/MortalShell2" --retoc "/path/to/retoc" --repak "/path/to/repak" --output "./dist"[/code]
Use a square PNG for the thumbnail; 512 x 512 is recommended. The default output name is [b]CSS_My_Outfit_YourName_P[/b]. Keep the same package ID when updating it.
[b]Some mods need adjustments before they work correctly.[/b] These can include material-slot mappings, missing dependencies, skeleton compatibility and color masks. Alternate source packs can be combined with --variant-sources; author-defined colors use --colors or a recipe for each variant. The converter does not automatically create color regions or fit assets from another game to Mortal Shell II.
The [url=https://github.com/ngodn/CustomShellSystem/blob/main/docs/css-packages.md]package instructions[/url], [url=https://github.com/ngodn/CustomShellSystem/blob/main/docs/porting-variants.md]variant workflow[/url] and [url=https://github.com/ngodn/CustomShellSystem/blob/main/docs/colors.md]color notes[/url] cover the current tools. Test the result in-game before sharing it, and keep the original authors credited.
The [url=https://github.com/ngodn/CustomShellSystem/blob/main/docs/modding/README.md]CSS modding guide[/url] is now available, with a [url=https://github.com/ngodn/CustomShellSystem/blob/main/tools/css_project.py]project utility[/url] for repeatable builds and verified outfit ZIPs. It covers the current package format, mesh variants and color recipes. CSS is still developing; I'll keep the guide updated as the framework settles.
[size=4][b]CSS in-game[/b][/size]
[img]https://raw.githubusercontent.com/ngodn/CustomShellSystem/main/docs/media/v0.2.0/inventory-css.jpg[/img]
Seductress in the new Shell page.
[youtube]O1H3GaDDY2I[/youtube]
CSS menu walkthrough, 1080p / 60 fps.
[img]https://raw.githubusercontent.com/ngodn/CustomShellSystem/main/docs/media/v0.2.0/templates.jpg[/img]
Save and load your own appearance templates.
[youtube]p374pU4fFrU[/youtube]
Seductress showcase, 1080p / 60 fps.
[size=4][b]Credits[/b][/size]
[list]
[*]_eins0fx: CSS development, interface and packaging.
[*][url=https://www.nexusmods.com/stellarblade/mods/1496?tab=description]Custom Nanosuit System by DekitaRPG[/url]: inspiration for the wardrobe features and controls.
[*]UE4SS contributors and Framecore: UE4SS and its Mortal Shell II package.
[*]dantemk2: [url=https://www.nexusmods.com/mortalshell2/mods/161?tab=description]More Beautiful Genessa[/url] and [url=https://www.nexusmods.com/mortalshell2/mods/84?tab=files]BeauteKnightLady[/url], shown as separate outfit examples.
[*]XTGMods: HIT2 DE Scyther.
[*]erase, calcalmon, ducttus and GetJinxyed: BH Proxima, Curvy and Cute Proxima, Long Hair Proxima and Mileena over Tiel, shown as separately installed outfits.
[*]Seductress source credits: Skirbie, dantemk2, Larian Studios and Volno's Lazy Tailor library. I adapted and packaged the outfit for CSS; it is a separate download.
[/list]
[url=https://github.com/ngodn/CustomShellSystem]CSS on GitHub[/url] | [url=https://github.com/ngodn/CustomShellSystem]Source and tools[/url]