promotional bannermobile promotional banner

Vulire Skilling

Adds 21 skills, a slayer system, a clan system, and new achievements.

Vulire Skill Mod v1.3.2

Minecraft Forge Java License

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

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

Server Installation

  1. Install on both client and server
  2. Configure settings in config/vulireskillmod-server.toml
  3. 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

This mod is released under "All Rights Reserved" license. See the license file for full terms and conditions.

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

The Vulire Skilling Team

profile avatar
Nyhr
Owner
  • 1
    Projects
  • 843
    Downloads