HyRPGCore

HyRPGCore

HyRPGCore 是一款受仙境传说启发的属性与战斗框架,专为Hytale设计,引入了可扩展的属性系统、角色扮演游戏进程以及可自定义的伤害系统,旨在提供沉浸式的服务器游戏体验。

实用

HyRPGCore – 适用于 Hytale 的模块化 MMO RPG 框架

HyRPGCore 为 Hytale 增添了结构化的 MMO 风格成长系统。

受《仙境传说》启发,专为服务器所有者打造,它提供了一个确定性的、由 JSON 驱动的 RPG 框架,无需编写代码即可扩展和自定义。

HyRPGCore 专注于:

  • 确定性的战斗与成长曲线
  • 可配置的进度系统
  • 模块化的子系统
  • 服务端稳定性

它是面向 MMO 服务器的基石。


核心功能

  • 力量(STR) / 灵巧(AGI) / 体质(VIT) / 智力(INT) / 敏捷(DEX) / 幸运(LUK) 属性系统
  • 衍生属性(生命值、法力值、命中、闪避、暴击等)
  • 确定性战斗计算(热路径中无随机数)
  • 可配置的经验值进度(等级曲线 + 预设)
  • 基于区域或玩家的怪物等级调整
  • 精英怪物系统
  • JSON 驱动的武器伤害系数
  • 任务系统(构建器 + 运行时)
  • NPC 对话与任务发布系统
  • 自定义 UI 集成
  • 完全 JSON 可配置的架构

如何使用

玩家属性

/stats

打开玩家属性界面。

经验值通过游戏行为(例如击杀怪物)自动获得。


区域信息

/zone

显示当前区域。

区域等级范围可在以下位置配置:

Mod/fuyuga_hyrpgcore/config


NPC 管理

/hyrpg npc

打开 NPC 管理员界面。

在此你可以:

  • 分配角色
  • 配置对话
  • 关联任务

任务构建器

/hyrpg quest

打开任务构建器界面。

额外 CLI 命令:

/quest list
/quest reload
/quest status <id>

玩家任务日志:

/questlog


怪物与战斗重载命令

/mobs reload
/weaponprofiles reload
/weaponmapping reload

这些命令允许在不完全重启服务器的情况下实时重载配置。

配置

所有系统均可在此路径下配置:

Mod/fuyuga_hyrpgcore/config

主要系统文件:

  • zones.json
  • mob-scaling.json
  • xp_config.json
  • combat-globals.json
  • weapon-profiles.json
  • weapon-mapping.json
  • quests.json
  • npc-roles.json
  • nameplates.json
  • derived-stats.json
配置详情

区域(zones.json)

控制怪物等级逻辑。

{
  "mobLevelMode": "ZONE",
  "zones": [
    {
      "matchName": "zone1",
      "minLevel": 1,
      "maxLevel": 10,
      "eliteChance": 0.05,
      "eliteBonusLevels": 2,
      "eliteScale": 1.1
    }
  ]
}

mobLevelMode(怪物等级模式):

  • ZONE → 使用区域的最小/最大等级
  • PLAYER → 根据玩家等级调整

怪物等级调整(mob-scaling.json)

控制生命值和伤害成长,设有软上限。

{
  "maxLevel": 99,
  "baseHpMultiplier": 1.0,
  "perLevelHpMultiplier": 0.15,
  "hpSoftcapS": 0.35,
  "hpMaxMultiplier": 20.0,
  "baseDamageMultiplier": 1.0,
  "perLevelDamageMultiplier": 0.08
}

生命值成长现在采用基于软上限的缩放,以实现更平滑的成长曲线。


经验值配置(xp_config.json)

支持等级曲线预设和多种经验值模型。

模型:

  • LEGACY(旧版)
  • HP_ANCHORED(基于生命值锚定)

示例:

{
  "levelCurvePreset": "NORMAL",
  "kill": {
    "model": "LEGACY",
    "baseXp": 5,
    "XP_multiplier": 1.0
  }
}

等级曲线预设:

  • EASY(简单)
  • NORMAL(普通)
  • HARD(困难)
  • NIGHTMARE(噩梦)

战斗全局参数(combat-globals.json)

定义:

  • 命中率计算
  • 闪避率计算
  • 暴击率与暴击伤害倍数
  • 伤害减免
  • 攻击速度软上限
  • 施法速度行为
  • 空手伤害规则

战斗是确定性的,且服务器端保持一致。


武器配置(weapon-profiles.json)

定义每种武器类型的属性加成系数。

{
  "weaponTypes": {
    "SWORD_ONE_HAND": {
      "damageScale": { "STR": 0.02 },
      "aspdFactor": 1.0,
      "usesCast": false
    }
  }
}

武器映射(weapon-mapping.json)

将物品或物品系列映射到武器类型。

{
  "defaultType": "UNARMED",
  "families": {
    "SWORD": "SWORD_ONE_HAND"
  },
  "items": {
    "IronSword": "SWORD_ONE_HAND"
  }
}

支持物品系列映射和直接物品 ID 映射。


任务(quests.json)

支持的目标类型:

  • KILL(击杀)
  • COLLECT(收集)
  • TALK_TO(交谈)
  • REACH_LOCATION(到达指定地点)
  • COMPOSITE(复合目标)

最小化示例:

{
  "quests": [
    {
      "id": "apple_delivery_01",
      "title": "送苹果",
      "repeatable": true,
      "minLevel": 1,
      "objectives": [
        { "type": "COLLECT", "itemId": "Apple", "amount": 3 }
      ],
      "rewards": {
        "xp": 50
      }
    }
  ]
}

铭牌(nameplates.json)

控制怪物名称的显示。

{
  "enabled": true,
  "showEliteMarker": true,
  "showLevel": true
}

项目愿景

HyRPGCore 并非一个已完成的 MMO 服务器。

它是一个模块化、确定性的 RPG 框架,专为希望通过 JSON 配置掌控成长、平衡和缩放规则的 Hytale 服务器构建者设计。

未来的扩展可能包括高级技能系统、队伍机制以及更多层次的成长系统。