Changing NPCs - Tweak edit (REDMod)

Changing NPC's info on scan and its archetype.

Created & Published: October 19 2023 by daemon2077 Game Version 2.01

This tutorial will show you how to use REDmod to edit an NPC's TweakDB record, changing their info when scanning them with your Kiroshis. In this tutorial we will edit Panam

If you want to learn more about the Tweak database, check TweakDB: Game database.

Prerequisites

• the free REDMod DLC (you can get it here)

• An IDE to edit .json files. I prefer Visual Studio Code, but you can also use Notepad++

Preparation

Since we are using REDmod, we need to structure our project accordingly.

1. Open your Cyberpunk 2077 game directory in the Windows Explorer.

2. Find the folder mods. If it doesn't exist, create it.

3. Inside mods, create a folder for your custom mod — call it however you want. For this tutorial, we will name ours "example mod"

4. Inside your mod folder, create an empty text file with the name of info.json. This file will tell Cyberpunk how to load your mod.

5. Copy the following template and paste it into your empty file:

{
  "name": "YOURMODNAME",
  "version": "1.0",
  "customSounds": []
}

1. Inside your mod folder, create the following nested folders: tweaks\base\gameplay\static_data\database\characters\npcs\records\quest\main_characters

2. Copy the following file to the folder main_characters inside your mod directory: Cyberpunk 2077\tools\redmod\tweaks\base\gameplay\static_data\database\characters\npcs\records\quest\main_characters\primarycharacters.tweak

Your mod folder should now look like this:

- example mod
    info.json
  - tweaks
    - base
      - gameplay
        - static_data
          - database
            - characters
              - npcs
                - records
                  - quest
                    - main_characters
                        primarycharacters.tweak

Editing the .tweak file

To make changes inside, find an NPC with the properties that you want, and copy/paste the values into the record that you want to edit.

Open primarycharacters.tweak in your IDE and search for "Panam". You will find the following record:

Panam's full character record (as of 2.02

Panam : aldecaldos_grunt2_sniper2_sor22_wa_elite
{
	priority = "SpawnableObjectPriority.Quest";
	tags += 
	[
		"Invulnerable"
	];
	entityTemplatePath = "base\quest\primary_characters\panam.ent";
	reactionPreset = "ReactionPresets.NoReaction";
	isBumpable = false;
	displayName = "LocKey#34412";
	fullDisplayName = "LocKey#34413";
	CName voiceTag = "panam";
	baseAttitudeGroup = "panam";
	archetypeData = "ArchetypeData.SniperT2";
	sensePreset = "Senses.panam_sniper_relaxed";
	relaxedSensesPreset = "panam_sniper_relaxed";
	alertedSensesPreset = "panam_sniper_alerted";
	combatSensesPreset = "panam_sniper_combat";
	skipDisplayArchetype = true;
	fk< StatModifier >[] statModifiers = 
	[
		{
			statType = "BaseStats.BurningImmunity";
			modifierType = "Additive";
			value = 1;
		} : ConstantStatModifier
	];
	primaryEquipment = 
	{
		equipmentItems = 
		[
			{
				item = "Items.Preset_Grad_Panam";
				equipSlot = "AttachmentSlots.WeaponRight";
				onBodySlot = "AttachmentSlots.ItemSlotGenericRanged";
				equipCondition = 
				[
					"WeaponConditions.SniperPrimaryWeaponSniperEquipCondition"
				];
				unequipCondition = 
				[
					"WeaponConditions.SniperPrimaryWeaponSniperUnequipCondition"
				];
			} : NPCEquipmentItem, 
			{
				item = "Items.Preset_Base_Copperhead";
				equipSlot = "AttachmentSlots.WeaponRight";
				onBodySlot = "AttachmentSlots.ItemSlotGenericRanged";
				equipCondition = 
				[
					"WeaponConditions.SniperPrimaryWeaponRangedEquipCondition"
				];
				unequipCondition = 
				[
					"WeaponConditions.SniperPrimaryWeaponRangedUnequipCondition"
				];
			} : NPCEquipmentItem
		];
	};
	statModifierGroups += 
	[
		"NPCStatPreset.VeryHighHealth", "NPCStatPreset.PanamSniperDamage", "NPCStatPreset.FollowerDamageAgainstBosses"
	];
	savable = true;
	bountyDrawTable = 
	{
		bountyChoices = 
		[
			{
				bountySetter = "Factions.NCPD";
				transgressions = 
				[
					{
						localizedDescription = "LocKey#48952";
					}
				];
				reward = "BountyReward.bounty_panam";
			}
		];
	};
}

Properties

We will take a look at some of the properties.

property name	value in Panam's template	explanation
fullDisplayName	LocKey#34413	Which text is displayed in scan tab?
displayName	LocKey#34412	Which text is displayed in dialogues and choices?
archetypeData	ArchetypeData.SniperT2	base template (how she fights)

Changing an NPC's faction

All existing factions are defined in the following file:

Cyberpunk 2077\tools\redmod\tweaks\base\gameplay\static_data\database\factions\factions.tweak

What you need to look for

To change an NPC's affiliation, you will need to add the following line to their template:

fk< Affiliation > affiliation = "Factions.FACTION_NAME_HERE"

Panam works for Arasaka now.

Results

That's, save your work, deploy your mod and hop in the game to see the results.

If you have any questions, you're welcome to join us on discord.