﻿MUSHOKU TENSEI CORE
===================

Magic, swordplay, Toki and the Mk-I Magic Armor for Valheim — a fan mod inspired by the isekai novel Mushoku Tensei.

You start at zero and there are no classes. What you practice is what you become: cast spells and your mana deepens, swing a sword and your style grows, push your body and your Toki awakens. Everything is designed to be rewarding without breaking the game.

Modules
-------

Module | What it adds | Required?
MT Core | Mana, Toki (battle aura), meditation, birth talent, body training, caps | Yes
MT Magia | 9 schools, 69 spells, staffs, grimoire, scrolls, Mk-I Magic Armor | Optional
MT Espada | Three sword styles (Sword God, Water God, North God), ranks, secret arts | Optional
MT Paso | Toki Step: near-instant dash with afterimages | Optional

Features
--------

Mana and Toki (MT Core)
  - Mana from day one. It grows the more you spend it. Meditate (H) to train it; sitting (X), fires and beds restore it much faster.
  - Birth talent: normal, great reserve, or the rare Laplace Factor (huge mana… but your body rejects Toki).
  - Toki (levels 1–10) awakens by training hard or surviving close calls: more health (+15 per level), stamina, mana, damage, speed, swimming and a hardened body. Falls never kill you.
  - Toki Mantle (F1): burn mana to ignite your aura — much stronger hits, faster running and swimming, damage absorption.
  - Any hit chops and mines once your Toki is awake.
  - Real training: sword swings (even in the air), hitting trees and rocks, fighting, running, swimming and jumping all make you stronger — with glowing arrows rising when you gain experience.

How to awaken Toki
  - Toki is the aura inside your body. It does not come from magic: it comes from pushing your body.
  - Every physical skill you train (running, jumping, swimming, weapons, blocking…) raises your Body Level. Check it with mt_status.
  - From Body Level 12, every hard effort (training until exhausted) and every close call (surviving with very low health) can awaken your Toki. The chance grows up to 99 % at Body Level 25. A rare 1 % are born with it.
  - Once awake, your Toki level (1–10) grows with Mastery (using your Toki and the Mantle) and is capped by your body: Body Level ÷ 10 + 1.
  - Without Toki you can still train up to +200 stamina and reach Advanced in the sword styles. Saint and above need Toki (level 1+); King, Emperor and God need higher Toki levels and bosses.
  - The Laplace Factor talent can never awaken Toki.

Toki level | What you get
1 | +15 health, +30 stamina, more mana; sword styles can reach Saint
4 | Reflex: Toki flashes on by itself against surprise hits and falls; sword King
6 | Sword Emperor (with the Goblin King defeated)
7 | Natural Toki: a weak Mantle always on
8 | Sword God (with the Seeker Queen defeated)
10 | +150 health, +300 stamina: the peak of the body

Magic (MT Magia)
  - 9 schools: Fire, Water, Wind, Earth, Gravity (rare), Healing, Detox, Barrier and Summoning.
  - Channeling: hold the click to pour mana into a spell. It drains mana fast, but power grows faster than the charge (×3 charge ≈ ×5.8 power, ×5 ≈ ×13). A full charge takes several seconds and a lot of mana. A quick click casts at once; charged projectiles fly straight, travel farther and explode in an area (a circle on the ground shows the blast radius).
  - Highlights: Fireball that turns blue and purple as it charges, Absolute Zero, Chain Lightning, Eikthyr's Lightning, Tornado, Hurricane, Stone Wall and Stone Fortress (1–3 floors by charge), Earthquake, Levitation, Full Heal, Containment Seal that throws chains of light (works on bosses), summons up to a young dragon.
  - Grimoire (F9): all your spells by school, with search and a live damage estimate. Drag a spell onto one of the 9 favourite slots (Alt+1–9); double click to use it.
  - 4 languages: menus and all 69 spells in English, Spanish, Portuguese and Russian, following the game language.
  - Protected bases: destructive magic never damages your buildings.
  - Status resistance: other players resist paralysis and seals according to their Toki and magic rank.

Mk-I Magic Armor
  - Forge the Helmet, Core and Greaves Mk-I, then assemble the full 2.3 m Magic Armor. It moves exactly like your character.
  - Runs on mana: much less damage taken, more health, damage, jump and speed, fast swimming, slow health regeneration. It wears out while active and switches off without mana.
  - Mk-I Shield with magic disruption (cancels a projectile, with cooldown, mana cost and wear) and one-handed Mk-I Cannon that fires red-hot stone bullets and burns out if overused. Both are too heavy to carry alone: they can only be equipped while wearing the Mk-I Magic Armor.
  - Heavy footsteps, camera shake and a crushing landing that damages nearby enemies.

Swordplay (MT Espada) and Toki Step (MT Paso)
  - Three styles: Sword God (first strike, combos), Water God (parries, counters), North God (any weapon, even bare hands).
  - Rank up by fighting well; secret arts; double hits at Emperor and triple hits at God.
  - Toki Step (F3): near-instant dash paid with Toki.

Progression
-----------

Magic ranks

Each school has its own rank. To reach a rank you cast spells of the previous rank of that school. From Saint on, you also need mana Reserve and defeated bosses.

Rank | Casts of the previous rank | Max charge
Beginner | — | ×2
Intermediate | 20 | ×2.5
Advanced | 40 | ×3
Saint | 60 + Reserve + bosses | ×3.5
King | 100 + Reserve + bosses | ×4
Emperor | 150 + Reserve + bosses | ×4.5
God | 250 + Reserve + bosses | ×5

Learning spells

Source | Teaches
Crafting an Apprentice's wand | A random Beginner spell (the easy way to start)
Ranking up a school | You discover on your own a spell of that school your new rank allows
Magic scroll | A spell from Beginner to King you don't know yet
Runic grimoire | An Emperor or God spell
Gravity scroll | The Gravity school (Lighten, Pull, Levitate, Gravity Pressure)

Where to get items

Item | How to get it
Apprentice's wand | Workbench: 5 Wood, 3 Resin, 2 Greydwarf Eye
Apprentice staff | Drop: Greydwarf Elite/Shaman, Skeletons
Adept staff | Drop: Ghost, Draugr, Wraith, Fenring Cultist
Master staff | Drop: Goblin Shaman, Dverger mages
Archmage staff | Drop: Charred Mage
Legendary staffs | Bosses: Aqua Heartia, Azurith, Ignivar, Aurelia, Nihilum, Zefiria (one school each: −35 % cost, +40 % power in it)
Magic scroll | Every boss (100 %), many enemies, or buy it from Haldor (150 coins)
Runic grimoire | Rare drop from magic-using enemies
Gravity scroll | Moder, Yagluth, Seeker Queen, chests, or Galdr table: 3 Dragon Tear, 10 Crystal, 10 Obsidian

Mk-I crafting (Forge level 3)

Item | Materials
Helmet Mk-I (part) | 10 Black Metal, 10 Iron, 3 Crystal
Core Mk-I (part) | 30 Black Metal, 30 Iron, 10 Crystal, 10 Surtling Core
Greaves Mk-I (part) | 20 Black Metal, 20 Iron, 4 Surtling Core
Mk-I Magic Armor | Helmet + Core + Greaves Mk-I. Requires Earth magic at Saint rank to wear.
Mk-I Shield | 15 Black Metal, 15 Iron
Mk-I Cannon | 20 Black Metal, 10 Iron, 5 Surtling Core

Controls
--------

Key | Action
F1 | Toki Mantle (hold: off)
H | Meditate (X: sit and rest)
F3 | Toki Step
Mouse (with a staff) | Click: cast · hold: charge · release: fire
Page Up / Alt+wheel | Next / previous spell
Page Down | Hide spell
F8 | Adventurer's Journal
F9 | Grimoire
Alt+1–9 / Alt+Shift+1–9 | Use / save favourite (or drag in F9)
J / K | Levitate / land (Shift: faster)

All keys can be changed in BepInEx/config/mushokutensei.core.cfg.

Testing: spawn codes and commands
---------------------------------

Open the console with F5 and type devcommands first.

Item | Spawn code
Mk-I Magic Armor | mt_give mk1_armor
Mk-I Shield / Cannon | mt_give mk1_shield · mt_give mk1_cannon
Mk-I parts | mt_give mk1_helmet · mt_give mk1_core · mt_give mk1_greaves
Staffs | mt_give apprentice_staff · adept_staff · master_staff · archmage_staff · water_staff · rock_staff · sylph_staff · tempest_staff
Legendary staffs | mt_give aqua_heartia · azurith · ignivar · aurelia · nihilum · zefiria
Wand | mt_give apprentice_wand
Scrolls / grimoire | mt_give magic_scroll 5 · mt_give gravity_scroll · mt_give runic_grimoire
Command | What it does
mt_learn all | Learn every spell (master: every spell and every school at God)
mt_school_rank <school> <0-6> | Set a school rank (fire, water, wind, earth, gravity, healing, detox, barrier, summoning)
mt_mana [amount] | Fill or add mana
mt_level reserve <0-100> | Set Reserve, Control, Mastery or Meditation
mt_awaken / mt_sleep | Awaken / put to sleep your Toki
mt_talent <normal|greatreserve|laplace> | Change your birth talent
mt_boss defeated_eikthyr | Register a defeated boss
mt_style_rank <sword|water|north> <0-6> | Set a sword style rank
mt_art <1-5> | Learn a Water God secret art
mt_dragon_god on | Force the Dragon God caps (1000 health, stamina and mana)
mt_status · mt_magic · mt_styles | Show your mana, Toki, magic and sword progress
mt_mk1_camera <factor> · mt_mk1_shake <step> [fall] | Adjust Mk-I camera and shake
mt_mk1_shield <size> [offset] [flip] [x y z] | Adjust the Mk-I shield in hand
mt_mk1_cannon <size> [x y z] [x y z] | Adjust the Mk-I cannon on the forearm

Requirements and installation
-----------------------------
  - Install BepInExPack for Valheim and Jotunn.
  - Copy the BepInEx folder from the zip into your Valheim folder (or use Vortex / r2modman).
  - Start the game. Config files appear in BepInEx/config.

In multiplayer, every player must use the same version.

Credits
-------

Built with BepInEx (https://github.com/BepInEx/BepInEx) and Jotunn (https://github.com/Valheim-Modding/Jotunn).

Inspired by Mushoku Tensei by Rifujin na Magonote. This is a fan work, not affiliated with the novel, the anime or their authors.

Bugs and feedback
-----------------

Report in the Bugs tab and attach BepInEx/LogOutput.log.