Black Knife – Dark Blade Combat

╔════════════════════════════════════════════════════════════════════╗
║              BLACK KNIFE - CRAFTING RECIPES                       ║
╚════════════════════════════════════════════════════════════════════╝

┌─ RECIPE 1: DARK BLADE ─────────────────────────────────────────────┐
│                                                                      │
│  CRAFTING TABLE                                                      │
│                                                                      │
│  ┌───┬───┬───┐                                                      │
│  │   │   │ ⬛ │  (1) Black Shard                                    │
│  ├───┼───┼───┤                                                      │
│  │   │ ⬛ │   │  (2) Black Shard                                    │
│  ├───┼───┼───┤                                                      │
│  │ ⬛ │   │   │  (3) Black Shard                                    │
│  └───┴───┴───┘                                                      │
│                                                                      │
│  OUTPUT:  Dark Blade × 1                                            │
│                                                                      │
└──────────────────────────────────────────────────────────────────────┘

┌─ RECIPE 2: BLACK KNIFE SWORD ──────────────────────────────────────┐
│                                                                      │
│  CRAFTING TABLE                                                      │
│                                                                      │
│  ┌───┬───┬───┐                                                      │
│  │   │   │🔪 │  (1) Dark Blade                                     │
│  ├───┼───┼───┤                                                      │
│  │   │🔪 │   │  (2) Dark Blade                                     │
│  ├───┼───┼───┤                                                      │
│  │⭐ │   │   │  (3) Nether Star                                    │
│  └───┴───┴───┘                                                      │
│                                                                      │
│  OUTPUT:  Black Knife Sword × 1                                     │
│                                                                      │
└──────────────────────────────────────────────────────────────────────┘

╔════════════════════════════════════════════════════════════════════╗
║                    CRAFTING CHAIN SUMMARY                         ║
╠════════════════════════════════════════════════════════════════════╣
║                                                                    ║
║  STEP 1:  Defeat marked enemies                                   ║
║           ↓                                                         ║
║           Get Black Shards (drop)                                  ║
║                                                                    ║
║  STEP 2:  Collect 3× Black Shard                                  ║
║           ↓                                                         ║
║           Craft Dark Blade (Recipe 1)                             ║
║                                                                    ║
║  STEP 3:  Collect 2× Dark Blade + 1× Nether Star                 ║
║           (Kill Wither or raid End for Nether Star)               ║
║           ↓                                                         ║
║           Craft Black Knife Sword (Recipe 2)                      ║
║                                                                    ║
║  FINAL:   ⚔️  BLACK KNIFE READY TO USE                            ║
║                                                                    ║
╚════════════════════════════════════════════════════════════════════╝

TOTAL REQUIREMENTS (Per Sword):
─────────────────────────────────
  • Black Shard × 9 (need to mark & defeat 9 enemies)
  • Nether Star × 1 (Wither drop OR End raid loot)

DIFFICULTY: Mid-game to Late-game
INVESTMENT: Time (farming marked kills) + Combat (Wither/End)

Core Mechanics

Charging System

• Duration: 100 ticks (~5 seconds) of held charge
• Effect: Grants Slowness IV while charging, building momentum
• Reload: 65 seconds between charges
• Bonus: Wielder receives 6-second levitation boost post-charge

Blade Attacks

• X-Slash: Dual-line arc attack dealing 20 damage per line with signature particle effects
• Range: 10-block target radius
• Target Marking: Enemies marked with status for 10-tick debuff window
• Visual FX: Custom smoke particles + heavy sword swoosh audio

Parry Mechanics

• Duration: 60-second cooldown between parries
• Window: 3-second active parry window
• Effect Radius: 5-block parry counter zone
• Damage Output: 100 flat damage to incoming attackers + knockback
• Secondary Effects:
  • Darkness debuff (20-block radius, 5 ticks)
  • Max Slowness amplifier (255) on blocking player
  • Regeneration IV (10-second duration) + health regen
  • Knockback: 4.5 strength, 0.45 vertical component

Block Mechanics

• Heal: +1 health per successful block
• Attacker Penalty: 4.5-strength knockback + 0.45 vertical velocity
• Ready State Knockback: Reduced (0.45 / 0.12) for chip damage prevention

Items

Black Knife (my_sword)

• Main weapon | Wielder-exclusive crafting
• Custom 3D model in crouched and standing poses
• Animated attack sequences
• Full texturing with dark theme

Dark Blade (dark_blade)

• Crafting component | Required for sword assembly

Black Shard (black_shard)

• Material drop | Harvested from defeated marked enemies

Technical Details

• Engine: Minecraft Bedrock 1.26.40+
• Format: Behavior Pack + Resource Pack + Script Module
• Script API: JavaScript ES6 (minecraft/server 2.9.0)
• Namespace: dpf: (Dark_PixelForge standard)
• Dependencies: Vanilla runtime + official server-ui module

Features

✓ Fully scripted combat system (no item modifiers, pure JS logic)
✓ Server-synced HUD (10-tick refresh rate)
✓ Particle layering (2-layer arc rendering)
✓ Custom sound effects (4 unique audio tracks)
✓ Advanced knockback + effect stacking
✓ Dual-pose 3D model rigging
✓ Dynamic cooldown tracking
✓ Marker-based damage windows

Gameplay Balance

• Charge commitment: High risk (locked movement, visible slowness)
• Parry reward: Punishes aggressive play with 100-damage counter
• Mark system: Skill-based target priority mechanic
• Reload timing: Encourages tactical sword swaps
• Cooldown scaling: 65-second recharge prevents spam

Visuals

• Dark fantasy aesthetic (black textures, metallic accents)
• Particle arcs during X-slash combos
• Swoon effect on parry triggers
• Glass shatter audio for impact feedback
• Custom heavy sword swoosh audio

Compatibility

• Multiplayer: Full support (server-synced tracking)
• Survival/Creative: Both modes supported
• Other Addons: Non-conflicting namespace prefix
• Updates: Modular structure for easy feature expansion

Author

Dark_PixelForge
Original development | Precision combat design

---

Installation Instructions

1. Download Black_Knife_V1_Dark_PixelForge.mcaddon
2. Open file with Minecraft Bedrock (auto-import)
3. Create new world → Apply packs:
   • Black Knife (Behavior Pack)
   • Black Knife (Resource Pack)
4. Enable experimental features if prompted
5. Craft sword in survival mode

---

Crafting Recipe

Black Knife Sword Recipe:

• Dark Blade (1x) + Black Shard (2x) → Black Knife

Attack Combos:

• Tap: Single slash (20 dmg)
• Hold (5s): Charge sequence → X-slash (40 dmg dual-line)
• Crouch + Tap: Parry ready (60s CD) → Counter (100 dmg)

---

Known Limitations

• Single sword per crafting (consumable per death)
• Parry requires line-of-sight detection
• Charging prevents sprint/movement
• Darkness effect only visible on affected radius
• Particle rendering scales with chunk distance

---

Version Info

• Current: v1.0.0
• Release Date: [Release Date]
• Tested on: Bedrock 1.26.40+
• Game Modes: Survival, Adventure, Creative