Valheim Mastery — Public Beta

New features and fixes

• Rewards 2.0: persistent resource bonus progress, new milestones and cape powers, paid production queues, optional Farming resowing, Foraging filters, Sailing bearings and Construction condition views.
• Clearer controls: B toggles saved Quick Prayers; Mastery activates individual cape powers and Apex lists available powers. Active cape effects use native status icons and timers. The XP bar shows the last trained skill.
• Altar and contracts: the Prayer altar uses a native skull with textured materials and moving flames. Draugr contracts award 16–25 base marks according to their required target count.
• Performance: cached cape information avoids repeatedly constructing cape item names and reduces temporary allocations.
• Combat-credit fix: separate host installations of the same world keep independent checkpoints. Update clients and server together. Existing earned XP is retained; historical unapplied credits are not automatically recovered.

Neuerungen und Korrekturen

• Rewards 2.0: gespeicherter Ressourcen-Bonusfortschritt, Meilensteine, Cape-Kräfte, bezahlte Herstellungsfolgen, optionale Nachsaat, Sammlerfilter, Segelpeilung und Bauzustandsansicht.
• Bedienung: B schaltet Schnellgebete; MASTERY aktiviert eine Einzelkraft direkt; APEX öffnet die Auswahl. Native Buff-Symbole zeigen Restzeiten, die XP-Leiste den zuletzt trainierten Skill.
• Altar und Aufträge: nativer Altarschädel, Oberflächen und bewegte Flammen; Draugr-Aufträge geben je nach Zielzahl 16–25 Basismarken.
• Leistung: Cape-Namen werden zwischengespeichert, wiederholtes Zusammensetzen der Namen und temporäre Speicherzuweisungen reduziert. Inventarprüfungen bleiben erhalten.
• Kampf-XP: getrennte Hostinstallationen derselben Welt erhalten unabhängige Checkpoints. Clients und Server gemeinsam aktualisieren. Bestehende XP bleiben erhalten; historische fehlende Gutschriften werden nicht automatisch nachgetragen.

Known validation limits / Prüfgrenzen

The new host-scoped combat-credit protocol has passed 39 focused source checks and the full build, but no native multiplayer acceptance run. The earlier remote-owner combo/refund proof is also outstanding. These are validation gaps, not confirmed current product defects. No universal performance or leveling-time guarantee is made.

Das neue Host-Kampf-XP-Protokoll ist mit 39 gezielten Quellenprüfungen und Gesamtbuild geprüft, aber noch nicht nativ im Mehrspielerbetrieb abgenommen. Der frühere Remote-Kombo-Nachweis steht ebenfalls aus. Das sind Prüfgrenzen, keine bestätigten aktuellen Produktfehler. Keine allgemeine Leistungs- oder Levelzeitgarantie.

Version 0.16.48 · 21 connected skills including Prayer. A new combat progression. Slayer contracts. Mastery Capes.

Inspired by Old School RuneScape (OSRS): level-based progression, mastery capes, Slayer contracts and long-term mastery, adapted to Valheim's survival and co-op gameplay. Valheim Mastery is an independent fan-made mod, not affiliated with or endorsed by Jagex.

Build a character through combat, gathering, production and exploration. Every Mastery skill progresses from level 1 to 100, with unlocks, milestones and a dedicated Mastery Cape. The Apex Mastery Cape combines all Mastery Cape bonuses after mastering all twenty-one skills at level 100. Existing Apex owners retain their grandfathered entitlement.

This is an early public beta with German and English gameplay text. Mastery follows Valheim's language setting; other languages currently use English.

Quick prayers: save up to three compatible unlocked prayers in the Prayer panel, then switch the set together. Blue highlighting marks active effects. Combat, protection and regeneration prayers consume more points; active prayers persist through dungeon and portal transitions.

What is included?

Area	Skills
Combat	Attack, Strength, Defence, Hitpoints, Ranged, Magic
Gathering and wildlife	Mining, Woodcutting, Foraging, Hunter, Fishing
Production	Smithing, Crafting, Farming, Cooking, Alchemy
Exploration and building	Agility, Sailing, Construction
Contracts	Slayer
Prayer	Prayer

• Combat styles, accuracy, max hits and equipment requirements. Accuracy failures become 25% glancing hits; successful parries remain damage-free. Immunities and arrows that physically miss are separate from accuracy rolls.
• Optional Vanilla equipment itemization: persistent crafted and dropped quality with matching weapon, armor, shield and cape bonuses, including six elemental staves. Unique and decorative items keep their separate equipment rules. Native set bonuses, resistances, elemental effects and summons are preserved.
• Optional NPC gear loot: a curated set of ordinary enemies can leave at most one extra equipment item from their progression tier, with stored quality and a chance of an affix. Starred enemies improve the loot chance and quality. Native material and trophy drops remain available; bosses and special reward sources use their own rules. Tamed, bred and player-summoned creatures are excluded.
• Optional Dyrnwyn Perfect Strike: arm the next eligible attack using the SP button. A committed attack costs 50 of a maximum 100 Special Energy and adds an accuracy boost with an optional short fire visual. Dyrnwyn is the only Special weapon in this release. The compact bar appears only with a supported equipped weapon and stays visible at zero energy. See activation instructions below.
• Base stamina, health and Eitr progression; movement and swimming through Agility.
• Resource tiers, production milestones, material-saving chances, farming grids, additional cultivatable plants and natural ore/tree regeneration.
• Hunter carcass processing and lethal baited traps. Bait attracts nearby wild boars and hares within 18 metres; the trap springs on contact.
• Slayer contracts, two-player shared tasks, completion and streak tokens, prestige upgrades, reward crates, weapons and unlockable Monsterbane headgear styles. The three main helmet tiers and their nine color variants share the revised Slayer silhouette, with recessed eye channels and bone-to-metal materials.
• A Runebound Staff with four Eitr-powered Barrage spells and area effects.
• Twenty-one Mastery Capes and eight styles of the animated Apex Mastery Cape.
• Prayer progression with 30 prayers, a buildable altar, trophy and bone-fragment offerings, and Prayer Mead. The Prayer panel is ordered by unlock level, shows each Prayer's bonus and point drain, and accepts touch and controller input. Active Prayer icons show the same details in their status-bar tooltip. The mead base uses the existing cauldron and fermenter; no extra brewing station is needed.
• Collapsible screen-edge tabs for Prayer, Magic, combat styles and senses, with touch and controller input. A successful selection closes its panel. Hold the HUD cursor key to select with the mouse; conflicting game bindings must be reassigned. The vanilla status bar also displays the current combat style, active prayers and sense cooldowns.
• Freeform Construction, building-area projects, work orders and area repair. At level 100, the equipped Construction cape also offers Return home to your own bed set as your respawn point in this world. Alt+F1 with a hammer, or the Construction board button, opens the choice. Area repair remains; each power has its own 6-minute cooldown. Normal world and inventory transport rules apply. Without a valid selected bed, return home is unavailable. Prebuilt village blueprints are temporarily disabled. Saved plans remain dormant; already built pieces are preserved.
• The basic campfire is buildable at Construction 1. With BetterUI installed, enable its customSkillUI setting; Mastery then displays its twenty-one skills in that renderer. The optional Comfort Pack includes this setting.

Install

1. Use a fresh Valheim profile in a Thunderstore-compatible mod manager.
2. Install this package and its declared BepInEx dependency, then launch modded.
3. For the first beta session, use a new character and test world, or back up your character, world and existing mod configuration before loading them.
4. Open the skill window and click a Mastery skill to inspect its milestones.

Built against Windows / Steam Valheim 1.0.16, using BepInExPack_Valheim 5.4.2350. The plugin also accepts 1.0.15. Other operating systems are unverified. See the beta limitations below.

The core mod does not require BetterUI, Jotunn or Equipment and Quick Slots. With Equipment and Quick Slots, the quiver can use additional inventory cells. Without it, equip the quiver by right-clicking it; ammunition stays in the main inventory.

For manual installation, install BepInEx separately and copy this archive's plugins/ValheimMastery/ folder into BepInEx/plugins/.

Progression and configuration

Fresh installations use XP x1. All twenty-one skills share the same thresholds: level 100 requires 1,439,116 XP. Approximately 10 hours of relevant activity per skill is a balancing target, not a measured completion-time guarantee.

Standard progression uses XP x1. Existing custom multipliers and earned progress are preserved. Higher multipliers deliberately accelerate progression. Hitpoints awards are 30% of awarded primary combat XP, including block/parry Defence XP. These are balancing changes, not a measured ten-hour completion guarantee.

After the first launch, close the game and edit BepInEx/config/org.valheim.mastery.cfg:

[Progression]
CombatXpMultiplier = 1

Despite its historical name, this setting controls all Mastery skills and the integrated native/mod skill XP paths. For faster progression, set it to 5. The host controls the multiplayer multiplier. Existing settings are not replaced by this package. The development XP slider is not included in this release.

Enable itemization and Dyrnwyn Perfect Strike

The Thunderstore Core and Comfort packages preserve existing Mastery settings. On a fresh profile, the new itemization and Special options are off by default. After the first launch, close Valheim and set the following keys in BepInEx/config/org.valheim.mastery.cfg, keeping the other settings intact. You can also edit these keys with a compatible configuration manager.

[Prototype]
EnableItemizationI01I04 = true
EnableItemizationEarlyVanilla = true
EnableItemizationMidVanilla = true
EnableItemizationLateVanilla = true
EnableItemizationEndgameVanilla = true
EnableItemizationDefenceVanilla = true
EnableItemizationDirectMagicVanilla = true
EnableNpcGearDrops = true

[Special Attacks]
EnableSpecialAttacks = true
EnableSpecialVisual = true

Use the same Mastery version and gameplay settings on every client and the host or dedicated server, then restart them. Connections with different Mastery versions or combat rules are rejected. The visual switch is local and does not have to match; the host supplies the XP multiplier.

Existing ordinary gear remains neutral, including when upgraded. Newly crafted supported equipment and new eligible NPC gear drops receive an itemization identity; upgrading an item that already has an identity preserves its stored quality. No new keys are assigned automatically: use the SP button through the existing HUD cursor, or configure the optional ArmKey or QuickUseModifier after checking your bindings. The modifier works with your existing primary attack.

EnableNpcGearDrops requires the core itemization switch and the switches for the equipment groups you want in the loot pools. It is off on fresh profiles. Changing this setting does not reroll existing items or previous deaths. Generated gear keeps its stored quality when picked up, transferred or loaded. The curated list does not cover every creature. Loot pools follow the source creature: for example, trolls can yield troll equipment and draugr can yield iron equipment. These are occasional bonus drops. The current base chance ranges from 1.5% to 6.05%, depending on tier and stars; the separate affix chance applies only after an equipment drop succeeds.

Anonymous balancing telemetry is stored locally under BepInEx/ValheimMastery/balancing. It records XP sources, active-time windows, outputs, perk procs and resource/combat samples; multipliers are normalized back to x1 for comparison. It does not transmit data or record player/world names, chat, peer IDs or coordinates. Set Diagnostics.EnableBalanceTelemetry = false to disable future recording.

Existing Mastery progress is retained. Compatible existing vanilla and legacy mod skill levels are imported once where a matching migration exists; new skills begin at level 1. Loading an existing character can perform that migration, so make the backup before the first Mastery session.

Character backups and recovery

Mastery automatically keeps a local backup after a healthy character save. It covers all 21 Mastery skill progressions and their character unlocks, plus Mastery items and equipment with Mastery quality actually held in the character inventory. Item quality and saved properties are retained. Equipped items and Equipment and Quick Slots 3.1.3, including the Mastery quiver, are supported. World chests, graves and separate bag inventories are not included.

If the next healthy load finds a missing or lower saved state, a recovery prompt appears before the old backup is replaced. You can also open Mastery recovery from the inventory. Review the listed skills and items, then choose:

• Review recovery and Confirm loss and recover to restore the listed state. Make room in the ordinary inventory first; recovered items are not auto-equipped.
• Keep current state to accept what the character currently has.
• Later / close to keep the previous evidence and decide another time.

Nothing is restored automatically. A backup cannot observe transfers, consumption or deaths while Mastery is absent. Missing items may still exist in a chest, grave or another player's inventory; confirming recovery could duplicate them. A first backup cannot recreate items lost before the backup existed. Already spent resources, claimed rewards and world-side Slayer accounts are not rolled back. An interrupted confirmed recovery remains blocked for manual review instead of issuing the same items again. Keep its files; do not delete them to force a retry.

Use Show backup folder in the recovery window to find the character's files. They live under MasteryRecovery in the active Valheim save directory and are not automatically synchronized by Steam Cloud. Copy the complete recovery folder along with character saves when moving to another device. A change between local and cloud save sources requires review. Continue keeping full character and world backups separately.

Controls

Key	Action
F1	Cycle combat style
Q	Activate the selected sense
F2	Cycle resource, contract, hunting and fishing senses
Shift + F2	Native connection information
B	Toggle saved compatible Quick Prayers; disabled with building tools
F4	Cycle unlocked rune-focus spells
F5	Open rune spellbook
F3	Cycle unlocked Runebound Staff spells
Hold R	Use the HUD cursor to choose a combat style, sense or prayer; move Valheim's Hide action to T first
Controller view button + shoulder buttons	Navigate the combat-style and sense HUD; south face button activates the focused choice
Controller view button + D-pad up/down	Navigate the Prayer list; east face button toggles the focused prayer
Touch the left PRAYER / GEBET tab	Open or close the Prayer list
Hold R and click SP	Arm or cancel Dyrnwyn Perfect Strike; then use the normal primary attack
Hold middle mouse	Bow/crossbow zoom
Ctrl + F1	Slayer Mastery Cape berserk
Shift + F1	Contextual Mining, Woodcutting or Sailing power
Alt + F1	Contextual Hunter, Construction or Fishing cape power
Alt + Q	Slayer hunting instinct, when unlocked

Controls are configurable. The Apex Mastery Cape keeps the same contextual controls; Q activates only the selected sense. Auto-run is unbound by the mod. The SP button also accepts touch and HUD controller focus when Special attacks are enabled. Controller button labels depend on the selected device layout.

Additional usage / Weitere Bedienung

Hold R, then click the Prayer, Magic, Style, Senses, Mastery or Apex tab. R frees the cursor; it does not automatically open a panel. If bindings conflict, move Hide weapon to T and the emote wheel to Y, or select another HUD key. Successful selections close panels. B toggles the saved prayer set; blue rows show actual active prayers, checkboxes only saved selections. Shift+F3 selects the previous Runebound spell.

R halten und Gebet, Magie, Stil, Sinne, Mastery oder Apex anklicken. R gibt die Maus frei, öffnet aber nicht automatisch ein Fenster. Bei Konflikten Waffe wegstecken auf T und Emote-Rad auf Y oder eine andere HUD-Taste wählen. B schaltet gespeicherte Schnellgebete; blaue Zeilen zeigen aktive Gebete, Häkchen gespeicherte Auswahl. F4 wechselt Runenfokus-Zauber, F5 öffnet das Zauberbuch; Umschalt+F3 wechselt rückwärts.

Input / Eingabe	Action / Aktion
Shift+Use / Umschalt+Benutzen	Cooking station: one paid batch, limited by available slots / Kochstation: eine bezahlte Charge mit freien Plätzen
Ctrl+Shift+Use / Strg+Umschalt+Benutzen	Cooking 75: up to five batch orders / Kochen 75: bis zu fünf Chargenaufträge
Shift+Use / Umschalt+Benutzen	Own fermenter, Alchemy 90: batch planner / Eigener Fermenter, Alchemie 90: Chargenplaner

Mastery directly activates an eligible individual cape power; Construction offers two actions and Apex lists eligible powers. Field repair opens inventory selection and requires 3 seconds stationary,10 seconds out of combat and one explicit recipe metal. Production queues are selected in the crafting inventory and check/pay every order separately, respecting native maximum quality. Optional Farming resowing is toggled through Mastery/Apex and requires cultivator, seed payment and recorded own planting provenance. Foraging filters and Sailing target pins are in skill details; the Construction board shows own-piece condition.

Mastery aktiviert eine berechtigte Einzelcape-Kraft, Baukunst bietet zwei Aktionen, Apex die verfügbaren Kräfte. Feldreparatur öffnet die Inventarauswahl:3 Sekunden still,10 Sekunden kampffrei und ein Hauptmetall aus dem Rezept. Herstellungsfolgen werden im Herstellungsinventar gewählt; jeder Auftrag wird einzeln geprüft und bezahlt, native Maximalqualität gilt. Nachsaat über Mastery/Apex benötigt Kultivator, Saatgut und erfasste eigene Pflanzherkunft. Sammlerfilter und Segelziel stehen in Skilldetails, Bauzustand am Baubrett.

F6–F8 quickslots and F10 BetterUI editing are optional comfort-mod bindings, not Core controls. / F6–F8-Schnellslots und F10-BetterUI-Bearbeitung gehören zu optionalen Komfortmods, nicht zum Core.

Host identity backup / Hostidentität sichern

Also preserve BepInEx/ValheimMastery/combat-host-identity-v2.txt together with the host journals and world backups. Do not delete or regenerate it to reset XP. Copying an entire installation including this identity intentionally retains the same authority; a separate installation receives a separate identity. Character/journal rollback needs an explicit recovery review and does not automatically rebase checkpoints.

Zusätzlich BepInEx/ValheimMastery/combat-host-identity-v2.txt mit Hostjournalen und Welt sichern. Nicht als XP-Reset löschen oder neu erzeugen. Eine vollständig kopierte Installation einschließlich Identität bleibt absichtlich dieselbe Instanz; eine separate Installation erhält eine eigene Identität. Charakter-/Journal-Rollback setzt Checkpoints nicht automatisch zurück.

Multiplayer beta

Every player and the host or dedicated server must use the same Mastery release and matching combat, itemization and Special gameplay settings. Visual effects and keybindings may differ. Use a compatible Valheim version on each machine.

Slayer co-op is explicitly started for two players at the board. Join before the first kill; qualifying nearby participants receive the same Slayer kill XP. Tokens are awarded at completion. Both players must be alive and within the required 70 m completion range to receive the shared completion reward.

Multiplayer remains a beta feature, particularly reconnects, ownership changes and long sessions. Dedicated-server support is experimental.

Back up BepInEx/config/ValheimMastery/ alongside character and world saves. This directory contains the host's slayer-<world-id>.json ledger and combat-coop-<world-id>.tsv combat-credit journal. Replacing the DLL does not reset them. If an interrupted journal write can be recovered, Mastery saves a .recovery-*.bak copy first. Corruption in completed records or an ambiguous legacy tail stops shared combat credits and is reported in the log; do not delete the journal to force a reset. Older Mastery releases cannot read the new checksummed journal entries. Before updating, keep a backup of this directory; reverting the DLL alone is insufficient for a downgrade. Restore a matching journal backup if returning to an older release.

Compatibility and updates

Do not run the replaced Smoothbrain Mining, Lumberjacking, Blacksmithing, Farming, Foraging, Cooking or Sailing plugins alongside Mastery. Their known plugin IDs are declared incompatible. Back up first, then disable those plugins; Mastery can read supported legacy progress without their DLLs being loaded.

BetterArchery, other combat overhauls, additional skill-replacement plugins and SkillBonusTooltips are outside the supported starting setup. Begin with the core mod and add optional UI/comfort mods only after it works.

Close Valheim before updating. If Mastery cannot initialize, it disables its startup and cleans up its own patches and components. Check BepInEx/LogOutput.log, resolve the reported cause and restart the game.

Do not load the same character in a vanilla session as an uninstall test: this mod adds saved progress, items and world objects. Restore a pre-Mastery backup for a clean rollback.

Known limits

• Village blueprint placement and terrain preparation are intentionally paused.
• Bait attracts boars and hares only. Birds can still trigger a baited trap when they land on it, but are not drawn toward it.
• Languages other than German and English currently fall back to English.
• The 10-hour progression target needs real playtime feedback.
• Multiplayer reconnects, long sessions and dedicated servers remain experimental.
• Controller layouts may need rebinding; complete controller support and all Prayer-effect combinations remain under development.
• Third-party enemy/content mods may need explicit compatibility work.
• Reducing damage to zero does not remove status effects that are already active.

Useful beta feedback

Report a bug or balance problem on GitHub Issues. This is the feedback channel for both the standalone mod and Comfort Pack. Public reports are visible to other users, so remove personal information.

Include the Mastery and Valheim versions, XP multiplier, installed mods, whether you were host/client, exact reproduction steps and expected/actual behaviour. For balance feedback, add your skill level, activity and rough duration.

Attach only the relevant log excerpt from BepInEx/LogOutput.log; remove private server details and personal paths first. FEEDBACK.md contains a template.

Unofficial fan-made mod. Not affiliated with Iron Gate, Coffee Stain or Jagex. See NOTICE.md for asset and compatibility attribution.

Deutsch

Valheim Mastery 0.16.48 ist eine öffentliche Beta mit 21 Fertigkeiten, Stufen von 1 bis 100, Slayer-Aufträgen und Mastery Capes. Inspiriert von Old School RuneScape (OSRS), angepasst an Valheims Überleben und Koop-Spiel. Die Spieltexte folgen Valheims Sprache: Deutsch oder Englisch; andere Sprachen verwenden derzeit Englisch. Dieses unabhängige Fanprojekt ist nicht mit Jagex, Iron Gate oder Coffee Stain verbunden und wird von ihnen nicht unterstützt.

Inhalte

Bereich	Fertigkeiten
Kampf	Angriff, Stärke, Verteidigung, Lebenspunkte, Fernkampf, Magie
Sammeln und Tiere	Bergbau, Holzfällen, Sammeln, Jagd, Angeln
Herstellung	Schmieden, Handwerk, Landwirtschaft, Kochen, Alchemie
Erkundung und Bauen	Gewandtheit, Segeln, Baukunst
Weitere	Slayer, Gebet

• Kampfstile, Genauigkeit, maximaler Schaden und Ausrüstungsanforderungen. Misslungene Genauigkeitswürfe verursachen Streiftreffer mit 25 % Schaden; erfolgreiche Paraden bleiben schadensfrei. Immunitäten und tatsächlich vorbeifliegende Geschosse sind davon getrennt.
• Optionale Itemization für unterstützte Vanilla-Waffen, Rüstungen, Schilde, Capes und sechs Elementarstäbe: gespeicherte Herstellungs-/Beutequalität und passende Ausrüstungsboni. Einzigartige und dekorative Gegenstände behalten ihre eigenen Regeln. Native Setboni, Resistenzen, Elementareffekte und Beschwörungen bleiben.
• Optionale NPC-Ausrüstungsbeute: eine kuratierte Auswahl gewöhnlicher Gegner kann höchstens ein zusätzliches Ausrüstungsteil ihrer Fortschrittsstufe hinterlassen, mit gespeicherter Qualität und einer Chance auf ein Affix. Sterne erhöhen die Beutechance und Qualität. Native Materialien und Trophäen bleiben erhalten; Bosse und besondere Belohnungsquellen haben eigene Regeln. Gezähmte, gezüchtete und vom Spieler beschworene Kreaturen sind ausgeschlossen.
• Dyrnwyns optionaler Perfect Strike verbraucht 50 von maximal 100 Spezialenergie und verbessert die Treffergenauigkeit. Der kurze Feuereffekt ist rein optisch. Nur Dyrnwyn hat derzeit ein eigenes Special. Die kompakte Spezialleiste samt SP erscheint nur mit einer passenden ausgerüsteten Waffe und bleibt dann auch bei 0 Energie sichtbar.
• Fortschritt für Leben, Ausdauer und Eitr; Bewegung und Schwimmen über Gewandtheit. Rohstoffstufen, Herstellungsmeilensteine, Materialersparnis, Pflanzraster, zusätzliche Nutzpflanzen und Regeneration natürlicher Erze und Bäume.
• Jagd mit Kadavern und tödlichen Köderfallen. Die Fallen locken wilde Wildschweine und Hasen aus bis zu 18 m an und lösen bei Berührung aus.
• Slayer-Aufträge, gemeinsame Zweispieler-Aufträge, Abschluss- und Serienmarken, Prestige, Belohnungskisten und Waffen. Drei überarbeitete Slayerhelm-Stufen mit neun zusätzlichen Farbvarianten und innenliegenden Augenkanälen.
• Runebound Staff mit vier Eitr-basierten Barrage-Zaubern und Flächenwirkungen.
• 21 Fertigkeitscapes sowie acht Stile des animierten Apex Mastery Cape. Neue Apex-Freischaltungen benötigen alle 21 Fertigkeiten auf Stufe 100; bereits gespeicherte ältere Berechtigungen bleiben erhalten.
• Gebet mit 30 Gebeten, Altar, Trophäen- und Knochenopfern sowie Gebetsmet. Die Liste zeigt Freischaltstufe, Wirkung und Punkteverbrauch. Metbasis und Met verwenden Kessel und Fermentierer; eine zusätzliche Station ist unnötig.
• Kampfstil- und Ortungs-HUD mit Maus-, Touch- und Controllerbedienung. Die Statusleiste zeigt Kampfstil, aktive Gebete und Ortungs-Abklingzeiten.
• Freie Baukunst, Baugebiete, Aufträge und Flächenreparatur. Ab Level 100 bietet das ausgerüstete Baukunstcape zusätzlich Heimkehr zum eigenen Bett, das in dieser Welt als Respawnpunkt gesetzt ist. Alt+F1 mit Hammer oder der Knopf am Baubrett öffnet die Auswahl. Gebietsreparatur bleibt erhalten; beide Kräfte haben eigene sechs Minuten Abklingzeit. Die normalen Welt- und Inventartransportregeln gelten. Ohne gültiges gesetztes Bett keine Heimkehr. Dorf-Baupläne sind vorübergehend deaktiviert; gespeicherte Pläne und bereits gebaute Teile bleiben. Das einfache Lagerfeuer ist ab Baukunst 1 verfügbar.

Installation und Fortschritt

1. Ein frisches Profil in einem Thunderstore-kompatiblen Modmanager verwenden.
2. Dieses Paket samt BepInEx-Abhängigkeit installieren und modifiziert starten.
3. Vor dem ersten Laden bestehende Charaktere, Welten und Konfigurationen sichern; alternativ einen neuen Charakter und eine neue Welt verwenden.
4. Im Fertigkeitsfenster eine Fertigkeit anklicken, um ihre Meilensteine zu sehen.

Zielversion ist Windows/Steam-Valheim 1.0.16 mit BepInExPack_Valheim 5.4.2350; 1.0.15 wird ebenfalls akzeptiert. Andere Betriebssysteme sind ungeprüft. Zur manuellen Installation BepInEx separat installieren und plugins/ValheimMastery/ nach BepInEx/plugins/ kopieren.

BetterUI, Jotunn und Equipment and Quick Slots sind für den Core nicht nötig. Mit Equipment and Quick Slots kann der Köcher zusätzliche Inventarfelder nutzen. Ohne diese Mod den Köcher per Rechtsklick ausrüsten; Munition bleibt im Hauptinventar. Bei BetterUI customSkillUI = true verwenden, damit alle 21 Fertigkeiten angezeigt werden. Das optionale Komfortpaket liefert diese Einstellung mit.

Frische Profile verwenden XP ×1. Alle 21 Fertigkeiten teilen dieselben Schwellen; Stufe 100 benötigt 1.439.116 XP. Etwa zehn Stunden sinnvoller Tätigkeit je Fertigkeit sind ein Balancingziel, keine zugesicherte Spielzeit. Nach dem ersten Start Valheim schließen und bei Bedarf in BepInEx/config/org.valheim.mastery.cfg unter [Progression] den Wert CombatXpMultiplier = 1 anpassen, etwa auf 5 für schnelleren Fortschritt. Der Wert betrifft trotz seines Namens alle Mastery-Fertigkeiten und eingebundene native beziehungsweise Mod-XP-Pfade. Im Multiplayer gilt der Wert des Hosts. Vorhandene Einstellungen werden durch das Paket nicht ersetzt.

Bestehender Mastery-Fortschritt bleibt gespeichert. Unterstützte Vanilla- und ältere Mod-Fertigkeitsstufen werden einmalig übernommen; neue Fertigkeiten starten bei 1. Die Übernahme kann beim ersten Laden stattfinden, deshalb vorher sichern.

Itemization und Spezialangriff aktivieren

Beide Funktionen sind in frischen Profilen zunächst ausgeschaltet. Nach dem Beenden des Spiels die acht Itemization- und zwei Special-Einträge im obigen Configblock auf true setzen. Alle anderen Werte erhalten. Dasselbe Mastery- Release und dieselben Spielregeln auf Clients und Host beziehungsweise Server verwenden und alle neu starten. Abweichende Versionen oder Kampfregeln führen zur Verbindungsablehnung. Der rein optische Schalter EnableSpecialVisual und Tastenbelegungen dürfen unterschiedlich sein; den XP-Faktor liefert der Host.

Bestehende gewöhnliche Ausrüstung bleibt neutral, auch beim Aufwerten. Neu hergestellte unterstützte Ausrüstung und neue geeignete NPC-Gear-Drops erhalten eine Itemization-Identität. Beim Aufwerten eines bereits identifizierten Gegenstands bleibt dessen gespeicherte Qualität erhalten. EnableNpcGearDrops benötigt den zentralen Itemization-Schalter und die Schalter der gewünschten Ausrüstungsgruppen. Er ist in frischen Profilen ausgeschaltet. Bestehende Gegenstände und vergangene Tode werden nicht neu gewürfelt; neue Beute behält ihre Qualität beim Aufheben, Übertragen und Laden. Die kuratierte Liste umfasst nicht jede Kreatur. Die Beute folgt der Gegnerart: Trolle können etwa Trollausrüstung und Draugr Eisenausrüstung hinterlassen. Diese zusätzliche Beute ist selten: Die aktuelle Grundchance liegt je nach Stufe und Sternen bei 1,5 bis 6,05 %. Der getrennte Affixwurf erfolgt erst, wenn tatsächlich ein Ausrüstungsdrop entsteht. Zusätzliche Special-Tasten sind zunächst unbelegt; optional ArmKey oder QuickUseModifier konfigurieren. Der Modifier verwendet den normalen Primärangriff. Vorher mögliche Tastenkonflikte prüfen.

Charaktersicherung und Wiederherstellung

Mastery legt nach einem gesunden Charakterspeichervorgang automatisch eine lokale Sicherung an. Erfasst werden der Fortschritt aller 21 Mastery-Skills und ihre Charakterfreischaltungen sowie tatsächlich im Charakterinventar gehaltene Mastery-Gegenstände und Ausrüstung mit Mastery-Qualität. Qualität und gespeicherte Eigenschaften bleiben erhalten. Ausgerüstete Items und Equipment and Quick Slots 3.1.3 einschließlich Mastery-Köcher werden unterstützt. Welttruhen, Gräber und separate Tascheninventare sind nicht enthalten.

Fehlt beim nächsten gesunden Laden etwas oder ist der gespeicherte Fortschritt niedriger, erscheint eine Vorschau, bevor die alte Sicherung ersetzt wird. Über Mastery-Sicherung im Inventar kannst du sie erneut öffnen. Prüfe die angezeigten Fertigkeiten und Gegenstände und wähle:

• Wiederherstellung prüfen und Verlust bestätigen und wiederherstellen, um die angezeigten Werte zurückzuholen. Zuerst freie normale Inventarplätze schaffen; zurückgeholte Gegenstände werden nicht automatisch ausgerüstet.
• Aktuellen Stand behalten, um den gegenwärtigen Charakterstand zu übernehmen.
• Später / schließen, um die bisherige Sicherung für eine spätere Entscheidung zu erhalten.

Es erfolgt keine automatische Wiederherstellung. Ohne laufende Mastery-Mod kann die Sicherung Weitergabe, Verbrauch und Tod nicht beobachten. Fehlende Items können noch in einer Truhe, einem Grab oder bei einem Mitspieler liegen; eine bestätigte Wiederherstellung könnte sie verdoppeln. Die erste Sicherung kann frühere Verluste nicht rekonstruieren. Verbrauchte Ressourcen, eingelöste Belohnungen und weltseitige Slayer-Konten werden nicht zurückgesetzt. Eine unterbrochene bestätigte Wiederherstellung bleibt zur manuellen Prüfung gesperrt. Ihre Dateien behalten und nicht löschen, um eine erneute Ausgabe zu erzwingen.

Sicherungsordner anzeigen im Fenster zeigt den Ablageort. Die Dateien liegen unter MasteryRecovery im aktiven Valheim-Saveverzeichnis und werden nicht automatisch über Steam Cloud synchronisiert. Beim Gerätewechsel den gesamten Recovery-Ordner zusammen mit den Charaktersaves kopieren. Ein Wechsel zwischen lokalem und Cloud-Speicher erfordert eine Prüfung. Vollständige Charakter- und Weltsicherungen weiterhin separat anlegen.

Steuerung

Taste	Aktion
F1	Kampfstil wechseln
Q	Ausgewählte Ortung aktivieren
F2	Ortungsmodus wechseln
Umschalt + F2	Native Verbindungsinformationen
F3	Freigeschalteten Runebound-Zauber wechseln
R halten	HUD-Cursor für Kampfstil, Ortung und Gebet; „Waffe wegstecken“ vorher auf T legen
R halten und SP anklicken	Dyrnwyn-Special vorbereiten oder abbrechen; danach normal angreifen
Controller-Ansichtstaste + Schultertasten	Rechtes HUD durchgehen; untere Aktionstaste bestätigt
Controller-Ansichtstaste + Steuerkreuz hoch/runter	Gebetsliste durchgehen; rechte Aktionstaste schaltet Gebet
Linke GEBET-Lasche berühren	Gebetsliste öffnen oder schließen
Mittlere Maustaste halten	Bogen-/Armbrustzoom
Strg + F1	Berserk des Slayer Mastery Cape
Umschalt + F1	Kontextabhängige Bergbau-, Holzfäll- oder Segelkraft
Alt + F1	Kontextabhängige Jagd-, Baukunst- oder Angelkraft
Alt + Q	Slayer-Jagdinstinkt, sobald freigeschaltet

Die Tasten sind konfigurierbar. Das Apex Mastery Cape verwendet dieselben kontextabhängigen Tasten. Q aktiviert nur die gewählte Ortung. Die Mod entfernt die Auto-Run-Belegung. SP unterstützt auch Touch und Controllerfokus; die Buttonbezeichnungen können je nach Controllerlayout abweichen.

Koop, Sicherungen und Updates

Slayer-Koop am Brett zu zweit beginnen; der Partner muss vor dem ersten Kill beitreten. Berechtigte Teilnehmer in der Nähe erhalten dieselben Slayer-Kill-XP. Für die gemeinsamen Abschlussmarken müssen beide beim letzten Kill leben und höchstens 70 m vom Ziel entfernt sein. Multiplayer bleibt Beta, insbesondere Wiederverbindungen, Besitzerwechsel und lange Sitzungen. Dedizierte Server sind experimentell.

Zusätzlich zu Charakteren und Welten den Ordner BepInEx/config/ValheimMastery/ sichern. Er enthält die Slayer-Datei slayer-<world-id>.json und das Kampf-XP-Journal combat-coop-<world-id>.tsv des Hosts. Ein DLL-Update setzt diese Dateien nicht zurück. Vor einer möglichen Wiederherstellung eines unterbrochenen Journalschreibvorgangs wird eine .recovery-*.bak-Kopie angelegt. Beschädigte abgeschlossene Einträge oder ein nicht eindeutig lesbares altes Dateiende stoppen die gemeinsamen Kampf-XP; der Fehler steht im Log. Das Journal nicht zum Erzwingen eines Resets löschen. Ältere Mastery-Versionen können neue Journaleinträge mit Prüfsumme nicht lesen. Den Ordner deshalb vor dem Update sichern. Für einen Versionsrückgang genügt der DLL-Tausch allein nicht; dazu eine passende Journalsicherung wiederherstellen.

Valheim vor Updates schließen. Scheitert Masterys Initialisierung, wird der Start deaktiviert und eigene Patches und Komponenten werden aufgeräumt. Ursache in BepInEx/LogOutput.log prüfen, beheben und das Spiel neu starten.

Die ersetzten Smoothbrain-Mods Mining, Lumberjacking, Blacksmithing, Farming, Foraging, Cooking und Sailing nicht gleichzeitig verwenden. Erst sichern, dann diese Plugins deaktivieren; unterstützter alter Fortschritt kann ohne ihre DLLs übernommen werden. Andere Kampfumbauten, BetterArchery, weitere Skill- Ersatzmods und SkillBonusTooltips gehören nicht zur unterstützten Ausgangsbasis.

Mastery speichert Fortschritt, Gegenstände und Weltobjekte. Einen bestehenden Charakter deshalb nicht zur Probe ohne Mods laden. Für eine saubere Rückkehr zum Zustand vor Mastery eine entsprechende Sicherung wiederherstellen.

Lokale Daten und bekannte Grenzen

Anonyme Balancingdaten werden ausschließlich lokal unter BepInEx/ValheimMastery/balancing gespeichert: XP-Quellen, Aktivitätsfenster, Erträge, Boni und Ressourcen-/Kampfwerte. Es werden weder Daten übertragen noch Spieler-/Weltnamen, Chat, Netzwerk-IDs oder Koordinaten erfasst. Mit EnableBalanceTelemetry = false unter [Diagnostics] künftige Aufzeichnung abschalten.

• Dorf-Baupläne und deren Geländevorbereitung bleiben deaktiviert.
• Köder locken nur Wildschweine und Hasen. Landende Vögel können Fallen auslösen, werden aber nicht angelockt.
• Andere Sprachen verwenden Englisch. Das Zehn-Stunden-Ziel benötigt Spielpraxis.
• Controllerlayouts können Anpassungen benötigen; vollständige Controller- Unterstützung und alle Gebetskombinationen sind noch in Entwicklung.
• Weitere Gegner- und Inhaltsmods können eigene Kompatibilitätsanpassungen benötigen.
• Auf null reduzierter Schaden entfernt keine bereits aktiven Statuseffekte.

Fehler und Balancing bitte über die oben verlinkten GitHub Issues melden. Versionen, XP-Faktor, Mods, Host-/Clientrolle, genaue Schritte sowie erwartetes und tatsächliches Ergebnis angeben. Für Balancing auch Stufe, Tätigkeit und ungefähre Dauer nennen. Nur den relevanten Ausschnitt aus BepInEx/LogOutput.log anhängen; persönliche Pfade und private Serverdetails entfernen. Öffentliche Meldungen sind für andere Nutzer sichtbar. Eine Vorlage steht in FEEDBACK.md.

Asset- und Kompatibilitätsangaben stehen in NOTICE.md.