NPV: AMM Nibbles Replacer
How to make your NPV work with the AMM Nibbles Replacer
This guide is part of the guide for creating an NPV - V as custom NPC. It will teach you how to make your NPV compatible with xBaebsae's awesome Nibbles to NPCs 2.0 mod, letting you use your NPV in the game's photo mode.
Requirements:
minimum version | |
---|---|
the latest version compatible with your game | |
>= 3.5 | |
an NPV as per the tutorial |
You can find the original instructions in the mod description under Creating an NPC+/NPV Replacer inside the spoiler tags.
If you experience floating clothes, try switching appearances. Often, that resolves the issue. If not, you can check Appearances: change the looks for how to copy the correct components.
Compatibility: NPV < 2.0.0
For NPV projects >= v2.0.0 (30. October 2023), you can skip to #the-photo-mode-.app-file.
For earlier versions, or if you have not been using the example project, you need to add the photo mode animations component.
Download Wkit Project - NPC App from the mod's optional files.
In the .app file, open the first appearance
Open the
components
arrayFind the
entAnimationSetupExtensionComponent
with the name ofPhotomodeAnimations
Copy it to each appearance in your NPV's .app file.
Step 1: The photo mode .app file
You enable the feature by overwriting the dummy .app file for your chosen NPV. Instead of looking up the path in the mod description, we're lazy and overwrite the template file, which we find in the Mod Browser by using the following search query:
If you don't find those files, your AMM Nibbles Replacer isn't installed correctly. You'll want to fix this before proceeding.
Find the file that you want to use, and add it to your project.
If a file name shows up more than once, you already have an NPV with photo mode replacer support installed. In that case, you'll want to pick the other file — there are two for each body type.
Adding support for more than two .app files requires you to edit both the photo mode replacer and AMM, so it won't be covered in this tutorial.
Step 2: Overwrite the file
Instead of the dummy file, you will want to put your own app file there. You can copy the file by holding the ctrl
key while dragging in the Wolvenkit Project Browser.
Step 3: Appearance names
The photo mode replacer assumes that your appearances will be named like this:
For the sake of clarity, the NPV appearances are not named this way. Open the photo mode .app that you copied in the previous step, and change the names of your appearances.
Step 4: Changing the facialsetup graph
For each appearance definition in In your photomode .app file, find the component with the name
face_rig
.Make sure that the
depotPath
is of thegraph
is set to the correct.animgraph
depending on your body gender:
Save the file. You now have photo mode expressions, but no more AMM expressions. Can only have one…
Step 5: Pack and test
After you have changed the appearance names and saved the file, you can install and launch your Wolvenkit project.
Before entering photo mode, select the correct replacer in AMM:
Open the AMM overlay
Switch to Settings -> Photomode Nibbles Replacer
Select the correct replacer corresponding to your file
Step 5 (optional): Edit pose packs
The paths that you need to replace are in the mod description under Adding your Pose Packs to Nibbles Replacer inside the spoiler tags. For your convenience, there's a duplicate in the expandable box below. If that's not working, please check the mod description!
To add more compatibility to a pose pack, you only have to edit the mod's .xl file, which you can do with a text editor. An entry looks like this:
There might be one or multiple entries for each supported .ent
file. Find out which entry or entries belong together, then duplicate them and replace the paths with the one to your NPV replacer's .ent file.
Make sure that you keep the indent at the beginning (the number of spaces) exactly the same as it is for the other entries, or the file will break. If that happens, you'll see an entry in the .
To make sure that your file is okay, run it through yamllint.
Troubleshooting
(Most of) my NPV isn't moving in photo mode!
Force a refresh - select a different pose.
If that isn't working, refresh the appearance:
Open the AMM overlay
Switch to the Tools tab
Click the
Target Replacer
buttonIn the
scan
tab or the target tools, assign a different appearance. You can switch back right away.
Last updated