SimpleSkills Enhanced

SimpleSkills Enhanced

A community-developed fork of SimpleSkills, a Fabric RPG mod for Minecraft, featuring skill progression, equipment unlocks, and profession-based gameplay — expanded with new mechanics, improvements, and features.

💬 Feedback & Contact

Questions, suggestions, or bug reports? Contact me on Discord: whandger.

❤️ Original Mod & Credits

Created by obyekt (Discord: obyekt). This fork builds upon the original project while preserving its core concept and giving credit to its creator.

• Modrinth — SimpleSkills
• GitHub — Original Source

⚠️ Compatibility

Some features modify mechanics also used by other mods, including mining, woodcutting, farming, and fishing. Mods that alter these systems may cause conflicts or unexpected behavior.

🔧 Contribute

Explore the source code or contribute on the SimpleSkills Enhanced GitHub repository.

---

🏆 Progression Philosophy

Every level represents dedication, every milestone brings meaningful growth, and every skill mastered should make the journey worthwhile. Reaching level 99 is no small feat — it is the ultimate proof of commitment. Players who reach the pinnacle of a skill deserve rewards that feel extraordinary: powerful bonuses, meaningful advantages, and a true sense of mastery. The greater the effort, the greater the reward.

✨ What the Fork Adds

⛏️ Mining, 🪓 Woodcutting & 🥄 Excavating

Gathering Bonuses

• Gathering Speed: +1% block-breaking speed per level, up to +99% at level 99.
• Bonuses require the appropriate tool:
  • Mining: Pickaxe.
  • Woodcutting: Axe.
  • Excavating: Shovel.
• The bonus multiplies vanilla block-breaking speed rather than replacing its calculation.
• Tool Durability Protection: +1 percentage point per level, up to 99% at level 99.

⛏️ Mining

• Loot Duplication: +5 percentage points of duplication chance every 10 levels, up to 45% at level 90.
• Vein Mining: Unlocked at level 15. Hold Shift while mining an ore to break connected blocks of the same ore type.
• Every 15 levels adds 2 extra blocks, up to 12 additional blocks at level 90.

🪓 Woodcutting

• Loot Duplication: +5 percentage points of duplication chance every 10 levels, up to 45% at level 90.
• Tree Feller: Unlocked at level 5. Hold Shift and break a tree trunk with an axe to make the connected tree fall, including its branches and leaves.
• Fallen logs and leaves have animations. Leaves produce their normal drops when they land.

🥄 Excavating

Sand Investigation

Use a shovel to investigate Sand and search for buried treasures.

• Investigation Time: Decreases from 3 seconds at level 1 to 1 second at level 99.
• Investigations are processed server-side.
• Only one player can investigate a specific Sand block at a time.
• Changing the target, tool, selected slot, or dimension, moving too far away, or releasing the interaction cancels the investigation.
• Canceled investigations leave the Sand block untouched and consume no durability or XP.

Ranks & Rewards

• 10 unique ranks, each with its own name and color.
• Higher ranks unlock increasingly valuable rewards.
• 28 possible rewards across seven rarity tiers:
  • Common
  • Uncommon
  • Rare
  • Very Rare
  • Epic
  • Legendary
  • Mythic

Reward chances and rarity budgets scale with Excavating level. The distribution adjusts to available rewards and always totals 100%, including the chance of finding Nothing.

📊 Excavating Loot Odds

The following table shows the rarity distribution at selected Excavating levels. Nothing represents an investigation that produces no reward.

Rarity	Level 1	Level 30	Level 60	Level 99
Common	70%	35%	15%	5%
Uncommon	10%	25%	25%	15%
Rare	5%	20%	25%	25%
Very Rare	0%	0%	8%	20%
Epic	5%	7%	15%	15%
Legendary	0%	0%	3%	12%
Mythic	0%	0%	0%	8%
Nothing	10%	13%	9%	0%
Total	100%	100%	100%	100%

These percentages represent rarity distribution, not individual item drop chances. Each reward's probability depends on the available rewards and the player's Excavating level.

XP Rewards

Every completed investigation grants XP based on the discovery:

Discovery	Total XP
Nothing	40
Common	140
Uncommon	190
Rare	240
Very Rare	340
Epic	540
Legendary	840
Mythic	1540

Additional mechanics:

• Very Rare and higher discoveries trigger chat notifications.
• Legendary and Mythic discoveries also trigger special sounds and particle effects.
• Investigated Sand becomes simpleskills:investigated_sand, a special block that cannot be investigated again.
• The block retains vanilla Sand textures and properties, including gravity, breaking, drops, and placement behavior.
• Includes 18 additional recipes for sandstone, TNT, and concrete powder.
• Excavating benefits from the shared Gathering Speed and Tool Durability Protection bonuses.

---

🎣 Fishing

Fishing becomes an interactive experience where players must react to real fish, manage line tension, and fight to land their catch.

Real-Time Fishing Minigame

The fishing process has five stages:

Settling → Waiting → Approaching → Biting → Fighting

• Real Fish Entities: Uses Cod, Salmon, Tropical Fish, and Pufferfish in the world.
• Fish Approach: Fish swim toward the bait before biting.
• Bite Timing: Right-click during the bite window to start the fight.
• Directional Fights: Fish pull left, right, or pause. Counter their movement by looking in the opposite direction while reeling.
• Dynamic HUD: Displays line tension, fish fatigue, catch progress, and fish movement.
• Line Tension: Excessive tension breaks the fishing line.
• Fish AI: Fish behavior is controlled during an active session and restored when it ends.
• Fish Awareness: Fish can react to nearby players through configurable hearing and vision systems.

🐟 Individual Fish Attributes

Each fish has individual weight and length attributes, making every catch different.

• Attributes are generated individually, not fixed for an entire species.
• Fish of the same species can have different sizes and weights.
• Tropical Fish variants are supported.
• Individual attributes influence the fish's strength and fight difficulty.

💪 Size-Based Fishing Difficulty

Larger fish are generally harder to catch.

• Weight and length influence fish strength during the fight.
• Stronger fish create a greater challenge when countering movements and managing line tension.
• Smaller and lighter fish are generally easier to land.

This makes every encounter different, even when catching the same species.

📈 Size-Based Fishing XP

Fishing XP is calculated using the individual fish's characteristics.

• Both weight and length influence the XP awarded.
• Larger fish can grant more XP, while smaller catches generally grant less.
• Size-based scaling uses a square-root calculation, with a multiplier between 0.6× and 2.0×.
• The final reward is capped at 3× base XP, including the species multiplier.
• XP is calculated server-side and awarded through the normal Fishing progression system.

🎣 Fishing Catch Results

🐠 Supported Fish Species

Each species has its own fight characteristics, XP multiplier, and minimum Fishing level.

Species	Pull Strength	Fatigue Factor	XP Multiplier	Minimum Level
Cod	1.00×	1.00×	1.00×	1
Salmon	1.20×	0.85×	1.15×	1
Tropical Fish	0.85×	1.15×	1.30×	1
Pufferfish	1.10×	0.90×	1.50×	25

🌊 Fishing Ecosystem

The ecosystem manages fish populations and checks whether a location is suitable for fishing.

• Water Validation: Checks connected water volume and depth.
• Minimum Requirements: Configurable water volume and depth determine eligible locations.
• Population Management: Tracks eligible fish and replenishes the local population when needed.
• Discreet Spawning: New fish spawn away from the player and bait, preferring deeper water and locations outside the player's view.
• Population Limits: A configurable maximum prevents unlimited spawning.
• Flexible Requirements: The minimum fish count is a replenishment target, not a strict requirement. At least one eligible fish is enough to fish.

📈 Fishing Skill Progression

Fishing levels improve several aspects of the minigame:

• Fish Attraction Speed: Up to +150% at level 99 (2.5× base speed).
• Fish Fatigue: Up to +100% at level 99, making fish tire faster.
• Line Tension: Up to 40% less tension growth at level 99.
• Line Recovery: Up to +100% at level 99.

These bonuses can be configured individually.

The original fishing speed bonus can also be disabled independently through fishing_speed_bonus_enabled.

🎁 Fishing Rewards & Durability

• Main Catch: The fish item matches the species caught.
• Bonus Loot: A separate loot roll can award additional junk and treasure.
• No Duplicate Fish Category: Bonus loot excludes fish because the main catch is already awarded.
• Loot Fallback: Vanilla fishing loot is used when the custom rank-based table is unavailable or disabled.
• XP Rewards: Based on configured catch XP, the species multiplier, and the individual fish's size and weight.
• Durability: A successful catch consumes 1 fishing rod durability point.
• Escaped Fish: Escaped fish grant no XP or rewards.
• Broken Line: Applies a configurable durability penalty (default: 3).

🛠 Fishing Debug & Configuration

• Debug Command: /simpleskills fishing debug toggles detailed fishing diagnostics.
• Fishing Mechanics: Configure detection range, attraction speed, flee range, hearing, vision, fatigue, line tension, recovery, bite window, and durability penalties.
• Ecosystem: Configure minimum water volume and depth, fish population targets, maximum population, and spawning.
• Species Requirements: Set minimum Fishing levels for individual species.

---

⚔️ Slaying

• Sword Damage: +0.3% per level, up to +29.7% at level 99.
• Critical Hit Chance: +0.5 percentage points per level, up to 49.5% at level 99.
• Custom Critical Hits: Deal 1.5× damage.
• Vanilla Compatibility: Vanilla critical hits remain functional. A vanilla critical and a SimpleSkills critical can trigger on the same hit.
• Life Steal I (Level 50): 30% chance to recover half a heart.
• Life Steal II (Level 99): 60% chance to recover half a heart.
• Bonuses apply to swords during charged attacks.

🏹 Ranged

• Projectile Damage: +0.5% per level, up to +49.5% at level 99.
• Double Shot (Levels 1–50): +2 percentage points of duplication chance per level, reaching 100% at level 50.
• Triple Shot (Levels 51–99): The chance of firing a second extra projectile increases from 0% at level 50 to 100% at level 99.
• Maximum Projectiles: Up to 3 projectiles per shot.
• Weapons: Bows and Crossbows.
• Arrow Duplication: Works with both weapons.
• Firework Duplication: Works with Crossbows only.
• Multishot: Each projectile has an independent duplication chance.
• Free Duplication: Extra projectiles consume no additional ammunition and grant no extra skill XP.
• Trajectory: Duplicated projectiles follow the original direction and spawn at randomized positions.

🛡️ Defense

• Damage Reduction: +0.3 percentage points per level, up to 29.7% at level 99.
• Armor Durability Protection: +1 percentage point per level, up to 99% at level 99.
• Knockback Resistance: +0.5 percentage points per level, up to 49.5% at level 99.

🌾 Farming

Farming now offers additional perks that reward players for developing their agricultural skills.

Farming Bonuses

• Harvest Bonus: +1 percentage point of extra harvest drop chance per level, up to 99% at level 99.
• Animal Loot Bonus: +1 percentage point of extra loot chance per level, up to 99% at level 99.
  • Applies to drops from killed farm animals.
  • Also provides a chance to obtain extra wool when shearing sheep.
  • Both mechanics share the same bonus chance.

🔓 Farming Perks

Both perks unlock at Farming Level 5.

Bone Meal Mastery: Use any hoe and right-click a compatible crop to apply bone meal without consuming bone meal items.

• Levels 5–9: Costs 2 hunger bars.
• Levels 10–14: Costs 1.5 hunger bars.
• Levels 15–19: Costs 1 hunger bar.
• Level 20+: Free.

Auto Plant: Use any hoe and left-click a mature crop planted on farmland to harvest and automatically replant it.

• Uses seeds obtained from the harvested crop's own drops.
• Supports compatible crops, including modded crops where applicable.
• Only mature crops can be harvested this way.

✨ Enchanting

SimpleSkills Enhanced completely overhauls Minecraft's vanilla enchanting system, replacing the standard RNG-based table with an interactive, skill-based minigame.

⛏️ Rune Ores

• Added Rune Ore and Deepslate Rune Ore to Overworld generation.
• Mining these ores drops Runes, required for the new Enchanting system.
• Grants significant Mining XP:
  • Rune Ore: 900 XP
  • Deepslate Rune Ore: 1,100 XP

🔮 Rune Infusion Minigame

Interacting with an Enchanting Table now opens the Rune Infusion menu.

• No XP or Lapis Cost: Enchanting exclusively consumes Runes (1 Rune per selected enchantment).
• Multiple Enchantments: Select up to 4 compatible enchantments to apply to your equipment at once.

undefined

Rune Infusion — Enchantment Selection

undefined

• Interactive Gameplay: Stabilize magical energy by repairing cracks that appear directly on the equipment. Hold your click on each crack before it grows too large and damages the item's integrity.
• Difficulty Scaling: Crack speed and frequency depend on the combined levels of the selected enchantments, ranging from Calm to Chaotic.
• Grading System: Your performance is graded at the end of each infusion: Poor, Fair, Good, Excellent, or Perfect. Higher grades provide a chance to receive a bonus enchantment level for free.

undefined

Rune Infusion — Magical Stabilization Minigame

undefined

📈 Over-level Enchanting & Progression

• Tier Unlocks: Every 10 profession levels generally unlock the next enchantment tier (e.g., Level 10–19 unlocks Tier II, Level 90–99 unlocks Tier X).
• Beyond Vanilla Limits: Supported enchantments can exceed their normal maximum levels (e.g., Sharpness X), configurable through enchantment_limits.json.
• Anvil Integration: The Anvil respects your current Enchanting profession level and configured limits, allowing you to combine enchanted books up to your unlocked tiers.

🏅 Ranks & Progression

Progress through 10 unique ranks as you master the art of Rune Infusion.

Rank	Level Range
Rune Novice	1–10
Rune Initiate	11–20
Glyph Scribe	21–30
Sigil Adept	31–40
Spellweaver	41–50
Rune Binder	51–60
Arcane Infuser	61–70
Master Runesmith	71–80
Grand Runecaster	81–90
Archmage of Runes	91–99

🖥️ HUD & Interface

• Skills HUD: Refreshed appearance with the original yellow border removed.
• Reworked TAB Menu (SkillTabMenu):
  • Displayed exclusively on the multiplayer player TAB screen.
  • Shows profession benefits, progression, and per-level bonuses.
  • Improved layout and organization of skill information.
  • Locked indicators: Skills and perks that have not yet been unlocked display a LOCKED indicator, helping players identify upcoming abilities and see what they can unlock as they progress.
  • Singleplayer Compatibility: In singleplayer, the TAB menu can also be displayed using third-party mods that provide multiplayer-style TAB functionality. Carpet is one example.

⚖️ Rebalanced Equipment Progression

The original equipment level requirements were adjusted to make progression more accessible and rewarding.

During playtesting with a small group of 3–4 players, I noticed that the original requirements made progression feel too slow, especially when unlocking Iron and Diamond equipment. This could discourage players before they reached the higher skill levels.

To address this, equipment requirements were rebalanced to provide a smoother progression curve while keeping skill levels meaningful.

Tool Requirements

Each tool is unlocked through its corresponding skill:

Material	Required Skill Level
Wood	0
Gold	5
Stone	10
Copper	15
Iron	25
Diamond	30
Netherite	35

• Pickaxes use Mining.
• Axes use Woodcutting.
• Shovels use Excavating.
• Hoes use Farming.

Armor Requirements

Armor	Required Defense Level
Leather	0
Gold	0
Copper	5
Turtle Helmet	15
Chainmail	15
Iron	20
Diamond	25
Netherite	30

Additional Equipment Requirements

Equipment	Required Skill	Level
Shield	Defense	5
Mace	Slaying	35
Crossbow	Ranged	10
Bow	Ranged	0
Trident	Ranged	30
Elytra	Prayer	25

• Requirements are displayed in item lore.
• Equipment requirements can be customized in the tool_requirements.json and armor_requirements.json files inside the SimpleSkills configuration folder.
• You can change these values to match your server's preferred progression balance.

---

📜 Features from the Original SimpleSkills Mod

The features in this section belong to the original SimpleSkills project. Full credit goes to its creator, obyekt.

SimpleSkills is a server-side Fabric mod that turns Minecraft into an RPG with 15 skills, equipment unlocks, leaderboards, and progression up to level 99.

In multiplayer, players do not need to install the mod on their clients. For singleplayer, install it on the client.

⭐ Original Features

• 15 Skills: Each with its own progression and benefits.
• Gear Unlocks: Equipment such as Diamond and Netherite is restricted by skill level.
• Ironman Mode: Players lose items and XP on death, have 50% reduced HP, and receive only 0.2× XP. Includes a red skull icon and server death announcement. Can be enforced for all players.
• Leaderboards: Top 5 rankings for individual skills or total levels, including an Ironman-exclusive leaderboard. XP continues to be tracked after level 99.
• Prestige System: Reach maximum level in all skills to reset progression and earn a Prestige counter next to your name.
• Natural Economy: High-level players can offer services such as enchanting, cooking, and crafting.
• JSON Configuration: Customize gameplay and reload changes using /simpleskills reload, without restarting the server.
• Vanilla+ Experience: Simple, intuitive, and unobtrusive gameplay.

🛠️ The 15 Skills

Skill	Description
Mining	Break stone and ores to unlock better tools.
Woodcutting	Chop trees.
Excavating	Dig dirt, sand, and gravel.
Farming	Till, compost, shear, feed, breed animals, and harvest crops.
Fishing	Fish faster and unlock better loot.
Defense	Take armor hits to unlock better equipment.
Slaying	Improve melee combat progression.
Ranged	Use bows, crossbows, and tridents.
Enchanting	Unlock level-restricted enchantments at the anvil.
Alchemy	Brew potions with extended durations.
Smithing	Repair and upgrade equipment.
Cooking	Prepare meals that restore more hunger and saturation.
Crafting	Create more durable tools and armor, with a chance to recover materials.
Agility	Run, jump, and swim faster.
Prayer	Sacrifice rare items to obtain long-lasting buffs.

⚒️ Original Skill Highlights

Mining, Excavating & Woodcutting

• XP is calculated based on block hardness and the required tool.
• Block XP overrides are configured through block_mappings.json.
• Ores mined with Silk Touch grant no XP.

🍖 Cooking

Hunger and saturation multipliers by tier:

Tier	Multiplier
Novice	0.875×
Journeyman	1×
Artisan	1.125×
Expert	1.25×
Grandmaster	1.5×

Customizable XP tables encourage players to prepare a variety of foods, including Rabbit Stew, Golden Apple, and Pumpkin Pie.

🧪 Alchemy

Potion duration multipliers:

Tier	Multiplier
Novice	1×
Journeyman	1.25×
Artisan	1.5×
Expert	1.75×
Grandmaster	3×

🌾 Farming

• XP for breeding, feeding, and shearing animals.
• XP for harvesting mature crops.
• XP configuration through farming_xp.json.
• +1% chance of an extra harvest drop per level, up to 99%.
• Unlocks better hoes as players progress.

🧰 Crafting

Durability and ingredient recovery bonuses:

Tier	Durability Bonus	Ingredient Recovery
Novice	0%	0%
Journeyman	5%	2.5%
Artisan	10%	5%
Expert	15%	7.5%
Grandmaster	25%	15%

Crafted items are signed with the player's name and rank.

🔨 Smithing

Repair bonuses by tier:

Tier	Repair Bonus
Novice	25%
Journeyman	35%
Artisan	45%
Expert	55%
Grandmaster	100%

• Anvils do not take damage when repairing items.
• Diamond-to-Netherite upgrades grant additional durability bonuses: 0%, 5%, 7.5%, 10%, and 20% by tier.
• Smithing bonuses stack with Crafting bonuses.

🙏 Prayer

• Sacrifice rare items by right-clicking a lit candle.
• Five buff tiers, lasting from 1 to 8 hours.
• Examples:
  • Rabbit Foot → Luck.
  • Diamond → Speed II.
  • Totem of Undying → Invisibility.
  • Nether Star → Haste II.
• Sacrifices and buffs are customizable.

---

💻 Commands

Players

Command	Description
/simpleskills togglehud	Toggle the skills HUD.
/simpleskills ironman enable	Enable Ironman mode.
/simpleskills reset	Reset your skills.
`/simpleskills leaderboard <skill\\	total>`
`/simpleskills leaderboardironman <skill\\	total>`
`/simpleskills query <username> <skill\\	total>`
/simpleskills fishing debug	Toggle detailed fishing diagnostics.

Administrators

Command	Description
/simpleskills reload	Reload configuration files.
/simpleskills reset <username>	Reset a player's progression.
/simpleskills addxp <username> <skill> <amount>	Add XP to a player's skill.
/simpleskills setlevel <username> <skill> <level>	Set a player's skill level.
/simpleskills excavating odds <level>	Display the exact Excavating loot distribution for a level from 1 to 99.

---

⚙️ Configuration

Configuration files are located in:

server_root/config/simpleskills

Customize XP progression, unlock requirements, loot tables, Prayer sacrifices, and Ironman difficulty.

Apply configuration changes without restarting the server:

/simpleskills reload

---

🚀 Installation

1. Install Fabric Loader and Fabric API for the supported Minecraft version.
2. Download the SimpleSkills Enhanced JAR.
3. Place the JAR in your server's mods folder.
4. For singleplayer, place the JAR in your client's mods folder.
5. Customize the configuration files if desired.
6. Start Minecraft and enjoy your RPG progression!

Development Environment

Component	Version
Minecraft	26.3
Java	25.0.1
Fabric Loader	0.20.1
Fabric API	0.165.2+26.3
Fabric Loom	1.17.21

---

❤️ Credits

Original SimpleSkills

Created and maintained by obyekt.

The original concept, codebase, skill system, and original features belong to the original author.

• Modrinth — SimpleSkills
• GitHub — Original SimpleSkills
• Buy Me a Coffee — obujekuto

SimpleSkills Enhanced

Fork developed by Whandger.

This fork introduces additional features and improvements, including:

• Mining, Woodcutting, and Excavating gathering bonuses.
• Vein Mining and Tree Feller.
• Sand Investigation, Excavating ranks, and loot progression.
• Real-Time Fishing Minigame and Fishing Ecosystem.
• Individual fish weight and length attributes.
• Size- and weight-based fishing difficulty and XP.
• Slaying, Ranged, and Defense improvements.
• Farming perks: Harvest Bonus, Animal Loot Bonus, Bone Meal Mastery, and Auto Plant.
• Rebalanced equipment progression.
• HUD and TAB interface enhancements.
• Supporting technical implementations and compatibility improvements.

Built upon the original SimpleSkills project with respect for its creator and the community.