v3.0 — Correct mod structure with ArchiveXL localization

Structure:
  r6/tweaks/crystal_blades/crystal_blades.yaml     ← TweakXL weapon defs
  archive/pc/mod/crystal_blades.archive.xl         ← ArchiveXL localization registration
  archive/pc/mod/crystal_blades/localization/
    en-us/translation_strings.json                 ← English
    de-de/translation_strings.json                 ← German

Changes:
- .xl file in archive/pc/mod/ (where ArchiveXL scans)
- Localization JSONs as real files (not inside .archive)
- String keys (crystal_katana_name) in YAML, not LocKey#
- primaryKey: 0 for ArchiveXL auto-assignment
- Clean 1:1 structure — just copy into game dir

README.md

@@ -0,0 +1,49 @@
+# Crystal Blades — Kristallklingen
+
+Two new Iconic weapons for Cyberpunk 2077, cloned from Satori and Nehan.
+
+## Requirements
+- ArchiveXL
+- TweakXL
+- RED4ext
+
+## Installation
+
+Copy the entire folder structure into your Cyberpunk 2077 game directory (or MO2/Fluorine mods folder):
+
+```
+cp2077-crystal-blades/
+│
+├── r6/
+│   └── tweaks/
+│       └── crystal_blades/
+│           └── crystal_blades.yaml          ← Weapon definitions (clone Satori + Nehan)
+│
+└── archive/
+    └── pc/
+        └── mod/
+            ├── crystal_blades.archive.xl     ← ArchiveXL localization registration
+            └── crystal_blades/
+                └── localization/
+                    ├── en-us/
+                    │   └── translation_strings.json   ← English names/descriptions
+                    └── de-de/
+                        └── translation_strings.json   ← German names/descriptions
+```
+
+## Spawn Commands (CET Console)
+
+```
+Game.AddToInventory("Items.Preset_Crystal_Katana", 1)
+Game.AddToInventory("Items.Preset_Crystal_Knife", 1)
+```
+
+## Weapons
+
+### Kristallschneider (Crystal Cleaver) — Katana
+- **Base:** Satori (Items.Preset_Katana_Saburo_Legendary)
+- **Retains:** Bleeding on hit, hemorrhaging, all hidden GameplayLogicPackages
+
+### Phantom Splitter — Wurfdolch
+- **Base:** Nehan (Items.Preset_Tanto_Saburo_Retrofix)
+- **Retains:** Thrown hits apply Bleeding, hemorrhaging on already-bleeding targets, health restoration

archive/pc/mod/crystal_blades.archive.xl

@@ -0,0 +1,6 @@
+localization:
+  onscreens:
+    en-us:
+      - crystal_blades\localization\en-us\translation_strings.json
+    de-de:
+      - crystal_blades\localization\de-de\translation_strings.json

archive/pc/mod/crystal_blades/localization/de-de/translation_strings.json

@@ -0,0 +1,26 @@
+[
+  {
+    "femaleVariant": "Kristallschneider",
+    "maleVariant": "",
+    "primaryKey": 0,
+    "secondaryKey": "crystal_katana_name"
+  },
+  {
+    "femaleVariant": "Ein Katana mit monomolekularer Kristallklinge. Jeder Treffer verursacht unkontrollierbare Blutung — Rüstung ist bedeutungslos.",
+    "maleVariant": "",
+    "primaryKey": 0,
+    "secondaryKey": "crystal_katana_desc"
+  },
+  {
+    "femaleVariant": "Phantom Splitter",
+    "maleVariant": "",
+    "primaryKey": 0,
+    "secondaryKey": "crystal_knife_name"
+  },
+  {
+    "femaleVariant": "Ein Wurfdolch mit monomolekularer Kristallklinge. Geworfene Treffer garantieren Blutung. Wenn das Ziel bereits blutet, verursacht der Dolch innere Blutungen und heilt den Träger.",
+    "maleVariant": "",
+    "primaryKey": 0,
+    "secondaryKey": "crystal_knife_desc"
+  }
+]

archive/pc/mod/crystal_blades/localization/en-us/translation_strings.json

@@ -0,0 +1,26 @@
+[
+  {
+    "femaleVariant": "Crystal Cleaver",
+    "maleVariant": "",
+    "primaryKey": 0,
+    "secondaryKey": "crystal_katana_name"
+  },
+  {
+    "femaleVariant": "A katana with a monomolecular crystal blade. Every strike causes uncontrollable bleeding — armor is meaningless.",
+    "maleVariant": "",
+    "primaryKey": 0,
+    "secondaryKey": "crystal_katana_desc"
+  },
+  {
+    "femaleVariant": "Phantom Splitter",
+    "maleVariant": "",
+    "primaryKey": 0,
+    "secondaryKey": "crystal_knife_name"
+  },
+  {
+    "femaleVariant": "A throwing knife with a monomolecular crystal edge. Thrown hits guarantee bleeding. If the target is already bleeding, the knife causes hemorrhaging and heals the wielder.",
+    "maleVariant": "",
+    "primaryKey": 0,
+    "secondaryKey": "crystal_knife_desc"
+  }
+]

r6/tweaks/crystal_blades/crystal_blades.yaml

@@ -0,0 +1,23 @@
+# Crystal Blades — Kristallklingen
+# Klon von Satori (Katana) und Nehan (Wurfdolch)
+# Alle GameplayLogicPackages, Scripte und Effekte bleiben erhalten
+
+# ============================================================
+# WAFFE 1: Kristallschneider — Klon von Satori
+# ============================================================
+
+Items.Preset_Crystal_Katana:
+  $base: Items.Preset_Katana_Saburo_Legendary
+  displayName: crystal_katana_name
+  localizedDescription: crystal_katana_desc
+  quality: Quality.Legendary
+
+# ============================================================
+# WAFFE 2: Phantom Splitter — Klon von Nehan
+# ============================================================
+
+Items.Preset_Crystal_Knife:
+  $base: Items.Preset_Tanto_Saburo_Retrofix
+  displayName: crystal_knife_name
+  localizedDescription: crystal_knife_desc
+  quality: Quality.Legendary