HoR XLib

• 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.

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).

Status effect framework for timed buffs, debuffs, and triggered effects

• Effect Types
  AnimationEffect (visual), AttributeEffect (stat modification), and custom effect types. Effects can be stacked, refreshed, or replaced based on configuration.
• Trigger System
  Effects triggered by entity attributes reaching thresholds. Built-in triggers: AttributeTriggerBodyTemp, AttributeTriggerFoodLevel, AttributeTriggerHealth, and generic AttributeTrigger/AttributeTriggerAttribute. Custom triggers supported.
• Entity Behavior
  AffectedEntityBehavior attaches to entities and manages active effects, trigger evaluation, and effect lifecycle (application, tick, expiry).
• Effect Frame
  Client-side rendering system for displaying active effects in the HUD with icons and duration timers.

Full translations for 12 languages:

Arabic • Chinese • Czech • English • French • German • Italian • Japanese • Polish • Portuguese (BR) • Russian • Ukrainian

Additional XEffects translations: Spanish (419 + ES), Dutch, Romanian, Swedish

IXLevelingAPI provides the public interface for other mods to integrate:

• Register Skills, Add new skills with custom XP curves and class modifiers
• Register Abilities, Add abilities to existing or new skills with full tier/requirement configuration
• Grant XP, Award experience to players for specific skills
• Query Abilities, Check if a player has unlocked a specific ability and at what tier
• Register Requirements, Add custom requirement types for ability gating
• Tier Change Events, Subscribe to OnPlayerAbilityTierChanged for custom ability effects

Required: Vintage Story 1.22.0+

Side: Universal (required on both client and server)

Note: This is a compatibility-maintained build. Replaces the original “xlib” mod, do not install both.