# 事件索引表
# 世界
事件 | 描述 | |
---|---|---|
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 | 服务端 | 当默认游戏模式或个人游戏模式发生变化时服务端触发,如果个人游戏模式不为默认时,修改默认游戏模式也会同时修改个人游戏模式,此时会触发两次该事件 |
OnLocalPlayerActionClientEvent | 客户端 | 玩家动作事件,当本地玩家开始/停止某些动作时触发该事件 |
OnLocalPlayerStartJumpClientEvent | 客户端 | 本地玩家开始跳跃时触发 |
OnPlayerActionServerEvent | 服务端 | 玩家动作事件,当玩家开始/停止某些动作时触发该事件 |
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 | 服务端 | 玩家即将捡起抛射物时触发,包括使用"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组件里格子数目发生变化时触发 |
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事件 |