NPV: Cleanup and troubleshooting

I'm done, what's next?


Published: May 13 2023 by @manavortex Last documented edit: Mar 02 2023 by @manavortex

Re-path your folder

Why are we doing this?

When packing a mod, Wolvenkit generates an .archive file with the files in your project's source folder. The problem here is that each file can only be modified once.

Assume both you and your friend make an NPV. They made Alice, you are making Bob. And because your friend was lazy, they didn't complete this step. And since their project is called Alice_NPV.archive, none of your changes will even show!

That's why you'll have to re-path your folder. If you don't, you will ruin someone's day.

You need to re-name the template folders. Unless you want to make more NPVs, it will be enough to re-name tutorial to your_username. Find a full guide to the process under Moving and renaming in existing projects.


My NPV breaks AMM!

That's how you know that you have syntax errors in your NPV's .lua file. Copy the contents of the file into a lua validator, then run the code and make sure to fix all errors.

It's usually missing quotation marks or commas. The tool above will give you a line number. Compare the line with the working template and fix the differences.

If you feel stuck, you can ask ChatGPT โ€“ just tell it that you're trying to fix LUA code, or it won't know the syntax.

My NPV doesn't spawn!

You can't select them in AMM

The error is with your .lua file โ€“ either it's not in the correct folder, or AMM fails to load it.

If you can select the NPV in AMM

If you click on the button, but nothing happens, that means that the game can't find your .ent file. The error is between your .lua and your .ent.

Most likely, the path to the .ent file is not correct. If it is, make sure that it has no upper-case characters.

My NPV turns into someone else if I walk away from them!

That is due to appearance proxies, which are how the game saves performance. If you're using the most recent NPV template project, you shouldn't have any, but if you set up your files from scratch, you'll have to disable the proxy appearance.

Clothes are floating!

For each of the mesh components that aren't moving, expand it and find the skinning entry. Make sure that the bindName points at root:

My NPV loads, but I'm getting a random appearance!

That happens when you're loading an appearance that the game doesn't know about โ€” the problem is between your .lua file and your root entity. The names must match exactly, and must contain not typos or leading/trailing spaces.

If that was not it, double-check the path in your lua file and make sure that it points to the correct .ent file, and not to a backup or backup project.

This particular problem is always between those two files. Other mistakes will have other effects.

Another NPV is showing!

This is the reason for the Re-path your folder section in this guide. If you want more information, read . Otherwise, you can temporarily remove all other NPVs or make sure to complete the re-pathing.

I'm getting errors in Wolvenkit!

It installs, but doesn't launch

Just install the mod via WKit, launch Cyberpunk the way you normally do.

Last updated