Infernal Ruby Greatsword

# Infernal Ruby Greatsword

Wield a massive ruby-and-steel greatsword that burns enemies, steals life and grows
stronger by absorbing boss souls. Charge a heavy diagonal cleave, then unleash a
crescent fire wave through the enemies ahead of you.

The weapon includes a detailed 3D model, animated glowing cracks, ruby blade
trails, spinning crystal shards and original sound effects. Boss souls illuminate
five runes along the blade; a fully empowered pommel pulses like a heartbeat.

## Requirements

- Minecraft **Java Edition 1.20.1**.
- **Fabric Loader 0.19.5 or newer**.
- **Fabric API 0.92.12+1.20.1 or newer for Minecraft 1.20.1**.
- Java 17 or newer. Java 17 is the tested game runtime.

This is a Fabric mod, not a Forge, NeoForge or Bedrock add-on. Install the mod and
Fabric API on both the client and server when playing multiplayer.

## Obtain the sword

Find **Infernal Ruby Greatsword** in Creative → Combat, or use:

```mcfunction
/give @s infernal_ruby_greatsword:infernal_ruby_greatsword
```

Craft rubies at a crafting table: **1 diamond + 4 redstone + 1 blaze powder → 1 ruby** (shapeless).

Craft the greatsword with **3 rubies, 1 netherite ingot and 1 blaze rod**:

```text
· R ·
R N R
· B ·
```

R = this mod's Ruby; N = netherite ingot; B = blaze rod; · = empty.
Recipes unlock in the recipe book when you obtain a diamond, then a ruby.
Rubies are also in Creative → Ingredients. No other ruby mod is required.

## Combat

- **25 base attack damage**, **1 attack per second**, **5,000 durability**.
- Successful damaging hits ignite enemies for **10 seconds**, heal you for
  **30% of actual health removed**, and apply heavy knockback.
- **+100% damage** against recognized bosses and enemies with at least 100 maximum health.
- Held in the main hand: **Strength III (+9 melee damage)**, Fire Resistance and
  **50% knockback resistance**.
- **Tap right-click and release:** Infernal Cleave, a 140° forward arc reaching
  five blocks, with 20 base damage and an eight-durability cost.
- **Hold right-click for 1.5 seconds and release:** up to 40 cleave damage and a
  24-damage fire wave travelling up to 12 blocks. Full-charge cost: 16 durability.
- Both cleaves share a **one-second cooldown beginning on release**.
- Finish non-boss mobs already at **15% health or less** with an execution strike.
- Direct boss kills grant **+10% sword damage per soul**, up to five souls/+50%.
  Empowerment belongs to the individual sword and persists when saved or transferred.

Armor, fire immunity, shields, totems and other defenses still matter. Execution
does not bypass every defense. The wave stops at walls; it does not destroy blocks
or place fire. Your pets and teammates are excluded from cleave targeting, and
server PvP rules apply. Burn kills do not grant boss souls or lifesteal.

The sword is deliberately powerful. Strength raises ordinary melee damage to 34
before further bonuses and defenses; cleave and wave damage use their own values.
Repair it in an anvil with netherite ingots.

## Visuals and sound

Enjoy a weighted carry and charging pose, diagonal swing recovery, reactive
fissures, an enchanted ruby shimmer, lifesteal wisps, execution effects and eight
original sound cues with English subtitles. The model has chipped edges, a
hooked guard, inset ruby fragments and five illuminated soul runes.

Optional nearby lighting brightens terrain without changing world blocks or mob
spawning. It uses normal Minecraft lighting rather than colored light or bloom.

Client commands let you adjust the presentation without operator permissions:

```text
/rubyfx recoil 0
/rubyfx particles 0.5
/rubyfx trails false
/rubyfx lighting false
```

Recoil and particle settings accept values from 0 to 1. Particle density controls
the new shards, wisps and execution effects; Minecraft's own particle setting
also applies. Settings are saved in `config/infernal-ruby-effects.json`.

## Compatibility and feedback

Tested with the standard Fabric Indigo renderer. Sodium, Iris, shader packs and
other animation/combat mods have not been verified. Dynamic lighting may shine
through thin walls and can be disabled independently. No shader pack is required.

Version 1.0.1 includes survival crafting. Twelve automated tests pass, and client
checks cover textures, charge/release, hit/execute/soul events and terrain lighting.
Please report problems in the project comments with your mod version, loader/API
versions, reproduction steps and relevant crash log. Remove personal information
from logs before sharing them.

## Credits and license

Created by **GUTS**.

Custom model and effects were developed for this project. Concept/material art
was created with AI assistance; rune/shard graphics and sound synthesis were
authored programmatically. Built using Fabric and the Fabric example-mod scaffold.
The project uses the included **CC0 1.0 Universal** license.