# 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
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://courone-owner.gitbook.io/funcube-modpacks/skills/keystone-expansion-pufferfishs-skills.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.