Skip to content

事件索引表


世界

事件
描述
AchievementCompleteEvent服务端玩家完成自定义成就时触发该事件
AddEntityClientEvent客户端客户端侧创建新实体时触发
AddEntityServerEvent服务端服务端侧创建新实体,或实体从存档加载时触发
AddPlayerAOIClientEvent客户端玩家加入游戏或者其余玩家进入当前玩家视野时触发的事件,替换AddPlayerEvent
AddPlayerCreatedClientEvent客户端玩家进入当前玩家所在的区块AOI后,玩家皮肤数据异步加载完成后触发的事件
AddServerPlayerEvent服务端触发时机:玩家加入时触发该事件。
ChunkAcquireDiscardedClientEvent客户端触发时机:客户端区块即将被卸载时
ChunkAcquireDiscardedServerEvent服务端服务端区块即将被卸载时触发
ChunkGeneratedServerEvent服务端触发时机:区块创建完成时触发
ChunkLoadedClientEvent客户端触发时机:客户端区块加载完成时
ChunkLoadedServerEvent服务端触发时机:服务端区块加载完成时
ClientLoadAddonsFinishServerEvent服务端触发时机:客户端mod加载完成时,服务端触发此事件。服务器可以使用此事件,往客户端发送数据给其初始化。
CommandEvent服务端玩家请求执行指令时触发
CustomCommandTriggerServerEvent服务端自定义命令触发事件
DelServerPlayerEvent服务端触发时机:删除玩家时触发该事件。
EntityRemoveEvent服务端实体被删除时触发
ExplosionServerEvent服务端当发生爆炸时触发。
GameRenderTickEvent客户端客户端渲染帧开始时触发该事件,一秒触发次数为当前的帧数
GlobalCommandServerEvent服务端服务端全局命令事件,包括聊天栏发送、SetCommand接口、命令方块(矿车)、行为包动画执行命令
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服务端当默认游戏模式或个人游戏模式发生变化时服务端触发,如果个人游戏模式不为默认时,修改默认游戏模式也会同时修改个人游戏模式,此时会触发两次该事件
MountTamingEvent服务端玩家通过骑乘驯服生物后触发该事件
OnLocalPlayerActionClientEvent客户端玩家动作事件,当本地玩家开始/停止某些动作时触发该事件
OnLocalPlayerStartJumpClientEvent客户端本地玩家开始跳跃时触发
OnPlayerActionServerEvent服务端玩家动作事件,当玩家开始/停止某些动作时触发该事件
OnPlayerHitBlockClientEvent客户端触发时机:通过OpenPlayerHitBlockDetection打开方块碰撞检测后,当玩家碰撞到方块时触发该事件。玩家着地时会触发OnGroundClientEvent,而不是该事件。客户端和服务端分别作碰撞检测,可能两个事件返回的结果略有差异。
OnPlayerHitBlockServerEvent服务端触发时机:通过OpenPlayerHitBlockDetection打开方块碰撞检测后,当玩家碰撞到方块时触发该事件。监听玩家着地请使用客户端的OnGroundClientEvent。客户端和服务端分别作碰撞检测,可能两个事件返回的略有差异。
PerspChangeClientEvent客户端视角切换时会触发的事件
PlayerAttackEntityEvent服务端触发时机:当玩家攻击时触发该事件。
PlayerAttackEntityEvent客户端触发时机:当本地玩家攻击时触发该事件。
PlayerCheatSpinAttackServerEventApollo触发时机:玩家开始/结束快速旋转攻击并且不符合发送快速旋转攻击条件时触发(装备激流附魔的三叉戟、在水中或雨中,且未骑乘)
PlayerDieEvent服务端触发时机:当玩家死亡时触发该事件。
PlayerDoInteractServerEvent服务端玩家与有minecraft:interact组件的生物交互时触发该事件,例如玩家手持空桶对牛挤奶、玩家手持打火石点燃苦力怕
PlayerEatFoodServerEvent服务端触发时机:玩家吃下食物时触发
PlayerFeedEntityServerEvent服务端玩家喂养生物时触发,例如玩家手持小麦喂养牛、玩家手持胡萝卜喂养幼年猪。
PlayerHungerChangeServerEvent服务端玩家饥饿度变化时触发该事件
PlayerHurtEvent服务端触发时机:当玩家受伤害前触发该事件。
PlayerInteractServerEvent服务端触发时机:玩家可以与实体交互时。如果是鼠标控制模式,则当准心对着实体时触发。如果是触屏模式,则触发时机与屏幕下方的交互按钮显示的时机相同。玩家真正与实体发生交互的事件见PlayerDoInteractServerEvent
PlayerNamedEntityServerEvent服务端玩家用命名牌重命名实体时触发,例如玩家手持命名牌对羊修改名字、玩家手持命名牌对盔甲架修改名字。
PlayerRespawnEvent服务端触发时机:玩家复活时触发该事件。
PlayerRespawnFinishServerEvent服务端触发时机:玩家复活完毕时触发
PlayerSleepServerEvent服务端玩家使用床睡觉成功
PlayerSpinAttackServerEventApollo触发时机:玩家开始/结束快速旋转攻击时触发
PlayerStopSleepServerEvent服务端玩家停止睡觉
PlayerTeleportEvent服务端触发时机:当玩家传送时触发该事件,如:玩家使用末影珍珠或tp指令时。
PlayerTrySleepServerEvent服务端玩家尝试使用床睡觉
ServerPlayerGetExperienceOrbEvent服务端触发时机:玩家获取经验球时触发的事件
StoreBuySuccServerEvent服务端触发时机:玩家游戏内购买商品时服务端抛出的事件

方块

事件
描述
BlockAnimateRandomTickEvent客户端触发时机:以摄像机为中心,随机选取周围的方块触发Tick,触发的数量取决于设备性能。只有添加了netease:block_animate_random_tick的自定义方块才会触发此事件
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服务端玩家即将捡起抛射物时触发,包括使用"netease:pick_up"的自定义抛射物
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组件里格子数目发生变化时触发
HudButtonChangedClientEvent客户端当原生HUD按钮位置或大小发生改变时触发,例如玩家使用了自定义控件功能会触发,可在该事件中修改mod按钮的位置防止重叠
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客户端玩家按下使用物品/放置方块键时触发,例如鼠标右键、新触控交互键、手柄左扳机键
RightClickReleaseClientEvent客户端玩家松开使用物品/放置方块键时触发,例如鼠标右键、新触控交互键、手柄左扳机键
TapBeforeClientEvent客户端玩家点击屏幕并松手,即将响应到游戏内时触发。仅在移动端或pc的F11模式下触发。pc的非F11模式可以监听LeftClickBeforeClientEvent事件
TapOrHoldReleaseClientEvent客户端玩家点击屏幕后松手时触发。仅在移动端或pc的F11模式下触发。pc的非F11模式可以使用LeftClickReleaseClientEventRightClickReleaseClientEvent事件监听鼠标松开

联机大厅

事件
描述
lobbyGoodBuySucServerEvent服务端玩家登录联机大厅服务器,或者联机大厅游戏内购买商品时触发。如果是玩家登录,触发时玩家客户端已经触发了UiInitFinished事件