promotional bannermobile promotional banner
premium banner

Pufferfish Skills Leveling

An RPG Style expansion for Puffish Skills featuring multi-level progression, equipment imbuing, obtaining skills through loot, and much more!

Description

A powerful expansion for Pufferfish Skills that transforms the standard skill-unlock system into a deep, multi-tiered RPG progression experience. Designed for modpack creators who want full control over how players interact with their skill trees — from hidden techniques and equipment imbuing to full class progression systems with job tiers, quest gating, and more.

  • Need help? Join the community and open a support ticket with your crash report, latest.log, or suggestions! Blue Lotus Studios

✨ Key Features

📈 Multi-Level Skill Progression

Skills are no longer simply on or off.

  • Skill Levels: Configure skills with 5, 10, or even 100 levels.
  • Per-Level Rewards: Define unique attribute modifiers and effects at every tier.

🛡️ Equipment Imbuing & Skill Tomes

Take your skills off the menu and onto your gear.

  • Skill Tomes: Find or craft Tomes to imbue specific skills into weapons and armor at an Anvil.
  • Imbuement Slots: Items support up to 3 unique skill slots, unlocked via the Sigil of Imbuement.
  • Vanilla-Style Upgrading: Combine two identical Tomes to obtain the next skill level — just like vanilla enchanting.

📿 Curios & Skill Charms

Fully integrated with the Curios API:

  • Skill Charms: Wearable accessories that provide skill bonuses in dedicated Skill Charm slots.
  • Instant Activation: Equipping a charm applies its bonuses immediately, making them ideal for dynamic attribute effects.

🏛️ Skill Master Villager (Datapack Opt-In)

A new profession with a specialized workstation — the Skill Scribe Table:

  • Tiered Trading: Intelligent trade scaling across 5 tiers.
  • Mastery System: Unlock better prices and powerful Tomes by mastering skills yourself.
  • Reputation Awareness: Fully configurable emerald costs and experience gains.
  • Opt-In Spawning: The Skill Master and his house will only appear in the world if you include the relevant structure entry in your datapack. No unwanted spawns in vanilla or other modpack structures.

🎮 Rise of Heroes Mod Integration

Full bridge support for Rise of Heroes, turning Pufferfish Skills into the authoritative source of truth for level and XP:

  • Unlimited Job Tier Progression: Build class chains of any depth using the class_parent field — 1st Job → 2nd Job → 3rd Job → 4th Job and beyond, with no hardcoded cap. The class selection screen dynamically calculates each class's position in the chain and labels it correctly ("Choose your 3rd class", "Choose your 4th class", etc.) with proper ordinals at every tier. Child classes automatically inherit the weapon permissions of their parent — a Swordsman branching from a Mage can use both swords and staffs with no duplicate configuration needed.
  • Bridge-Owned Weapon Restrictions: Specify allowed weapons per class using explicit item IDs or Forge item tags (e.g. forge:swords). The bridge enforces these rules natively, replacing ECM's legacy restriction system when enabled.
  • enableAutoClassWeaponRestrictions: Toggle the bridge weapon system on or off from your datapack config. When enabled, the bridge handles all class weapon gating. When disabled, ECM's own system takes over.
  • Stat Point Carry-Over: Unspent stat points are preserved when a player changes class or their level data is resynced — no more losing accumulated points on transition.
  • XP & Level Sync: Pufferfish Skills is the authoritative XP and level source. All Epic Class HUD notifications (XP gain, level-up overlays) are driven by the bridge sync, not ECM's native mob kill system.

🧩 Custom NPC Quest Bridge (CNPC Integration)

Designed for servers using Custom NPCs:

  • Quest-Gated Class Progression: Map CNPC quest completions to class unlocks and progression gates via datapack configuration.
  • Clean UI: CNPC quest accept and completion toasts are suppressed and replaced with the bridge's own feedback system, preventing duplicate or conflicting notifications.

🕵️ Advanced Mechanics

  • Hidden Skills: Create secret techniques that are completely invisible until prerequisites are met.
  • Level Gating: Lock a skill tier behind a requirement from a different category.
  • Skill Refunds: Reset skills using the Tome of Clear Mind (targeted) or Greater Clear Mind (full reset).

🛠️ Requirements & Setup

This is an addon and requires the following:

  1. Pufferfish Skills — Base mod
  2. Curios API — Recommended for Skill Charms
  3. A compatible datapack with the addon's custom fields. See the template below.
  4. Getting Started Guide

📜 Datapack Driven

Everything — skill levels, villager trades, class definitions, weapon restrictions, quest mappings — is configured through standard Minecraft Datapacks. Check the Wiki & Guides for detailed JSON examples.

Example Datapack: A full starter template is available here. Most of what you already know from Pufferfish Skills carries over — the addon simply adds more fields to work with, giving you far greater control without rebuilding from scratch.

Epic Class / Rise of Heroes integration guide: Custom Class Creation Guide

🎨 Asset Credits