RUNESTONE VALE

RunestoneSkills

The professions and progression module of RunestoneMMO — built to turn gathering, crafting, exploration, and long-term advancement into real realm progression.

RunestoneSkills is the official skill and profession progression module for the RunestoneMMO ecosystem. It manages skill XP, level data, skill registration, profession listeners, anti-abuse protections, and skill-specific configuration for Runestone Vale.

Built on top of RunestoneCore, RunestoneSkills registers enabled skills into Core’s public skill registry so player displays, menus, scoreboards, rewards, and other systems can read progression through a shared API boundary instead of hardcoding skill logic everywhere.

In simple terms: RunestoneCore provides the shared foundation, while RunestoneSkills provides the profession progression layer that makes player effort matter.

View on Hangar Join the Discord Back to Runestone Vale

Platform: Minecraft Java Edition • Paper 1.21.11 • Java 21
Requires: RunestoneCore
Optional Integration: Oraxen

What RunestoneSkills Owns

RunestoneSkills is focused on progression. It does not own the entire server runtime, combat engine, Hub menus, NPC system, or AdminTool. Its job is to provide profession XP, skill data, skill listeners, configuration, anti-abuse rules, and Core registry integration.

Skill Progression

Stores and mutates skill XP, registers skill definitions, and supports long-term leveling through the shared RunestoneMMO XP direction.

Profession Listeners

Awards XP from live gameplay such as mining, fishing, farming, cooking, forestry, hunting, exploration, foraging, and smithing actions.

Config-Driven Tuning

Each skill has its own configuration file so XP values, anti-abuse settings, enabled state, and behavior can be tuned independently.

Core Integration

Registers enabled skills with RunestoneCore through SkillDef and provides a service-backed skill registry for UI/listing integrations.

Newest Skills Highlights

RunestoneSkills has grown into a broad profession backbone with multiple skill families, independent configs, Oraxen asset support, optional mining worldgen support, and cleaner Core API registration.

Full Skill Family Registration

The module currently wires 13 skills — Mining, Forestry, Fishing, Hunting, Farming, Cooking, Strength, Defense, Range, Exploration, Foraging, Smithing, and Logistics (sub-skill of Smithing) — into the wider RunestoneMMO progression system.

Core Registry Integration

Enabled skills are registered into RunestoneCore’s SkillsRegistry with XP providers and mutators, allowing Core systems to display and interact with progression cleanly.

Oraxen Asset Installer

RunestoneSkills includes an optional Oraxen asset installer for bundled skill-related items, models, textures, ores, and resource-pack content.

Mining Oraxen Support

Mining can award XP from a whitelist of Oraxen block IDs, including custom ore direction such as Runestone and Firestone ore.

Anti-Abuse Protection

Multiple skills include protections such as placed-block tracking, gamemode ignores, correct-tool checks, cooldowns, spawn-reason filters, and XP rate limits.

Optional Additive Ore Generation

The module includes an oregen_system.yml resource for additive custom ore placement in new chunks. Runtime stat reporting is limited, but the mining/worldgen helper remains part of the module structure.

Module Boundary

RunestoneSkills is intentionally progression-focused. It should not be treated as the owner of every gameplay system. This keeps the RunestoneMMO architecture cleaner and easier to expand.

RunestoneSkills Owns

  • Skill XP storage and mutation
  • Skill configs and tuning
  • Profession event listeners
  • Skill registration into RunestoneCore
  • RunestoneSkillRegistry service provider
  • Oraxen asset install support
  • Mining worldgen helper resources
  • Placed-block anti-abuse tracking for supported skills

Other Modules Own

  • RunestoneCore owns shared APIs, displays, commands, economy, scoreboards, and core services.
  • RunestoneCombat owns authoritative combat runtime behavior.
  • RunestoneStamina owns stamina drain, regen, HUD, buffs, and stamina brews.
  • RunestoneHub owns the Hub Compass and Login Hub UI runtime.
  • RunestoneNPCs owns NPC quests, dialogue, shops, and quest state.
  • RunestoneAdminTool owns the Admin Control Nexus and staff GUI workflows.

Live Skills in RunestoneSkills (13 Total)

RunestoneSkills currently supports 13 configured skill families. Some skills award XP directly from gameplay listeners, while Strength, Defense, and Range are data-backed stat-source skills used for broader progression integration.

Mining

  • XP from configured mineable blocks
  • Correct-tool support
  • Fortune multiplier support
  • Silk Touch multiplier option
  • Vanilla material XP overrides
  • Auto-generation support for missing material XP entries
  • Oraxen block whitelist support
  • Placed-block anti-abuse tracking

Forestry

  • XP from configured natural tree blocks
  • Axe/correct-tool requirement support
  • Natural-tree context checks
  • Placed-block anti-abuse support
  • Nether stem and hyphae support
  • Rate-limit and gamemode-ignore options

Fishing

  • XP from PlayerFishEvent outcomes
  • Fish, treasure, junk, and entity categories
  • Per-material fish XP overrides
  • Per-entity caught XP overrides
  • Fishing rod requirement support
  • Optional open-water requirement
  • Minimum catch interval and rate-limit options

Hunting

  • XP from configured passive mob kills
  • Per-entity XP overrides
  • Blocks XP from breeding, spawners, spawn eggs, commands, custom spawns, and similar farm sources
  • Can ignore babies, named mobs, and tamed mobs
  • Built to reward field hunting, not exploit farms

Farming

  • XP from harvesting configured crops and plants
  • Ageable crops can require full maturity
  • Stack-growing plants can require non-base segment breaks
  • Crop trample protection support
  • Per-material XP tuning
  • Rate-limit and gamemode-ignore options

Cooking

  • XP from crafting edible items
  • XP from extracting cooked items from furnaces, smokers, and blast furnaces
  • XP from taking cooked items from campfires
  • Source multipliers for craft, cook, smoker, blast, and campfire
  • Explicit edible material XP list
  • Cooldown and rate-limit options

Strength

  • Registered as a first-class skill
  • Data-backed skill progression source
  • Used as an offensive stat-source direction for combat progression planning
  • Does not own combat runtime damage handling

Defense

  • Registered as a first-class skill
  • Data-backed skill progression source
  • Used as a vitality/defensive stat-source direction for combat progression planning
  • Does not own combat runtime damage handling

Exploration

  • Background travel XP
  • Optimized batched sampling instead of heavy movement loops
  • Biome discovery XP
  • Landmark discovery configuration
  • Anti-teleport and anti-glide/fly/vehicle safeguards
  • Giant mushroom capitator support
  • Used as the current agility-equivalent progression source for combat planning

Foraging

  • XP from configured natural vegetation blocks
  • Strict list mode support
  • XP from right-click harvesting sources such as berries and cave vines
  • Cooldowns for break and harvest actions
  • Gamemode-ignore and rate-limit support
  • Works with placed-block tracking through the shared anti-abuse layer where applicable

Smithing

  • XP from crafting weapons, tools, and armor
  • XP from smithing table upgrades
  • XP from smelting extraction
  • Strict list mode support
  • Separate XP groups for weapons, tools, armor, smithing table actions, and smelted outputs
  • Cooldown and rate-limit options

Range

  • Ranged combat progression skill
  • Data-backed stat-source direction
  • Integrates with combat progression bridge
  • Contributes to broader player combat identity

Logistics

  • Sub-skill of Smithing
  • Covers crafting, refining, and item management progression
  • Tracks broader crafting and logistics activity beyond pure smithing
  • Registered as a separate skill family in the Core registry

Combat Progression Boundary

RunestoneSkills contributes progression data that can be consumed by other systems, but it does not own combat runtime math. This keeps skill progression separate from live combat behavior.

Progression Inputs

  • combat — overall combat progression layer owned by combat/core runtime systems
  • strength — offensive stat-source direction
  • defense — vitality/defensive stat-source direction
  • exploration — agility-equivalent stat-source direction for now

Important Boundary

  • RunestoneSkills does not apply live damage math.
  • RunestoneSkills does not own combat event outcomes.
  • RunestoneSkills registers progression data and skill definitions.
  • Combat runtime behavior belongs to the combat runtime module/service boundary.

How RunestoneSkills Connects to RunestoneCore

RunestoneSkills depends on RunestoneCore. Core provides the public APIs, skill registry, shared XP/display direction, and UI surfaces that allow skill progression to appear cleanly across the server.

SkillDef Registration

  • Each enabled skill is registered into Core using SkillDef.
  • Registration includes skill ID, display name, max level, XP provider, add-XP mutator, and set-total-XP mutator.
  • Registered IDs are unregistered cleanly on plugin disable.

Service Provider

  • RunestoneSkills registers a RunestoneSkillRegistry service provider.
  • This provides skill listing information for UI and integration systems.
  • The service includes the combat listing plus enabled RunestoneSkills skill families.

Core-Owned Display

  • Core owns the main /skills display direction.
  • RunestoneSkills supplies data and registration.
  • Daily rewards, Hub menus, scoreboards, and future systems can read progression through shared service boundaries.
Explore RunestoneCore RunestoneMMO on Hangar

Commands & Permissions

RunestoneSkills has a small admin command surface. Player-facing skill display is handled through RunestoneCore’s shared skill systems, while this module exposes admin operations for reloads, Oraxen asset installation, diagnostics, and ore-stat messaging.

Main Admin Command

  • /runestoneskills reload — reloads RunestoneSkills configs, managers, listeners, services, and skill registry wiring
  • /runestoneskills installoraxenassets — installs bundled Oraxen assets if Oraxen is present
  • /runestoneskills diag — runs diagnostics for Oraxen presence, bundled resources, and installer destinations
  • /runestoneskills orestats — reports ore-generation/stat availability messaging

Shortcuts

  • /rsr — shortcut for /runestoneskills reload
  • /rso — shortcut for /runestoneskills installoraxenassets

Permission

  • runestone.skills.admin
  • Default: OP
  • Required for all RunestoneSkills admin commands and shortcuts

Player Access Note

  • RunestoneSkills does not expose a separate player-facing skill command in its own plugin.yml.
  • Players normally view skills through Core-owned displays such as /skills and Hub/scoreboard integrations.
  • Admin XP changes are handled through Core-side admin progression tooling, not through RunestoneSkills commands.

Configuration & Runtime Files

RunestoneSkills generates its runtime configuration files under plugins/RunestoneSkills/. Each skill uses its own config so tuning remains clean and modular.

Global Config

  • config.yml
  • Controls the bundled Oraxen installer
  • Supports install-on-startup
  • Supports missing-only or overwrite-all update behavior
  • Supports installer action logging

Skill Config Files

  • mining.yml
  • forestry.yml
  • fishing.yml
  • hunting.yml
  • farming.yml
  • cooking.yml
  • strength.yml
  • defense.yml
  • exploration.yml
  • foraging.yml
  • smithing.yml

Mining Worldgen Config

  • oregen_system.yml
  • Controls optional additive custom ore placement for new chunks
  • Includes settings for queue limits, attempts, placement caps, height ranges, and Oraxen ore IDs
  • Worldgen handles placement only; Mining XP still comes from Mining configuration and listeners

Runtime Data

  • Skill XP data is stored by the Skills data manager.
  • Placed-block tracking can write to placed_blocks.yml where enabled.
  • Exploration state is loaded/saved through its own state store.
  • Data is saved on shutdown and relevant autosave paths where configured.

Oraxen Integration

Oraxen is optional, but RunestoneSkills includes support for installing bundled Oraxen assets and using Oraxen-backed ore blocks in Mining.

Bundled Asset Installer

  • Can install bundled Oraxen item files
  • Can install bundled resource-pack models and textures
  • Can run on startup if enabled
  • Can be triggered manually with /runestoneskills installoraxenassets or /rso
  • Reports copied, skipped, removed, and failed counts

Bundled Oraxen Content

  • runestonemmo_blocks.yml
  • runestonemmo_ores.yml
  • Runestone-themed skill blocks and ore assets
  • Firestone-themed ore assets
  • Models and textures under the RunestoneMMO namespace

Mining Oraxen XP

  • Mining has an Oraxen whitelist section.
  • Only listed Oraxen block IDs grant Mining XP.
  • Current custom ore direction includes runestone_ore and firestone_ore.
  • Decorative Oraxen blocks do not grant XP unless intentionally added to the whitelist.

Anti-Exploit & Stability Features

Progression value matters most when XP cannot be farmed through easy abuse. RunestoneSkills includes several protections across skill families.

Placed Block Tracking

  • Shared placed-block tracker
  • Used by supported block-breaking skills
  • Can ignore player-placed blocks
  • Autosave support for tracking data
  • Helps protect Mining, Forestry, and related gathering XP value

Gamemode Safeguards

  • Most skills can ignore Creative mode
  • Most skills can ignore Spectator mode
  • Exploration can ignore flying, gliding, vehicles, and teleport-like movement spikes

Rate Limits & Cooldowns

  • Optional per-player XP rate limits
  • Fishing minimum catch interval
  • Foraging break/harvest cooldowns
  • Cooking source-specific interval settings
  • Smithing source-specific interval settings

Source Validation

  • Correct-tool checks for Mining and Forestry
  • Natural-tree context checks for Forestry
  • Mature crop checks for Farming
  • Spawn-reason blocking for Hunting
  • Strict material lists for skills that need explicit control

Compatibility & Structure

Platform

  • Server: Paper
  • Minecraft: 1.21.11
  • Java: 21
  • Architecture: Gradle multi-module

Dependencies

  • Required: RunestoneCore
  • Optional: Oraxen
  • Uses public Core APIs instead of internal Core implementation packages

Lifecycle

  • Ensures default resources exist
  • Merges missing defaults non-destructively
  • Loads skill configs and data
  • Registers listeners for enabled skills
  • Registers SkillDef entries into Core
  • Saves data and unregisters services/listeners on shutdown

Why RunestoneSkills Matters

A realm feels stronger when progression has purpose. RunestoneSkills gives players more reasons to gather, craft, explore, trade, survive, and invest in the world over time.

That matters for players because ordinary actions become part of long-term advancement. It matters for the wider project because stronger professions support the economy, quests, NPC rewards, custom resources, crafting identity, towns, discovery, and future world content.

RunestoneSkills is what helps the realm feel worked, lived in, and shaped by player effort.

What Is Still Growing Inside RunestoneSkills

RunestoneSkills already acts as a real profession backbone, but the larger RunestoneMMO vision still leaves room for deeper loops, better content integration, more rewards, and stronger connections to quests, towns, economy, and world exploration.

More Full Profession Loops

The skill backbone is live, but deeper connections between gathering, crafting, rewards, economy, NPC shops, quests, and progression are still important.

Quest-Connected Progression

Skills are ready to support quest rewards and quest requirements, but more live quest content still needs to be built around the profession systems.

Discovery & World Hooks

Exploration already has travel, biome, and landmark direction, but more landmark content and world-linked rewards can deepen the system further.

Crafting & Economy Depth

Smithing, Cooking, Farming, Mining, and Foraging can all grow into stronger trade loops as the player economy expands.

More Profession Content

Each skill can keep gaining more meaningful activities, better XP sources, deeper rewards, and stronger progression identity.

Deeper Realm Integration

Skills become even more powerful as towns, quests, NPC systems, custom content, dungeons, and economy systems grow around them.

State of the Plugin

RunestoneSkills is actively serving as the profession backbone of Runestone Vale. It already gives the realm a stronger sense of long-term player growth and continues to grow in depth, integration, and world identity.

Ongoing development is not only about adding more skills. It is about making the progression layer feel connected to the world: how gathering feels, how materials matter, how rewards connect, and how the player’s time in the realm builds toward something bigger.

This is the progression layer that helps the realm feel lived in — where the work of the world starts becoming part of its identity.

Forge Your Path

From Mining and Smithing to Forestry, Fishing, Farming, Cooking, Hunting, Exploration, Foraging, Strength, and Defense, RunestoneSkills is where the professions of the realm take shape. Follow the addon, track its growth, and watch the progression layer of Runestone Vale continue to deepen over time.

Open on Hangar See RunestoneCore View Server Features Join the Discord