Back to NxLabs

NxLabs / Vintage Story

HoR XLib

PBy Panduhs

HoR patch for XLib.

Description

HoR-XLib is a compatibility build of Xandu's XLib mod, providing the core skill/leveling framework (XLeveling) and status effect system (XEffects) for Vintage Story. This fork has been updated for VS 1.22 compatibility with all breaking API changes resolved. XLib provides the engine that powers XSkills, HoR-XSkills-Addon, and any other mod that wants to add skills, abilities, experience, and status effects to the game.

Stats: XLeveling Framework (40+ classes) • XEffects System • 12 Languages • Extensible Skill/Ability API • JSON-Driven Configuration • Network Sync • Universal

✨ What's New in v0.9.2 (HoR Compat) <span style="margin-left: auto; font-size: 12px;">▼</span>
  • VS 1.22 Compatibility
    Full migration to VS 1.22 APIs. All breaking changes resolved: Entity.Pos property conversion, ResolvedItemStack capitalization, PascalCase property access patterns, and GridRecipe/IRecipeBase signature updates.
  • Current HoR Progression Stack
    Version alignment for the current HoR mod stack. This is the library layer used by HoR-XSkills and HoR-XSkills-Addon for skills, abilities, syncing, and status effects on 1.22.
  • Maintained compatibility build
    The original mod has not been updated for 1.22, this fork ensures continued compatibility for the HoR modpack and any dependent mods.
📚 XLeveling Framework <span style="margin-left: auto; font-size: 12px;">▼</span>

The core skill/leveling engine powering all HoR progression systems

  • Skill System
    Define skills with custom names, display names, groups, and experience equations. Each skill supports quadratic or logarithmic XP curves with configurable base values and class-specific multipliers. Skills can be grouped in the GUI and hidden from specific players.
  • Ability System
    Each skill contains multiple abilities with tiered progression (1-N tiers). Abilities have minimum level requirements, descriptions with value interpolation, and requirements that can be combined with AND/OR/NOT logic. Ability types include StatAbility (auto-apply stats), TraitAbility (toggle traits), and StatsAbility (multiple stat modifiers).
  • Requirement System
    Flexible requirement types: SkillRequirement (another skill at level X), ClassRequirement (specific VS class), DaytimeRequirement (time of day), KnowledgeRequirement (unlocked knowledge), ExclusiveAbilityRequirement (mutually exclusive perks), and LimitationRequirement (global perk limits). Custom requirement types can be registered by mods.
  • Player Skill Sets
    Per-player persistent skill data stored via VS save system. Tracks current level, experience, earned abilities, and ability tiers for every skill. Supports save/load with backward compatibility for older save formats.
  • Configuration System
    JSON-driven skill and ability definitions loaded from assets/[modid]/skills/. Supports custom skill configs (CustomSkillConfig), experience equation delegates, and global configuration via config files.
  • Skill Dialog GUI
    Built-in skill dialog showing all skills and abilities with tier progress, requirements, and tooltips. Ability tooltips display interpolated values for each tier. Supports grouping and custom skill ordering.
  • Skill Books
    ItemSkillBook implementation for granting XP via craftable/lootable books.
  • Client/Server Sync
    XLevelingClient and XLevelingServer implementations handle network synchronization. Skill changes on the server propagate to clients via command packages (CommandPackage), experience packages (ExperiencePackage), and knowledge packages (KnowledgePackage).
Read the full description on Vintage Story ModDB →

Ratings & reviews

No ratings yet

Sign in to leave a rating or comment.