Crystal Blades — Kristallklingen

Two new Iconic weapons for Cyberpunk 2077, cloned from Satori and Nehan.

Weapons

Kristallschneider (Crystal Cleaver) — Katana

• Base: Satori (Items.Preset_Katana_Saburo_Legendary)
• Retains: Bleeding on hit, all hidden GameplayLogicPackages
• New: Custom name and description

Phantom Splitter — Wurfdolch

• Base: Nehan (Items.Preset_Tanto_Saburo_Retrofix)
• Retains: Thrown hits apply Bleeding, hemorrhaging on already-bleeding targets, health restoration
• New: Custom name and description

Requirements

• TweakXL
• ArchiveXL (for LocKey resolution)
• RED4ext

Installation

Copy the following folders to your Cyberpunk 2077 game directory:

r6/tweaks/crystal_blades/crystal_blades.yaml  → r6/tweaks/crystal_blades/
r6/loc/en-us/crystal_blades.json              → r6/loc/en-us/
r6/loc/de-de/crystal_blades.json              → r6/loc/de-de/

Spawn Commands (CET Console)

Game.AddToInventory("Items.Preset_Crystal_Katana", 1)
Game.AddToInventory("Items.Preset_Crystal_Knife", 1)

File Structure

cp2077-crystal-blades/
├── r6/
│   ├── tweaks/
│   │   └── crystal_blades/
│   │       └── crystal_blades.yaml      ← Weapon definitions (clone Satori + Nehan)
│   └── loc/
│       ├── en-us/
│       │   └── crystal_blades.json      ← English names/descriptions
│       └── de-de/
│           └── crystal_blades.json      ← German names/descriptions
├── archive/
│   └── pc/
│       └── mod/                          ← (future: custom meshes/textures)
└── README.md

How It Works

Instead of building weapons from scratch, this mod clones Satori and Nehan:

1. $base: Items.Preset_Katana_Saburo_Legendary copies the ENTIRE Satori record

   • All hidden GameplayLogicPackages (bleeding, hemorrhaging)
   • All statModifiers from the base weapon
   • All scripts and effectors

2. Only displayName and localizedDescription are overridden

3. LocKeys are resolved via r6/loc/ JSON files (not ArchiveXL)

TODO

• Custom 3D mesh (Blender → WolvenKit)
• Custom textures (ComfyUI — crystal look)
• Custom inventory icons
• ArchiveXL appearance definition (.xl)
• Virtual Atelier store entry