lawless/configs/README.md

洪荒大陆 Nacos 配置导入说明

配置清单

文件	命名空间建议	说明
honghuang-global.yaml	honghuang	全局锚点参数：时间流速、每日重置
honghuang-combat.yaml	honghuang	战斗/ATB/技能系数
honghuang-economy.yaml	honghuang	经济、税率、拍卖、帮派、社交
honghuang-map.yaml	honghuang	世界地图、副本、遗迹、怪物
honghuang-event.yaml	honghuang	登录信息流、实时遭遇、世界脉动
honghuang-cultivation.yaml	honghuang	功法、渡劫、转生、装备

导入方式

方式一：Nacos 控制台

1. 登录 Nacos 控制台 → 配置管理 → 配置列表。
2. 选择命名空间 honghuang（如不存在请新建）。
3. 点击「+ 新建配置」：
   • Data ID：honghuang-global.yaml
   • Group：DEFAULT_GROUP
   • 配置格式：YAML
   • 将文件内容粘贴到配置内容中。
4. 依次导入其余 5 个文件。

方式二：Nacos OpenAPI

NACOS_SERVER="http://127.0.0.1:8848"
NAMESPACE="honghuang"
GROUP="DEFAULT_GROUP"

for file in honghuang-global honghuang-combat honghuang-economy honghuang-map honghuang-event honghuang-cultivation; do
  curl -X POST "$NACOS_SERVER/nacos/v1/cs/configs" \
    -d "tenant=$NAMESPACE" \
    -d "dataId=${file}.yaml" \
    -d "group=$GROUP" \
    -d "type=yaml" \
    --data-urlencode "content=$(cat configs/nacos/${file}.yaml)"
done

命名空间规则

• 生产环境：honghuang-prod
• 测试环境：honghuang-test
• 灰度环境：honghuang-gray

服务端通过环境变量 NACOS_NAMESPACE 指定命名空间，默认 honghuang。

键名约定

• 所有键与 GDD-21《数值平衡与联调参数总表》保持一致，例如：
  • combat.atb.base_coefficient
  • economy.tax.trade_rate
  • event.encounter.base_interval_min
• 默认值与取值范围以行内注释形式标注，便于策划直接在 Nacos 中调参。

后续调参流程

1. 策划在 Nacos 修改目标参数并发布。
2. 服务端 config/config.go 通过 ListenConfig 监听变更并更新本地缓存。
3. 数值生效无需重启 Nakama 游戏逻辑服。