# 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