# 事件索引表


# 世界

事件
描述
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离开游戏”的玩家离开提示文字时服务端抛出的事件。
PrimaryClientSyncSkinClientEvent 客户端 主客户端自己更换了皮肤触发
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 服务端 玩家从容器拿出生成物品时触发
CraftUpdateResultItemClientEvent 客户端 玩家工作台界面更新显示可合成物品时抛出的事件。
FurnaceBurnFinishedServerEvent 服务端 服务端熔炉烧制触发事件。熔炉, 高炉,烟熏炉烧出物品时触发
GrindStoneRemovedEnchantClientEvent 客户端 玩家点击砂轮合成得到的物品时抛出的事件
InventoryItemChangedClientEvent 客户端 玩家背包物品变化时客户端抛出的事件。
InventoryItemChangedServerEvent 服务端 玩家背包物品变化时服务端抛出的事件。
ItemDurabilityChangedServerEvent 服务端 物品耐久度变化事件
ItemReleaseUsingClientEvent 客户端 触发时机:释放正在使用的物品
ItemReleaseUsingServerEvent 服务端 触发时机:释放正在使用的物品时
ItemUseAfterServerEvent 服务端 玩家在使用物品之后服务端抛出的事件。
ItemUseOnAfterServerEvent 服务端 玩家在对方块使用物品之后服务端抛出的事件。
OnCarriedNewItemChangedClientEvent 客户端 手持物品发生变化时,触发该事件;数量改变不会通知
OnCarriedNewItemChangedServerEvent 服务端 触发时机:玩家切换主手物品时触发该事件
OnItemPutInEnchantingModelServerEvent 服务端 触发时机:玩家将可附魔物品放到附魔台上时
OnNewArmorExchangeServerEvent 服务端 触发时机:玩家切换盔甲时触发该事件
OnOffhandItemChangedServerEvent 服务端 触发时机:玩家切换副手物品时触发该事件
OnPlayerActiveShieldServerEvent 服务端 触发时机:玩家激活/取消激活盾牌触发的事件。包括玩家持盾进入潜行状态,以及在潜行状态切换盾牌(切换耐久度不同的相同盾牌不会触发)
OnPlayerBlockedByShieldAfterServerEvent 服务端 触发时机:玩家使用盾牌抵挡伤害之后触发
OnPlayerBlockedByShieldBeforeServerEvent 服务端 触发时机:玩家使用盾牌抵挡伤害之前触发
PlayerDropItemServerEvent 服务端 触发时机:玩家丢弃物品时触发
PlayerPickupArrowServerEvent 服务端 玩家即将捡起箭矢时触发
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事件