Vulire Skill Mod v1.3.2

Overview

Vulire Skill Mod is a comprehensive skill system for Minecraft 1.20.1 that introduces 21 unique skills across 5 categories, providing hundreds of hours of progression-based gameplay. The mod transforms the Minecraft experience by adding meaningful character development, social features, and challenging goals.

Key Features

21 Skills with levels 1-99 and balanced XP progression curves
Mount System - Per-entity horse and boat leveling with XP gains from riding and stat bonuses
Data-Driven Configuration System - Fully customizable skills through JSON files
Multi-Skill Requirements - Advanced items can require multiple skills (Attack + Strength, etc.)
Beautiful GUI with parchment-style skill books and skill icons
Advanced Clan System with capability-based persistence, ranks, chat channels, alliances, and wars
XP Lamp System with 8 lamp varieties (500-100,000 XP) and command-based usage
Comprehensive Achievement System with 100+ achievements and area-based diaries
Slayer System with 200+ varied quest templates and automated task generation
Mastery Bonuses for level 90+ players with damage, efficiency, and drop rate bonuses
Advanced Configuration with per-skill XP multipliers, combat scaling, and mastery settings
Prayer Buffs providing divine protection and XP bonuses
Performance Optimizations with caching systems and security improvements
Developer API for comprehensive mod integration

Technical Information

Mod Details

Mod ID: vulireskillmod
Version: 1.3.2
Minecraft Version: 1.20.1
Forge Version: 47.4.0
Java Version: 17+
License: All Rights Reserved

Dependencies

Minecraft: 1.20.1
Forge: 47.4.4 or later
Java: 17 or higher

Skills System

Combat Skills (5)

Attack 🗡️ - Melee weapon effectiveness and tool requirements
Strength 💪 - Increases melee damage output
Defence 🛡️ - Armor effectiveness and damage reduction
Hitpoints ❤️ - Health and regeneration improvements
Ranged 🏹 - Bow and crossbow effectiveness

Gathering Skills (5)

Mining ⛏️ - Ore extraction and underground exploration
Woodcutting 🪓 - Tree harvesting and wood processing
Excavation ⛏️ - Digging and excavation of soft materials
Fishing 🎣 - Aquatic resource gathering
Farming 🌾 - Agricultural development and crop management

Artisan Skills (6)

Cooking 🍳 - Food preparation and enhancement
Fletching 🏹 - Bow and arrow crafting
Firemaking 🔥 - Fire-related activities and furnace efficiency
Crafting 🔨 - General item creation and tool manufacturing
Smithing ⚒️ - Metal working and weapon/armor creation
Construction 🏗️ - Building and architectural projects

Support Skills (5)

Agility 🏃 - Movement improvements and obstacle navigation
Herblore 🧪 - Potion brewing and alchemical enhancement
Thieving 🥷 - Stealth activities and resource acquisition
Slayer ⚔️ - Monster hunting and quest completion
Prayer 🙏 - Divine protection and spiritual enhancement

Mount System

Horse and Boat Leveling

The mount system allows individual horses and boats to level up as entities, gaining XP and stat bonuses from being ridden and used.

Horse Leveling 🐎

Experience Sources:
- Passive Riding: 15 XP every 100 ticks while moving (minimum 1 block distance)
- High-Speed Travel: 25 XP every 80 ticks at speeds ≥0.5 blocks/tick
Level Progression: Horses advance from level 1 to 50 with quadratic XP requirements (100 + level² × 25)
Bonuses by Level:
- Speed Bonus: +1% movement speed per level (configurable, default 0.01 = 1%)
- Health Bonus: +1 HP per level (configurable, default 1.0 HP = 0.5 hearts)
Visual Indicators: Level and XP display above the horse when riding

Boat Leveling ⛵

Experience Sources:
- Passive Riding: 15 XP every 100 ticks while moving (minimum 1 block distance)
- High-Speed Travel: 25 XP every 80 ticks at speeds ≥0.5 blocks/tick
- Distance Travel: 30 XP every 50 blocks traveled on water
Level Progression: Boats advance from level 1 to 50 with quadratic XP requirements
Bonuses by Level:
- Speed Bonus: +5% water speed per level (configurable, default 0.05 = 5%)
Persistence: Boats can be picked up (sneak + right-click) and their levels are preserved in the item form
Visual Indicators: Level and XP display above the boat when riding

Mount Features

Per-Entity Progression: Each individual horse and boat levels up independently
Real-time XP Display: Action bar shows XP gains and current level/XP progress
Level-up Notifications: Special messages when mounts reach new levels
Configuration: All XP rates and bonuses are fully configurable in server settings
Multiplayer Support: Mount progression works in multiplayer environments

Data-Driven Configuration System

Overview

Vulire Skill Mod v1.2.8 introduces a comprehensive data-driven configuration system that allows server administrators to customize every aspect of the skill system through JSON files.

Key Benefits

Single Source of Truth: All skill data is centralized in easy-to-edit JSON files
Server Customization: Admins can adjust XP values, level requirements, and skill progression
Mod Compatibility: Easy integration with other mods through simple JSON configuration
Version Control Friendly: Changes are isolated to specific skill files
No Code Changes Required: Full customization without touching Java code

Configuration Files

Located in data/vulireskillmod/skills/:

Block-Based Skills (mining, woodcutting, farming, construction)

{
  "skill": "mining",
  "description": "The art of extracting ore and minerals from the earth",
  "blocks": {
    "minecraft:stone": { "xp": 3, "level_required": 1 },
    "minecraft:coal_ore": { "xp": 17, "level_required": 10 },
    "minecraft:iron_ore": { "xp": 35, "level_required": 15 },
    "minecraft:diamond_ore": { "xp": 100, "level_required": 50 }
  }
}

Item-Based Skills (crafting, smithing, cooking, fletching)

{
  "skill": "crafting",
  "description": "Creating items from raw materials",
  "items": {
    "minecraft:planks": { "xp": 5, "level_required": 1 },
    "minecraft:stick": { "xp": 2, "level_required": 1 },
    "minecraft:chest": { "xp": 25, "level_required": 15 }
  }
}

Entity-Based Skills (combat, slayer)

{
  "skill": "combat",
  "description": "Combat training and monster hunting",
  "entities": {
    "minecraft:zombie": { "xp": 25, "level_required": 1 },
    "minecraft:skeleton": { "xp": 30, "level_required": 5 },
    "minecraft:ender_dragon": { "xp": 500, "level_required": 80 }
  }
}

Equipment-Based Skills (combat, prayer, etc.)

{
  "skill": "combat",
  "description": "Combat training and weapon mastery",
  "weapons": {
    "minecraft:wooden_sword": {
      "requirements": {
        "attack": 1
      },
      "damage_bonus": 0,
      "rarity": "common"
    },
    "minecraft:diamond_sword": {
      "requirements": {
        "attack": 40,
        "strength": 30
      },
      "damage_bonus": 2.0,
      "rarity": "rare"
    },
    "minecraft:netherite_sword": {
      "requirements": {
        "attack": 60,
        "strength": 50,
        "hitpoints": 40
      },
      "damage_bonus": 3.0,
      "rarity": "legendary"
    }
  }
}

Tool and Equipment Requirements

{
  "tools": {
    "minecraft:iron_pickaxe": { "level_required": 10 },
    "minecraft:diamond_pickaxe": { "level_required": 30 },
    "minecraft:netherite_pickaxe": { "level_required": 75 }
  },
  "equipment": {
    "minecraft:iron_sword": { "level_required": 10 },
    "minecraft:diamond_sword": { "level_required": 30 }
  }
}

Tag Support

The system supports Minecraft tags for grouping multiple items/blocks:

{
  "tags": {
    "#minecraft:logs": { "xp": 25, "level_required": 1 },
    "#forge:ores": { "xp": 35, "level_required": 15 }
  }
}

Multi-Skill Requirements

One of the most powerful features is the ability to set multiple skill requirements for items, blocks, and equipment. This creates realistic progression gates where advanced items require mastery of multiple skills.

How Multi-Skill Requirements Work

All requirements must be met - Players need to meet every skill requirement to use the item
Flexible combinations - Mix any skills together (Attack + Strength, Mining + Construction, etc.)
Progressive difficulty - Higher-tier items require more skills at higher levels
Realistic progression - Advanced weapons require both offensive and defensive skills

Examples of Multi-Skill Requirements

Advanced Weapons:

{
  "weapons": {
    "minecraft:diamond_sword": {
      "requirements": {
        "attack": 40,
        "strength": 30
      }
    },
    "minecraft:netherite_sword": {
      "requirements": {
        "attack": 60,
        "strength": 50,
        "hitpoints": 40
      }
    }
  }
}

Specialized Tools:

{
  "tools": {
    "modded:master_drill": {
      "requirements": {
        "mining": 80,
        "smithing": 70,
        "construction": 60
      }
    }
  }
}

Advanced Blocks:

{
  "blocks": {
    "modded:reinforced_obsidian": {
      "requirements": {
        "mining": 85,
        "smithing": 75
      }
    }
  }
}

Common Multi-Skill Combinations

Combat Equipment: Attack + Strength + Hitpoints
Advanced Tools: Primary Skill + Smithing + Construction
Magical Items: Prayer + Herblore + Crafting
Specialized Gear: Multiple combat skills + relevant support skills

Benefits for Server Admins

Realistic Progression: Advanced items require well-rounded characters
Skill Balance: Encourages players to develop multiple skills
Server Customization: Create unique progression paths
Mod Integration: Perfect for modded items that should require multiple skills

Customization Examples

Adjust XP Rates: Make mining more rewarding by increasing XP values
Change Level Requirements: Lower requirements for easier progression
Add Modded Content: Include items from other mods by adding their IDs
Balance Skills: Fine-tune individual skills without affecting others
Create Custom Progressions: Design unique XP curves for your server

Clan System

Core Features

Capability-Based Storage: Uses Minecraft's capability system for reliable data persistence
Multi-Level Hierarchy: Owner, Deputy, General, Sergeant, Corporal, Recruit ranks
Permission System: Fine-grained control over clan member actions
Clan Creation: Create clans with custom names and tags

Communication System

Clan Chat (/cc <message>): General clan communication
Officer Chat (/oc <message>): Leadership-only communication
Leader Chat (/lc <message>): Owner and deputy-only communication
Chat Formatting: Rank-based chat prefixes and color coding

Diplomatic Features

Alliance System: Form alliances with other clans
War Declarations: Declare wars for competitive gameplay
Neutral Relations: Maintain neutral standings with other clans
Diplomatic Commands: Manage relationships through commands

Achievement System

Achievement Categories

Skills Achievements: Level milestones for all skills
Combat Achievements: Monster hunting and boss fights
Slayer Achievements: Quest completion milestones
General Achievements: Mining, crafting, and exploration goals

Achievement Diaries

Area-based achievement collections with tiered difficulty levels:

Easy Tasks: Basic skill requirements and simple objectives
Medium Tasks: Intermediate goals requiring dedication
Hard Tasks: Challenging objectives requiring skill
Elite Tasks: Master-level achievements for dedicated players

XP Lamp System

Available XP Lamps

500 XP Lamp: Basic lamp for early achievements
1000 XP Lamp: Common reward for easy achievements
2500 XP Lamp: Medium achievement reward
5000 XP Lamp: Significant XP boost for hard achievements
10000 XP Lamp: Major XP reward for elite achievements
25000 XP Lamp: Rare high-value lamp
50000 XP Lamp: Exceptional reward for major accomplishments
100000 XP Lamp: Ultimate XP lamp for the most challenging achievements

Usage

Use the /xplamp <skillname> command to apply XP lamps from your inventory to any skill.

Configuration

Server Configuration

Located at config/vulireskillmod-server.toml

XP Multipliers

global_xp_multiplier: Global XP multiplier (1.0 = normal)
combat_xp_multiplier: Combat skills multiplier
mining_xp_multiplier: Mining skill multiplier
woodcutting_xp_multiplier: Woodcutting skill multiplier
fishing_xp_multiplier: Fishing skill multiplier
farming_xp_multiplier: Farming skill multiplier
crafting_xp_multiplier: Crafting skill multiplier
cooking_xp_multiplier: Cooking skill multiplier
smithing_xp_multiplier: Smithing skill multiplier
construction_xp_multiplier: Construction skill multiplier

Mastery Bonuses

mastery_damage_bonus: Damage bonus for mastery level combat skills
mastery_efficiency_bonus: Efficiency bonus for mastery level gathering skills
mastery_rare_drop_bonus: Rare drop chance bonus for mastery level skills
mastery_level_requirement: Level required for mastery bonuses (default: 90)

Prayer System

prayer_xp_bonus_start_level: Level when Prayer XP bonus starts (default: 30)
prayer_xp_bonus_per_level: XP bonus per Prayer level (default: 0.002)
prayer_xp_bonus_max: Maximum XP bonus from prayer (default: 0.14)

Installation

Requirements

Minecraft: 1.20.1
Forge: 47.4.0 or later
Java: 17 or higher

Steps

Download the latest release from the releases page
Place the .jar file in your mods folder
Start Minecraft with Forge profile
The mod will auto-generate configuration files on first run

Server Installation

Install on both client and server
Configure settings in config/vulireskillmod-server.toml
Restart server to apply changes

Commands

Player Commands

/skills - Open skill book interface
/skill <skillname> - View specific skill details
/skilltop <skillname> - View skill leaderboards
/xplamp <skillname> - Use XP lamp on specified skill
/clan help - View clan command help
/achievements - View achievement progress

Clan Commands

/clan create <name> - Create a new clan
/clan disband - Disband your clan (Owner only)
/clan info [clanName] - View clan information
/clan leave - Leave your current clan
/clan list - List all clans on the server
/clan invite <player> - Invite a player to your clan
/clan accept - Accept a clan invitation
/clan deny - Deny a clan invitation
/clan kick <player> - Remove a player from clan
/clan promote <player> - Promote a clan member
/clan demote <player> - Demote a clan member
/cc <message> - Send message to clan chat
/oc <message> - Send message to officer chat (Sergeant+)
/lc <message> - Send message to leader chat (Deputy+)

Admin Commands

/skillmod reload - Reload configuration files
/skillmod backup <player> - Backup player skill data
/skillmod restore <player> - Restore player skill data
/skillmod setlevel <player> <skill> <level> - Set player skill level
/skillmod addxp <player> <skill> <amount> - Add XP to player skill
/skillmod reset <player> [skill] - Reset player skills
/skills test bonuses - Run automated skill bonus verification

API Documentation

For Mod Developers

The Vulire Skill Mod provides comprehensive APIs for integration with other mods.

Skill API (ISkillAPI)

// Get player skill level
int level = VulireSkillAPI.getSkillLevel(player, Skill.MINING);

// Add experience with validation
boolean leveledUp = VulireSkillAPI.addExperience(player, Skill.CRAFTING, 100);

// Check skill requirements
boolean hasLevel = VulireSkillAPI.hasLevel(player, Skill.SMITHING, 50);

Clan API (IClanAPI)

// Get player clan
Clan clan = VulireSkillAPI.getPlayerClan(player);

// Check permissions
boolean canInvite = VulireSkillAPI.hasPermission(player, ClanPermission.INVITE_MEMBERS);

Achievement API (IAchievementAPI)

// Award achievement
VulireSkillAPI.awardAchievement(player, AchievementType.FIRST_LEVEL_50);

// Check completion
boolean completed = VulireSkillAPI.hasAchievement(player, achievement);

Development

Development Environment

IDE: IntelliJ IDEA recommended
JDK: Java 17+
Gradle: 8.8+
Mappings: Official Mojang mappings
Testing: Automated test suite included

Version History

v1.3.2

New feature added to show unlocks in the chat (Client side)
Fixed a bug where woodcutting would not award XP
Fixed a bug where the clan UI would break on small displays

v1.3.1

Fixed a bug where XP Lamps would be given on server reboot
Fixed a bug where Construction was not awarding saved blocks to the user

v1.3.0

Fixed a bug where equipment required gathering levels to attack
Fixed a bug where equipment required attack levels to gather
Fixed a bug where all datapack files were not generated on server start
Moved all configuration settings to datapacks
Performance improvements
Level requirements updated

v1.2.9

Fixed a UI bug with the slayer book

v1.2.8

NEW: Mount System - Per-entity horse and boat leveling with XP from riding and stat bonuses
NEW: Excavation Skill - Digging and excavation of soft materials with shovel-based activities
NEW: Data-Driven Configuration System - Complete skill customization through JSON files
Advanced configuration options
Performance improvements

v1.2.7

Item duplication bug resolved
New Clan interface
Hotkeys added for the skillbook and the slayer book (J & K Keys)
Server config for clan bank slots

v1.2.6

/clan now opens a clan GUI
XP Lamps now have a GUI

v1.2.5

Major clan system overhaul with capability-based persistence
Comprehensive XP lamp system (8 varieties)
Enhanced achievement system with diaries
Advanced configuration options
Mastery bonus system
Performance improvements
Slayer task cancellation
New option to turn bonus messages off

v1.2.4

Skill Icons added to the Skill Codex
Server TOML updated to enable / disable skills

v1.2.3

Performance updates
Fixes a bug with the XP lamp achievements

v1.2.0

Massive upgrades to the Slayer system (200+ tasks)

v1.1.7

Current release with 19 skills and comprehensive features

v1.1.6

Added Prayer buffs and expanded Slayer quests

v1.1.5

Introduced clan system and achievements

v1.1.4

Core skill system and basic functionality

Earlier versions

Development and testing phases

Credits

Development Team

Nyhr - Lead Developer and Creator

Special Thanks

Minecraft Forge Team - Framework and development tools
Mojang Studios - Minecraft base game
Community Contributors - Testing, feedback, and suggestions
Doleman - Allowing me to use your server and community to act like guinea pigs and amazing insight on future features
CallOfMage Community - All of the play testing and feedback
karasunezumi - Datapack suggestion
spake404 - Skill Book and Slayer Book Hotkey suggestion
*HoodSimba - Unlock message after leveling suggestion

License

Thank you for using Vulire Skill Mod! We hope you enjoy the enhanced Minecraft experience with meaningful progression, social features, and engaging challenges.

Vulire Skilling