update simplified chinese docs

Author: dockfries

frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCChangeNode.md

@@ -0,0 +1,65 @@
+---
+title: OnNPCChangeNode
+sidebar_label: OnNPCChangeNode
+description: 当 NPC 在基于节点的移动过程中尝试从一个导航节点切换到另一个节点时调用此回调。
+tags: ["npc", "节点", "导航"]
+---
+
+<VersionWarnZH_CN name='回调' version='omp v1.1.0.changemelater' />
+
+## 描述
+
+当 NPC 在基于节点的移动过程中尝试从一个导航节点切换到另一个节点时调用此回调。这允许您控制是否应允许或拒绝节点切换。
+
+| 名称      | 描述                        |
+| --------- | --------------------------- |
+| npcid     | 尝试切换节点的 NPC 的 ID    |
+| newnodeid | NPC 想要移动到的新节点的 ID |
+| oldnodeid | NPC 当前所在节点的 ID       |
+
+## 返回值
+
+返回 `true` 允许节点切换，或返回 `false` 拒绝切换。
+
+## 示例
+
+```c
+public OnNPCChangeNode(npcid, newnodeid, oldnodeid)
+{
+    printf("NPC %d 正在从节点 %d 切换到节点 %d", npcid, oldnodeid, newnodeid);
+
+    // 检查新节点是否打开
+    if (!NPC_IsNodeOpen(newnodeid))
+    {
+        return false; // 拒绝切换到已关闭的节点
+    }
+
+    // 防止 NPC 前往节点 5
+    if (newnodeid == 5)
+    {
+        return false; // 阻止访问节点 5
+    }
+
+    return true; // 允许切换
+}
+```
+
+## 注意事项
+
+- 此回调仅在 NPC 通过 `NPC_PlayNode` 使用基于节点的导航时调用
+- 返回 `false` 将阻止 NPC 切换节点，并可能导致其停止导航
+- NPC 必须先使用 `NPC_OpenNode` 加载节点文件，才能在节点之间导航
+
+## 相关函数
+
+以下函数可能有用，因为它们与此回调以某种方式相关。
+
+- [NPC_PlayNode](../functions/NPC_PlayNode): 开始 NPC 基于节点的导航
+- [NPC_OpenNode](../functions/NPC_OpenNode): 打开导航节点文件
+- [NPC_CloseNode](../functions/NPC_CloseNode): 关闭导航节点文件
+- [NPC_StopPlayingNode](../functions/NPC_StopPlayingNode): 停止 NPC 节点导航
+
+## 相关回调
+
+- [OnNPCFinishNode](OnNPCFinishNode): 当 NPC 完成导航完整节点时调用
+- [OnNPCFinishNodePoint](OnNPCFinishNodePoint): 当 NPC 到达节点中的特定点时调用

frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCConnect.md

@@ -0,0 +1,49 @@
+---
+title: OnNPCCreate
+sidebar_label: OnNPCCreate
+description: 当 NPC 成功创建时调用此回调。
+tags: ["npc"]
+---
+
+<VersionWarnZH_CN name='回调' version='omp v1.1.0.changemelater' />
+
+## 描述
+
+当 NPC 成功创建并添加到服务器时调用此回调。
+
+| 名称  | 描述               |
+| ----- | ------------------ |
+| npcid | 已创建的 NPC 的 ID |
+
+## 示例
+
+```c
+public OnNPCCreate(npcid)
+{
+    printf("NPC %d 已被创建", npcid);
+
+    // 设置初始属性
+    NPC_SetSkin(npcid, 23);
+    NPC_SetPos(npcid, 1958.33, 1343.12, 15.36);
+
+    return true;
+}
+```
+
+## 注意事项
+
+- 此回调在 NPC 创建后立即调用，但在其生成之前
+- NPC 需要使用 `NPC_Spawn` 生成才能在游戏世界中可见
+
+## 相关函数
+
+以下函数可能有用，因为它们与此回调以某种方式相关。
+
+- [NPC_Create](../functions/NPC_Create): 创建新的 NPC
+- [NPC_Destroy](../functions/NPC_Destroy): 销毁现有的 NPC
+- [NPC_Spawn](../functions/NPC_Spawn): 在游戏世界中生成 NPC
+
+## 相关回调
+
+- [OnNPCDestroy](OnNPCDestroy): 当 NPC 被销毁时调用
+- [OnNPCSpawn](OnNPCSpawn): 当 NPC 被生成时调用

frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCCreate.md

@@ -0,0 +1,66 @@
+---
+title: OnNPCDeath
+sidebar_label: OnNPCDeath
+description: 当 NPC 死亡时调用此回调。
+tags: ["npc"]
+---
+
+<VersionWarnZH_CN name='回调' version='omp v1.1.0.changemelater' />
+
+## 描述
+
+当 NPC 死亡时调用此回调。
+
+| 名称     | 描述                                                        |
+| -------- | ----------------------------------------------------------- |
+| npcid    | 死亡的 NPC 的 ID                                            |
+| killerid | 击杀 NPC 的玩家/NPC 的 ID（如果没有则为 INVALID_PLAYER_ID） |
+| reason   | 死亡原因（武器 ID 或死亡原因）                              |
+
+## 示例
+
+```c
+public OnNPCDeath(npcid, killerid, reason)
+{
+    if (killerid != INVALID_PLAYER_ID)
+    {
+        printf("NPC %d 被 %d 以原因 %d 击杀", npcid, killerid, reason);
+    }
+    else
+    {
+        printf("NPC %d 死亡", npcid);
+    }
+
+    // 5 秒后重生
+    SetTimerEx("RespawnNPC", 5000, false, "i", npcid);
+
+    return true;
+}
+
+forward RespawnNPC(npcid);
+public RespawnNPC(npcid)
+{
+    NPC_Respawn(npcid);
+}
+```
+
+## 注意事项
+
+- 如果 NPC 死亡不是由玩家造成的，`killerid` 参数将为 `INVALID_PLAYER_ID`
+- `reason` 参数包含导致死亡的武器 ID（未知/其他原因为 255）
+
+## 相关函数
+
+以下函数可能有用，因为它们与此回调以某种方式相关。
+
+- [NPC_Kill](../functions/NPC_Kill): 击杀 NPC
+- [NPC_Respawn](../functions/NPC_Respawn): 重生死亡的 NPC
+- [NPC_GetHealth](../functions/NPC_GetHealth): 获取 NPC 的生命值
+- [NPC_SetHealth](../functions/NPC_SetHealth): 设置 NPC 的生命值
+
+## 相关回调
+
+- [OnNPCSpawn](OnNPCSpawn): 当 NPC 生成时调用
+- [OnNPCRespawn](OnNPCRespawn): 当 NPC 重生时调用
+- [OnNPCTakeDamage](OnNPCTakeDamage): 当 NPC 受到伤害时调用
+- [OnPlayerDeath](OnPlayerDeath): 当玩家死亡时调用

frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/scripting/callbacks/OnNPCDeath.md

@@ -0,0 +1,51 @@
+---
+title: OnNPCDestroy
+sidebar_label: OnNPCDestroy
+description: 当 NPC 被销毁时调用此回调。
+tags: ["npc"]
+---
+
+<VersionWarnZH_CN name='回调' version='omp v1.1.0.changemelater' />
+
+## 描述
+
+当 NPC 被销毁并从服务器移除时调用此回调。
+
+| 名称  | 描述               |
+| ----- | ------------------ |
+| npcid | 被销毁的 NPC 的 ID |
+
+## 示例
+
+```c
+public OnNPCDestroy(npcid)
+{
+    printf("NPC %d 已被销毁", npcid);
+
+    // 清理定时器
+    if (g_NPCTimer[npcid] != -1)
+    {
+        KillTimer(g_NPCTimer[npcid]);
+        g_NPCTimer[npcid] = -1;
+    }
+
+    return true;
+}
+```
+
+## 注意事项
+
+- 此回调在 NPC 从服务器移除之前立即调用
+- 在此回调之后，NPC 将断开连接并释放其玩家槽位
+
+## 相关函数
+
+以下函数可能有用，因为它们与此回调以某种方式相关。
+
+- [NPC_Create](../functions/NPC_Create): 创建新的 NPC
+- [NPC_Destroy](../functions/NPC_Destroy): 销毁现有的 NPC
+- [IsValidNPC](../functions/IsValidNPC): 检查 NPC ID 是否有效
+
+## 相关回调
+
+- [OnNPCCreate](OnNPCCreate): 当 NPC 被创建时调用