gitea-server/fz-survival-datapack
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新开发文档

Browse Source
This commit is contained in:
延皓 2022-07-11 18:28:47 +08:00
parent d85e07874f
commit 5a2255a9f8
1 changed files with 53 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

57
DEVDOC.md
View File

@ -21,27 +21,28 @@
## 基本要求
- 主要逻辑和模块逻辑分离
- 接口逻辑和模块逻辑分离
- 函数由两个以上的函数调用，或由不同包下的函数调用，或需要作为接口开放给下游数据包时，应改用标签调用！
- 函数调用尽量不要使用`function`命令，应改在标签中按顺序调用！
## 未来计划
- 细化版本管理，提供不同版本之间的升级函数，由`update_manager`控制。*务必仔细测试再发布，一旦升级无法降级！*
- playerdata相关功能
## 系统模块
### 频繁使用的计算单元
- 位于`tags/functions/calculation`目录下的标签通常被用来进行简单重复的计算任务
- `#fz:calculation/*`标签通常被用来进行简单重复的计算任务
### 事件模块
- 通常由**进度**触发，触发后调用同名的事件标签
- 在`tags/functions/event/<事件名称>`标签中注册触发时需要调用的函数即可
- 在`#fz:game_event/<事件>(/...)`标签中注册触发时需要调用的函数即可
### 日志模块
- 仓库中提供了日志相关的代码片段，位于`.vscode/settings.json`
- 暂时没有找到方法在控制台记录日志
- 暂时没有找到方法在服务端控制台打印日志，但会被记录在客户端
#### 详细 Fine
- 等级：300
@ -70,31 +71,51 @@
## 功能模块
### 配置模块
- 标签`tags/functions/module/config/timeout`：超时时的操作
- 标签`tags/functions/module/config/reset_trigger`：重置玩家`@s`的触发器计分板
#### 按钮操作
1. 定义一个显示按钮时执行的函数，使用形如`tellraw @s {"text": "[按钮]", "clickEvent": {"action": "run_command", "value": "/trigger fz.module.config.trigger set <触发器分数>"}}`的指令定义按钮。**大多数情况下这里的触发器分数必须是独一无二的**
2. 在`tags/functions/module/config/display`标签中注册
3. 定义一个点击按钮时执行的函数，使用形如`execute if score @s fz.module.config.trigger matches <min>..<max> run ...`的指令判断玩家的触发器分数，并执行你的操作
4. 在`tags/functions/module/config/on_click`标签中注册上述函数
4. 在[`#fz:module/config/on_click`](data/fz/tags/functions/module/config/on_click.json)标签中注册上述函数
#### 其他接口
- 标签[`#fz:module/config/timeout`](data/fz/tags/functions/module/config/timeout.json)：超时时的操作
- 标签[`#fz:module/config/reset_trigger`](data/fz/tags/functions/module/config/reset_trigger.json)：重置玩家`@s`的触发器计分板
### 计分板模块
#### 自定义计分板颜色
- 数据包提供了所有计分板的全部16色命名函数
- 使用方法：**覆盖**`tags/functions/module/scoreboard/display/set_text/<计分板名称>`标签，填入`functions/module/scoreboard/display/set_text/<计分板名称>/<颜色名称>`函数
- 使用方法：**覆盖**`#fz:module/scoreboard/display/set_text/<计分板名称>`标签，填入`fz:module/scoreboard/display/set_text/<计分板名称>/<颜色名称>`函数
#### 自定义计分板名称
1. 定义一个设置计分板颜色、文本的函数，格式可以参考`functions/module/scoreboard/display/set_text/general/*`函数
2. **覆盖**`tags/functions/module/scoreboard/display/set_text/<计分板名称>`标签，填入上述函数
1. 定义一个设置计分板颜色、文本的函数，格式可以参考[`fz:module/scoreboard/display/set_text/general/*`](data/fz/functions/module/scoreboard/display/set_text/general/aqua.mcfunction)函数
2. **覆盖**`#fz:module/scoreboard/display/set_text/<计分板名称>`标签，填入上述函数
#### 扩展自己的计分板
1. 定义一个创建计分板的函数，参考`functions/module/scoreboard/display/create`函数
2. 在`tags/functions/module/scoreboard/display/create`标签中注册该函数
1. 定义一个安装函数，参考[`fz:module/scoreboard/install`](data/fz/functions/module/scoreboard/install.mcfunction)函数
2. 在[`#fz:module/scoreboard/install`](data/fz/tags/functions/module/scoreboard/install.json)标签中注册该函数
3. 按照“自定义计分板颜色”和“自定义计分板名称”中的操作，定义你的计分板颜色和名称
4. 定义一个生成计分板运行时id的函数，参考`functions/module/scoreboard/display/register_id`函数
5. 在`tags/functions/module/scoreboard/display/register_id`标签中注册该函数
6. 定义一个用来在轮播时显示你的计分板的函数，参考`functions/module/scoreboard/display/carousel/set_display/*`函数
7. 定义一个用来判断在轮播时是否轮到你的计分板的函数，在判断后调用上一条中的函数，参考`functions/module/scoreboard/display/carousel/try_display/*`函数
8. 将该函数注册到`tags/functions/module/scoreboard/display/try_display`标签中
4. 定义一个生成计分板运行时id的函数，参考[`fz:module/scoreboard/display/register_id`](data/fz/functions/module/scoreboard/display/register_id.mcfunction)函数
5. 在[`#fz:module/scoreboard/display/register_id`](data/fz/tags/functions/module/scoreboard/display/register_id.json)标签中注册该函数
6. 定义一个用来在轮播时显示你的计分板的函数，参考[`fz:module/scoreboard/display/carousel/set_display/*`](data/fz/functions/module/scoreboard/display/carousel/set_display/activation.mcfunction)函数
7. 定义一个用来判断在轮播时是否轮到你的计分板的函数，在判断后调用上一条中的函数，参考[`fz:module/scoreboard/display/carousel/try_display/*`](data/fz/functions/module/scoreboard/display/carousel/try_display/activation.mcfunction)函数
8. 将该函数注册到[`#fz:module/scoreboard/display/try_display`](data/fz/tags/functions/module/scoreboard/display/carousel/try_display.json)标签中
## 自定义模块
#### 注册安装、卸载、加载函数
- 在下列标签中注册你的安装、卸载、加载函数：
- [`#fz:system/install/module`](data/fz/tags/functions/system/install/module.json)
- [`#fz:system/uninstall/module`](data/fz/tags/functions/system/uninstall/module.json)
- [`#fz:system/load/module`](data/fz/tags/functions/system/load/module.json)
#### 注册设置页面
1. 定义显示函数，参考：
- [`fz:module/scoreboard/config/display/head`](data/fz/functions/module/scoreboard/config/display/head.mcfunction)
- [`fz:module/scoreboard/config/display/buttons`](data/fz/functions/module/scoreboard/config/display/buttons.mcfunction)
2. 向[`#fz:module/config/display`](data/fz/tags/functions/module/config/display.json)标签中注册上述函数
3. 定义点击按钮时运行的函数，参考[`fz:module/scoreboard/config/on_click`](data/fz/functions/module/scoreboard/config/on_click.mcfunction)
4. 向[`#fz:module/config/on_click`](data/fz/tags/functions/module/config/on_click.json)标签中注册上述函数