# Keystone Expansion Pufferfish's Skills

## Custom Skill Trees Pack (Pufferfish’s Skills Addon)

A **plug‑and‑play skill tree pack** made for **Pufferfish’s Skills**.

Level up by playing normally (combat, mining, exploration, farming, crafting, building, magic, taming) and spend points to unlock meaningful, RPG‑style upgrades.

***

### Highlights

* **8 gameplay categories**, each with its own XP sources and progression
* **Clear “How to earn XP”** hints on every category (hover text in-game)
* Lots of **small upgrades** + a few **big milestones** (challenge nodes / keystones)
* Built to work in **singleplayer + multiplayer**

***

### Requirements

* **Pufferfish’s Skills** (required)
* **Pufferfish’s Attributes** (required — this pack uses custom attributes)

***

### Quick start

1. Install the required mods.
2. Install this pack (either as a **datapack** or a **mod-bundle**, depending on your download).
3. Launch the game and press **`K`** to open the Skills screen.

→ Full instructions: **Getting Started → Installation**

## Summary

* [Home](#custom-skill-trees-pack-pufferfishs-skills-addon)

### Getting Started

* [Installation](#installation)
* [Updating](#updating)
* [Quick Tips](#quick-tips)

### How It Works

* [Points & Levels](#points-and-levels)
* [Experience & Anti-Farming](#experience-and-anti-farming)

### Categories

* [Combat](#combat-h-and-s-constellation-150)
* [Mining](#mining)
* [Exploration](#exploration)
* [Farming](#farming)
* [Crafting](#crafting)
* [Building](#building-and-architecture)
* [Magic](#magic)
* [Taming](#taming-companions)

### Admin & Support

* [Commands](#commands-admin)
* [Troubleshooting](#troubleshooting)

### Creator Notes (Optional)

* [Folder Structure](#folder-structure-optional)
* [Editing & Localization](#editing-and-localization-optional)

## Installation

This pack is designed for **Pufferfish’s Skills** and **requires Pufferfish’s Attributes** (it uses custom stats).

***

### Requirements

* **Pufferfish’s Skills** (required)
* **Pufferfish’s Attributes** (required)

***

### Install as a datapack (recommended)

1. Download this pack as a **zip datapack**.
2. Put it into your world folder:

```
<world>/datapacks/<this-pack>.zip
```

3. In game, run:

```
/reload
```

4. Press **`K`** to open the Skills screen.

***

### Install as a mod (if you downloaded a .jar)

If you downloaded a **.jar**, install it like any other mod:

```
.minecraft/mods/
```

Then launch the game.

***

### Verify it works

* Open the skill screen (**K**).
* You should see multiple categories on the left.
* Hover a category: you’ll see **How to earn XP**.

If you see **“Invalid Configuration”**, go to **Admin & Support → Troubleshooting**.

## Quick Tips

* **Spend points often**: small upgrades stack and the power growth is very noticeable.
* **Hover category titles**: each category explains exactly **how XP is earned**.
* **Milestone nodes matter**: challenge/keystone nodes are your “big spikes” in power.
* Running a server? Consider announcing the hotkey **K** and the reset commands in your rules.

## Updating

### Updating the skill pack

* If installed as a **datapack**: replace the zip in `<world>/datapacks/` and run `/reload`.
* If installed as a **mod**: replace the jar in `.minecraft/mods/`.

### Resetting player progression (optional)

If you changed the tree a lot and want a clean slate, use the admin commands:

* Reset one category (hard reset):\
  `/puffish_skills category erase <player> <category>`
* Reset skills in a category (refund points):\
  `/puffish_skills skills reset <player> <category>`

## Experience & Anti-Farming

Each category defines how XP is earned in its own configuration.

### How XP is calculated

This pack uses a mix of:

* **Events** (kill mobs, breed animals, craft items, use potions…)
* **Statistics** (distance traveled, blocks mined/placed…)

The exact rules are shown in game:

* Hover a category title → **How to earn XP**
* Some categories also show extra details (rates, caps, formulas)

### Anti-farm protection

Some XP sources have limits to reduce “AFK grinders”.\
Example: Combat can apply per‑chunk kill limits to prevent mob spawners from printing infinite XP.

## Points & Levels

### Basics

* Each **category** has its own XP bar.
* When you level up a category, you gain **skill points** for that category.
* Spend points to unlock skills in the tree.

### Opening the UI

Default keybind is **`K`** (can be changed in controls).

### Skill trees are data‑driven

Pufferfish’s Skills is a framework: trees are added via external packs (like this one).

## Building & Architecture

### How to earn XP

Build, decorate, optimize. A long MMO-style tree that makes you stronger as your projects grow.

Earn XP by placing building blocks (planks, stone, decor, and detail blocks). Rates: Planks +0.08 XP/block • Stone +0.10 • Decor +0.15 • Details +0.12.

***

### Milestones (quick reference)

* **City Forge** 🏆 — Your style reshapes survival: speed, luck and stability.
* **Grand Designer** 🏆 — The ultimate architect toolkit: reach, speed and luck.
* **Master Builder** 🏆 — The sum of your work: you become a true builder tank.
* **Skyline Legend** 🏆 — Pure end-game mobility and fall safety.

<details>

<summary><strong>Full skill list (57 skills)</strong></summary>

**City Forge 🏆**

Your style reshapes survival: speed, luck and stability. • +2% Movement Speed • +2.0 Luck • +15% Knockback Resistance

**Grand Designer 🏆**

The ultimate architect toolkit: reach, speed and luck. • +1.0 Block Reach • +3.0 Luck • +2% Movement Speed

**Master Builder 🏆**

The sum of your work: you become a true builder tank. • +6 Max Health • +4 Armor • +2 Armor Toughness

**Skyline Legend 🏆**

Pure end-game mobility and fall safety. • +0.20 Step Height • +5 Safe Fall Distance • −10% Fall Damage

**Agile Step I**

Climbing up and down feels smoother. • +0.10 Step Height

**Agile Step II**

Step over small obstacles without thinking. • +0.10 Step Height

**Agile Step III**

Peak worksite mobility. • +0.10 Step Height

**Apprentice Architect**

Begin your architect journey. The bonuses are small at first… but become insane in end-game.

**Blueprint 1**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 10**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 11**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 12**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 13**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 14**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 15**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 16**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 17**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 18**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 19**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 2**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 20**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 3**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 4**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 5**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 6**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 7**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 8**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Blueprint 9**

A small secondary bonus. Alone it’s subtle… but stacked, it becomes monstrous.

**Builder’s Reach I**

Place and interact from a bit farther away. • +0.5 Block Reach

**Builder’s Reach II**

Extended range for precision builds. • +0.5 Block Reach

**Decorator’s Eye I**

A bit of luck while looting and exploring. • +0.5 Luck

**Decorator’s Eye II**

Luck starts to show. • +0.75 Luck

**Decorator’s Eye III**

Solid end-game luck. • +1.0 Luck

**Decorator’s Eye IV**

Your instincts find the best details. • +1.25 Luck

**Endurance I**

More health to tank during construction. • +2 Max Health

**Endurance II**

Even more health. • +2 Max Health

**Endurance III**

Serious HP for end-game builders. • +4 Max Health

**Endurance IV**

Hardcore builder HP. • +4 Max Health

**Focus I**

A calm builder makes fewer mistakes. • +5% Knockback Resistance

**Focus II**

Hold your ground even when things get spicy. • +5% Knockback Resistance

**Focus III**

Unshakeable builder concentration. • +5% Knockback Resistance

**Masonry I**

Toughen up like your walls. • +1 Armor

**Masonry II**

Thicker plates, sturdier stance. • +1 Armor • +1 Armor Toughness

**Masonry III**

Real builder durability. • +2 Armor • +1 Armor Toughness • +2 Max Health

**Masonry IV**

Stronger walls, stronger you. • +2 Armor • +2 Armor Toughness • +2 Max Health

**Masonry V**

End-game-grade protection. • +3 Armor • +2 Armor Toughness • +2 Max Health

**Masonry VI**

Fortress mindset. • +3 Armor • +3 Armor Toughness • +4 Max Health

**Masonry VII**

The final layer before true mastery. • +2 Armor • +1 Armor Toughness • +2 Max Health

**Stability I**

A steady builder doesn’t get pushed around. • +10% Knockback Resistance

**Stability II**

Reinforced stability. • +15% Knockback Resistance

**Stability III**

Absolute stability, even under pressure. • +20% Knockback Resistance

**Sure Grip I**

Move better on the job site. • +1% Movement Speed

**Sure Grip II**

Faster movement during big projects. • +1% Movement Speed

**Sure Grip III**

Keep momentum on massive builds. • +1% Movement Speed

**Worksite Reflexes I**

Less punishment from falls. • +2 Safe Fall Distance

**Worksite Reflexes II**

Even more margin for falls. • +3 Safe Fall Distance • −5% Fall Damage

**Worksite Reflexes III**

Falls become a minor inconvenience. • +4 Safe Fall Distance • −5% Fall Damage

</details>

## Combat — H\&S Constellation (150)

### How to earn XP

Earn XP by killing mobs. Stronger enemies grant more XP.

**Details**

XP formula: dropped XP + (max health / 20). Anti-farm: max 15 kills per chunk every 5 minutes.

***

### Milestones (quick reference)

* **Combat Mastery (+1% Resistance)** 🏆 — Unlocks the Combat tree.
* **KEYSTONE: Fortress (+12% Resistance, +2 ❤, +4 Armor, +10% Knockback Resist)** 🏆 — +12% Damage Resistance
* **KEYSTONE: Hawkeye (+12% Ranged, +0.75 Luck, +10% Sprint Speed)** 🏆 — +12% Ranged Damage
* **KEYSTONE: Warmaster (+12% Melee, +6% Attack Speed, +0.25 Luck)** 🏆 — +12% Melee Damage
* **STANCE: Berserker (+6% Stamina, +3% Melee)** 🏆 — +6% Stamina
* **STANCE: Bulwark (+6% Resistance, +2 Armor)** 🏆 — +6% Damage Resistance
* **STANCE: Duelist (+4% Attack Speed, +2% Melee)** 🏆 — +4% Attack Speed
* **STANCE: Paladin (+2 ❤, +10% Healing)** 🏆 — +2 ❤ Max Health
* **STANCE: Skirmisher (+5% Ranged, +6% Sprint Speed)** 🏆 — +5% Ranged Damage
* **STANCE: Sniper (+5% Ranged, +0.25 Luck)** 🏆 — +5% Ranged Damage
* **ULTIMATE: Ascendant Champion (+8% Melee, +8% Ranged, +6% Resistance, +3 ❤, +10% Healing)** 🏆 — +8% Melee Damage

<details>

<summary><strong>Full skill list (51 skills)</strong></summary>

**Combat Mastery (+1% Resistance) 🏆**

Unlocks the Combat tree. • +1% Damage Resistance

**KEYSTONE: Fortress (+12% Resistance, +2 ❤, +4 Armor, +10% Knockback Resist) 🏆**

Keystone bonus: • +12% Damage Resistance • +2 ❤ Max Health • +4 Armor • +10% Knockback Resistance

**KEYSTONE: Hawkeye (+12% Ranged, +0.75 Luck, +10% Sprint Speed) 🏆**

Keystone bonus: • +12% Ranged Damage • +0.75 Luck • +10% Sprint Speed

**KEYSTONE: Warmaster (+12% Melee, +6% Attack Speed, +0.25 Luck) 🏆**

Keystone bonus: • +12% Melee Damage • +6% Attack Speed • +0.25 Luck

**STANCE: Berserker (+6% Stamina, +3% Melee) 🏆**

Stance effect: • +6% Stamina • +3% Melee Damage

**STANCE: Bulwark (+6% Resistance, +2 Armor) 🏆**

Stance effect: • +6% Damage Resistance • +2 Armor

**STANCE: Duelist (+4% Attack Speed, +2% Melee) 🏆**

Stance effect: • +4% Attack Speed • +2% Melee Damage

**STANCE: Paladin (+2 ❤, +10% Healing) 🏆**

Stance effect: • +2 ❤ Max Health • +10% Healing

**STANCE: Skirmisher (+5% Ranged, +6% Sprint Speed) 🏆**

Stance effect: • +5% Ranged Damage • +6% Sprint Speed

**STANCE: Sniper (+5% Ranged, +0.25 Luck) 🏆**

Stance effect: • +5% Ranged Damage • +0.25 Luck

**ULTIMATE: Ascendant Champion (+8% Melee, +8% Ranged, +6% Resistance, +3 ❤, +10% Healing) 🏆**

Ultimate bonus: • +8% Melee Damage • +8% Ranged Damage • +6% Damage Resistance • +3 ❤ Max Health • +10% Healing

**+0.15 Luck**

Gain +0.15 Luck.

**+0.25 Luck**

Gain +0.25 Luck.

**+0.5 Armor Toughness**

Gain +0.5 Armor Toughness.

**+0.5 Luck**

Gain +0.5 Luck.

**+1 Armor**

Gain +1 Armor.

**+1 ❤ Max Health**

Increases your max health by 1 heart (+2 HP).

**+1% Damage Resistance**

Increases your damage resistance by 1%.

**+1% Melee Damage**

Increases your melee damage by 1%.

**+1% Ranged Damage**

Increases your ranged damage by 1%.

**+10% Healing**

Increases your healing by 10%.

**+10% Sprint Speed**

Increases your sprint speed by 10%.

**+10% Stamina**

Increases your stamina by 10%.

**+2 Armor**

Gain +2 Armor.

**+2 ❤ Max Health**

Increases your max health by 2 hearts (+4 HP).

**+2% Attack Speed**

Increases your attack speed by 2%.

**+2% Damage Resistance**

Increases your damage resistance by 2%.

**+2% Melee Damage**

Increases your melee damage by 2%.

**+2% Ranged Damage**

Increases your ranged damage by 2%.

**+3% Damage Resistance**

Increases your damage resistance by 3%.

**+3% Healing**

Increases your healing by 3%.

**+3% Melee Damage**

Increases your melee damage by 3%.

**+3% Ranged Damage**

Increases your ranged damage by 3%.

**+3% Sprint Speed**

Increases your sprint speed by 3%.

**+3% Stamina**

Increases your stamina by 3%.

**+4% Attack Speed**

Increases your attack speed by 4%.

**+5% Damage Resistance**

Increases your damage resistance by 5%.

**+5% Knockback Resistance**

Gain +5% Knockback Resistance.

**+5% Melee Damage**

Increases your melee damage by 5%.

**+5% Ranged Damage**

Increases your ranged damage by 5%.

**+6% Attack Speed**

Increases your attack speed by 6%.

**+6% Healing**

Increases your healing by 6%.

**+6% Sprint Speed**

Increases your sprint speed by 6%.

**+6% Stamina**

Increases your stamina by 6%.

**Synergy: +1 Armor & +5% Knockback Resist**

Synergy bonus: • +1 Armor • +5% Knockback Resistance

**Synergy: +3% Melee & +2% Attack Speed**

Synergy bonus: • +3% Melee Damage • +2% Attack Speed

**Synergy: +3% Melee & +6% Stamina**

Synergy bonus: • +3% Melee Damage • +6% Stamina

**Synergy: +3% Ranged & +0.25 Luck**

Synergy bonus: • +3% Ranged Damage • +0.25 Luck

**Synergy: +3% Ranged & +6% Sprint Speed**

Synergy bonus: • +3% Ranged Damage • +6% Sprint Speed

**Synergy: +3% Resistance & +1 ❤**

Synergy bonus: • +3% Damage Resistance • +1 ❤ Max Health

**Synergy: +3% Resistance & +6% Healing**

Synergy bonus: • +3% Damage Resistance • +6% Healing

</details>

## Crafting

### How to earn XP

Earn XP by crafting items and enchanting gear.

**Details**

Crafting: +0.25 XP per crafted item (stack-size matters). Bonus XP for key crafts: Iron tools, Diamond tools/armor, Anvil, Enchanting Table, Brewing Stand, Ender Chest, End Crystal, Beacon, Netherite Block, Golden Apple. Enchanting: +12 XP per level spent (+35 extra for Enchanted Books).

***

### Milestones (quick reference)

* **Artisan's Path** 🏆 — Unlocks the Crafting skill tree.
* **Certification: Master** 🏆 — +3 Skill Points (Crafting)
* **Crafting Legend** 🏆 — Unlocks the Legend capstone.
* **Masterwork** 🏆 — Unlocks the Masterwork capstone.

<details>

<summary><strong>Full skill list (84 skills)</strong></summary>

**Artisan's Path 🏆**

Unlocks the Crafting skill tree. • +2% Skill XP Gain

**Certification: Master 🏆**

• +3 Skill Points (Crafting) • +3% Skill XP Gain

**Crafting Legend 🏆**

Unlocks the Legend capstone. • +1.5 Luck • +8% Skill XP Gain • +4 Max Health • +3 Armor • +2 Armor Toughness

**Masterwork 🏆**

Unlocks the Masterwork capstone. • +1 Luck • +6% Skill XP Gain • +2 Max Health

**Arcana — Foundations**

• +1% Skill XP Gain

**Archmage of Crafting**

• +3% Skill XP Gain • +0.35 Luck

**Blueprints & Recipes**

• +1% Skill XP Gain

**Careful Crafter**

• +0.5 Armor

**Carpentry 1**

• +0.7%% Skill XP Gain

**Carpentry 2**

• +0.8%% Skill XP Gain

**Carpentry 3**

• +0.9%% Skill XP Gain

**Carpentry 4**

• +1% Skill XP Gain

**Carpentry 5**

• +1.1%% Skill XP Gain

**Carpentry 6**

• +1.2%% Skill XP Gain

**Carpentry 7**

• +1.3%% Skill XP Gain

**Carpentry 8**

• +1.4%% Skill XP Gain

**Certification: Apprentice**

• +1 Skill Point (Crafting) • +2% Skill XP Gain

**Certification: Journeyman**

• +2 Skill Points (Crafting) • +2% Skill XP Gain

**Enchanter I**

• +0.15 Luck

**Enchanter II**

• +0.2 Luck

**Focus 1**

• +2.5%% Healing Power

**Focus 2**

• +0.8%% Skill XP Gain

**Focus 3**

• +3.5%% Healing Power

**Focus 4**

• +1% Skill XP Gain

**Focus 5**

• +4.5%% Healing Power

**Focus 6**

• +1.2%% Skill XP Gain

**Focus 7**

• +5.5%% Healing Power

**Focus 8**

• +1.4%% Skill XP Gain

**Forge Overseer**

• +3% Skill XP Gain • +1.5 Armor

**Forge — Foundations**

• +1% Skill XP Gain

**Furnace Basics**

• +1% Skill XP Gain

**Honed Arcana**

• +4% Attack Damage

**Legendary Steel**

• +1 Max Health • +1 Armor Toughness

**Living Library**

• +2% Skill XP Gain

**Logistics 1**

• +0.06 Luck

**Logistics 2**

• +0.08 Luck

**Logistics 3**

• +0.1 Luck

**Logistics 4**

• +0.12 Luck

**Logistics 5**

• +0.14 Luck

**Logistics 6**

• +0.16 Luck

**Logistics 7**

• +0.18 Luck

**Logistics 8**

• +0.2 Luck

**Mass Production**

• +2% Skill XP Gain

**Master Blacksmith**

• +1.2 Armor

**Metallurgy I**

• +0.5 Armor Toughness

**Metallurgy II**

• +0.7 Armor Toughness

**Optimized Tools**

• +3% Attack Speed

**Pack Organization**

• +0.1 Luck

**Quick Assembly I**

• +1% Skill XP Gain

**Quick Assembly II**

• +1.5%% Skill XP Gain

**Reinforcement Craft**

• +0.6 Armor Toughness

**Ritual 1**

• +0.08 Luck

**Ritual 2**

• +0.11 Luck

**Ritual 3**

• +0.14 Luck

**Ritual 4**

• +0.17 Luck

**Ritual 5**

• +0.2 Luck

**Ritual 6**

• +0.23 Luck

**Ritual 7**

• +0.26 Luck

**Ritual 8**

• +0.29 Luck

**Rune Studies**

• +1% Skill XP Gain

**Specialization: Architect**

Unlocks the Architect specialization. • +4% Skill XP Gain

**Specialization: Blacksmith**

Unlocks the Blacksmith specialization. • +2 Armor • +1 Armor Toughness

**Specialization: Enchanter**

Unlocks the Enchanter specialization. • +0.6 Luck • +4% Skill XP Gain

**Sturdy Forge**

• +1 Max Health

**Tempering & Alloys**

• +0.8 Armor

**Tempering 1**

• +0.33 Armor

**Tempering 2**

• +0.41 Armor

**Tempering 3**

• +0.49 Armor

**Tempering 4**

• +0.57 Armor

**Tempering 5**

• +0.65 Armor

**Tempering 6**

• +0.73 Armor

**Tempering 7**

• +0.81 Armor

**Tempering 8**

• +0.89 Armor

**Vigor 1**

• +1 Max Health

**Vigor 2**

• +3% Damage Resistance

**Vigor 3**

• +1 Max Health

**Vigor 4**

• +4% Damage Resistance

**Vigor 5**

• +1 Max Health

**Vigor 6**

• +5% Damage Resistance

**Vigor 7**

• +1 Max Health

**Vigor 8**

• +6% Damage Resistance

**Workshop Mastery**

• +3% Skill XP Gain

**Workshop — Foundations**

• +1% Skill XP Gain

**XP Flow**

• +2% Skill XP Gain

</details>

## Exploration

### How to earn XP

Earn XP by traveling: walk, sprint, swim, fly, ride, boat, fall, and jump.

**Details**

XP rates (approx.):

* Walk: +0.09 XP per block
* Sprint: +0.12 XP per block
* Swim: +0.13 XP per block
* Boat: +0.10 XP per block
* Elytra flight: +0.15 XP per block
* Horse: +0.11 XP per block
* Falling: +0.035 XP per block
* Jump: +0.12 XP per jump

***

### Milestones (quick reference)

* **Breath — +0.5 Stamina** — Starting skill.
* **First Leap — +5% Jump Height** — Starting skill.
* **Scout — +5% Speed** — Starting skill.
* **Soft Steps — +1 Stealth** — Starting skill.
* **Endurance** 🏆 — Challenge capstone.
* **Legendary Pathfinder** 🏆 — Challenge capstone.
* **Roadrunner** 🏆 — Challenge capstone.
* **Shadowstep** 🏆 — Challenge capstone.
* **Worldwalker (Mythic)** 🏆 — Mythic capstone.

<details>

<summary><strong>Full skill list (32 skills)</strong></summary>

**Breath — +0.5 Stamina**

Starting skill. • +0.5 Stamina

**First Leap — +5% Jump Height**

Starting skill. • +5% Jump Height

**Scout — +5% Speed**

Starting skill. • +5% Movement Speed

**Soft Steps — +1 Stealth**

Starting skill. • +1 Stealth (reduced detection)

**Endurance 🏆**

Challenge capstone. • +2 Stamina • +15% Natural Regeneration • +5% Resistance

**Legendary Pathfinder 🏆**

Challenge capstone. • +10% Sprint Speed • +10% Jump Height • +1 Stamina • +10% XP (orbs)

**Roadrunner 🏆**

Challenge capstone. • +8% Movement Speed • +12% Sprint Speed • +1 Stamina

**Shadowstep 🏆**

Challenge capstone. • +3 Stealth • +8% Sprint Speed • +10% XP (orbs)

**Worldwalker (Mythic) 🏆**

Mythic capstone. • +10% Movement Speed • +15% Sprint Speed • +15% Jump Height • +3 Fall Reduction • +2 Stamina • +15% XP (orbs) • +2 Stealth • +7% Resistance • +20% Natural Regeneration • +10% Healing Received

**+0.5 Stamina**

Increases stamina by 0.5.

**+1 Stamina**

Increases stamina by 1.

**+1 Stealth (reduced detection)**

Increases stealth by 1 (reduces detection).

**+10% Jump Height**

Increases jump height by 10%.

**+10% Natural Regeneration**

Increases natural regeneration by 10%.

**+10% Sprint Speed**

Increases sprinting speed by 10%.

**+10% XP (orbs)**

Increases XP gained from orbs by 10%.

**+2 Stealth (reduced detection)**

Increases stealth by 2 (reduces detection).

**+3% Resistance**

Increases damage resistance by 3%.

**+5% Healing Received**

Increases healing received by 5%.

**+5% Jump Height**

Increases jump height by 5%.

**+5% Natural Regeneration**

Increases natural regeneration by 5%.

**+5% Speed**

Increases movement speed by 5%.

**+5% Sprint Speed**

Increases sprinting speed by 5%.

**+5% XP (orbs)**

Increases XP gained from orbs by 5%.

**+7% Speed**

Increases movement speed by 7%.

**+7% XP (orbs)**

Increases XP gained from orbs by 7%.

**Acrobat**

Combo skill. • +10% Jump Height • +1 Fall Reduction

**Marathon**

Combo skill. • +1 Stamina • +5% Sprint Speed

**Runner's High**

Combo skill. • +7% Sprint Speed • +0.5 Stamina

**Scout**

Combo skill. • +2 Stealth • +5% XP (orbs)

**Soft Landing — +1 Fall Reduction**

Reduces fall damage taken by 1.

**Soft Landing — +2 Fall Reduction**

Reduces fall damage taken by 2.

</details>

## Farming

### How to earn XP

Earn XP by harvesting crops, breeding animals, fishing, and planting seeds.

**Details**

XP rates:

* Wheat / Carrots / Potatoes / Beetroots: +0.40 XP each
* Melon / Pumpkin: +0.70 XP each
* Nether Wart: +0.55 XP each
* Cocoa: +0.45 XP each
* Sweet Berries: +0.25 XP each
* Sugar Cane / Cactus / Bamboo / Kelp: +0.06 XP each
* Animals bred: +8 XP each
* Fish caught: +4 XP each
* Planting (seeds/crops): +0.05 XP each

***

### Milestones (quick reference)

* **Cooking Root** 🏆 — Unlocks the Cooking branch.
* **Fishing Root** 🏆 — Unlocks the Fishing branch.
* **Harvesting Root** 🏆 — Unlocks the Harvesting branch.
* **Husbandry Root** 🏆 — Unlocks the Husbandry branch.
* **Keystone: Angler King** 🏆 — A major milestone for the Fishing branch.
* **Keystone: Beastmaster** 🏆 — A major milestone for the Husbandry branch.
* **Keystone: Gourmet** 🏆 — A major milestone for the Cooking branch.
* **Keystone: Harvest Master** 🏆 — A major milestone for the Harvesting branch.
* **Keystone: Homestead Legend** 🏆 — The ultimate Farming milestone.

<details>

<summary><strong>Full skill list (20 skills)</strong></summary>

**Cooking Root 🏆**

Unlocks the Cooking branch. • +3% Healing

**Fishing Root 🏆**

Unlocks the Fishing branch. • +0.5 Luck

**Harvesting Root 🏆**

Unlocks the Harvesting branch. • +0.5 Luck

**Husbandry Root 🏆**

Unlocks the Husbandry branch. • +0.5 Stamina

**Keystone: Angler King 🏆**

A major milestone for the Fishing branch. • +2 Luck • +5% Healing • Unlocks: Angler King

**Keystone: Beastmaster 🏆**

A major milestone for the Husbandry branch. • +2 Hearts • +2 Stamina • Unlocks: Beastmaster

**Keystone: Gourmet 🏆**

A major milestone for the Cooking branch. • +2 Stamina • +10% Healing • Unlocks: Gourmet

**Keystone: Harvest Master 🏆**

A major milestone for the Harvesting branch. • +2 Luck • +10% XP from orbs • Unlocks: Harvest Master

**Keystone: Homestead Legend 🏆**

The ultimate Farming milestone. • +3 Luck • +3 Hearts • +3 Stamina • +15% Healing • +15% XP from orbs • Unlocks: Homestead Legend

**+0.5 Luck**

Increases your Luck by 0.5.

**+0.5 Stamina**

Increases your Stamina by 0.5.

**+1 Heart**

Increases your maximum health by 1 heart.

**+1 Luck**

Increases your Luck by 1.

**+1 Stamina**

Increases your Stamina by 1.

**+1% Resistance**

Increases your damage resistance by 1%.

**+10% XP (orbs)**

Gain 10% more experience from XP orbs.

**+2 Hearts**

Increases your maximum health by 2 hearts.

**+3% Healing**

Increases your healing by 3%.

**+5% Healing**

Increases your healing by 5%.

**+5% XP (orbs)**

Gain 5% more experience from XP orbs.

</details>

## Magic

### How to earn XP

Earn XP by enchanting items, healing, and using potions.

**Details**

Enchanting: 320 XP per level spent. Healing: 15 XP per health restored. Potions: 55 XP per use (cap 330).

***

### Milestones (quick reference)

* **Arcane Initiate** 🏆 — Unlocks the Magic tree.
* **Keystone: Archmage** 🏆 — A powerful arcane specialization.
* **Keystone: Grand Alchemist** 🏆 — A master of potions and recovery.
* **Keystone: Spellwarden** 🏆 — A defensive magic specialization.

<details>

<summary><strong>Full skill list (50 skills)</strong></summary>

**Arcane Initiate 🏆**

Unlocks the Magic tree. • +2% XP gain

**Keystone: Archmage 🏆**

A powerful arcane specialization. • +25% XP gain • +2.0 Luck

**Keystone: Grand Alchemist 🏆**

A master of potions and recovery. • +25% Healing • +4 Hearts

**Keystone: Spellwarden 🏆**

A defensive magic specialization. • +25% Resistance • +6 Armor

**+0.25 Luck**

Increases your Luck by 0.25.

**+0.25 Luck**

Increases your Luck by 0.25.

**+0.25 Luck**

Increases your Luck by 0.25.

**+0.5 Luck**

Increases your Luck by 0.5.

**+0.5 Luck**

Increases your Luck by 0.5.

**+1 Armor**

Increases your Armor by 1.

**+1 Armor**

Increases your Armor by 1.

**+1 Heart**

Increases your maximum health by 1 heart.

**+1 Heart**

Increases your maximum health by 1 heart.

**+1 Heart**

Increases your maximum health by 1 heart.

**+1 Toughness**

Increases your Armor Toughness by 1.

**+1 Toughness**

Increases your Armor Toughness by 1.

**+1.0 Luck**

Increases your Luck by 1.0.

**+2 Armor**

Increases your Armor by 2.

**+2 Armor**

Increases your Armor by 2.

**+2 Hearts**

Increases your maximum health by 2 hearts.

**+2 Hearts**

Increases your maximum health by 2 hearts.

**+2 Toughness**

Increases your Armor Toughness by 2.

**+2 Toughness**

Increases your Armor Toughness by 2.

**+2% Attack Speed**

Increases your Attack Speed by 2%.

**+2% Healing**

Increases healing effects by 2%.

**+2% Knowledge (XP)**

Increases the XP you gain by 2%.

**+2% Knowledge (XP)**

Increases the XP you gain by 2%.

**+2% Resistance**

Increases your resistance by 2%.

**+3 Armor**

Increases your Armor by 3.

**+3% Attack Damage**

Increases your Attack Damage by 3%.

**+3% Attack Speed**

Increases your Attack Speed by 3%.

**+3% Healing**

Increases healing effects by 3%.

**+3% Knowledge (XP)**

Increases the XP you gain by 3%.

**+3% Knowledge (XP)**

Increases the XP you gain by 3%.

**+3% Resistance**

Increases your resistance by 3%.

**+4% Attack Damage**

Increases your Attack Damage by 4%.

**+4% Attack Speed**

Increases your Attack Speed by 4%.

**+4% Healing**

Increases healing effects by 4%.

**+4% Knowledge (XP)**

Increases the XP you gain by 4%.

**+4% Resistance**

Increases your resistance by 4%.

**+5% Attack Damage**

Increases your Attack Damage by 5%.

**+5% Attack Speed**

Increases your Attack Speed by 5%.

**+5% Healing**

Increases healing effects by 5%.

**+5% Knockback Res.**

Increases your Knockback Resistance by 5%.

**+5% Knockback Res.**

Increases your Knockback Resistance by 5%.

**+5% Resistance**

Increases your resistance by 5%.

**+6% Attack Damage**

Increases your Attack Damage by 6%.

**+6% Healing**

Increases healing effects by 6%.

**+7% Knockback Res.**

Increases your Knockback Resistance by 7%.

**+8% Knockback Res.**

Increases your Knockback Resistance by 8%.

</details>

## Mining

### How to earn XP

Earn XP by mining stone and ores (no XP with Silk Touch).

**Details**

XP per block:

* Stone: 1
* Deepslate: 2
* Coal/Copper/Iron: 4 (5 in deepslate)
* Gold/Redstone/Lapis: 6 (7 in deepslate)
* Diamond/Emerald: 10 (12 in deepslate)
* Nether Quartz/Nether Gold: 8
* Ancient Debris: 25

***

### Milestones (quick reference)

* **Keystone — Deep Delver (+5 Hearts & +10% Mining Speed)** — Increases your max health by 5 hearts
* **Keystone — Foreman (+15% Mining Speed & +15% Pickaxe Speed)** — Increases your Mining Speed by 15%
* **Keystone — Prospector (+0.40 Fortune & +0.75 Luck)** — Grants +0.4 Fortune (ores)
* **Keystone — Smithmaster (-30% Anvil Cost & +10% Pickaxe Speed)** — Reduces your Anvil Cost by 30%

<details>

<summary><strong>Full skill list (31 skills)</strong></summary>

**+0.05 Fortune (ores)**

Grants +0.05 Fortune (ores).

**+0.10 Fortune (ores)**

Grants +0.1 Fortune (ores).

**+0.10 Luck**

Grants +0.1 Luck.

**+0.15 Fortune (ores)**

Grants +0.15 Fortune (ores).

**+0.20 Fortune (ores)**

Grants +0.2 Fortune (ores).

**+0.25 Luck**

Grants +0.25 Luck.

**+0.50 Luck**

Grants +0.5 Luck.

**+1 Heart**

Increases your max health by 1 heart.

**+2 Hearts**

Increases your max health by 2 hearts.

**+3% Mining Speed**

Increases your Mining Speed by 3%.

**+3% Mining Speed**

Core Mining perk. • Increases your Mining Speed by 3%

**+3% Pickaxe Speed**

Increases your Pickaxe Speed by 3%.

**+5% Mining Speed**

Increases your Mining Speed by 5%.

**+5% Pickaxe Speed**

Increases your Pickaxe Speed by 5%.

**+7% Mining Speed**

Increases your Mining Speed by 7%.

**+7% Pickaxe Speed**

Increases your Pickaxe Speed by 7%.

**-10% Anvil Cost**

Reduces your Anvil Cost by 10%.

**-15% Anvil Cost**

Reduces your Anvil Cost by 15%.

**-2% Anvil Cost**

Reduces your Anvil Cost by 2%.

**-5% Anvil Cost**

Reduces your Anvil Cost by 5%.

**Combo — +0.10 Fortune & +0.25 Luck**

Bonuses: • Grants +0.1 Fortune (ores) • Grants +0.25 Luck

**Combo — +5% Mining Speed & +1 Heart**

Bonuses: • Increases your Mining Speed by 5% • Increases your max health by 1 heart

**Combo — +5% Mining Speed & +5% Pickaxe Speed**

Bonuses: • Increases your Mining Speed by 5% • Increases your Pickaxe Speed by 5%

**Combo — +5% Pickaxe Speed & +0.05 Fortune**

Bonuses: • Increases your Pickaxe Speed by 5% • Grants +0.05 Fortune (ores)

**Combo — -5% Anvil Cost & +0.25 Luck**

Bonuses: • Reduces your Anvil Cost by 5% • Grants +0.25 Luck

**Combo — -5% Anvil Cost & +5% Pickaxe Speed**

Bonuses: • Reduces your Anvil Cost by 5% • Increases your Pickaxe Speed by 5%

**Keystone — Deep Delver (+5 Hearts & +10% Mining Speed)**

Bonuses: • Increases your max health by 5 hearts • Increases your Mining Speed by 10%

**Keystone — Foreman (+15% Mining Speed & +15% Pickaxe Speed)**

Bonuses: • Increases your Mining Speed by 15% • Increases your Pickaxe Speed by 15%

**Keystone — Prospector (+0.40 Fortune & +0.75 Luck)**

Bonuses: • Grants +0.4 Fortune (ores) • Grants +0.75 Luck

**Keystone — Smithmaster (-30% Anvil Cost & +10% Pickaxe Speed)**

Bonuses: • Reduces your Anvil Cost by 30% • Increases your Pickaxe Speed by 10%

**ULTIMATE — Mining Magnate (massive bonuses)**

Bonuses: • Increases your Mining Speed by 25% • Increases your Pickaxe Speed by 25% • Grants +0.6 Fortune (ores) • Reduces your Anvil Cost by 35% • Grants +1.5 Luck • Increases your max health by 4 hearts

</details>

## Taming / Companions

### How to earn XP

Master pets and mounts. Earn XP by breeding animals and traveling while mounted.

**Details**

Breeding: +60 XP per animal bred. Travel XP (approx per block): Horse +0.38, Boat +0.45, Strider +0.42, Pig +0.36, Minecart +0.50. (1 block ≈ 100 cm in stats.) End-game perks: sustain (healing), resistance, stamina, sprint speed, and luck.

***

### Milestones (quick reference)

* **Trainer's Instinct** — Unlocks the Taming / Companions tree.
* **Keystone — Beastmaster's Pact** — A powerful bond focused on survival.
* **Keystone — Master Rider** — Mobility-focused mastery.
* **Keystone — Pack Guardian** — Offense-focused mastery.
* **Keystone — Tamer's Fortune** — Fortune-focused mastery.

<details>

<summary><strong>Full skill list (61 skills)</strong></summary>

**Trainer's Instinct**

Unlocks the Taming / Companions tree. • +1% Resistance • +1% Stamina

**+1 Armor**

Improves your protection. • +1 Armor

**+1 Armor II**

Further improves your protection. • +1 Armor

**+1 Luck**

Increases your luck. • +1 Luck

**+1 Luck (Bonus)**

A small luck bonus. • +1 Luck

**+1 Luck II**

Increases your luck. • +1 Luck

**+1 Luck III**

Increases your luck. • +1 Luck

**+1 Luck IV**

Increases your luck. • +1 Luck

**+1 ❤ (Bond II)**

Strengthens your bond even further. • +1 Max Heart

**+1 ❤ (Bond III)**

Strengthens your bond. • +1 Max Heart

**+1 ❤ (Bond)**

Strengthens your bond. • +1 Max Heart

**+1 ❤ (Bonus)**

A small health bonus. • +1 Max Heart

**+1% Resistance**

A small resistance bonus. • +1% Resistance

**+10% Knockback Resistance**

Get pushed back less. • +10% Knockback Resistance

**+10% Knockback Resistance**

Stay in the saddle. • +10% Knockback Resistance

**+2% Resistance**

Take slightly less damage. • +2% Resistance

**+2% Sprint Speed**

A small speed bonus. • +2% Sprint Speed

**+3% Attack Speed**

Attack a bit faster. • +3% Attack Speed

**+3% Healing**

A small healing bonus. • +3% Healing

**+3% Melee Damage**

Stronger hits. • +3% Melee Damage

**+3% Ranged Damage**

Stronger ranged hits. • +3% Ranged Damage

**+3% Stamina**

A small stamina bonus. • +3% Stamina

**+4% Melee Damage**

Stronger melee hits. • +4% Melee Damage

**+5% Attack Speed**

Attack faster. • +5% Attack Speed

**+5% Ranged Damage II**

Improves your ranged attacks. • +5% Ranged Damage

**+5% Stamina**

More stamina. • +5% Stamina

**+6% Melee Damage**

Stronger hits in close combat. • +6% Melee Damage

**+7% Attack Speed**

Attack a bit faster. • +7% Attack Speed

**Anchored +10% Knockback Resistance**

You get pushed back less. • +10% Knockback Resistance

**Breathing Room +4% Healing**

Recover faster between fights. • +4% Healing

**Cadence +4% Stamina**

Maintain pace longer. • +4% Stamina

**Cadence II +6% Stamina**

More stamina for long rides. • +6% Stamina

**Cadence III +8% Stamina**

Ride longer without slowing down. • +8% Stamina

**Carapace +5% Resistance**

You can take heavier hits. • +5% Resistance

**Care +4% Healing**

Better recovery. • +4% Healing

**Care II +8% Healing**

Stronger recovery. • +8% Healing

**Care III +10% Healing**

Take better care of yourself and your companions. • +10% Healing

**Caution +2% Resistance**

Take slightly less damage. • +2% Resistance

**Control +3% Sprint Speed**

Run a bit faster. • +3% Sprint Speed

**Control II +4% Sprint Speed**

Run faster. • +4% Sprint Speed

**Control III +5% Sprint Speed**

Run even faster. • +5% Sprint Speed

**Control IV +6% Sprint Speed**

Maintain high speed more easily. • +6% Sprint Speed

**Cool Head +3% Resistance**

Safer while traveling. • +3% Resistance

**Endurance +5% Stamina**

Improves your stamina. • +5% Stamina

**Guardian Plating +1 Armor Toughness**

You can take heavier hits without staggering. • +1 Armor Toughness

**Keystone — Beastmaster's Pact**

A powerful bond focused on survival. • +12% Healing • +8% Resistance • +2 Max Hearts

**Keystone — Master Rider**

Mobility-focused mastery. • +15% Sprint Speed • +12% Stamina • +5% Resistance

**Keystone — Pack Guardian**

Offense-focused mastery. • +10% Melee Damage • +6% Resistance • +6% Healing

**Keystone — Tamer's Fortune**

Fortune-focused mastery. • +2 Luck • +10% Healing • +6% Stamina

**Management +5% Stamina**

More stamina. • +5% Stamina

**Management II +7% Stamina**

Better stamina management during long sessions. • +7% Stamina

**Mark: Beastmaster**

Specialization mark. • Unlocks Beastmaster path bonuses

**Mark: Handler**

Specialization mark. • Unlocks Handler path bonuses

**Mark: Pack Leader**

Specialization mark. • Unlocks Pack Leader path bonuses

**Mark: Rider**

Specialization mark. • Unlocks Rider path bonuses

**Natural Healing +5% Healing**

Your regeneration effects are slightly stronger. • +5% Healing

**Natural Recovery +10% Healing**

Your regeneration effects are more effective. • +10% Healing

**Reactivity +3% Sprint Speed**

Move faster. • +3% Sprint Speed

**Recovery +8% Healing**

Regeneration is more efficient. • +8% Healing

**Steady Rider +4% Resistance**

Less vulnerable while traveling. • +4% Damage Resistance

**Thick Skin +3% Resistance**

Reduces incoming damage. • +3% Resistance

</details>

## Commands (Admin)

Pufferfish’s Skills provides commands to manage points, experience, and unlocks.

### Points

* Add points\
  `/puffish_skills points add <player> <category> <count>`
* Set points\
  `/puffish_skills points set <player> <category> <count>`

### Experience

* Add XP\
  `/puffish_skills experience add <player> <category> <amount>`
* Set XP\
  `/puffish_skills experience set <player> <category> <amount>`

### Skills

* Unlock a skill\
  `/puffish_skills skills unlock <player> <category> <skill>`
* Reset skills in a category (refund points)\
  `/puffish_skills skills reset <player> <category>`

### Categories

* Lock / unlock\
  `/puffish_skills category lock <player> <category>`\
  `/puffish_skills category unlock <player> <category>`
* Erase a category (hard reset: points + XP + skills)\
  `/puffish_skills category erase <player> <category>`

## Troubleshooting

### “Invalid Configuration” on startup

This usually means a JSON file is invalid or a category folder is mis‑named.

#### Checklist

1. Check logs (`latest.log`) and search for `puffish_skills`.
2. Make sure every category folder contains the expected files:
   * `category.json`
   * `definitions.json`
   * `skills.json`
   * `connections.json`
   * `experience.json`
3. Category folder names should only use **a–z** and underscores (`_`).
4. If you edited `skills.json` manually: re‑export from the editor (manual edits are discouraged).

### Skill screen is empty

* Make sure the datapack/mod is installed **in the correct place**.
* Run `/reload` after changing datapacks.
* Verify you have the required mods installed.

### Server doesn’t show the same tree as the client

Ensure **the server** has the pack installed. Clients follow the server’s skill configuration.

## Editing & Localization (Optional)

### Recommended workflow

Use the official editor to edit layout and connections.\
Manual edits to `skills.json` are not recommended.

### Editing English text

Most player-facing text lives in:

* `category.json`: `title`, `description`, `extra_description`
* `definitions.json`: `title`, `description`

#### Multi-language strategy (simple & clean)

Publish:

* a full **EN pack**
* a full **FR pack** …and let modpack owners pick one (or maintain parallel branches).

Tip: keep naming consistent (same words for the same mechanics across categories).

## Folder Structure (Optional)

Each category lives in its own folder and can include:

* `category.json` — category name/icon/background
* `definitions.json` — skill templates (title, icon, rewards, description)
* `skills.json` — skill nodes + positions (use editor, don’t hand edit)
* `connections.json` — links between nodes
* `experience.json` — XP sources + per-level formula

Typical datapack layout:

```
data/puffish_skills/categories/<category_name>/
  category.json
  definitions.json
  skills.json
  connections.json
  experience.json
```