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 游戏逻辑服。
|