promotional bannermobile promotional banner
premium banner

Fishguy’s Modular Skills

Vanilla-friendly configurable skills mod with FTB Ultimine, Tide and EconMC integration

Description

Fishguy's Bearly Vanilla - Modular Skills

Bearly Vanilla - Skills (or Fishguy's Modular Skills) adds a fully configurable skill progression system to Minecraft while staying server-friendly and modpack-ready.

This mod is designed to feel lightweight and not overpowered, while still giving server admins and modpack developers deep control over progression.

With built-in FTB Ultimine, Tide 2, Econ: Market and Commerce, and Modular Toasts API integration

Features

Currently included skills:

  • Mining
  • Farming
  • Fishing
  • Combat
  • Riding

Each skill gains XP from real gameplay actions and levels up using configurable formulas.

GUI

Bearly Vanilla - Skills includes a polished in-game skills journal:

As of v1.0.9:

Skill Progression

Each skill has:

  • Its own XP formula
  • Its own XP sources
  • Its own rewards
  • Optional reward ranges for bulk progression setup
  • Its own GUI display and reward journal path

Skills are defined in JSON, so admins can rebalance progression without editing code.

Rewards

Skills can grant rewards at exact levels or across level ranges.

Supported reward types include:

  • Items
  • Money rewards
  • Passive enchantment-style buffs
  • Abilities
  • Commands
  • Unlock Recipes

Examples:

  • Mining can grant Fortune, Efficiency, Unbreaking, Ultimine, unlocking better pickaxe recipes, and money
  • Farming can grant bonus yield, golden crop chances, growth speed, and money
  • Fishing can grant Lure, Luck of the Sea, double rewards, treasure bonus effects, and money

Built-In Integrations

Modular Toasts API

Level-ups and rewards can display as custom notifications using Modular Toasts API.

FTB Ultimine

Mining progression can unlock and scale Ultimine usage.

Tide 2

Fishing skill progression supports Tide 2 fish and fishing-related reward behavior.

EconMC

Money rewards can be granted directly through EconMC if installed.

The mod is built so optional integrations can be supported cleanly, while core progression still works on its own.

Mining

Mining levels through breaking configured blocks and ores.

Mining Rewards

Possible mining rewards include:

  • Efficiency
  • Fortune
  • Unbreaking
  • Ultimine (via FTB Ultimine)
  • Money rewards (via EconMC)
  • Custom items
  • Commands
  • Unlock Recipes

Mining Notes

  • Natural Unbreaking can refund tool durability
  • Ultimine support respects the player’s unlocked Ultimine rank
  • Ultimine block limits were adjusted to match the current progression setup

Farming

Farming levels through harvesting configured crops and plant-type blocks.

Farming Rewards

Possible farming rewards include:

  • Bonus Yield
  • Growth Speed
  • Golden Crop rewards
  • Money rewards
  • Items
  • Commands
  • Unlock Recipes

Farming Notes

  • Bonus Yield can drop extra normal crop items
  • Golden Crop can drop upgraded/special harvest rewards
  • Growth Speed periodically boosts nearby crop growth around the player
  • Growth behavior is configurable through JSON

Fishing

Fishing levels through catching configured fish and loot.

Fishing Rewards

Possible fishing rewards include:

  • Lure
  • Luck of the Sea
  • Double Rewards
  • Treasure Bonus
  • Money rewards
  • Items
  • Commands
  • Unlock Recipes

Fishing Notes

  • Double Rewards can duplicate caught loot
  • Lure can grant extra fish-like catches
  • Treasure Bonus can spawn extra treasure rolls
  • Luck of the Sea can add bonus treasure chance
  • Fishing bonus loot is spawned near the player for easy testing and visibility

Config Manual

A very detailed PDF guide on every single config type is available in my Discord server, join us!

Admin / Modpack Configurability

This mod was built to be configurable first.

Main Skill JSON Files

Located in:

 
config/bvskills/
 

Default skill files include:

  • mining.json
  • farming.json
  • fishing.json

These files control:

  • Skill id
  • Display name
  • XP formula
  • XP sources
  • Rewards
  • Reward ranges

Reward Ranges

Reward ranges let admins define rewards for many levels at once instead of writing every level manually.

Example use cases:

  • Reward money from levels 1–100
  • Bigger money rewards from 101–200
  • Repeat a reward every 5 levels
  • Include or exclude specific levels

This makes large progression trees far easier to maintain.

Skill Effect Config

The mod also includes a separate tuning config for passive effect strength and proc chances:

config/bvskills/skill_effects.json
 

This file controls the actual strength and proc rate of effects such as:

Farming

  • bonus_yield_chance
  • bonus_yield_extra_min
  • bonus_yield_extra_max
  • golden_crop_chance
  • growth_speed_interval_ticks
  • growth_speed_attempts
  • growth_speed_radius
  • growth_speed_proc_chance

Fishing

  • double_rewards_chance
  • lure_extra_fish_chance
  • treasure_bonus_chance
  • treasure_bonus_extra_rolls
  • luck_of_the_sea_bonus_treasure_chance

Mining

unbreaking_refund_chance

  • All chance values use decimal format:
  • 0.0 = never
  • 0.5 = 50%
  • 1.0 = guaranteed

This makes balancing easy and also makes testing easy by setting ridiculous values temporarily.

Fortune Block Config

Natural mining fortune behavior is also configurable through:

config/bvskills/fortune_blocks.json
 

This file defines:

  • Which blocks support natural fortune
  • What item they drop
  • Base drop count
  • Multiplier scaling

Unlock Recipe

Recipes can now be locked behind specific skill levels using the Unlock Recipes reward type. This allows modpack developers and server owners to gate progression naturally through gameplay instead of only through item access.

Examples:

  • Better pickaxe recipes locked behind Mining
  • Advanced farming recipes locked behind Farming
  • Fishing-related crafts locked behind Fishing

How it works

  • Recipes can be assigned as rewards in skill JSON files
  • Each recipe can require a specific skill and level
  • Players only gain access once they meet the requirement
  • Locked recipes are automatically synced as players level up
  • Recipe unlocks persist through relogs, respawns, reloads, and admin level changes

Vanilla Crafting Enforcement

This system properly enforces recipe locks for:

  • Player 2x2 crafting
  • Crafting table 3x3 crafting

If a recipe is skill-locked and the player does not meet the requirement, the crafting result is blocked until the required level is reached.

This makes it possible to create progression systems where players must actually earn access to crafted gear, tools, and recipes through the skills system.

For more information, visit my discord server for the guide pdf.

 

Commands

Reload configs

 
/skills reload
 

Reloads:

  • Skill JSON files
  • Reward tables
  • Reward ranges
  • Fortune config
  • Passive skill effect config
  • Online player sync

This allows admins to edit JSON configs and apply the changes without requiring a full restart in most cases.

Set XP

 
/skills setxp <player> <skill> <amount>
 

Set Level

 
/skills setlevel <player> <skill> <level>
 

 

Show Skills

 
/skills show
/skills show <player>
 

Show Buffs

 
/skills buffs
/skills buffs <player>
 

Leaderboard

 
/skills leaderboard <skill>
 

Example Progression Ideas

Mining

  • Early game: Efficiency and small money rewards
  • Mid game: Fortune and Ultimine unlocks (if FTB Ultimine is installed)
  • Late game: stronger Unbreaking and larger money rewards

Farming

  • Early game: bonus crop yield
  • Mid game: better golden crop rates
  • Late game: stronger crop growth aura and larger harvest bonuses

Fishing

  • Early game: extra fish
  • Mid game: duplicated catches
  • Late game: high treasure chance and premium loot rewards

Designed For

Bearly Vanilla - Skills was built specifically for Roman_Bearman's faction server.

However, it is not limited, and it is still a good fit for:

  • Vanilla+ Servers
  • RPG survival servers
  • Economy-based servers
  • Progression modpacks
  • Custom modpacks needing JSON-driven progression
  • Solo runs

Important Notes

Existing config files are not automatically overwritten by newer defaults

Admins should edit the files inside:

config/bvskills/

After editing configs, use:

/skills reload
 
  • Optional integrations require the supported mod to be installed
  • Some integrations are optional, while others are only active if present

Testing Tips

To verify passive effects quickly:

  • set chances to 1.0
  • set bonus amounts very high
  • reload with /skills reload
  • test the effect immediately

Examples:

  • guaranteed bonus farming yield
  • guaranteed fishing treasure
  • guaranteed unbreaking refund
  • very fast crop growth

This makes it easy to confirm whether a reward path is working correctly before final balancing.

Why Use This Mod?

Bearly Vanilla - Skills gives you:

  • Meaningful long-term progression
  • RPG-like skill leveling
  • Configurable reward trees and unlockables
  • Built-in GUI
  • Optional economy and toast integration
  • JSON-first balancing
  • Admin-friendly live reload workflow for servers

It is built for people who want vanilla progression that feels customizable without affecting important parts of the game like PVP or combat.

Current Focus

Current systems are centered around:

  • Mining
  • Farming
  • Fishing
  • Passive effects
  • JSON-driven progression
  • Economy support via EconMC
  • Tide and FTB Ultimine support
  • Notification Support via Modular Toasts API

More expansion is possible through additional rewards, if you have suggestions for a new skill let me know.

Support Me!

If you like my work, consider supporting me on my Patreon, or join my Discord server!