330 lines
59 KiB
Markdown
330 lines
59 KiB
Markdown
---
|
||
sidebarDepth: 1
|
||
---
|
||
# 事件索引表
|
||
|
||
---
|
||
|
||
- [世界](#世界)
|
||
- [实体](#实体)
|
||
- [玩家](#玩家)
|
||
- [方块](#方块)
|
||
- [物品](#物品)
|
||
- [模型](#模型)
|
||
- [UI](#ui)
|
||
- [音效](#音效)
|
||
- [控制](#控制)
|
||
- [联机大厅](#联机大厅)
|
||
|
||
## 世界
|
||
| 事件| <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [AchievementCompleteEvent](世界.md#achievementcompleteevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家完成自定义成就时触发该事件 |
|
||
| [AddEntityClientEvent](世界.md#addentityclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 客户端侧创建新实体时触发 |
|
||
| [AddEntityServerEvent](世界.md#addentityserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 服务端侧创建新实体，或实体从存档加载时触发 |
|
||
| [AddPlayerAOIClientEvent](世界.md#addplayeraoiclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家加入游戏或者其余玩家进入当前玩家视野时触发的事件，替换AddPlayerEvent |
|
||
| [AddPlayerCreatedClientEvent](世界.md#addplayercreatedclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家进入当前玩家所在的区块AOI后，玩家皮肤数据异步加载完成后触发的事件 |
|
||
| [AddServerPlayerEvent](世界.md#addserverplayerevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家加入时触发该事件。 |
|
||
| [ChunkAcquireDiscardedClientEvent](世界.md#chunkacquirediscardedclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：客户端区块即将被卸载时 |
|
||
| [ChunkAcquireDiscardedServerEvent](世界.md#chunkacquirediscardedserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 服务端区块即将被卸载时触发 |
|
||
| [ChunkGeneratedServerEvent](世界.md#chunkgeneratedserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：区块创建完成时触发 |
|
||
| [ChunkLoadedClientEvent](世界.md#chunkloadedclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：客户端区块加载完成时 |
|
||
| [ChunkLoadedServerEvent](世界.md#chunkloadedserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：服务端区块加载完成时 |
|
||
| [ClientLoadAddonsFinishServerEvent](世界.md#clientloadaddonsfinishserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：客户端mod加载完成时，服务端触发此事件。服务器可以使用此事件，往客户端发送数据给其初始化。 |
|
||
| [CommandEvent](世界.md#commandevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家请求执行指令时触发 |
|
||
| [CustomCommandTriggerServerEvent](世界.md#customcommandtriggerserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 自定义命令触发事件 |
|
||
| [DelServerPlayerEvent](世界.md#delserverplayerevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：删除玩家时触发该事件。 |
|
||
| [EntityRemoveEvent](世界.md#entityremoveevent) | <span style="display:inline;color:#ff5555">服务端</span> | 实体被删除时触发 |
|
||
| [ExplosionServerEvent](世界.md#explosionserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 当发生爆炸时触发。 |
|
||
| [GameRenderTickEvent](世界.md#gamerendertickevent) | <span style="display:inline;color:#7575f9">客户端</span> | 客户端渲染帧开始时触发该事件,一秒触发次数为当前的帧数 |
|
||
| [GlobalCommandServerEvent](世界.md#globalcommandserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 服务端全局命令事件，包括聊天栏发送、SetCommand接口、命令方块（矿车）、行为包动画执行命令 |
|
||
| [LoadClientAddonScriptsAfter](世界.md#loadclientaddonscriptsafter) | <span style="display:inline;color:#7575f9">客户端</span> | 客户端加载mod完成事件 |
|
||
| [LoadServerAddonScriptsAfter](世界.md#loadserveraddonscriptsafter) | <span style="display:inline;color:#ff5555">服务端</span> | 服务器加载完mod时触发 |
|
||
| [NewOnEntityAreaEvent](世界.md#newonentityareaevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：通过RegisterEntityAOIEvent注册过AOI事件后，当有实体进入或离开注册感应区域时触发该事件。 |
|
||
| [OnCommandOutputClientEvent](世界.md#oncommandoutputclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 当command命令有成功消息输出时触发 |
|
||
| [OnCommandOutputServerEvent](世界.md#oncommandoutputserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | Command命令执行成功事件 |
|
||
| [OnContainerFillLoottableServerEvent](世界.md#oncontainerfillloottableserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：随机奖励箱第一次打开根据loottable生成物品时 |
|
||
| [OnLightningLevelChangeServerEvent](世界.md#onlightninglevelchangeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 打雷强度发生改变 |
|
||
| [OnLocalLightningLevelChangeServerEvent](世界.md#onlocallightninglevelchangeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 独立维度天气打雷强度发生改变时触发 |
|
||
| [OnLocalPlayerStopLoading](世界.md#onlocalplayerstoploading) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：玩家进入存档，出生点地形加载完成时触发。该事件触发时可以进行切换维度的操作。 |
|
||
| [OnLocalRainLevelChangeServerEvent](世界.md#onlocalrainlevelchangeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 独立维度天气下雨强度发生改变时触发 |
|
||
| [OnRainLevelChangeServerEvent](世界.md#onrainlevelchangeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 下雨强度发生改变 |
|
||
| [OnScriptTickClient](世界.md#onscripttickclient) | <span style="display:inline;color:#7575f9">客户端</span> | 客户端tick事件,1秒30次 |
|
||
| [OnScriptTickServer](世界.md#onscripttickserver) | <span style="display:inline;color:#ff5555">服务端</span> | 服务器tick时触发,1秒有30个tick |
|
||
| [PlaceNeteaseLargeFeatureServerEvent](世界.md#placeneteaselargefeatureserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：网易版大型结构即将生成时服务端抛出该事件。 |
|
||
| [PlaceNeteaseStructureFeatureEvent](世界.md#placeneteasestructurefeatureevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：首次生成地形时，结构特征即将生成时服务端抛出该事件。 |
|
||
| [PlayerIntendLeaveServerEvent](世界.md#playerintendleaveserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：即将删除玩家时触发该事件，此时可以通过各种API获取玩家的当前状态。 |
|
||
| [PlayerJoinMessageEvent](世界.md#playerjoinmessageevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：准备显示“xxx加入游戏”的玩家登录提示文字时服务端抛出的事件。 |
|
||
| [PlayerLeftMessageServerEvent](世界.md#playerleftmessageserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：准备显示“xxx离开游戏”的玩家离开提示文字时服务端抛出的事件。 |
|
||
| [RemoveEntityClientEvent](世界.md#removeentityclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 客户端侧实体被移除时触发 |
|
||
| [RemovePlayerAOIClientEvent](世界.md#removeplayeraoiclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家离开当前玩家视野时触发的事件 |
|
||
| [ServerChatEvent](世界.md#serverchatevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家发送聊天信息时触发 |
|
||
| [ServerPostBlockPatternEvent](世界.md#serverpostblockpatternevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：用方块组合生成生物，生成生物之后触发该事件。 |
|
||
| [ServerPreBlockPatternEvent](世界.md#serverpreblockpatternevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：用方块组合生成生物，在放置最后一个组成方块时触发该事件。 |
|
||
| [ServerSpawnMobEvent](世界.md#serverspawnmobevent) | <span style="display:inline;color:#ff5555">服务端</span> | 游戏内自动生成生物，以及使用api生成生物时触发 |
|
||
| [UnLoadClientAddonScriptsBefore](世界.md#unloadclientaddonscriptsbefore) | <span style="display:inline;color:#7575f9">客户端</span> | 客户端卸载mod之前触发 |
|
||
|
||
## 实体
|
||
| 事件| <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [ActorHurtServerEvent](实体.md#actorhurtserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：生物（包括玩家）受伤时触发 |
|
||
| [ActuallyHurtServerEvent](实体.md#actuallyhurtserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 实体实际受到伤害时触发，相比于DamageEvent，该伤害为经过护甲及buff计算后，实际的扣血量 |
|
||
| [AddEffectServerEvent](实体.md#addeffectserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：实体获得状态效果时 |
|
||
| [ApproachEntityClientEvent](实体.md#approachentityclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家靠近生物时触发 |
|
||
| [ChangeSwimStateServerEvent](实体.md#changeswimstateserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：实体开始或者结束游泳时 |
|
||
| [DamageEvent](实体.md#damageevent) | <span style="display:inline;color:#ff5555">服务端</span> | 实体受到伤害时触发 |
|
||
| [EntityChangeDimensionServerEvent](实体.md#entitychangedimensionserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 实体维度改变时服务端抛出 |
|
||
| [EntityDefinitionsEventServerEvent](实体.md#entitydefinitionseventserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：生物定义json文件中设置的event触发时同时触发。生物行为变更事件 |
|
||
| [EntityDieLoottableAfterServerEvent](实体.md#entitydieloottableafterserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：生物死亡掉落物品之后 |
|
||
| [EntityDieLoottableServerEvent](实体.md#entitydieloottableserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：生物死亡掉落物品时 |
|
||
| [EntityDroppedItemServerEvent](实体.md#entitydroppeditemserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：生物扔出物品时触发 |
|
||
| [EntityEffectDamageServerEvent](实体.md#entityeffectdamageserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 生物受到状态伤害/回复事件。 |
|
||
| [EntityLoadScriptEvent](实体.md#entityloadscriptevent) | <span style="display:inline;color:#ff5555">服务端</span> | 数据库加载实体自定义数据时触发 |
|
||
| [EntityModelChangedClientEvent](实体.md#entitymodelchangedclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：实体模型切换时触发 |
|
||
| [EntityMotionStartServerEvent](实体.md#entitymotionstartserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 实体运动器开始事件。实体（包含玩家）添加运动器后，运动器开始运行时触发 |
|
||
| [EntityMotionStopServerEvent](实体.md#entitymotionstopserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 实体运动器停止事件。实体（包含玩家）添加运动器并开始运行后，运动器自动停止时触发 |
|
||
| [EntityPickupItemServerEvent](实体.md#entitypickupitemserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 有minecraft:behavior.pickup_items行为的生物拾取物品时触发该事件，例如村民拾取面包、猪灵拾取金锭 |
|
||
| [EntityStartRidingEvent](实体.md#entitystartridingevent) | <span style="display:inline;color:#ff5555">服务端</span> | 当实体骑乘上另一个实体时触发 |
|
||
| [EntityStopRidingEvent](实体.md#entitystopridingevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当实体停止骑乘时 |
|
||
| [EntityStopRidingEvent](实体.md#entitystopridingevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：当实体停止骑乘时 |
|
||
| [EntityTickServerEvent](实体.md#entitytickserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 实体tick时触发。该事件为20帧每秒。需要使用AddEntityTickEventWhiteList添加触发该事件的实体类型白名单。 |
|
||
| [HealthChangeBeforeServerEvent](实体.md#healthchangebeforeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 生物生命值或最大生命值发生变化之前触发 |
|
||
| [HealthChangeClientEvent](实体.md#healthchangeclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 生物生命值发生变化时触发 |
|
||
| [HealthChangeServerEvent](实体.md#healthchangeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 生物生命值发生变化时触发 |
|
||
| [LeaveEntityClientEvent](实体.md#leaveentityclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家远离生物时触发 |
|
||
| [MobDieEvent](实体.md#mobdieevent) | <span style="display:inline;color:#ff5555">服务端</span> | 实体死亡时触发 |
|
||
| [MobGriefingBlockServerEvent](实体.md#mobgriefingblockserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 环境生物改变方块时触发，触发的时机与mobgriefing游戏规则影响的行为相同 |
|
||
| [OnFireHurtEvent](实体.md#onfirehurtevent) | <span style="display:inline;color:#ff5555">服务端</span> | 生物受到火焰伤害时触发 |
|
||
| [OnGroundClientEvent](实体.md#ongroundclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 实体着地事件。玩家，沙子，铁砧，掉落的物品，点燃的TNT掉落地面时触发，其余实体着地不触发。 |
|
||
| [OnGroundServerEvent](实体.md#ongroundserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 实体着地事件。实体，掉落的物品，点燃的TNT掉落地面时触发 |
|
||
| [OnKnockBackServerEvent](实体.md#onknockbackserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 实体被击退时触发 |
|
||
| [OnMobHitBlockServerEvent](实体.md#onmobhitblockserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：通过OpenMobHitBlockDetection打开方块碰撞检测后，当生物（不包括玩家）碰撞到方块时触发该事件。 |
|
||
| [OnMobHitMobClientEvent](实体.md#onmobhitmobclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：通过OpenPlayerHitMobDetection打开生物碰撞检测后，当生物间（包含玩家）碰撞时触发该事件。注：客户端和服务端分别作碰撞检测，可能两个事件返回的略有差异。 |
|
||
| [OnMobHitMobServerEvent](实体.md#onmobhitmobserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：通过OpenPlayerHitMobDetection打开生物碰撞检测后，当生物间（包含玩家）碰撞时触发该事件。注：客户端和服务端分别作碰撞检测，可能两个事件返回的略有差异。 |
|
||
| [ProjectileCritHitEvent](实体.md#projectilecrithitevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当抛射物与头部碰撞时触发该事件。注：需调用OpenPlayerCritBox开启玩家爆头后才能触发。 |
|
||
| [ProjectileDoHitEffectEvent](实体.md#projectiledohiteffectevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当抛射物碰撞时触发该事件 |
|
||
| [RefreshEffectServerEvent](实体.md#refresheffectserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：实体身上状态效果更新时触发，更新条件1、新增状态等级较高，更新状态等级及时间；2、新增状态等级不变，时间较长，更新状态持续时间 |
|
||
| [RemoveEffectServerEvent](实体.md#removeeffectserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：实体身上状态效果被移除时 |
|
||
| [SpawnProjectileServerEvent](实体.md#spawnprojectileserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：抛射物生成时触发 |
|
||
| [StartRidingClientEvent](实体.md#startridingclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：一个实体即将骑乘另外一个实体 |
|
||
| [StartRidingServerEvent](实体.md#startridingserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：一个实体即将骑乘另外一个实体 |
|
||
| [WillAddEffectServerEvent](实体.md#willaddeffectserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：实体即将获得状态效果前 |
|
||
| [WillTeleportToServerEvent](实体.md#willteleporttoserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 实体即将传送或切换维度 |
|
||
|
||
## 玩家
|
||
| 事件| <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [AddExpEvent](玩家.md#addexpevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当玩家增加经验时触发该事件。 |
|
||
| [AddLevelEvent](玩家.md#addlevelevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当玩家升级时触发该事件。 |
|
||
| [CameraMotionStartClientEvent](玩家.md#cameramotionstartclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 相机运动器开始事件。相机添加运动器后，运动器开始运行时触发 |
|
||
| [CameraMotionStopClientEvent](玩家.md#cameramotionstopclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 相机运动器停止事件。相机添加运动器并开始运行后，运动器自动停止时触发 |
|
||
| [ChangeLevelUpCostServerEvent](玩家.md#changelevelupcostserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：获取玩家下一个等级升级经验时，用于重载玩家的升级经验，每个等级在重置之前都只会触发一次 |
|
||
| [DimensionChangeClientEvent](玩家.md#dimensionchangeclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家维度改变时客户端抛出 |
|
||
| [DimensionChangeFinishClientEvent](玩家.md#dimensionchangefinishclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家维度改变完成后客户端抛出 |
|
||
| [DimensionChangeFinishServerEvent](玩家.md#dimensionchangefinishserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家维度改变完成后服务端抛出 |
|
||
| [DimensionChangeServerEvent](玩家.md#dimensionchangeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家维度改变时服务端抛出 |
|
||
| [ExtinguishFireClientEvent](玩家.md#extinguishfireclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家扑灭火焰时触发。下雨，倒水等方式熄灭火焰不会触发。 |
|
||
| [ExtinguishFireServerEvent](玩家.md#extinguishfireserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家扑灭火焰时触发。下雨，倒水等方式熄灭火焰不会触发。 |
|
||
| [GameTypeChangedClientEvent](玩家.md#gametypechangedclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 个人游戏模式发生变化时客户端触发。 |
|
||
| [GameTypeChangedServerEvent](玩家.md#gametypechangedserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 当默认游戏模式或个人游戏模式发生变化时服务端触发，如果个人游戏模式不为默认时，修改默认游戏模式也会同时修改个人游戏模式，此时会触发两次该事件 |
|
||
| [MountTamingEvent](玩家.md#mounttamingevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家通过骑乘驯服生物后触发该事件 |
|
||
| [OnLocalPlayerActionClientEvent](玩家.md#onlocalplayeractionclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家动作事件，当本地玩家开始/停止某些动作时触发该事件 |
|
||
| [OnLocalPlayerStartJumpClientEvent](玩家.md#onlocalplayerstartjumpclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 本地玩家开始跳跃时触发 |
|
||
| [OnPlayerActionServerEvent](玩家.md#onplayeractionserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家动作事件，当玩家开始/停止某些动作时触发该事件 |
|
||
| [OnPlayerHitBlockClientEvent](玩家.md#onplayerhitblockclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：通过OpenPlayerHitBlockDetection打开方块碰撞检测后，当玩家碰撞到方块时触发该事件。玩家着地时会触发OnGroundClientEvent，而不是该事件。客户端和服务端分别作碰撞检测，可能两个事件返回的结果略有差异。 |
|
||
| [OnPlayerHitBlockServerEvent](玩家.md#onplayerhitblockserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：通过OpenPlayerHitBlockDetection打开方块碰撞检测后，当玩家碰撞到方块时触发该事件。监听玩家着地请使用客户端的OnGroundClientEvent。客户端和服务端分别作碰撞检测，可能两个事件返回的略有差异。 |
|
||
| [PerspChangeClientEvent](玩家.md#perspchangeclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 视角切换时会触发的事件 |
|
||
| [PlayerAttackEntityEvent](玩家.md#playerattackentityevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当玩家攻击时触发该事件。 |
|
||
| [PlayerAttackEntityEvent](玩家.md#playerattackentityevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：当本地玩家攻击时触发该事件。 |
|
||
| [PlayerCheatSpinAttackServerEvent](玩家.md#playercheatspinattackserverevent) | <span style="display:inline;color:#ff5555">Apollo</span> | 触发时机：玩家开始/结束快速旋转攻击并且不符合发送快速旋转攻击条件时触发（装备激流附魔的三叉戟、在水中或雨中，且未骑乘） |
|
||
| [PlayerDieEvent](玩家.md#playerdieevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当玩家死亡时触发该事件。 |
|
||
| [PlayerDoInteractServerEvent](玩家.md#playerdointeractserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家与有minecraft:interact组件的生物交互时触发该事件，例如玩家手持空桶对牛挤奶、玩家手持打火石点燃苦力怕 |
|
||
| [PlayerEatFoodServerEvent](玩家.md#playereatfoodserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家吃下食物时触发 |
|
||
| [PlayerFeedEntityServerEvent](玩家.md#playerfeedentityserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家喂养生物时触发，例如玩家手持小麦喂养牛、玩家手持胡萝卜喂养幼年猪。 |
|
||
| [PlayerHungerChangeServerEvent](玩家.md#playerhungerchangeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家饥饿度变化时触发该事件 |
|
||
| [PlayerHurtEvent](玩家.md#playerhurtevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当玩家受伤害前触发该事件。 |
|
||
| [PlayerInteractServerEvent](玩家.md#playerinteractserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家可以与实体交互时。如果是鼠标控制模式，则当准心对着实体时触发。如果是触屏模式，则触发时机与屏幕下方的交互按钮显示的时机相同。玩家真正与实体发生交互的事件见[PlayerDoInteractServerEvent](玩家.md#playerdointeractserverevent) |
|
||
| [PlayerNamedEntityServerEvent](玩家.md#playernamedentityserverevent) | <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> | 玩家使用床睡觉成功 |
|
||
| [PlayerSpinAttackServerEvent](玩家.md#playerspinattackserverevent) | <span style="display:inline;color:#ff5555">Apollo</span> | 触发时机：玩家开始/结束快速旋转攻击时触发 |
|
||
| [PlayerStopSleepServerEvent](玩家.md#playerstopsleepserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家停止睡觉 |
|
||
| [PlayerTeleportEvent](玩家.md#playerteleportevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当玩家传送时触发该事件，如：玩家使用末影珍珠或tp指令时。 |
|
||
| [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> | 触发时机:玩家游戏内购买商品时服务端抛出的事件 |
|
||
|
||
## 方块
|
||
| 事件| <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [BlockAnimateRandomTickEvent](方块.md#blockanimaterandomtickevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：以摄像机为中心，随机选取周围的方块触发Tick，触发的数量取决于设备性能。只有添加了netease:block_animate_random_tick的自定义方块才会触发此事件 |
|
||
| [BlockDestroyByLiquidServerEvent](方块.md#blockdestroybyliquidserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：方块被水流破坏的事件 |
|
||
| [BlockLiquidStateChangeAfterServerEvent](方块.md#blockliquidstatechangeafterserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：方块转为含水或者脱离含水(流体)后触发 |
|
||
| [BlockLiquidStateChangeServerEvent](方块.md#blockliquidstatechangeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：方块转为含水或者脱离含水(流体)前触发 |
|
||
| [BlockNeighborChangedServerEvent](方块.md#blockneighborchangedserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：自定义方块周围的方块发生变化时，需要配置netease:neighborchanged_sendto_script，详情请查阅《自定义农作物》文档 |
|
||
| [BlockRandomTickServerEvent](方块.md#blockrandomtickserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：自定义方块配置<a href="../../../mcguide/20-玩法开发/15-自定义游戏内容/2-自定义方块/1-JSON组件.html#netease-random-tick">netease:random_tick</a>随机tick时 |
|
||
| [BlockRemoveServerEvent](方块.md#blockremoveserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：监听该事件的方块在销毁时触发，可以通过[ListenOnBlockRemoveEvent](方块.md#listenonblockremoveevent)方法进行监听，或者通过json组件<a href="../../../mcguide/20-玩法开发/15-自定义游戏内容/2-自定义方块/1-JSON组件.html#netease-listen-block-remove">netease:listen_block_remove</a>进行配置 |
|
||
| [BlockSnowStateChangeAfterServerEvent](方块.md#blocksnowstatechangeafterserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：方块转为含雪或者脱离含雪后触发 |
|
||
| [BlockSnowStateChangeServerEvent](方块.md#blocksnowstatechangeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：方块转为含雪或者脱离含雪前触发 |
|
||
| [BlockStrengthChangedServerEvent](方块.md#blockstrengthchangedserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：自定义机械元件方块红石信号量发生变化时触发 |
|
||
| [ChestBlockTryPairWithServerEvent](方块.md#chestblocktrypairwithserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：两个并排的小箱子方块准备组合为一个大箱子方块时 |
|
||
| [ClientBlockUseEvent](方块.md#clientblockuseevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：玩家右键点击新版自定义方块（或者通过接口AddBlockItemListenForUseEvent增加监听的MC原生游戏方块）时客户端抛出该事件（该事件tick执行，需要注意效率问题）。 |
|
||
| [CommandBlockContainerOpenEvent](方块.md#commandblockcontaineropenevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家点击命令方块，尝试打开命令方块的设置界面 |
|
||
| [CommandBlockUpdateEvent](方块.md#commandblockupdateevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家尝试修改命令方块的内置命令时 |
|
||
| [DestroyBlockEvent](方块.md#destroyblockevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当方块已经被玩家破坏时触发该事件。 |
|
||
| [DirtBlockToGrassBlockServerEvent](方块.md#dirtblocktograssblockserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：泥土方块变成草方块时触发 |
|
||
| [EntityPlaceBlockAfterServerEvent](方块.md#entityplaceblockafterserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当生物成功放置方块后触发 |
|
||
| [FallingBlockBreakServerEvent](方块.md#fallingblockbreakserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当下落的方块实体被破坏时，服务端触发该事件 |
|
||
| [FallingBlockCauseDamageBeforeClientEvent](方块.md#fallingblockcausedamagebeforeclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：当下落的方块开始计算砸到实体的伤害时，客户端触发该事件 |
|
||
| [FallingBlockCauseDamageBeforeServerEvent](方块.md#fallingblockcausedamagebeforeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当下落的方块开始计算砸到实体的伤害时，服务端触发该事件 |
|
||
| [FallingBlockReturnHeavyBlockServerEvent](方块.md#fallingblockreturnheavyblockserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当下落的方块实体变回普通重力方块时，服务端触发该事件 |
|
||
| [FarmBlockToDirtBlockServerEvent](方块.md#farmblocktodirtblockserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：耕地退化为泥土时触发 |
|
||
| [GrassBlockToDirtBlockServerEvent](方块.md#grassblocktodirtblockserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：草方块变成泥土方块时触发 |
|
||
| [HeavyBlockStartFallingServerEvent](方块.md#heavyblockstartfallingserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当重力方块变为下落的方块实体后，服务端触发该事件 |
|
||
| [HopperTryPullInServerEvent](方块.md#hoppertrypullinserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当漏斗上方连接容器后，容器往漏斗开始输入物品时触发，事件仅触发一次 |
|
||
| [HopperTryPullOutServerEvent](方块.md#hoppertrypulloutserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当漏斗以毗邻的方式连接容器时，即从旁边连接容器时，漏斗向容器开始输出物品时触发，事件仅触发一次 |
|
||
| [ModBlockEntityLoadedClientEvent](方块.md#modblockentityloadedclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 客户端自定义方块实体初始化完成时触发 |
|
||
| [ModBlockEntityRemoveClientEvent](方块.md#modblockentityremoveclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 客户端自定义方块实体卸载时触发 |
|
||
| [ModBlockEntityTickClientEvent](方块.md#modblockentitytickclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 客户端自定义方块实体tick事件 |
|
||
| [OnAfterFallOnBlockClientEvent](方块.md#onafterfallonblockclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：当实体降落到方块后客户端触发，主要用于力的计算 |
|
||
| [OnAfterFallOnBlockServerEvent](方块.md#onafterfallonblockserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当实体降落到方块后服务端触发，主要用于力的计算 |
|
||
| [OnBeforeFallOnBlockServerEvent](方块.md#onbeforefallonblockserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当实体刚降落到方块上时服务端触发，主要用于伤害计算 |
|
||
| [OnEntityInsideBlockClientEvent](方块.md#onentityinsideblockclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：当实体碰撞盒所在区域有方块时，客户端持续触发 |
|
||
| [OnEntityInsideBlockServerEvent](方块.md#onentityinsideblockserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当实体碰撞盒所在区域有方块时，服务端持续触发 |
|
||
| [OnModBlockNeteaseEffectCreatedClientEvent](方块.md#onmodblockneteaseeffectcreatedclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 自定义方块实体绑定的特效创建成功事件，在自定义方块实体中绑定的特效创建成功时触发以及使用接口CreateFrameEffectForBlockEntity或CreateParticleEffectForBlockEntity为自定义方块实体添加特效成功时触发。 |
|
||
| [OnStandOnBlockClientEvent](方块.md#onstandonblockclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：当实体站立到方块上时客户端持续触发 |
|
||
| [OnStandOnBlockServerEvent](方块.md#onstandonblockserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当实体站立到方块上时服务端持续触发 |
|
||
| [PistonActionServerEvent](方块.md#pistonactionserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：活塞或者粘性活塞推送/缩回影响附近方块时 |
|
||
| [PlayerTryDestroyBlockClientEvent](方块.md#playertrydestroyblockclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 当玩家即将破坏方块时，客户端线程触发该事件。主要用于床，旗帜，箱子这些根据方块实体数据进行渲染的方块，一般情况下请使用ServerPlayerTryDestroyBlockEvent |
|
||
| [ServerBlockEntityTickEvent](方块.md#serverblockentitytickevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：自定义方块配置了netease:block_entity组件并设tick为true，方块在玩家的模拟距离（新建存档时可以设置，默认为4个区块）内，或者在tickingarea内的时候触发 |
|
||
| [ServerBlockUseEvent](方块.md#serverblockuseevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家右键点击新版自定义方块（或者通过接口AddBlockItemListenForUseEvent增加监听的MC原生游戏方块）时服务端抛出该事件（该事件tick执行，需要注意效率问题）。 |
|
||
| [ServerEntityTryPlaceBlockEvent](方块.md#serverentitytryplaceblockevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：当生物试图放置方块时触发该事件。 |
|
||
| [ServerPlaceBlockEntityEvent](方块.md#serverplaceblockentityevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：手动放置或通过接口创建含自定义方块实体的方块时触发，此时可向该方块实体中存放数据 |
|
||
| [ServerPlayerTryDestroyBlockEvent](方块.md#serverplayertrydestroyblockevent) | <span style="display:inline;color:#ff5555">服务端</span> | 当玩家即将破坏方块时，服务端线程触发该事件。 |
|
||
| [ShearsDestoryBlockBeforeClientEvent](方块.md#shearsdestoryblockbeforeclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：玩家手持剪刀破坏方块时，有剪刀特殊效果的方块会在客户端线程触发该事件 |
|
||
| [ShearsDestoryBlockBeforeServerEvent](方块.md#shearsdestoryblockbeforeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家手持剪刀破坏方块时，有剪刀特殊效果的方块会在服务端线程触发该事件 |
|
||
| [StartDestroyBlockClientEvent](方块.md#startdestroyblockclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家开始挖方块时触发。创造模式下不触发。 |
|
||
| [StartDestroyBlockServerEvent](方块.md#startdestroyblockserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家开始挖方块时触发。创造模式下不触发。 |
|
||
| [StepOffBlockClientEvent](方块.md#stepoffblockclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：实体移动离开一个实心方块时触发 |
|
||
| [StepOffBlockServerEvent](方块.md#stepoffblockserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：实体移动离开一个实心方块时触发 |
|
||
| [StepOnBlockClientEvent](方块.md#steponblockclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：实体刚移动至一个新实心方块时触发。 |
|
||
| [StepOnBlockServerEvent](方块.md#steponblockserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：实体刚移动至一个新实心方块时触发。 |
|
||
|
||
## 物品
|
||
| 事件| <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [ActorAcquiredItemClientEvent](物品.md#actoracquireditemclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：玩家获得物品时客户端抛出的事件（有些获取物品方式只会触发客户端事件，有些获取物品方式只会触发服务端事件，在使用时注意一点。） |
|
||
| [ActorAcquiredItemServerEvent](物品.md#actoracquireditemserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家获得物品时服务端抛出的事件（有些获取物品方式只会触发客户端事件，有些获取物品方式只会触发服务端事件，在使用时注意一点。） |
|
||
| [ActorUseItemClientEvent](物品.md#actoruseitemclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：玩家使用物品时客户端抛出的事件（比较特殊不走该事件的例子：1）染料对有水的炼药锅使用；2）盔甲架装备盔甲）;3)喝牛奶 |
|
||
| [ActorUseItemServerEvent](物品.md#actoruseitemserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家使用物品生效之前服务端抛出的事件（比较特殊不走该事件的例子：1）染料对有水的炼药锅使用；2）盔甲架装备盔甲） |
|
||
| [AnvilCreateResultItemAfterClientEvent](物品.md#anvilcreateresultitemafterclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家点击铁砧合成得到的物品时抛出的事件。 |
|
||
| [ClientItemTryUseEvent](物品.md#clientitemtryuseevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家点击右键尝试使用物品时客户端抛出的事件，可以通过设置cancel为True取消使用物品。注：ClientItemTryUseEvent事件设置cancel时即可取消使用，无需服务端ServerItemTryUseEvent再次cancel，且服务端事件将不再触发。 |
|
||
| [ClientItemUseOnEvent](物品.md#clientitemuseonevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家在对方块使用物品时客户端抛出的事件。注：事件设置ret = True 时即可取消使用，无需服务端再次设置ServerItemUseOnEvent取消，且服务端事件将不再触发。 |
|
||
| [ClientShapedRecipeTriggeredEvent](物品.md#clientshapedrecipetriggeredevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家合成物品时触发 |
|
||
| [ContainerItemChangedServerEvent](物品.md#containeritemchangedserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 容器物品变化事件 |
|
||
| [CraftItemOutputChangeServerEvent](物品.md#craftitemoutputchangeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家从容器拿出生成物品时触发 |
|
||
| [CraftUpdateResultItemClientEvent](物品.md#craftupdateresultitemclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家工作台界面更新显示可合成物品时抛出的事件。 |
|
||
| [FurnaceBurnFinishedServerEvent](物品.md#furnaceburnfinishedserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 服务端熔炉烧制触发事件。熔炉, 高炉，烟熏炉烧出物品时触发 |
|
||
| [GrindStoneRemovedEnchantClientEvent](物品.md#grindstoneremovedenchantclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家点击砂轮合成得到的物品时抛出的事件 |
|
||
| [InventoryItemChangedClientEvent](物品.md#inventoryitemchangedclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家背包物品变化时客户端抛出的事件。 |
|
||
| [InventoryItemChangedServerEvent](物品.md#inventoryitemchangedserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家背包物品变化时服务端抛出的事件。 |
|
||
| [ItemDurabilityChangedServerEvent](物品.md#itemdurabilitychangedserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 物品耐久度变化事件 |
|
||
| [ItemReleaseUsingClientEvent](物品.md#itemreleaseusingclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：释放正在使用的物品 |
|
||
| [ItemReleaseUsingServerEvent](物品.md#itemreleaseusingserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：释放正在使用的物品时 |
|
||
| [ItemUseAfterServerEvent](物品.md#itemuseafterserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家在使用物品之后服务端抛出的事件。 |
|
||
| [ItemUseOnAfterServerEvent](物品.md#itemuseonafterserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家在对方块使用物品之后服务端抛出的事件。 |
|
||
| [OnCarriedNewItemChangedClientEvent](物品.md#oncarriednewitemchangedclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 手持物品发生变化时，触发该事件；数量改变不会通知 |
|
||
| [OnCarriedNewItemChangedServerEvent](物品.md#oncarriednewitemchangedserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家切换主手物品时触发该事件 |
|
||
| [OnItemPutInEnchantingModelServerEvent](物品.md#onitemputinenchantingmodelserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家将可附魔物品放到附魔台上时 |
|
||
| [OnNewArmorExchangeServerEvent](物品.md#onnewarmorexchangeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家切换盔甲时触发该事件 |
|
||
| [OnOffhandItemChangedServerEvent](物品.md#onoffhanditemchangedserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家切换副手物品时触发该事件 |
|
||
| [OnPlayerActiveShieldServerEvent](物品.md#onplayeractiveshieldserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家激活/取消激活盾牌触发的事件。包括玩家持盾进入潜行状态，以及在潜行状态切换盾牌（切换耐久度不同的相同盾牌不会触发） |
|
||
| [OnPlayerBlockedByShieldAfterServerEvent](物品.md#onplayerblockedbyshieldafterserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家使用盾牌抵挡伤害之后触发 |
|
||
| [OnPlayerBlockedByShieldBeforeServerEvent](物品.md#onplayerblockedbyshieldbeforeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家使用盾牌抵挡伤害之前触发 |
|
||
| [PlayerDropItemServerEvent](物品.md#playerdropitemserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：玩家丢弃物品时触发 |
|
||
| [PlayerPickupArrowServerEvent](物品.md#playerpickuparrowserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家即将捡起抛射物时触发，包括使用"netease:pick_up"的自定义抛射物 |
|
||
| [PlayerTryDropItemClientEvent](物品.md#playertrydropitemclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：玩家丢弃物品时触发 |
|
||
| [PlayerTryPutCustomContainerItemServerEvent](物品.md#playertryputcustomcontaineritemserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家尝试将物品放入自定义容器时触发该事件 |
|
||
| [ServerItemTryUseEvent](物品.md#serveritemtryuseevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家点击右键尝试使用物品时服务端抛出的事件。注：ClientItemTryUseEvent的cancel设置为True时，服务端事件不会被触发了。 |
|
||
| [ServerItemUseOnEvent](物品.md#serveritemuseonevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家在对方块使用物品之前服务端抛出的事件。注：客户端事件ClientItemUseOnEvent设置ret设置为True时，服务端不再会接受到这个事件。 |
|
||
| [ServerPlayerTryTouchEvent](物品.md#serverplayertrytouchevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家即将捡起物品时触发 |
|
||
| [ShearsUseToBlockBeforeServerEvent](物品.md#shearsusetoblockbeforeserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 触发时机：实体手持剪刀对方块使用时，有剪刀特殊效果的方块会在服务端线程触发该事件 |
|
||
| [StartUsingItemClientEvent](物品.md#startusingitemclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家使用物品（目前仅支持Bucket（奶桶）、Trident（三叉戟）、RangedWeapon（弓）、Food（食物）、Potion（药水）、Crossbow（弩））时抛出 |
|
||
| [StopUsingItemClientEvent](物品.md#stopusingitemclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家停止使用物品（目前仅支持Bucket（奶桶）、Trident（三叉戟）、RangedWeapon（弓）、Food（食物）、Potion（药水）、Crossbow（弩））时抛出 |
|
||
| [UIContainerItemChangedServerEvent](物品.md#uicontaineritemchangedserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 合成容器物品发生变化时触发 |
|
||
|
||
## 模型
|
||
| 事件| <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [AttackAnimBeginClientEvent](模型.md#attackanimbeginclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 攻击动作开始时触发 |
|
||
| [AttackAnimBeginServerEvent](模型.md#attackanimbeginserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 当攻击动作开始时触发 |
|
||
| [AttackAnimEndClientEvent](模型.md#attackanimendclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 攻击动作结束时触发 |
|
||
| [AttackAnimEndServerEvent](模型.md#attackanimendserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 当攻击动作结束时触发 |
|
||
| [JumpAnimBeginServerEvent](模型.md#jumpanimbeginserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 当跳跃动作开始时触发 |
|
||
| [WalkAnimBeginClientEvent](模型.md#walkanimbeginclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 走路动作开始时触发 |
|
||
| [WalkAnimBeginServerEvent](模型.md#walkanimbeginserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 当走路动作开始时触发 |
|
||
| [WalkAnimEndClientEvent](模型.md#walkanimendclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 走路动作结束时触发 |
|
||
| [WalkAnimEndServerEvent](模型.md#walkanimendserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 当走路动作结束时触发 |
|
||
|
||
## UI
|
||
| 事件| <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [AchievementButtonMovedClientEvent](UI.md#achievementbuttonmovedclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：使用自定义成就系统的时，拖动成就入口结束时触发 |
|
||
| [ClientChestCloseEvent](UI.md#clientchestcloseevent) | <span style="display:inline;color:#7575f9">客户端</span> | 关闭箱子界面时触发，包括小箱子，合并后大箱子和末影箱(实体容器不属于方块，不会触发该事件) |
|
||
| [ClientChestOpenEvent](UI.md#clientchestopenevent) | <span style="display:inline;color:#7575f9">客户端</span> | 打开箱子界面时触发，包括小箱子，合并后大箱子和末影箱(实体容器不属于方块，不会触发该事件) |
|
||
| [ClientPlayerInventoryCloseEvent](UI.md#clientplayerinventorycloseevent) | <span style="display:inline;color:#7575f9">客户端</span> | 关闭物品背包界面时触发 |
|
||
| [ClientPlayerInventoryOpenEvent](UI.md#clientplayerinventoryopenevent) | <span style="display:inline;color:#7575f9">客户端</span> | 打开物品背包界面时触发 |
|
||
| [CloseNeteaseShopEvent](UI.md#closeneteaseshopevent) | <span style="display:inline;color:#7575f9">客户端</span> | 关闭商城界面时触发，包括脚本商城和Apollo插件商城 |
|
||
| [GridComponentSizeChangedClientEvent](UI.md#gridcomponentsizechangedclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | UI grid控件里格子重新排列时触发 |
|
||
| [HudButtonChangedClientEvent](UI.md#hudbuttonchangedclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 当原生HUD按钮位置或大小发生改变时触发，例如玩家使用了自定义控件功能会触发，可在该事件中修改mod按钮的位置防止重叠 |
|
||
| [OnItemSlotButtonClickedEvent](UI.md#onitemslotbuttonclickedevent) | <span style="display:inline;color:#7575f9">客户端</span> | 点击快捷栏、背包栏、盔甲栏、副手栏的物品槽时触发 |
|
||
| [PlayerChatButtonClickClientEvent](UI.md#playerchatbuttonclickclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家点击聊天按钮或回车键触发呼出聊天窗口时客户端抛出的事件 |
|
||
| [PlayerInventoryOpenScriptServerEvent](UI.md#playerinventoryopenscriptserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 某个客户端打开物品背包界面时触发 |
|
||
| [PopScreenAfterClientEvent](UI.md#popscreenafterclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | screen移除触发 |
|
||
| [PopScreenEvent](UI.md#popscreenevent) | <span style="display:inline;color:#7575f9">客户端</span> | screen移除触发 |
|
||
| [PushScreenEvent](UI.md#pushscreenevent) | <span style="display:inline;color:#7575f9">客户端</span> | screen创建触发 |
|
||
| [ScreenSizeChangedClientEvent](UI.md#screensizechangedclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 改变屏幕大小时会触发的事件 |
|
||
| [UiInitFinished](UI.md#uiinitfinished) | <span style="display:inline;color:#7575f9">客户端</span> | UI初始化框架完成,此时可以创建UI |
|
||
| [UrgeShipEvent](UI.md#urgeshipevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家点击商城催促发货按钮时触发该事件 |
|
||
|
||
## 音效
|
||
| 事件| <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [OnMusicStopClientEvent](音效.md#onmusicstopclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 音乐停止时，当玩家调用StopCustomMusic来停止自定义背景音乐时，会触发该事件 |
|
||
| [PlayMusicClientEvent](音效.md#playmusicclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 播放背景音乐时触发 |
|
||
| [PlaySoundClientEvent](音效.md#playsoundclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 播放场景音效或UI音效时触发 |
|
||
|
||
## 控制
|
||
| 事件| <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [ClientJumpButtonPressDownEvent](控制.md#clientjumpbuttonpressdownevent) | <span style="display:inline;color:#7575f9">客户端</span> | 跳跃按钮按下事件，返回值设置参数只对当次按下事件起作用 |
|
||
| [ClientJumpButtonReleaseEvent](控制.md#clientjumpbuttonreleaseevent) | <span style="display:inline;color:#7575f9">客户端</span> | 跳跃按钮按下释放事件 |
|
||
| [GetEntityByCoordEvent](控制.md#getentitybycoordevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家点击屏幕时触发，多个手指点在屏幕上时，只有第一个会触发。 |
|
||
| [GetEntityByCoordReleaseClientEvent](控制.md#getentitybycoordreleaseclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家点击屏幕后松开时触发，多个手指点在屏幕上时，只有最后一个手指松开时触发。 |
|
||
| [GyroSensorChangedClientEvent](控制.md#gyrosensorchangedclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 触发时机：陀螺仪传感器姿态发生变化时 |
|
||
| [HoldBeforeClientEvent](控制.md#holdbeforeclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家长按屏幕，即将响应到游戏内时触发。仅在移动端或pc的F11模式下触发。pc的非F11模式可以监听[RightClickBeforeClientEvent](控制.md#rightclickbeforeclientevent)事件 |
|
||
| [LeftClickBeforeClientEvent](控制.md#leftclickbeforeclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家按下攻击/摧毁键时触发，例如鼠标左键、新触控攻击键、手柄右扳机键。鼠标左键仅在pc的普通控制模式（即非F11模式）下触发 |
|
||
| [LeftClickReleaseClientEvent](控制.md#leftclickreleaseclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家松开攻击/摧毁键时触发，例如鼠标左键、新触控攻击键、手柄右扳机键。鼠标左键仅在pc的普通控制模式（即非F11模式）下触发 |
|
||
| [MouseWheelClientEvent](控制.md#mousewheelclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 鼠标滚轮滚动时触发 |
|
||
| [OnBackButtonReleaseClientEvent](控制.md#onbackbuttonreleaseclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 返回按钮（目前特指安卓系统导航中的返回按钮）松开时触发 |
|
||
| [OnClientPlayerStartMove](控制.md#onclientplayerstartmove) | <span style="display:inline;color:#7575f9">客户端</span> | 移动按钮按下触发事件，在按住一个方向键的同时，去按另外一个方向键，不会触发第二次 |
|
||
| [OnClientPlayerStopMove](控制.md#onclientplayerstopmove) | <span style="display:inline;color:#7575f9">客户端</span> | 移动按钮按下释放时触发事件，同时按下多个方向键，需要释放所有的方向键才会触发事件 |
|
||
| [OnGamepadControllerLayoutChangeClientEvent](控制.md#ongamepadcontrollerlayoutchangeclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 游戏手柄按键映射改变事件 |
|
||
| [OnGamepadKeyPressClientEvent](控制.md#ongamepadkeypressclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 游戏手柄按键事件 |
|
||
| [OnGamepadStickClientEvent](控制.md#ongamepadstickclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 游戏手柄摇杆事件 |
|
||
| [OnGamepadTriggerClientEvent](控制.md#ongamepadtriggerclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 游戏手柄扳机事件 |
|
||
| [OnKeyPressInGame](控制.md#onkeypressingame) | <span style="display:inline;color:#7575f9">客户端</span> | 按键按下或按键释放时触发 |
|
||
| [OnKeyboardControllerLayoutChangeClientEvent](控制.md#onkeyboardcontrollerlayoutchangeclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 键盘按键映射改变事件 |
|
||
| [OnMouseMiddleDownClientEvent](控制.md#onmousemiddledownclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 鼠标按下中键时触发 |
|
||
| [RightClickBeforeClientEvent](控制.md#rightclickbeforeclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家按下使用物品/放置方块键时触发，例如鼠标右键、新触控交互键、手柄左扳机键 |
|
||
| [RightClickReleaseClientEvent](控制.md#rightclickreleaseclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家松开使用物品/放置方块键时触发，例如鼠标右键、新触控交互键、手柄左扳机键 |
|
||
| [TapBeforeClientEvent](控制.md#tapbeforeclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家点击屏幕并松手，即将响应到游戏内时触发。仅在移动端或pc的F11模式下触发。pc的非F11模式可以监听[LeftClickBeforeClientEvent](控制.md#leftclickbeforeclientevent)事件 |
|
||
| [TapOrHoldReleaseClientEvent](控制.md#taporholdreleaseclientevent) | <span style="display:inline;color:#7575f9">客户端</span> | 玩家点击屏幕后松手时触发。仅在移动端或pc的F11模式下触发。pc的非F11模式可以使用[LeftClickReleaseClientEvent](控制.md#leftclickreleaseclientevent)与[RightClickReleaseClientEvent](控制.md#rightclickreleaseclientevent)事件监听鼠标松开 |
|
||
|
||
## 联机大厅
|
||
| 事件| <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [lobbyGoodBuySucServerEvent](联机大厅.md#lobbygoodbuysucserverevent) | <span style="display:inline;color:#ff5555">服务端</span> | 玩家登录联机大厅服务器，或者联机大厅游戏内购买商品时触发。如果是玩家登录，触发时玩家客户端已经触发了UiInitFinished事件 |
|
||
|