NPCs & player models
NPC record catalogue
Search 6,582 Character records, copy spawn IDs and inspect appearances and compatibility warnings.
On this page3 sections
TweakDB Β· Game 2.31
Explore NPC records
IDs are extracted, not certified. Review the warnings and test your chosen record in game.
// NPC catalogue loading...
Browse 6,582 Character.* records from Cyberpunk 2077 2.31, including Phantom Liberty. The index describes game data, not guaranteed multiplayer compatibility. The downloadable CSV also includes 86 internal TEST.* records, which the spawn API does not accept. Custom Character.* records require their assets on every client.
Use a record
Pass the exact record ID to the server, not the entity template path or its hash:
-- Server manifest: permission "world.npcs"
local id, reason = Open77.npcs.create({
record = "Character.cpz_maelstrom_grunt1_ranged1_lexington_wa",
position = { x = 381.0, y = -2400.0, z = 182.0 },
behavior = { combatEnabled = false, voiceEnabled = false },
})
if not id then print(reason) endCreating an ID does not confirm that the body spawned. Check readiness and spawn-failure events as explained in Server-owned NPCs. For passive characters, task control and silent NPCs, read AI, combat and voice control.
Understand the warnings
The extraction classifies records structurally, not through in-game testing:
| Classification | Meaning |
|---|---|
| Candidate | A starting point for testing; not guaranteed to work or be damageable. |
| Quest / scene | May require quest setup, special graphs or invulnerability settings. |
| Special rig | Animals, robots, photo-mode and other nonstandard rigs need extra care. |
| Vendor | May depend on vendor-specific setup. |
| Child | Special child records; not ordinary combat NPCs. |
| Player | Player-body records; not ordinary NPC spawn candidates. |
| Missing template | No entity template was resolved by this extraction. |
An appearance is not a record ID. Appearance names and entity paths help investigate assets;
they do not certify rig compatibility. Reusing a quest character for armed combat can be unsafe.
The tweakdb_ep1.bin source describes the extracted database, not a reliable per-record DLC
requirement: it also contains base-game entries. Ensure the record and assets exist on every
observing client. This catalogue excludes third-party mod archives.
Download the data
Use the compact JSON catalogue for tooling and agents, or the complete extraction CSV for all raw fields. The JSON records the game version, source path and CSV SHA-256 so tools can identify the exact dataset.
Open77.npcs.templates() still returns the small set of legacy aliases, not this catalogue.
Neither the catalogue nor an alias registration is required to spawn a valid Character.* record.
// For agents & LLMsthis page as Markdownllms.txtllms-full.txt