2.6

2025-12-01 20:59:16 +08:00
parent 12738a142c
commit 760c2dd9ad
5535 changed files with 21070 additions and 2021 deletions
--- a/docs/mcdocs/1-ModAPI/事件/玩家.md
+++ b/docs/mcdocs/1-ModAPI/事件/玩家.md
@@ -38,6 +38,8 @@ sidebarDepth: 1
 | [PlayerHurtEvent](玩家.md#playerhurtevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当玩家受伤害前触发该事件。 |
 | [PlayerInteractServerEvent](玩家.md#playerinteractserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家可以与实体交互时。如果是鼠标控制模式，则当准心对着实体时触发。如果是触屏模式，则触发时机与屏幕下方的交互按钮显示的时机相同。玩家真正与实体发生交互的事件见[PlayerDoInteractServerEvent](#playerdointeractserverevent) |
 | [PlayerNamedEntityServerEvent](玩家.md#playernamedentityserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家用命名牌重命名实体时触发，例如玩家手持命名牌对羊修改名字、玩家手持命名牌对盔甲架修改名字。 |
+| [PlayerPermissionChangeClientEvent](玩家.md#playerpermissionchangeclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家权限变更事件 |
+| [PlayerPermissionChangeServerEvent](玩家.md#playerpermissionchangeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家权限变更事件 |
 | [PlayerRespawnEvent](玩家.md#playerrespawnevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家复活时触发该事件。 |
 | [PlayerRespawnFinishServerEvent](玩家.md#playerrespawnfinishserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家复活完毕时触发 |
 | [PlayerSleepServerEvent](玩家.md#playersleepserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家使用床睡觉成功 |
@@ -47,6 +49,7 @@ sidebarDepth: 1
 | [PlayerTrySleepServerEvent](玩家.md#playertrysleepserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家尝试使用床睡觉 |
 | [ServerPlayerGetExperienceOrbEvent](玩家.md#serverplayergetexperienceorbevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家获取经验球时触发的事件 |
 | [StoreBuySuccServerEvent](玩家.md#storebuysuccserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机:玩家游戏内购买商品时服务端抛出的事件 |
+| [UpdatePlayerSkinClientEvent](玩家.md#updateplayerskinclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：玩家加入游戏或通过更衣室局内换肤后 同步皮肤信息至客户端后触发 |
 # 玩家

 ## AddExpEvent
@@ -991,6 +994,84 @@ comp.ClosePlayerHitBlockDetection()
 在零件中直接声明一个同名函数，即可完成监听，详情参考<a href="../../../mcguide/20-玩法开发/14-预设玩法编程/12-深入理解零件/0-零件开发.html#零件事件">零件事件</a>


+## PlayerPermissionChangeClientEvent
+
+<span style="display:inline;color:#7575f9">客户端</span>
+
+- 描述
+
+    玩家权限变更事件
+
+- 参数
+
+    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | causePlayerId | str | 发起者id |
+    | playerId | str | 玩家id |
+    | oldPermission | dict | 变化前的权限字典 |
+    | newPermission | dict | 变化后的权限字典 |
+    | changeCause | int | 变化原因，详见Minecraft枚举值文档的[PermissionChangeCause](../枚举值/PermissionChangeCause.md) |
+
+- 返回值
+
+    无
+
+- 备注
+    - 具体权限说明：
+        | 权限字段 | 类型 | 说明 |
+        | --- | --- | --- |
+        | build | bool | 放置方块 |
+        | mine | bool | 采集方块 |
+        | doorsandswitches | bool | 使用门和开关 |
+        | opencontainers | bool | 打开容器 |
+        | attackplayers | bool | 攻击玩家 |
+        | attackmobs | bool | 攻击生物 |
+        | op | bool | 操作员命令 |
+        | teleport | bool | 使用传送 |
+    - 当PlayerPermissionChangeServerEvent事件返回"cancel"为True时，权限变动被取消，该事件不会触发。
+
+在零件中直接声明一个同名函数，即可完成监听，详情参考<a href="../../../mcguide/20-玩法开发/14-预设玩法编程/12-深入理解零件/0-零件开发.html#零件事件">零件事件</a>
+
+
+## PlayerPermissionChangeServerEvent
+
+<span style="display:inline;color:#ff5555">服务端</span>
+
+- 描述
+
+    玩家权限变更事件
+
+- 参数
+
+    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | causePlayerId | str | 发起者id |
+    | playerId | str | 玩家id |
+    | oldPermission | dict | 变化前的权限字典 |
+    | newPermission | dict | 变化后的权限字典 |
+    | changeCause | int | 变化原因，详见Minecraft枚举值文档的[PermissionChangeCause](../枚举值/PermissionChangeCause.md) |
+    | cancel | bool | 为true时，取消本次权限变更 |
+
+- 返回值
+
+    无
+
+- 备注
+    - 具体权限说明：
+        | 权限字段 | 类型 | 说明 |
+        | --- | --- | --- |
+        | build | bool | 放置方块 |
+        | mine | bool | 采集方块 |
+        | doorsandswitches | bool | 使用门和开关 |
+        | opencontainers | bool | 打开容器 |
+        | attackplayers | bool | 攻击玩家 |
+        | attackmobs | bool | 攻击生物 |
+        | op | bool | 操作员命令 |
+        | teleport | bool | 使用传送 |
+
+在零件中直接声明一个同名函数，即可完成监听，详情参考<a href="../../../mcguide/20-玩法开发/14-预设玩法编程/12-深入理解零件/0-零件开发.html#零件事件">零件事件</a>
+
+
 ## PlayerRespawnEvent

 <span style="display:inline;color:#ff5555">服务端</span>
@@ -1209,3 +1290,27 @@ def OnStoreBuySucc(self, args):
 在零件中直接声明一个同名函数，即可完成监听，详情参考<a href="../../../mcguide/20-玩法开发/14-预设玩法编程/12-深入理解零件/0-零件开发.html#零件事件">零件事件</a>


+## UpdatePlayerSkinClientEvent
+
+<span style="display:inline;color:#7575f9">客户端</span>
+
+- 描述
+
+    触发时机：玩家加入游戏或通过更衣室局内换肤后 同步皮肤信息至客户端后触发
+
+- 参数
+
+    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | playerId | str | 更换皮肤的玩家id |
+
+- 返回值
+
+    无
+
+- 备注
+    - 此事件配合 IsOfficialSkin IsHighLevelOfficialSkin IsHighLevelMultiJointOfficialSkin 接口  用于获取玩家的皮肤信息
+
+在零件中直接声明一个同名函数，即可完成监听，详情参考<a href="../../../mcguide/20-玩法开发/14-预设玩法编程/12-深入理解零件/0-零件开发.html#零件事件">零件事件</a>
+
+