Respec Skill Mod

Reset and reallocate your skills used in Pufferfish's Skills easily!

Server-side mod. Players type /respec to open a clickable menu of every Puffish skill category on the server; each costs a configurable item. Categories are auto-discovered, so no setup is needed to support new skill trees.

Commands

| Command | Permission | Description |
| --- | --- | --- |
| /respec | All players | Opens the chat menu listing every Puffish category with a clickable [Reset] button. |
| /respec <namespace:category> | All players | Respecs the given category directly. Used by the menu's [Reset] button. |
| /respec prestige | All players | Lists configured prestige paths. Ineligible paths show greyed out. |
| /respec prestige <from_category> | All players | Ascends from the given category into its configured target. |
| /respec reload | Level 3 (op) | Reloads config/respec-skill.properties from disk. |

How It Works

1. Run /respec

Players see a chat menu listing every Puffish skill category loaded on the server, with the cost shown next to a clickable [Reset] button.

2. Click [Reset] (or run /respec <namespace:category>)

The mod checks:

• Player has enough total skill points in that category (min_level_to_respec)
• Player is past the cooldown (if configured)
• Player has enough of the cost item in their inventory

If all pass, the item is consumed, the category is erased, and a fraction of the previous XP is returned (xp_reduction_factor).

Configuration

Edit config/respec-skill.properties. Reload in-game with /respec reload (requires permission level 3).

# Minimum total skill points a player must have in a category before they can respec it.
min_level_to_respec = 20

# Fraction of category XP returned after respec (0.0 = lose all, 1.0 = lose none).
xp_reduction_factor = 0.2

# Cooldown in seconds between respecs (0 = no cooldown). Per player, in-memory only; resets on server restart.
cooldown_seconds = 0

# Default cost applied to every category that doesn't have an override below.
# Format:  <item_id>, <count>
default_cost = minecraft:emerald, 16

# Optional: per-category cost overrides. Categories without an override use default_cost.
# cost.puffish_skills:combat = minecraft:diamond, 4
# cost.puffish_skills:mining = minecraft:emerald, 32

You do not need to list each category. Every Puffish category loaded on the server is auto-discovered and appears in /respec automatically.

Prestige (optional)

A one-way irreversible ascension from one skill category into another. Configure paths in the same file:

# Format:  prestige.<n> = <from_category>, <to_category>, <min_points_in_from>, <xp_carryover_factor>, <cost_item>, <cost_count>
prestige.1 = puffish_skills:combat, puffish_skills:advanced_combat, 50, 0.4, minecraft:netherite_ingot, 1
prestige.2 = puffish_skills:mining, puffish_skills:master_mining,   75, 0.6, minecraft:netherite_ingot, 2

On a successful prestige, the source category is erased, the target category gains currentXp × xp_carryover_factor, and the cost is consumed. If any prestige paths are configured, /respec shows a clickable link to the prestige menu at the bottom of its output. See the Commands section above for the command syntax.

For Servers/Modpacks

Pure server-side; clients do not need the mod. Feel free to include in modpacks. Credit appreciated but not required.

1.x Legacy

The 1.x versions used a different mechanic: a craftable Respec Scroll right-clicked onto a Skill Altar (a lodestone placed on a configured base block). 2.0 removed all of that in favor of the /respec command described above.

If you are on 1.x and need that documentation, see below. Upgrading to 2.x will require regenerating the config (respec-skill.toml → respec-skill.properties).

# Respec Skill Mod Configuration
config_version = 2

min_level_to_respec = 20
xp_reduction_factor = 0.2

[skill_altar_map]
"minecraft:diamond_block" = "combat"
"minecraft:iron_block" = "mining"

[prestige_mappings]
# "combat" = "advanced_combat,true,50,0.4"
# "mining" = "master_mining,true,75,0.6"