65 行
2.2 KiB
Markdown
65 行
2.2 KiB
Markdown
|
# 洪荒大陆 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
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
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 游戏逻辑服。
|
