Описание
# Respec Skill Mod
Reset and reallocate your skills used in [Pufferfish's Skills](https://modrinth.com/mod/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 ` | 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 ` | 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 `)
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).
```properties
# 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: ,
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:
```properties
# Format: prestige. = , , , , ,
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`).
1.x docs
**Features**
- **Skill Respec System:** Reset individual skill categories and get back XP to reallocate.
- **Prestige System:** Transition from one skill tree to another at high levels.
- **Configurable:** Set minimum levels and XP retention rates.
**How it worked**
1. Craft a **Respec Scroll** with this recipe:
2. Build a **Skill Altar** by placing a configured skill block with a lodestone on top. Example setup for the [Default Skill Tree](https://modrinth.com/datapack/default-skill-trees):
3. Right-click the lodestone with the scroll to reset that category's points.
4. **Prestige:** at high levels, transition into advanced trees via configured `from → to` mappings.
**1.x config (TOML)**
```toml
# 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"
```
**Client-side note (1.x only):** to see the Respec Scroll in the creative inventory or in [REI](https://modrinth.com/mod/rei), the mod also had to be installed client-side. 2.x is fully server-side.