HomeDiscordGitHub
Edit

NPV: Photomode (formerly Nibbles Replacer)

How to add your NPV to Photomode's list of spawnable characters

Summary

Published: Oct 30 2023 by @manavortex Last documented update: January 4 2025 by @nutboy

This page shows you how to add your NPV to Photomode's spawnable character list. It is part of the guide for creating an NPV - V as custom NPC .

Wait, this is not what I want!

  • If you want to update your custom pose packs to work with photo mode NPCs, check ArchiveXL: adding Photo Mode Poses

  • If you want to add more appearances to vanilla photomode NPCs, check xBaebsae's tutorial

  • If you are trying to make or edit a NPV Nibbles replacer, read on. Nibbles Replacer is no longer compatible as of patch 2.2, and this guide will show you how to make a new Photomode NPV.

Nibbles Replacer and Photo Mode

This is a history lesson. If you don't care, skip straight to How to create a Photomode NPV.

You don't need to install any of the mods mentioned below if you don't want to.

With 2.2, CDPR added up to three spawnable Photo Mode NPCs. Before that, you could only spawn Nibbles the cat — and modders took full advantage. The result was the Nibbles Replacer, a mod by xbaebsae.

What did the Nibbles Replacer do?

By integrating the Photo Mode with Appearance Menu Mod, modders tricked the game into believing that NPCs were valid alternate appearances for Nibbles the cat.

What does the new photo mode do?

  • Adds up to 250 new spawnable NPC to the character list (this number has yet to be tested)

  • Spawn different kinds of NPVs without exiting Photomode and managing Nibbles "slots"

  • Switch NPC appearances directly in photo mode

  • NPC now can spawn props and weapons if a pose has them

How to create a Photomode NPV

Requirements:

minimum version

Cyberpunk 2077

Game version 2.2

ArchiveXL

1.19 or newer

Wolvenkit

Wolvenkit > 8.15.1, Nightly published after Jan 25 2025

Optional: PhotomodeEx

1.0

Prerequisites:

Optional: Adding your NPV's files to a new Wolvenkit project

If someone else made your NPV and you don't have the original Wolvenkit project, or you're scared of fucking up your existing NPV project, you can create a new Wolvenkit project and add the necessary files from your Mod Browser.

Here's how:

  1. Open Wolvenkit and create a new project. Avoid using special characters such as ! or #

  2. In your new project, open the Asset Browser. Toggle the Mod Browser button to on.

  3. Scroll down to your installed NPV's mod folder. Note: Mod files are in alphabetical order of archive name, but split into two sections for capitalized archive names and lowercase archive names.

  1. Open the NPV mod folder. Locate both the .app and the .ent file. Double click to add them to your project. Note: You may have an .app for a Nibbles replacer as well as your NPV's regular AMM app. Use the AMM app (not the Nibbles replacer app) if you want to keep your character's appearance names.

When you are done creating the photo mode files, you can delete the .app and .ent files you added. (Don't worry, the guide will show you a reminder)

After you are done creating the photomode files, you can combine the projects by merging their source folders in the Windows Explorer.

Step 1: Create photo mode files

If you made any mistakes, you can simply repeat the process. Either delete the files that you want to regenerate, or check the Overwrite Existing File box in the dialogue.

1. Open your NPV's project in Wolvenkit

2. Open the dialogue

Click on File > Add Files > Add Photomode Files. &#xNAN;If the command stays disabled, restart WolvenKit

2. Fill out the dialogue

Wolvenkit will pre-fill everything based on your project name and your file names, but you can still customize the options. (Keep reading)

  1. Double-check the NPC name, as Wolvenkit guesses it from your project and file names and you will see it every time you spawn your NPC in the photo mode picker. Remove any special characters from the file names.

  2. Make sure that the right .app and .ent file are selected (if multiple of those are in the project, Wolvenkit can't tell which you want) &#xNAN;Note: You may have an .app for a Nibbles replacer as well as your NPV's regular AMM app. Use the AMM app (not the Nibbles replacer app) if you want to keep your character's appearance names. \

  3. Next to NPC Name, select the body type of the character you're adding from the drop down. (Selecting the wrong one may lead to horrors.)

  4. When you click "Finish", Wolvenkit will generate everything you need to spawn a photo mode NPC. You should now see something like this (Project browser's source tab):

If you created an extra project just for photo mode:

Do not delete the new _photomode.app and _photomode.ent!

Delete the original .app and .ent file (they are a part of your NPV's mod, you don't need them in this mod as well).

You are done creating your photo mode files! You can now head to Step 2: Install your Photomode NPV.

If you want to know more about the process, feel free to expand the boxes below.

Wolvenkit just did the following things for you:

Created your_modder_name\photomode\npc_name_photomode and added the following files:

  • Create an icon: It added the .inkatlas and the .xbm texture it uses, and connected them (we'll customize it in Step 3: Add a custom icon for your character)

  • Create a photomode .ent file: It created a copy of your original .ent file, then configured it to use the NPC animations required by photo mode

  • Create a copy of your original .app file and registered it in the photomode .ent. In this file, your character's Facial animations have been configured to be photo mode compatible (including xBaebsae's Photomode expression pack)

  • Create a .json: For photo mode to know your NPC's name, it needs a translation file

Added the following control files under resources:

  • .archive.xl: Tells ArchiveXL to load your .json file, and that your .ent file is a photo mode .ent that needs animation support

  • .yaml: Tells ArchiveXL about the photo mode character you're adding, such as the

Step 2: Install your Photomode NPV

It's time to test your Photomode NPV!

  2. Enter Photomode. In the characters tab, you should see a new icon at the very bottom (you might need to scroll) with blue text:

  1. Click the icon and your character will appear!

Step 3: Add a custom icon for your character

In this step, we'll change the blue ICON text to your very own texture.

There is a detailed guide for Textures: Importing, editing, exporting, so this guide will only give you a quick overview.

  2. Click on Export Selected

  1. This will export a PNG to your raw folder:

  1. Open this PNG in Photoshop or an image editor of your choice and update it with an image of your character.

Do not change the size of the image width or height.

How to create a good icon

Check out these articles in the Wiki: Textures: Importing, editing, exporting Game icons: The inkatlas file Custom in-game icons

  1. Save over the PNG in the raw folder. Do not change the file name. You should be able to see a preview of the icon in Wolvenkit when selecting the .png:

  2. Click import selected. It will overwrite the existing placeholder .xbm in your project files.

  3. Select your .inkAtlas file or open it and check the Part Mapping tab to check if your new icon appears:

  1. Press install and check in game to see your new character icon!

Optional: Giving your Photomode NPC Weapons for Poses

Some poses spawn props, and if the pose calls for a certain weapon type (melee, handgun, etc.), it will spawn a default weapon for your NPC. You can customize your NPC further by adding specific in-game weapons to their inventory to spawn instead.

Check "AcceptedWeaponConfig" in Cheat Sheet: Poses/Animations to see a list of the types of weapons that can spawn in poses.

Here's how to give your NPC weapons:

  1. Open your NPC's .yaml

  2. You should see a section like this:

Character.your_characters_name_Photomode_Puppet
  $type: Character
  entityTemplatePath: your_characters_name.ent
  displayName: your_characters_name
  persistentName: PhotomodePuppet
  attachmentSlots: [ AttachmentSlots.WeaponRight, AttachmentSlots.WeaponLeft ]

Add a new line underneath it, and copy and paste this:

  effectors:
    - !append
      $type: AddItemsEffector
      itemsToAdd:
        - item:

  1. Find the record for the weapon(s) you'd like to add to your character's inventory. There are a few ways of doing this:

  2. Check the CET Console commands list. Find the weapon(s) you want (you can CTRL + F to search by name). In the "Command" column you'll see a CET command that reads Game.AddToInventory("Items.Item_Name"), Copy the Items.Item_Name and paste it into your yaml after - item. It should now read:

  effectors:
    - !append
      $type: AddItemsEffector
      itemsToAdd:
        - item: Items.Item_Name

Alternatively, you can search "Items." in the Tweak Browser in Wolvenkit and find your weapons.

  1. If you want to give your NPC more than one weapon, copy and paste - item: to a new line for each weapon you want . Spaces are important, make sure it's in line with the item entry above it. Multiple items registered properly will look like this:

  effectors:
    - !append
      $type: AddItemsEffector
      itemsToAdd:
        - item: Items.Item_Name
        - item: Items.Item_Name
        - item: Items.Item_Name

  1. Save your yaml, check poses with weapons in game to see them.

Troubleshooting

My custom poses aren't working!

If you want to update your custom pose packs to work with photo mode NPCs, check Updating Photomode Pose Packs for 2.2

My NPV isn't showing up in Photomode!

  • Make sure you have AMM's "Photomode Enhancements" turned off in the AMM settings

  • Uninstall Appearance Creator Mod, as of this guide (Jan 4 2024) it's not updated for 2.2

My image texture is completely white!

Check Textures: Importing, editing, exporting -> Importing a texture

PreviousNPV: Cleanup and troubleshootingNextAMM: Custom NPCs

Last updated