搜索
# 事件索引表
# 世界
| 事件 | 描述 | |
|---|---|---|
| AchievementCompleteEvent | 服务端 | 玩家完成自定义成就时触发该事件 |
| AddEntityClientEvent | 客户端 | 客户端侧创建新实体时触发 |
| AddEntityServerEvent | 服务端 | 服务端侧创建新实体，或实体从存档加载时触发 |
| AddPlayerAOIClientEvent | 客户端 | 玩家加入游戏或者其余玩家进入当前玩家视野时触发的事件，替换AddPlayerEvent |
| AddPlayerCreatedClientEvent | 客户端 | 玩家进入当前玩家所在的区块AOI后，玩家皮肤数据异步加载完成后触发的事件 |
| AddServerPlayerEvent | 服务端 | 触发时机：玩家加入时触发该事件。 |
| ChunkAcquireDiscardedClientEvent | 客户端 | 触发时机：客户端区块即将被卸载时 |
| ChunkAcquireDiscardedServerEvent | 服务端 | 服务端区块即将被卸载时触发 |
| ChunkGeneratedServerEvent | 服务端 | 触发时机：区块创建完成时触发 |
| ChunkLoadedClientEvent | 客户端 | 触发时机：客户端区块加载完成时 |
| ChunkLoadedServerEvent | 服务端 | 触发时机：服务端区块加载完成时 |
| ClientLoadAddonsFinishServerEvent | 服务端 | 触发时机：客户端mod加载完成时，服务端触发此事件。服务器可以使用此事件，往客户端发送数据给其初始化。 |
| CommandEvent | 服务端 | 玩家请求执行指令时触发 |
| DelServerPlayerEvent | 服务端 | 触发时机：删除玩家时触发该事件。 |
| EntityRemoveEvent | 服务端 | 实体被删除时触发 |
| ExplosionServerEvent | 服务端 | 当发生爆炸时触发。 |
| LoadClientAddonScriptsAfter | 客户端 | 客户端加载mod完成事件 |
| LoadServerAddonScriptsAfter | 服务端 | 服务器加载完mod时触发 |
| NewOnEntityAreaEvent | 服务端 | 触发时机：通过RegisterEntityAOIEvent注册过AOI事件后，当有实体进入或离开注册感应区域时触发该事件。 |
| OnCommandOutputClientEvent | 客户端 | 当command命令有成功消息输出时触发 |
| OnCommandOutputServerEvent | 服务端 | Command命令执行成功事件 |
| OnContainerFillLoottableServerEvent | 服务端 | 触发时机：随机奖励箱第一次打开根据loottable生成物品时 |
| OnLightningLevelChangeServerEvent | 服务端 | 打雷强度发生改变 |
| OnLocalLightningLevelChangeServerEvent | 服务端 | 独立维度天气打雷强度发生改变时触发 |
| OnLocalPlayerStopLoading | 客户端 | 触发时机：玩家进入存档，出生点地形加载完成时触发。该事件触发时可以进行切换维度的操作。 |
| OnLocalRainLevelChangeServerEvent | 服务端 | 独立维度天气下雨强度发生改变时触发 |
| OnRainLevelChangeServerEvent | 服务端 | 下雨强度发生改变 |
| OnScriptTickClient | 客户端 | 客户端tick事件,1秒30次 |
| OnScriptTickServer | 服务端 | 服务器tick时触发,1秒有30个tick |
| PlaceNeteaseLargeFeatureServerEvent | 服务端 | 触发时机：网易版大型结构即将生成时服务端抛出该事件。 |
| PlaceNeteaseStructureFeatureEvent | 服务端 | 触发时机：首次生成地形时，结构特征即将生成时服务端抛出该事件。 |
| PlayerIntendLeaveServerEvent | 服务端 | 触发时机：即将删除玩家时触发该事件，此时可以通过各种API获取玩家的当前状态。 |
| PlayerJoinMessageEvent | 服务端 | 触发时机：准备显示“xxx加入游戏”的玩家登录提示文字时服务端抛出的事件。 |
| PlayerLeftMessageServerEvent | 服务端 | 触发时机：准备显示“xxx离开游戏”的玩家离开提示文字时服务端抛出的事件。 |
| RemoveEntityClientEvent | 客户端 | 客户端侧实体被移除时触发 |
| RemovePlayerAOIClientEvent | 客户端 | 玩家离开当前玩家视野时触发的事件 |
| ServerChatEvent | 服务端 | 玩家发送聊天信息时触发 |
| ServerPostBlockPatternEvent | 服务端 | 触发时机：用方块组合生成生物，生成生物之后触发该事件。 |
| ServerPreBlockPatternEvent | 服务端 | 触发时机：用方块组合生成生物，在放置最后一个组成方块时触发该事件。 |
| ServerSpawnMobEvent | 服务端 | 游戏内自动生成生物，以及使用api生成生物时触发 |
| UnLoadClientAddonScriptsBefore | 客户端 | 客户端卸载mod之前触发 |
# 实体
| 事件 | 描述 | |
|---|---|---|
| ActorHurtServerEvent | 服务端 | 触发时机：生物（包括玩家）受伤时触发 |
| ActuallyHurtServerEvent | 服务端 | 实体实际受到伤害时触发，相比于DamageEvent，该伤害为经过护甲及buff计算后，实际的扣血量 |
| AddEffectServerEvent | 服务端 | 触发时机：实体获得状态效果时 |
| ApproachEntityClientEvent | 客户端 | 玩家靠近生物时触发 |
| ChangeSwimStateServerEvent | 服务端 | 触发时机：实体开始或者结束游泳时 |
| DamageEvent | 服务端 | 实体受到伤害时触发 |
| EntityChangeDimensionServerEvent | 服务端 | 实体维度改变时服务端抛出 |
| EntityDefinitionsEventServerEvent | 服务端 | 触发时机：生物定义json文件中设置的event触发时同时触发。生物行为变更事件 |
| EntityDieLoottableAfterServerEvent | 服务端 | 触发时机：生物死亡掉落物品之后 |
| EntityDieLoottableServerEvent | 服务端 | 触发时机：生物死亡掉落物品时 |
| EntityDroppedItemServerEvent | 服务端 | 触发时机：生物扔出物品时触发 |
| EntityEffectDamageServerEvent | 服务端 | 生物受到状态伤害/回复事件。 |
| EntityLoadScriptEvent | 服务端 | 数据库加载实体自定义数据时触发 |
| EntityModelChangedClientEvent | 客户端 | 触发时机：实体模型切换时触发 |
| EntityMotionStartServerEvent | 服务端 | 实体运动器开始事件。实体（包含玩家）添加运动器后，运动器开始运行时触发 |
| EntityMotionStopServerEvent | 服务端 | 实体运动器停止事件。实体（包含玩家）添加运动器并开始运行后，运动器自动停止时触发 |
| EntityPickupItemServerEvent | 服务端 | 有minecraft:behavior.pickup_items行为的生物拾取物品时触发该事件，例如村民拾取面包、猪灵拾取金锭 |
| EntityStartRidingEvent | 服务端 | 当实体骑乘上另一个实体时触发 |
| EntityStopRidingEvent | 服务端 | 触发时机：当实体停止骑乘时 |
| EntityStopRidingEvent | 客户端 | 触发时机：当实体停止骑乘时 |
| EntityTickServerEvent | 服务端 | 实体tick时触发。该事件为20帧每秒。需要使用AddEntityTickEventWhiteList添加触发该事件的实体类型白名单。 |
| HealthChangeBeforeServerEvent | 服务端 | 生物生命值发生变化之前触发 |
| HealthChangeClientEvent | 客户端 | 生物生命值发生变化时触发 |
| HealthChangeServerEvent | 服务端 | 生物生命值发生变化时触发 |
| LeaveEntityClientEvent | 客户端 | 玩家远离生物时触发 |
| MobDieEvent | 服务端 | 实体死亡时触发 |
| MobGriefingBlockServerEvent | 服务端 | 环境生物改变方块时触发，触发的时机与mobgriefing游戏规则影响的行为相同 |
| OnFireHurtEvent | 服务端 | 生物受到火焰伤害时触发 |
| OnGroundClientEvent | 客户端 | 实体着地事件。玩家，沙子，铁砧，掉落的物品，点燃的TNT掉落地面时触发，其余实体着地不触发。 |
| OnGroundServerEvent | 服务端 | 实体着地事件。实体，掉落的物品，点燃的TNT掉落地面时触发 |
| OnKnockBackServerEvent | 服务端 | 实体被击退时触发 |
| OnMobHitBlockServerEvent | 服务端 | 触发时机：通过OpenMobHitBlockDetection打开方块碰撞检测后，当生物（不包括玩家）碰撞到方块时触发该事件。 |
| OnMobHitMobClientEvent | 客户端 | 触发时机：通过OpenPlayerHitMobDetection打开生物碰撞检测后，当生物间（包含玩家）碰撞时触发该事件。注：客户端和服务端分别作碰撞检测，可能两个事件返回的略有差异。 |
| OnMobHitMobServerEvent | 服务端 | 触发时机：通过OpenPlayerHitMobDetection打开生物碰撞检测后，当生物间（包含玩家）碰撞时触发该事件。注：客户端和服务端分别作碰撞检测，可能两个事件返回的略有差异。 |
| ProjectileCritHitEvent | 服务端 | 触发时机：当抛射物与头部碰撞时触发该事件。注：需调用OpenPlayerCritBox开启玩家爆头后才能触发。 |
| ProjectileDoHitEffectEvent | 服务端 | 触发时机：当抛射物碰撞时触发该事件 |
| RefreshEffectServerEvent | 服务端 | 触发时机：实体身上状态效果更新时触发，更新条件1、新增状态等级较高，更新状态等级及时间；2、新增状态等级不变，时间较长，更新状态持续时间 |
| RemoveEffectServerEvent | 服务端 | 触发时机：实体身上状态效果被移除时 |
| SpawnProjectileServerEvent | 服务端 | 触发时机：抛射物生成时触发 |
| StartRidingClientEvent | 客户端 | 触发时机：一个实体即将骑乘另外一个实体 |
| StartRidingServerEvent | 服务端 | 触发时机：一个实体即将骑乘另外一个实体 |
| WillAddEffectServerEvent | 服务端 | 触发时机：实体即将获得状态效果前 |
| WillTeleportToServerEvent | 服务端 | 实体即将传送或切换维度 |
# 玩家
| 事件 | 描述 | |
|---|---|---|
| AddExpEvent | 服务端 | 触发时机：当玩家增加经验时触发该事件。 |
| AddLevelEvent | 服务端 | 触发时机：当玩家升级时触发该事件。 |
| CameraMotionStartClientEvent | 客户端 | 相机运动器开始事件。相机添加运动器后，运动器开始运行时触发 |
| CameraMotionStopClientEvent | 客户端 | 相机运动器停止事件。相机添加运动器并开始运行后，运动器自动停止时触发 |
| ChangeLevelUpCostServerEvent | 服务端 | 触发时机：获取玩家下一个等级升级经验时，用于重载玩家的升级经验，每个等级在重置之前都只会触发一次 |
| DimensionChangeClientEvent | 客户端 | 玩家维度改变时客户端抛出 |
| DimensionChangeFinishClientEvent | 客户端 | 玩家维度改变完成后客户端抛出 |
| DimensionChangeFinishServerEvent | 服务端 | 玩家维度改变完成后服务端抛出 |
| DimensionChangeServerEvent | 服务端 | 玩家维度改变时服务端抛出 |
| ExtinguishFireClientEvent | 客户端 | 玩家扑灭火焰时触发。下雨，倒水等方式熄灭火焰不会触发。 |
| ExtinguishFireServerEvent | 服务端 | 玩家扑灭火焰时触发。下雨，倒水等方式熄灭火焰不会触发。 |
| GameTypeChangedClientEvent | 客户端 | 个人游戏模式发生变化时客户端触发。 |
| GameTypeChangedServerEvent | 服务端 | 个人游戏模式发生变化时服务端触发。 |
| OnPlayerHitBlockClientEvent | 客户端 | 触发时机：通过OpenPlayerHitBlockDetection打开方块碰撞检测后，当玩家碰撞到方块时触发该事件。玩家着地时会触发OnGroundClientEvent，而不是该事件。客户端和服务端分别作碰撞检测，可能两个事件返回的结果略有差异。 |
| OnPlayerHitBlockServerEvent | 服务端 | 触发时机：通过OpenPlayerHitBlockDetection打开方块碰撞检测后，当玩家碰撞到方块时触发该事件。监听玩家着地请使用客户端的OnGroundClientEvent。客户端和服务端分别作碰撞检测，可能两个事件返回的略有差异。 |
| PerspChangeClientEvent | 客户端 | 视角切换时会触发的事件 |
| PlayerAttackEntityEvent | 服务端 | 触发时机：当玩家攻击时触发该事件。 |
| PlayerCheatSpinAttackServerEvent | Apollo | 触发时机：玩家开始/结束快速旋转攻击并且不符合发送快速旋转攻击条件时触发（装备激流附魔的三叉戟、在水中或雨中，且未骑乘） |
| PlayerDieEvent | 服务端 | 触发时机：当玩家死亡时触发该事件。 |
| PlayerDoInteractServerEvent | 服务端 | 玩家与有minecraft:interact组件的生物交互时触发该事件，例如玩家手持空桶对牛挤奶、玩家手持打火石点燃苦力怕 |
| PlayerEatFoodServerEvent | 服务端 | 触发时机：玩家吃下食物时触发 |
| PlayerFeedEntityServerEvent | 服务端 | 玩家喂养生物时触发，例如玩家手持小麦喂养牛、玩家手持胡萝卜喂养幼年猪。 |
| PlayerHungerChangeServerEvent | 服务端 | 玩家饥饿度变化时触发该事件 |
| PlayerHurtEvent | 服务端 | 触发时机：当玩家受伤害前触发该事件。 |
| PlayerInteractServerEvent | 服务端 | 触发时机：玩家可以与实体交互时。如果是鼠标控制模式，则当准心对着实体时触发。如果是触屏模式，则触发时机与屏幕下方的交互按钮显示的时机相同。玩家真正与实体发生交互的事件见PlayerDoInteractServerEvent |
| PlayerNamedEntityServerEvent | 服务端 | 玩家用命名牌重命名实体时触发，例如玩家手持命名牌对羊修改名字、玩家手持命名牌对盔甲架修改名字。 |
| PlayerRespawnEvent | 服务端 | 触发时机：玩家复活时触发该事件。 |
| PlayerRespawnFinishServerEvent | 服务端 | 触发时机：玩家复活完毕时触发 |
| PlayerSleepServerEvent | 服务端 | 玩家使用床睡觉成功 |
| PlayerSpinAttackServerEvent | Apollo | 触发时机：玩家开始/结束快速旋转攻击时触发 |
| PlayerStopSleepServerEvent | 服务端 | 玩家停止睡觉 |
| PlayerTeleportEvent | 服务端 | 触发时机：当玩家传送时触发该事件，如：玩家使用末影珍珠或tp指令时。 |
| PlayerTrySleepServerEvent | 服务端 | 玩家尝试使用床睡觉 |
| ServerPlayerGetExperienceOrbEvent | 服务端 | 触发时机：玩家获取经验球时触发的事件 |
| StoreBuySuccServerEvent | 服务端 | 触发时机:玩家游戏内购买商品时服务端抛出的事件 |
# 方块
| 事件 | 描述 | |
|---|---|---|
| BlockDestroyByLiquidServerEvent | 服务端 | 触发时机：方块被水流破坏的事件 |
| BlockLiquidStateChangeAfterServerEvent | 服务端 | 触发时机：方块转为含水或者脱离含水(流体)后触发 |
| BlockLiquidStateChangeServerEvent | 服务端 | 触发时机：方块转为含水或者脱离含水(流体)前触发 |
| BlockNeighborChangedServerEvent | 服务端 | 触发时机：自定义方块周围的方块发生变化时，需要配置netease:neighborchanged_sendto_script，详情请查阅《自定义农作物》文档 |
| BlockRandomTickServerEvent | 服务端 | 触发时机：自定义方块配置netease:random_tick随机tick时 |
| BlockRemoveServerEvent | 服务端 | 触发时机：监听该事件的方块在销毁时触发，可以通过ListenOnBlockRemoveEvent方法进行监听，或者通过json组件netease:listen_block_remove进行配置 |
| BlockSnowStateChangeAfterServerEvent | 服务端 | 触发时机：方块转为含雪或者脱离含雪后触发 |
| BlockSnowStateChangeServerEvent | 服务端 | 触发时机：方块转为含雪或者脱离含雪前触发 |
| BlockStrengthChangedServerEvent | 服务端 | 触发时机：自定义机械元件方块红石信号量发生变化时触发 |
| ChestBlockTryPairWithServerEvent | 服务端 | 触发时机：两个并排的小箱子方块准备组合为一个大箱子方块时 |
| ClientBlockUseEvent | 客户端 | 触发时机：玩家右键点击新版自定义方块（或者通过接口AddBlockItemListenForUseEvent增加监听的MC原生游戏方块）时客户端抛出该事件（该事件tick执行，需要注意效率问题）。 |
| CommandBlockContainerOpenEvent | 服务端 | 触发时机：玩家点击命令方块，尝试打开命令方块的设置界面 |
| CommandBlockUpdateEvent | 服务端 | 触发时机：玩家尝试修改命令方块的内置命令时 |
| DestroyBlockEvent | 服务端 | 触发时机：当方块已经被玩家破坏时触发该事件。 |
| DirtBlockToGrassBlockServerEvent | 服务端 | 触发时机：泥土方块变成草方块时触发 |
| EntityPlaceBlockAfterServerEvent | 服务端 | 触发时机：当生物成功放置方块后触发 |
| FallingBlockBreakServerEvent | 服务端 | 触发时机：当下落的方块实体被破坏时，服务端触发该事件 |
| FallingBlockCauseDamageBeforeClientEvent | 客户端 | 触发时机：当下落的方块开始计算砸到实体的伤害时，客户端触发该事件 |
| FallingBlockCauseDamageBeforeServerEvent | 服务端 | 触发时机：当下落的方块开始计算砸到实体的伤害时，服务端触发该事件 |
| FallingBlockReturnHeavyBlockServerEvent | 服务端 | 触发时机：当下落的方块实体变回普通重力方块时，服务端触发该事件 |
| FarmBlockToDirtBlockServerEvent | 服务端 | 触发时机：耕地退化为泥土时触发 |
| GrassBlockToDirtBlockServerEvent | 服务端 | 触发时机：草方块变成泥土方块时触发 |
| HeavyBlockStartFallingServerEvent | 服务端 | 触发时机：当重力方块变为下落的方块实体后，服务端触发该事件 |
| HopperTryPullInServerEvent | 服务端 | 触发时机：当漏斗上方连接容器后，容器往漏斗开始输入物品时触发，事件仅触发一次 |
| HopperTryPullOutServerEvent | 服务端 | 触发时机：当漏斗以毗邻的方式连接容器时，即从旁边连接容器时，漏斗向容器开始输出物品时触发，事件仅触发一次 |
| ModBlockEntityLoadedClientEvent | 客户端 | 客户端自定义方块实体初始化完成时触发 |
| ModBlockEntityRemoveClientEvent | 客户端 | 客户端自定义方块实体卸载时触发 |
| ModBlockEntityTickClientEvent | 客户端 | 客户端自定义方块实体tick事件 |
| OnAfterFallOnBlockClientEvent | 客户端 | 触发时机：当实体降落到方块后客户端触发，主要用于力的计算 |
| OnAfterFallOnBlockServerEvent | 服务端 | 触发时机：当实体降落到方块后服务端触发，主要用于力的计算 |
| OnBeforeFallOnBlockServerEvent | 服务端 | 触发时机：当实体刚降落到方块上时服务端触发，主要用于伤害计算 |
| OnEntityInsideBlockClientEvent | 客户端 | 触发时机：当实体碰撞盒所在区域有方块时，客户端持续触发 |
| OnEntityInsideBlockServerEvent | 服务端 | 触发时机：当实体碰撞盒所在区域有方块时，服务端持续触发 |
| OnModBlockNeteaseEffectCreatedClientEvent | 客户端 | 自定义方块实体绑定的特效创建成功事件，在自定义方块实体中绑定的特效创建成功时触发以及使用接口CreateFrameEffectForBlockEntity或CreateParticleEffectForBlockEntity为自定义方块实体添加特效成功时触发。 |
| OnStandOnBlockClientEvent | 客户端 | 触发时机：当实体站立到方块上时客户端持续触发 |
| OnStandOnBlockServerEvent | 服务端 | 触发时机：当实体站立到方块上时服务端持续触发 |
| PistonActionServerEvent | 服务端 | 触发时机：活塞或者粘性活塞推送/缩回影响附近方块时 |
| PlayerTryDestroyBlockClientEvent | 客户端 | 当玩家即将破坏方块时，客户端线程触发该事件。主要用于床，旗帜，箱子这些根据方块实体数据进行渲染的方块，一般情况下请使用ServerPlayerTryDestroyBlockEvent |
| ServerBlockEntityTickEvent | 服务端 | 触发时机：自定义方块配置了netease:block_entity组件并设tick为true，方块在玩家的模拟距离（新建存档时可以设置，默认为4个区块）内，或者在tickingarea内的时候触发 |
| ServerBlockUseEvent | 服务端 | 触发时机：玩家右键点击新版自定义方块（或者通过接口AddBlockItemListenForUseEvent增加监听的MC原生游戏方块）时服务端抛出该事件（该事件tick执行，需要注意效率问题）。 |
| ServerEntityTryPlaceBlockEvent | 服务端 | 触发时机：当生物试图放置方块时触发该事件。 |
| ServerPlaceBlockEntityEvent | 服务端 | 触发时机：手动放置或通过接口创建含自定义方块实体的方块时触发，此时可向该方块实体中存放数据 |
| ServerPlayerTryDestroyBlockEvent | 服务端 | 当玩家即将破坏方块时，服务端线程触发该事件。 |
| ShearsDestoryBlockBeforeClientEvent | 客户端 | 触发时机：玩家手持剪刀破坏方块时，有剪刀特殊效果的方块会在客户端线程触发该事件 |
| ShearsDestoryBlockBeforeServerEvent | 服务端 | 触发时机：玩家手持剪刀破坏方块时，有剪刀特殊效果的方块会在服务端线程触发该事件 |
| StartDestroyBlockClientEvent | 客户端 | 玩家开始挖方块时触发。创造模式下不触发。 |
| StartDestroyBlockServerEvent | 服务端 | 玩家开始挖方块时触发。创造模式下不触发。 |
| StepOffBlockClientEvent | 客户端 | 触发时机：实体移动离开一个实心方块时触发 |
| StepOffBlockServerEvent | 服务端 | 触发时机：实体移动离开一个实心方块时触发 |
| StepOnBlockClientEvent | 客户端 | 触发时机：实体刚移动至一个新实心方块时触发。 |
| StepOnBlockServerEvent | 服务端 | 触发时机：实体刚移动至一个新实心方块时触发。 |
# 物品
| 事件 | 描述 | |
|---|---|---|
| ActorAcquiredItemClientEvent | 客户端 | 触发时机：玩家获得物品时客户端抛出的事件（有些获取物品方式只会触发客户端事件，有些获取物品方式只会触发服务端事件，在使用时注意一点。） |
| ActorAcquiredItemServerEvent | 服务端 | 触发时机：玩家获得物品时服务端抛出的事件（有些获取物品方式只会触发客户端事件，有些获取物品方式只会触发服务端事件，在使用时注意一点。） |
| ActorUseItemClientEvent | 客户端 | 触发时机：玩家使用物品时客户端抛出的事件（比较特殊不走该事件的例子：1）染料对有水的炼药锅使用；2）盔甲架装备盔甲）;3)喝牛奶 |
| ActorUseItemServerEvent | 服务端 | 触发时机：玩家使用物品生效之前服务端抛出的事件（比较特殊不走该事件的例子：1）染料对有水的炼药锅使用；2）盔甲架装备盔甲） |
| AnvilCreateResultItemAfterClientEvent | 客户端 | 玩家点击铁砧合成得到的物品时抛出的事件。 |
| ClientItemTryUseEvent | 客户端 | 玩家点击右键尝试使用物品时客户端抛出的事件，可以通过设置cancel为True取消使用物品。注：如果需要取消物品的使用需要同时在ClientItemTryUseEvent和ServerItemTryUseEvent中将cancel设置为True才能正确取消。 |
| ClientItemUseOnEvent | 客户端 | 玩家在对方块使用物品时客户端抛出的事件。注：如果需要取消物品的使用需要同时在ClientItemUseOnEvent和ServerItemUseOnEvent中将ret设置为True才能正确取消。 |
| ClientShapedRecipeTriggeredEvent | 客户端 | 玩家合成物品时触发 |
| ContainerItemChangedServerEvent | 服务端 | 容器物品变化事件 |
| CraftItemOutputChangeServerEvent | 服务端 | 玩家从容器拿出生成物品时触发 |
| FurnaceBurnFinishedServerEvent | 服务端 | 服务端熔炉烧制触发事件。熔炉, 高炉，烟熏炉烧出物品时触发 |
| GrindStoneRemovedEnchantClientEvent | 客户端 | 玩家点击砂轮合成得到的物品时抛出的事件 |
| InventoryItemChangedClientEvent | 客户端 | 玩家背包物品变化时客户端抛出的事件。 |
| InventoryItemChangedServerEvent | 服务端 | 玩家背包物品变化时服务端抛出的事件。 |
| ItemDurabilityChangedServerEvent | 服务端 | 物品耐久度变化事件 |
| ItemReleaseUsingClientEvent | 客户端 | 触发时机：释放正在使用的物品 |
| ItemReleaseUsingServerEvent | 服务端 | 触发时机：释放正在使用的物品时 |
| ItemUseAfterServerEvent | 服务端 | 玩家在使用物品之后服务端抛出的事件。 |
| ItemUseOnAfterServerEvent | 服务端 | 玩家在对方块使用物品之后服务端抛出的事件。 |
| OnCarriedNewItemChangedClientEvent | 客户端 | 手持物品发生变化时，触发该事件；数量改变不会通知 |
| OnCarriedNewItemChangedServerEvent | 服务端 | 触发时机：玩家切换主手物品时触发该事件 |
| OnItemPutInEnchantingModelServerEvent | 服务端 | 触发时机：玩家将可附魔物品放到附魔台上时 |
| OnNewArmorExchangeServerEvent | 服务端 | 触发时机：玩家切换盔甲时触发该事件 |
| OnOffhandItemChangedServerEvent | 服务端 | 触发时机：玩家切换副手物品时触发该事件 |
| OnPlayerActiveShieldServerEvent | 服务端 | 触发时机：玩家激活/取消激活盾牌触发的事件。包括玩家持盾进入潜行状态，以及在潜行状态切换盾牌（切换耐久度不同的相同盾牌不会触发） |
| OnPlayerBlockedByShieldAfterServerEvent | 服务端 | 触发时机：玩家使用盾牌抵挡伤害之后触发 |
| OnPlayerBlockedByShieldBeforeServerEvent | 服务端 | 触发时机：玩家使用盾牌抵挡伤害之前触发 |
| PlayerDropItemServerEvent | 服务端 | 触发时机：玩家丢弃物品时触发 |
| PlayerTryDropItemClientEvent | 客户端 | 触发时机：玩家丢弃物品时触发 |
| ServerItemTryUseEvent | 服务端 | 玩家点击右键尝试使用物品时服务端抛出的事件。注：如果需要取消物品的使用需要同时在ClientItemTryUseEvent和ServerItemTryUseEvent中将cancel设置为True才能正确取消。 |
| ServerItemUseOnEvent | 服务端 | 玩家在对方块使用物品之前服务端抛出的事件。注：如果需要取消物品的使用需要同时在ClientItemUseOnEvent和ServerItemUseOnEvent中将ret设置为True才能正确取消。 |
| ServerPlayerTryTouchEvent | 服务端 | 玩家即将捡起物品时触发 |
| ShearsUseToBlockBeforeServerEvent | 服务端 | 触发时机：实体手持剪刀对方块使用时，有剪刀特殊效果的方块会在服务端线程触发该事件 |
| StartUsingItemClientEvent | 客户端 | 玩家使用物品（目前仅支持Bucket（奶桶）、Trident（三叉戟）、RangedWeapon（弓）、Food（食物）、Potion（药水）、Crossbow（弩））时抛出 |
| StopUsingItemClientEvent | 客户端 | 玩家停止使用物品（目前仅支持Bucket（奶桶）、Trident（三叉戟）、RangedWeapon（弓）、Food（食物）、Potion（药水）、Crossbow（弩））时抛出 |
| UIContainerItemChangedServerEvent | 服务端 | 合成容器物品发生变化时触发 |
# 模型
| 事件 | 描述 | |
|---|---|---|
| AttackAnimBeginClientEvent | 客户端 | 攻击动作开始时触发 |
| AttackAnimBeginServerEvent | 服务端 | 当攻击动作开始时触发 |
| AttackAnimEndClientEvent | 客户端 | 攻击动作结束时触发 |
| AttackAnimEndServerEvent | 服务端 | 当攻击动作结束时触发 |
| JumpAnimBeginServerEvent | 服务端 | 当跳跃动作开始时触发 |
| WalkAnimBeginClientEvent | 客户端 | 走路动作开始时触发 |
| WalkAnimBeginServerEvent | 服务端 | 当走路动作开始时触发 |
| WalkAnimEndClientEvent | 客户端 | 走路动作结束时触发 |
| WalkAnimEndServerEvent | 服务端 | 当走路动作结束时触发 |
# UI
| 事件 | 描述 | |
|---|---|---|
| AchievementButtonMovedClientEvent | 客户端 | 触发时机：使用自定义成就系统的时，拖动成就入口结束时触发 |
| ClientChestCloseEvent | 客户端 | 关闭箱子界面时触发，包括小箱子，合并后大箱子和末影龙箱子 |
| ClientChestOpenEvent | 客户端 | 打开箱子界面时触发，包括小箱子，合并后大箱子和末影龙箱子 |
| ClientPlayerInventoryCloseEvent | 客户端 | 关闭物品背包界面时触发 |
| ClientPlayerInventoryOpenEvent | 客户端 | 打开物品背包界面时触发 |
| CloseNeteaseShopEvent | 客户端 | 关闭商城界面时触发，包括脚本商城和Apollo插件商城 |
| GridComponentSizeChangedClientEvent | 客户端 | 触发时机：UI grid组件里格子数目发生变化时触发 |
| OnItemSlotButtonClickedEvent | 客户端 | 点击快捷栏、背包栏、盔甲栏、副手栏的物品槽时触发 |
| PlayerChatButtonClickClientEvent | 客户端 | 玩家点击聊天按钮或回车键触发呼出聊天窗口时客户端抛出的事件 |
| PlayerInventoryOpenScriptServerEvent | 服务端 | 某个客户端打开物品背包界面时触发 |
| PopScreenAfterClientEvent | 客户端 | screen移除触发 |
| PopScreenEvent | 客户端 | screen移除触发 |
| PushScreenEvent | 客户端 | screen创建触发 |
| ScreenSizeChangedClientEvent | 客户端 | 改变屏幕大小时会触发的事件 |
| UiInitFinished | 客户端 | UI初始化框架完成,此时可以创建UI |
| UrgeShipEvent | 服务端 | 玩家点击商城催促发货按钮时触发该事件 |
# 音效
| 事件 | 描述 | |
|---|---|---|
| OnMusicStopClientEvent | 客户端 | 音乐停止时，当玩家调用StopCustomMusic来停止自定义背景音乐时，会触发该事件 |
| PlayMusicClientEvent | 客户端 | 播放背景音乐时触发 |
| PlaySoundClientEvent | 客户端 | 播放场景音效或UI音效时触发 |
# 控制
| 事件 | 描述 | |
|---|---|---|
| ClientJumpButtonPressDownEvent | 客户端 | 跳跃按钮按下事件，返回值设置参数只对当次按下事件起作用 |
| ClientJumpButtonReleaseEvent | 客户端 | 跳跃按钮按下释放事件 |
| GetEntityByCoordEvent | 客户端 | 玩家点击屏幕时触发，多个手指点在屏幕上时，只有第一个会触发。 |
| GetEntityByCoordReleaseClientEvent | 客户端 | 玩家点击屏幕后松开时触发，多个手指点在屏幕上时，只有最后一个手指松开时触发。 |
| GyroSensorChangedClientEvent | 客户端 | 触发时机：陀螺仪传感器姿态发生变化时 |
| HoldBeforeClientEvent | 客户端 | 玩家长按屏幕，即将响应到游戏内时触发。仅在移动端或pc的F11模式下触发。pc的非F11模式可以使用RightClickBeforeClientEvent事件监听鼠标右键 |
| LeftClickBeforeClientEvent | 客户端 | 玩家按下鼠标左键时触发。仅在pc的普通控制模式（即非F11模式）下触发。 |
| LeftClickReleaseClientEvent | 客户端 | 玩家松开鼠标左键时触发。仅在pc的普通控制模式（即非F11模式）下触发。 |
| MouseWheelClientEvent | 客户端 | 鼠标滚轮滚动时触发 |
| OnBackButtonReleaseClientEvent | 客户端 | 返回按钮（目前特指安卓系统导航中的返回按钮）松开时触发 |
| OnClientPlayerStartMove | 客户端 | 移动按钮按下触发事件，在按住一个方向键的同时，去按另外一个方向键，不会触发第二次 |
| OnClientPlayerStopMove | 客户端 | 移动按钮按下释放时触发事件，同时按下多个方向键，需要释放所有的方向键才会触发事件 |
| OnGamepadControllerLayoutChangeClientEvent | 客户端 | 游戏手柄按键映射改变事件 |
| OnGamepadKeyPressClientEvent | 客户端 | 游戏手柄按键事件 |
| OnGamepadStickClientEvent | 客户端 | 游戏手柄摇杆事件 |
| OnGamepadTriggerClientEvent | 客户端 | 游戏手柄扳机事件 |
| OnKeyPressInGame | 客户端 | 按键按下或按键释放时触发 |
| OnKeyboardControllerLayoutChangeClientEvent | 客户端 | 键盘按键映射改变事件 |
| OnMouseMiddleDownClientEvent | 客户端 | 鼠标按下中键时触发 |
| RightClickBeforeClientEvent | 客户端 | 玩家按下鼠标右键时触发。仅在pc下触发（普通控制模式及F11模式都会触发）。 |
| RightClickReleaseClientEvent | 客户端 | 玩家松开鼠标右键时触发。仅在pc的普通控制模式（即非F11模式）下触发。在F11下右键，按下会触发RightClickBeforeClientEvent，松开时会触发TapOrHoldReleaseClientEvent |
| TapBeforeClientEvent | 客户端 | 玩家点击屏幕并松手，即将响应到游戏内时触发。仅在移动端或pc的F11模式下触发。pc的非F11模式可以使用LeftClickBeforeClientEvent事件监听鼠标左键 |
| TapOrHoldReleaseClientEvent | 客户端 | 玩家点击屏幕后松手时触发。仅在移动端或pc的F11模式下触发。pc的非F11模式可以使用LeftClickReleaseClientEvent与RightClickReleaseClientEvent事件监听鼠标松开 |
# 联机大厅
| 事件 | 描述 | |
|---|---|---|
| lobbyGoodBuySucServerEvent | 服务端 | 玩家登录联机大厅服务器，或者联机大厅游戏内购买商品时触发。如果是玩家登录，触发时玩家客户端已经触发了UiInitFinished事件 |