⚔️ Mushoku Craft — Hardcore RPG Overhaul inspired by Mushoku Tensei

"Mastery over numbers. Skill over grind."

Mushoku Craft is an ambitious, hardcore RPG total-conversion mod for Minecraft inspired by the universe of Mushoku Tensei (Jobless Reincarnation). It completely reimagines combat, magic, crafting, and world exploration — replacing vanilla grind with systems that reward player skill, knowledge, and mastery.

You start as nobody — no magic, no sword techniques, nothing. Every ability must be earned.

---

🔮 Magic System

• 4 Schools of Magic — Water, Fire, Earth, Wind — each with independent mastery progression
• Spell Learning from Books — hold the book, read the incantation, and attempt to learn. Base success rate: 25%. On failure you only lose mana — the book stays
• Fizzle Mechanic — low mastery = chance of spell failure (interrupted cast, wasted mana). Mastery eliminates fizzle
• Silent Casting — at 100% spell mastery, incantation disappears, cast becomes instant, and you unlock Hold-to-Charge (hold to pour more mana into the spell for extra power)
• Mentorship (Multiplayer) — learn spells by standing near a casting master. Students inherit up to 20% of the teacher's mastery as a headstart
• Mentorship (Singleplayer) — learn from NPC masters in Magic Academies (rare world structures)
• Spell Ranks — Elementary, Intermediate, Advanced, and beyond

⚔️ Sword Combat & Touki (Battle Aura)

Three distinct Sword God Styles, switchable via stance menu:

Style	Focus	Signature
🔴 Sword God	Offense	Extended reach, fast attacks, Longsword Light Flash dash
🔵 Water God	Defense	Perfect parry (RMB), counter-attacks, projectile deflection
🟣 North God	Trickster	Debuffs (bleed, slow), blade throwing, unpredictable strikes

• Touki (Battle Aura) — unlocked at high style mastery, activated via radial menu. Continuously drains mana while providing style-specific combat bonuses that scale with mastery
• Sword mastery improves through combat and training on custom dummies

📖 Currently Implemented (v0.4.1 — Alpha 4)

• ✅ Full mana system with passive regen, sleep-based full restore, and configurable HUD (Classic Bar / Dynamic Arc / Hybrid / Minimal)
• ✅ Magic Books (Water, Fire, Earth) with 3D GeckoLib models and spell learning UI, now obtainable as rare loot in standard dungeons!
• ✅ Waterball spell — full cast cycle with incantation text, fizzle mechanic, mastery-based cast time reduction, and silent casting at 100%
• ✅ Fireball spell — explosive fire magic that sets the target area ablaze on impact!
• ✅ Rock Bullet spell — piercing earth magic that scales in speed and damage the longer you charge it!
• ✅ Hold-to-Charge mechanic for mastered spells — projectiles now smoothly sync with your camera direction in 1st-person view!
• ✅ Spell Mastery system fully synchronizes with the R-menu during combat.
• ✅ All 3 Sword Styles with functional stance switching, unique attack modifiers, and custom player animations
• ✅ Water God Parry — perfect parry window, counter-attacks, projectile deflection
• ✅ North God — blade throwing, bleed/slow debuffs, fall damage reduction with Touki
• ✅ Sword God — increased reach & attack speed
• ✅ Touki (Battle Aura) — per-style bonuses (damage, defense, speed/jump), mana drain, toggle via radial menu
• ✅ Fire, Earth, Wind spell schools
• ✅ Fabric compatibility

🗺️ Roadmap

🔜 Coming Soon

• 📕 Bestiary — scan defeated monsters to study their weaknesses and unlock damage bonuses
• 🌿 Herbalist Journal — discover and catalog magical plants for alchemy
• ⚗️ Intelligent Alchemy — no levels, pure player skill. Mortar & Pestle + Alchemy Cauldron with timing-based mini-games
• 🔨 Modular Weapon Forging — assemble unique weapons from Blade + Hilt + Monster Core on a Magic Anvil. Forging mini-game determines quality. Name your creation
• 🏛️ Magic Academies & Sword Dojos — rare generated structures with NPC masters and merchants

🔮 Future Vision

• 🐉 Custom boss mobs (Red Dragon, Orsted) with terrain-destructive AI, area attacks, and spawn zones
• 💍 Magic accessories (mana regen rings, amulets)
• 🌍 Full world generation overhaul with biome-specific magic creatures
• 🎓 Advanced mentorship system for multiplayer communities

---

📋 Technical Info

Minecraft	1.21.1
Mod Loader	NeoForge 21.1+
Java	21
Required Deps	GeckoLib 4.6.6, PlayerAnimator 2.0.4, Cloth Config, Architectury API
Optional	MmmMmmMmmMmm, Better Combat 2.3.2

---

🤝 We're Looking For Contributors!

Mushoku Craft is an open community project and we need YOUR help to bring the Six-Faced World to Minecraft!

We are actively looking for:

🎨 3D Modelers (Blockbench / GeckoLib)

• Custom mob models (Coati, Giant Frog, Stone Golem, Red Dragon, Orsted)
• Weapon and item models (modular swords, staves, alchemy equipment)
• Structure interiors (Magic Academies, Sword Dojos)
• Animated models with GeckoLib integration

☕ Java Developers (NeoForge)

• Combat systems & AI programming
• World generation (structures, biomes)
• Networking & multiplayer systems
• GUI/HUD development

🎵 Other Roles

• Texture Artists — mob textures, item sprites, UI elements
• Sound Designers — spell SFX, combat sounds, ambient audio
• Translators — help localize the mod to more languages

Interested? Join our Discord: DISCORD

---

📜 License

All Rights Reserved — please contact us before distributing or modifying.