Respec Skill

# Respec Skill Mod Reset and reallocate your skills used in (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. !(https://cdn.modrinth.com/data/cached_images/f18c5f04fdc806a9adc8acafa8ae1588ed4f4f83.png) # Commands | Command | Permission | Description | | --- | --- | --- | | `/respec` | All players | Opens the chat menu listing every Puffish category with a clickable `` button. | | `/respec <namespace:category>` | All players | Respecs the given category directly. Used by the menu's `` 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 `` button. ### 2. Click `` (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). ```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: <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: ```properties # 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`). <details> <summary>1.x docs</summary> **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: !(https://cdn.modrinth.com/data/cached_images/68beb43e27e38c317879286b21e66b20498de157.png) 2. Build a **Skill Altar** by placing a configured skill block with a lodestone on top. Example setup for the (https://modrinth.com/datapack/default-skill-trees): !(https://cdn.modrinth.com/data/cached_images/5ed253ed7fb86a670ca34a380505cb3c123ed14f.png) 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.