# Raiden Shogun Boss
A fan-made boss fight inspired by the Raiden Shogun (Genshin Impact) for **NeoForge 1.21.1**.
Original model, textures, effects and code. Sounds reuse vanilla Minecraft sound files only.
> Unofficial fan project. Not affiliated with, endorsed by or sponsored by HoYoverse / COGNOSPHERE.
> Genshin Impact and Raiden Shogun are property of their owners. No game assets are used.
## The boss
A 750 HP boss with a hand-built anime-style model (37 bones, 4x-density texture, glowing blade, Electro aura) and 17 animated actions. Every attack is telegraphed and can be dodged.
- **Katana Combo** - three cuts with lunges; the last one breaks shields.
- **Electro Slash** - a crescent of Electro energy that flies across the arena.
- **Dash** - she vanishes, leaves afterimages and strikes from behind or the side.
- **Lightning Strike** - Electro sigils on the ground fill up, then lightning hits.
- **Electro Waves** - chevron lines sweep out from her feet.
- **Musou no Hitotachi (ultimate)** - a 6 x 30 block band tracks you, turns red when it locks, then cuts. Dodge it or block it.
- **Parry and riposte** - she can deflect your hits between attacks; hit her during her recovery windows.
- **Phase 2 at 50% HP** - invulnerable transition, new "Eternity Unbound" boss bar, EX versions of every attack (5-hit combo, double dash, six lightning circles, double ultimate) and a Musou state.
- Smart AI with cooldowns and anti-repeat scoring; handles pillar-camping, hole-trapping, boats, long-range archers and leaving the arena.
- Tuned for **diamond gear** (Protection II, shield, golden apples). A full combo is lethal in iron armor.
- Scales her health up when several players fight her.
- Drops the **Musou Katana** (netherite-tier sword).
## Natural Inazuma shrine (new in 1.1)
- Generates in the world in plains, meadows, forests, flower/birch forests, taiga and cherry groves. Rare (about one per 40 chunks), only on dry, fairly level ground.
- A circular arena (radius 22) with a Mitsudomoe emblem, eight lacquered pillars, a red torii, four cherry trees, and **an offering barrel** with dangos and other goodies.
- Find it with **/locate structure raidenshogun:raiden_shrine**.
- **Respawn:** after she is defeated (or tamed and gone), the shrine gets a new guardian after one Minecraft day, as soon as the chunk is loaded and a (non-spectator) player is within 96 blocks.
- Op commands: /raiden respawn (list), /raiden respawn now.
## Dangos and taming (new in 1.1)
- **Hanami Dango** - craft: 1 stick + 1 sugar + 2 wheat + 1 pink dye -> 2 dangos.
- **Electro Dango** - craft: 1 dango + 1 amethyst shard + 1 purple dye (counts double).
- To tame her: push her to **phase 2**, then **between two of her attacks** right-click her with dangos (3 points needed). Earlier, or mid-attack, she refuses and the dango is kept.
### Companion mode (inspired by Touhou Little Maid)
- Follows you, runs when you run, teleports if you get far away.
- Fights hostile creatures with her real attacks (combo, crescent, dash, lightning, waves; the ultimate once your bond is 60%+). Never hurts you, villagers or animals.
- **Empty hand:** kneel / stand up. **Shift + empty hand:** passive / guard stance. **Dango:** heal and raise the bond.
- She cannot die in combat: at 1 HP she kneels, exhausted, until a dango (or 30 s) gets her back on her feet.
- Players, her owner and golems cannot hurt her. Bond, owner and stance are saved.
## Commands (op level 2)
| Command | What it does |
|---|---|
| /raiden arena [radius] | Builds an arena under you, makes it a rainy night, spawns her |
| /raiden summon | Spawns her in front of you |
| /raiden tame / release | Tames the nearest Raiden / makes her wild again |
| /raiden respawn [now] | Lists / forces shrine guardian respawns |
| /raiden clear | Removes the boss and her effects |
| /raiden debug ... | action, health, freeze, ai, log (testing tools) |
Spawn egg: creative tab "Spawn Eggs".
## Installation
1. Minecraft 1.21.1 with NeoForge 21.1.x (built and tested on 21.1.251), Java 21.
2. Drop the jar in the `mods` folder (client and server).
3. Create a world (structures enabled) and use /locate, or run /raiden arena for a ready-made arena.
## Tested
Played by an automated player-bot in the real game client: spawn, every attack, phase 2, ultimate, death and loot, anti-exploit cases, shrine generation in a normal world, /locate, respawn, taming, following, fighting, kneeling, exhaustion and saving (8 scenarios, 128 checks passed). Not yet tested: multiplayer and dedicated servers.
## Known limitations
- No graphical menu for the companion: everything is right-click and action-bar messages.
- Iron golems may still attack the companion (they cannot hurt her).
- The companion waits when her owner is offline or in another dimension.
- Respawn needs a non-spectator player nearby: a shrine nobody visits stays empty.
- Sounds are vanilla files re-pitched, no custom audio.
## Languages
English and French.
---------------------------------------------------------------------
3. DESCRIPTION (FRANCAIS) - pour une page ou un onglet en francais
---------------------------------------------------------------------
# Raiden Shogun Boss
Un combat de boss fait par un fan, inspire de la Raiden Shogun (Genshin Impact), pour **NeoForge 1.21.1**.
Modele, textures, effets et code originaux. Les sons reutilisent uniquement des fichiers de Minecraft vanilla.
> Projet de fan non officiel. Sans lien avec HoYoverse / COGNOSPHERE, ni approuve ou sponsorise par eux.
> Genshin Impact et la Raiden Shogun appartiennent a leurs proprietaires. Aucun asset du jeu n'est utilise.
## Le boss
Un boss de 750 PV avec un modele de style anime fait a la main (37 os, texture en densite 4x, lame lumineuse, aura Electro) et 17 actions animees. Chaque attaque est telegraphee et esquivable.
- **Combo au katana** - trois coups avec fentes ; le dernier brise les boucliers.
- **Entaille Electro** - un croissant d'energie qui traverse l'arene.
- **Dash** - elle disparait, laisse des images rémanentes et frappe dans ton dos ou sur le flanc.
- **Foudre** - des sceaux Electro se remplissent au sol, puis la foudre tombe.
- **Vagues Electro** - des lignes a chevrons partent de ses pieds.
- **Musou no Hitotachi (ultime)** - une bande de 6 x 30 blocs te suit, rougit au verrouillage, puis tranche. Esquive ou bloque.
- **Parade et riposte** - elle peut devier tes coups entre deux attaques ; frappe-la pendant ses fenetres de recuperation.
- **Phase 2 a 50 % de PV** - transition invulnerable, nouvelle barre « L'Eternite dechainee », versions EX de chaque attaque (combo a 5 coups, double dash, six cercles de foudre, double ultime) et etat Musou.
- IA a scores avec delais et anti-repetition ; gere le camping sur pilier, le piegeage dans un trou, les bateaux, les archers lointains et la sortie de l'arene.
- Reglee pour un equipement en **diamant** (Protection II, bouclier, pommes dorees). Un combo complet est mortel en fer.
- Ses PV augmentent quand plusieurs joueurs la combattent.
- Laisse le **Katana du Musou** (epee de niveau netherite).
## Sanctuaire d'Inazuma naturel (nouveau en 1.1)
- Se genere dans le monde : plaines, prairies, forets, forets de fleurs ou de bouleaux, taiga, bosquets de cerisiers. Rare (environ un tous les 40 chunks), sur terrain sec et peu pentu.
- Une arene circulaire (rayon 22) avec emblème mitsudomoe, huit piliers laques, un torii rouge, quatre cerisiers, et **un tonneau d'offrandes** (dangos et autres).
- Trouve-le avec **/locate structure raidenshogun:raiden_shrine**.
- **Respawn :** apres sa defaite (ou si elle est apprivoisee et partie), le sanctuaire retrouve une gardienne apres un jour Minecraft, des que le chunk est charge et qu'un joueur (pas spectateur) est a moins de 96 blocs.
- Commandes op : /raiden respawn (liste), /raiden respawn now.
## Dangos et apprivoisement (nouveau en 1.1)
- **Dango du Hanami** - craft : 1 baton + 1 sucre + 2 ble + 1 teinture rose -> 2 dangos.
- **Dango Electro** - craft : 1 dango + 1 eclat d'amethyste + 1 teinture violette (compte double).
- Pour l'apprivoiser : fais-la passer en **phase 2**, puis **entre deux de ses attaques** fais un clic droit avec des dangos (3 points necessaires). Avant, ou en pleine attaque, elle refuse et le dango n'est pas consomme.
### Mode compagne (inspire de Touhou Little Maid)
- Te suit, court quand tu cours, se teleporte si tu t'eloignes.
- Combat les creatures hostiles avec ses vraies attaques (combo, croissant, dash, foudre, vagues ; l'ultime a partir de 60 % de lien). Ne te blesse jamais, ni les villageois, ni les animaux.
- **Main vide :** s'agenouiller / se relever. **Shift + main vide :** passive / garde. **Dango :** soigne et renforce le lien.
- Elle ne peut pas mourir au combat : a 1 PV elle s'agenouille, epuisee, jusqu'a ce qu'un dango (ou 30 s) la remette debout.
- Les joueurs, son proprietaire et les golems ne peuvent pas la blesser. Lien, proprietaire et stance sont sauvegardes.
## Commandes (op niveau 2)
Voir le tableau de la description anglaise : /raiden arena, summon, tame, release, respawn [now], clear, debug.
## Installation
1. Minecraft 1.21.1 avec NeoForge 21.1.x (compile et teste sur 21.1.251), Java 21.
2. Mets le jar dans le dossier `mods` (client et serveur).
3. Cree un monde (structures activees) et utilise /locate, ou lance /raiden arena pour une arene toute prete.
## Teste
Joue par un joueur-robot automatique dans le vrai client : apparition, toutes les attaques, phase 2, ultime, mort et butin, cas d'anti-exploit, generation du sanctuaire dans un monde normal, /locate, respawn, apprivoisement, suivi, combat, position a genoux, epuisement et sauvegarde (8 scenarios, 128 controles reussis). Pas encore teste : multijoueur et serveurs dedies.
## Limitations connues
- Pas de menu graphique pour la compagne : tout passe par le clic droit et des messages dans la barre d'action.
- Les iron golems peuvent encore attaquer la compagne (ils ne peuvent pas la blesser).
- La compagne attend quand son proprietaire est hors ligne ou dans une autre dimension.
- Le respawn demande un joueur non spectateur a proximite : un sanctuaire que personne ne visite reste vide.
- Les sons sont des fichiers vanilla re-pitches, pas d'audio original.
