Skip to content

API索引表


通用

世界

实体

玩家

方块

物品

特效

模型

原生UI

自定义UI

音效

控制

游戏设置

虚拟世界

后处理

联机大厅

成就

商城

Component

接口
描述
CreateComponent服务端给实体创建服务端组件
CreateComponent客户端给实体创建客户端组件
DestroyComponent服务端删除实体的服务端组件
DestroyComponent客户端删除实体的客户端组件
GetComponent服务端获取实体的服务端组件。一般用来判断某个组件是否创建过,其他情况请使用CreateComponent
GetComponent客户端获取实体的客户端组件。一般用来判断某个组件是否创建过,其他情况请使用CreateComponent
GetComponentCls服务端用于获取服务器component基类。实现新的component时,需要继承该接口返回的类
GetComponentCls客户端用于获取客户端component基类。实现新的component时,需要继承该接口返回的类
GetEngineCompFactory服务端获取引擎组件的工厂,通过工厂可以创建服务端的引擎组件
GetEngineCompFactory客户端获取引擎组件的工厂,通过工厂可以创建客户端的引擎组件
RegisterComponent服务端用于将组件注册到引擎中
RegisterComponent客户端用于将组件注册到引擎中

System

接口
描述
GetClientSystemCls客户端用于获取客户端system基类。实现新的system时,需要继承该接口返回的类
GetServerSystemCls服务端用于获取服务器system基类。实现新的system时,需要继承该接口返回的类
GetSystem服务端获取已注册的系统
GetSystem客户端用于获取其他系统实例
RegisterSystem服务端用于将系统注册到引擎中,引擎会创建一个该系统的实例,并在退出游戏时回收。系统可以执行我们引擎赋予的基本逻辑,例如监听事件、执行Tick函数、与客户端进行通讯等。
RegisterSystem客户端用于将系统注册到引擎中,引擎会创建一个该系统的实例,并在退出游戏时回收。系统可以执行我们引擎赋予的基本逻辑,例如监听事件、执行Tick函数、与服务端进行通讯等。

事件

接口
描述
BroadcastEvent服务端
客户端
本地广播事件,客户端system广播的事件仅客户端system能监听,服务器system广播的事件仅服务端system能监听。
BroadcastToAllClient服务端服务器广播事件到所有客户端
CreateEventData服务端
客户端
创建自定义事件的数据,eventData用于发送事件。创建的eventData可以理解为一个dict,可以嵌套赋值dict,list和基本数据类型,但不支持tuple
GetEngineNamespace服务端获取引擎事件的命名空间。监听引擎事件时,namespace传该接口返回的namespace
GetEngineNamespace客户端获取引擎事件的命名空间。监听引擎事件时,namespace传该接口返回的namespace
GetEngineSystemName服务端获取引擎系统名。监听引擎事件时,systemName传该接口返回的systemName
GetEngineSystemName客户端获取引擎系统名。监听引擎事件时,systemName传该接口返回的systemName
ListenForEvent服务端
客户端
注册监听某个系统抛出的事件。若监听引擎事件时,namespace和systemName分别为GetEngineNamespace()和GetEngineSystemName()。具体每个事件的详细事件data可以参考"事件"分类下的内容
NotifyToClient服务端服务器发送事件到指定客户端
NotifyToMultiClients服务端服务器发送事件到指定一批客户端,相比于在for循环内使用NotifyToClient性能更好
NotifyToServer客户端客户端发送事件到服务器
UnListenAllEvents服务端
客户端
反注册监听某个系统抛出的所有事件,即不再监听。
UnListenForEvent服务端
客户端
反注册监听某个系统抛出的事件,即不再监听。若是引擎事件,则namespace和systemName分别为GetEngineNamespaceGetEngineSystemName。与ListenForEvent对应。

本地设备

接口
描述
GetEngineVersion客户端获取游戏版本-客户端。
GetIP客户端获取本地玩家的ip地址
GetMinecraftVersion服务端获取Minecraft版本-服务端。
GetMinecraftVersion客户端获取Minecraft版本-客户端。
GetPlatform服务端获取脚本运行的平台
GetPlatform客户端获取脚本运行的平台
IsInApollo服务端返回当前游戏Mod是否运行在Apollo网络服
IsInServer服务端获取当前游戏是否跑在服务器环境下

本地存储

接口
描述
GetConfigData客户端获取本地配置文件中存储的数据
SetConfigData客户端以本地配置文件的方式存储数据

数学

接口
描述
GetDirFromRot服务端通过旋转角度获取朝向
GetDirFromRot客户端通过旋转角度获取朝向
GetLocalPosFromWorld服务端获取基于实体的世界坐标对应的局部坐标
GetLocalPosFromWorld客户端获取基于实体的世界坐标对应的局部坐标
GetRotFromDir服务端通过朝向获取旋转角度
GetRotFromDir客户端通过朝向获取旋转角度
GetWorldPosFromLocal服务端获取基于实体的局部坐标对应的世界坐标
GetWorldPosFromLocal客户端获取基于实体的局部坐标对应的世界坐标

工具

接口
描述
AddRepeatedTimer服务端添加服务端触发的定时器,重复执行
AddRepeatedTimer客户端添加客户端触发的定时器,重复执行
AddTimer服务端添加服务端触发的定时器,非重复
AddTimer客户端添加客户端触发的定时器,非重复
CancelTimer服务端取消定时器
CancelTimer客户端取消定时器
CheckNameValid服务端检查昵称是否合法,即不包含敏感词
CheckNameValid客户端检查昵称是否合法,即不包含敏感词
CheckWordsValid服务端检查语句是否合法,即不包含敏感词
CheckWordsValid客户端检查语句是否合法,即不包含敏感词
GetChinese服务端获取langStr对应的中文,可参考PC开发包中\handheld\localization\handheld\data\resource_packs\vanilla\texts\zh_CN.lang
GetChinese客户端获取langStr对应的中文,可参考PC开发包中\handheld\localization\handheld\data\resource_packs\vanilla\texts\zh_CN.lang
GetClipboardContent客户端获取系统剪贴板内容
GetFps客户端获取fps
GetMinecraftEnum服务端用于获取枚举值文档中的枚举值
GetMinecraftEnum客户端用于获取枚举值文档中的枚举值
GetModConfigJson客户端以字典形式返回指定路径的json格式配置文件的内容,文件必须放置在资源包的/modconfigs目录下
GetServerTickTime服务端获取服务端引擎上一帧的帧消耗时间
ImportModule服务端使用字符串路径导入模块,作用与importlib.import_module类似,但只能导入当前加载的mod中的模块
ImportModule客户端使用字符串路径导入模块,作用与importlib.import_module类似,但只能导入当前加载的mod中的模块
SetClipboardContent客户端设置系统剪贴板内容
StartCoroutine服务端开启服务端协程,实现函数分段式执行,可用于缓解复杂逻辑计算导致游戏卡顿问题
StartCoroutine客户端开启客户端协程,实现函数分段式执行,可用于缓解复杂逻辑计算导致游戏卡顿问题
StopCoroutine服务端停止协程
StopCoroutine客户端停止客户端协程

调试

接口
描述
GetEnableReconnectNetgame客户端获取是否允许断线重连
GetKeepResourceWhenTransfer客户端获取快速切服设置
GetMcpModLogCanPostDump服务端获取是否可以打印错误信息到McpModLog日志。
GetMcpModLogCanPostDump客户端获取是否可以打印错误信息到McpModLog日志。
GetResourceFastload客户端获取资源快速加载设置
PostMcpModDump服务端主动打印信息到McpModLog日志,需要先调用 SetMcpModLogCanPostDump 接口进行设置,才能生效。
PostMcpModDump客户端主动打印信息到McpModLog日志,需要先调用 SetMcpModLogCanPostDump 接口进行设置,才能生效。
ReloadAllMaterials客户端重新加载所有材质文件
ReloadAllShaders客户端重新加载所有Shader文件
ReloadOneShader客户端重新加载某个Shader文件
SetEnableReconnectNetgame客户端设置是否允许断线重连
SetKeepResourceWhenTransfer客户端设置快速切服
SetMcpModLogCanPostDump服务端设置是否可以打印错误信息到McpModLog日志。
SetMcpModLogCanPostDump客户端设置是否可以打印错误信息到McpModLog日志。
SetResourceFastload客户端设置资源快速加载
StartMemProfile服务端开始启动服务端脚本内存分析,启动后调用StopMemProfile即可在路径fileName生成函数内存火焰图,此接口只支持PC端。生成的火焰图可以用浏览器打开,推荐chrome浏览器。
StartMemProfile客户端开始启动客户端脚本内存分析,启动后调用StopMemProfile即可在路径fileName生成函数内存火焰图,此接口只支持PC端。生成的火焰图可以用浏览器打开,推荐chrome浏览器。
StartMultiProfile服务端开始启动服务端与客户端双端脚本性能分析,启动后调用StopMultiProfile即可在路径fileName生成函数性能火焰图。双端采集时数据误差较大,建议优先使用StartProfile单端版本,此接口只支持PC端
StartMultiProfile客户端开始启动服务端与客户端双端脚本性能分析,启动后调用StopMultiProfile即可在路径fileName生成函数性能火焰图。双端采集时数据误差较大,建议优先使用StartProfile单端版本,此接口只支持PC端
StartProfile服务端开始启动服务端脚本性能分析,启动后调用StopProfile即可在路径fileName生成函数性能火焰图,此接口只支持PC端。生成的火焰图可以用浏览器打开,推荐chrome浏览器。
StartProfile客户端开始启动客户端脚本性能分析,启动后调用StopProfile即可在路径fileName生成函数性能火焰图,此接口只支持PC端。生成的火焰图可以用浏览器打开,推荐chrome浏览器。
StartRecordEventApollo开始启动服务端与客户端之间的脚本事件收发统计,启动后调用StopRecordEvent即可获取两个函数调用之间脚本事件收发的统计信息,仅支持租赁服与Apollo网络服环境(不支持单机环境)
StartRecordPacketApollo开始启动服务端与客户端之间的引擎收发包统计,启动后调用StopRecordPacket即可获取两个函数调用之间引擎收发包的统计信息,仅支持租赁服与Apollo网络服环境(不支持单机环境)
StopMemProfile服务端停止服务端脚本内存分析并生成火焰图,与StartMemProfile配合使用,此接口只支持PC端
StopMemProfile客户端停止客户端脚本内存分析并生成火焰图,与StartMemProfile配合使用,此接口只支持PC端
StopMultiProfile服务端停止双端脚本性能分析并生成火焰图,与StartMultiProfile配合使用,此接口只支持PC端
StopMultiProfile客户端停止双端脚本性能分析并生成火焰图,与StartMultiProfile配合使用,此接口只支持PC端
StopProfile服务端停止服务端脚本性能分析并生成火焰图,与StartProfile配合使用,此接口只支持PC端
StopProfile客户端停止客户端脚本性能分析并生成火焰图,与StartProfile配合使用,此接口只支持PC端
StopRecordEventApollo停止服务端与客户端之间的脚本事件收发统计并输出结果,与StartRecordEvent配合使用,输出结果为字典,key为网络包名,value字典中记录收发信息,具体见示例,仅支持租赁服与Apollo网络服环境(不支持单机环境)
StopRecordPacketApollo停止服务端与客户端之间的引擎收发包统计并输出结果,与StartRecordPacket配合使用,输出结果为字典,key为网络包名,value字典中记录收发信息,具体见示例,仅支持租赁服与Apollo网络服环境(不支持单机环境)

地图

接口
描述
CanSee服务端判断起始对象是否可看见目标对象,基于对象的Head位置判断
CanSee客户端判断起始对象是否可看见目标对象,基于对象的Head位置判断
CheckBlockToPos服务端判断位置之间是否有方块
CheckChunkState服务端判断指定位置的chunk是否加载完成
CreateDimension服务端创建新的dimension
CreateExplosion服务端用于生成爆炸
DeleteAllArea服务端删除所有常加载区域
DeleteArea服务端删除一个常加载区域
DetectStructure服务端检测自定义门的结构
DoTaskOnChunkAsync服务端异步加载指定范围区块,加载完成后调用输入的回调函数。
GetAllAreaKeys服务端获取所有常加载区域名称列表
GetBiomeInfo服务端获取群系天气相关参数
GetBiomeName服务端获取某一位置所属的生物群系信息
GetBiomeName客户端获取客户端当前维度已加载区域某一位置所属的生物群系信息
GetBlockLightLevel服务端获取方块位置的光照等级
GetChunkEntites服务端获取指定位置的区块中,全部的实体和玩家的ID列表
GetChunkMaxPos服务端获取某区块最大点的坐标
GetChunkMinPos服务端获取某区块最小点的坐标
GetChunkMobNum服务端获取某区块中的生物数量(不包括玩家,但包括盔甲架)
GetChunkPosFromBlockPos服务端通过方块坐标获得该方块所在区块坐标
GetChunkPosFromBlockPos客户端通过方块坐标获得该方块所在区块坐标
GetCurrentDimension客户端获取客户端当前维度
GetEntitiesAround服务端获取区域内的entity列表
GetEntitiesAround客户端获取区域内的entity列表
GetEntitiesAroundByType服务端获取区域内的某类型的entity列表
GetEntitiesAroundByType客户端获取区域内的某类型的entity列表
GetEntitiesInSquareArea服务端获取区域内的entity列表
GetEntitiesInSquareArea客户端获取区域内的entity列表
GetLevelId服务端获取levelId。某些组件需要levelId创建,可以用此接口获取levelId。其中level即为当前地图的游戏。
GetLevelId客户端获取levelId。某些组件需要levelId创建,可以用此接口获取levelId。其中level即为当前地图的游戏。
GetLoadedChunks服务端获取指定维度当前已经加载完毕的全部区块的坐标列表
GetSpawnDimension服务端获取世界出生维度
GetSpawnPosition服务端获取世界出生点坐标
GetStructureSize服务端获取结构体的长宽高
IsChunkGenerated服务端获取某个区块是否生成过。
IsSlimeChunk服务端获取某个区块是否是史莱姆区块。
LocateNeteaseFeatureRule服务端/locate指令相似,用于定位网易自定义特征规则
LocateStructureFeature服务端/locate指令相似,用于定位原版的部分结构,如海底神殿、末地城等。
MayPlace服务端判断方块是否可以放置
MayPlaceOn服务端判断物品是否可以放到指定的位置上
MirrorDimension服务端复制不同dimension的地形
OpenClientChunkGeneration服务端开启/关闭客户端区块生成功能,需要在LoadServerAddonScriptsAfter事件触发时调用。开启客户端区块生成功能时,如果使用了netease:structure_feature或修改了大部分地图,会导致客户端和服务端地图不一致的问题。此时可以通过关闭客户端区块生成功能解决该问题。
PlaceFeature服务端放置特征,与/placefeature指令相似
PlaceNeteaseLargeFeature服务端放置网易版大型结构特征
PlaceStructure服务端放置结构
SetAddArea服务端设置区块的常加载
SetBiomeByPos服务端设置某一位置所属的生物群系信息
SetBiomeByPosList服务端设置所有列表中位置所属的生物群系信息
SetBiomeByVolume服务端设置长方体空间中所属的生物群系信息
SetBiomeInfo服务端设置群系天气相关参数
SetMergeSpawnItemRadius服务端设置新生成的物品是否合堆
SetSpawnDimensionAndPosition服务端设置世界出生点维度与坐标
UpgradeMapDimensionVersion服务端提升指定地图维度的版本号,版本号不符的维度,地图存档信息将被废弃。使用后存档的地图版本均会同步提升至最新版本,假如希望使用此接口清理指定维度的地图存档,需要在保证该维度区块都没有被加载时调用。

实体管理

接口
描述
CreateClientEntityByTypeStr客户端创建客户端实体
CreateEngineEntityByNBT服务端根据nbt数据创建实体
CreateEngineEntityByTypeStr服务端创建指定identifier的实体
CreateEngineItemEntity服务端用于创建物品实体(即掉落物),返回物品实体的entityId
CreateEntityAOI服务端注册感应区域,有实体进入时和离开时会触发回调函数func
CreateExperienceOrb服务端创建专属经验球
CreateProjectileEntity服务端创建抛射物(直接发射)
DeleteEntityAOI服务端删除使用CreateEntityAOI注册的感应区
DestroyClientEntity客户端销毁客户端实体
DestroyEntity服务端销毁实体
GetDroppedItem服务端获取掉落物的物品信息
GetEngineActor服务端获取所有维度中已加载的所有实体(不包含玩家)。
GetEngineActor客户端获取客户端当前维度中已加载的所有实体(不包含玩家)。
GetLocalPlayerId客户端获取本地玩家的id
GetLootItems服务端指定战利品表获取一次战利品,返回的物品与json定义的概率有关
GetPlayerList服务端获取所有维度中的全部玩家的id列表
GetPlayerList客户端获取所有维度中的全部玩家的id列表
HasEntity客户端判断 entity 是否存在
IsEntityAlive服务端判断生物实体是否存活或非生物实体是否存在
IsEntityAlive客户端判断生物实体是否存活或非生物实体是否存在
KillEntity服务端杀死某个Entity
SpawnLootTable服务端使用生物类型模拟一次随机掉落,生成的物品与json定义的概率有关
SpawnLootTableWithActor服务端使用生物实例模拟一次随机掉落,生成的物品与json定义的概率有关
SpawnResources服务端产生方块随机掉落(该方法不适用于实体方块)
SpawnResourcesSilkTouched服务端模拟方块精准采集掉落
getEntitiesOrBlockFromRay服务端从指定位置发射一条射线,获取与射线相交的实体和方块
getEntitiesOrBlockFromRay客户端从指定位置发射一条射线,获取与射线相交的实体和方块

方块管理

接口
描述
GetBlock客户端获取某一位置的block
GetBlockClip服务端获取某一位置方块当前clip的aabb
GetBlockClip客户端获取指定位置方块当前clip的aabb
GetBlockCollision服务端获取某一位置方块当前collision的aabb
GetBlockCollision客户端获取指定位置方块当前collision的aabb
GetBlockNew服务端获取某一位置的block
GetDestroyTotalTime服务端获取使用物品破坏方块需要的时间
GetDestroyTotalTime客户端获取使用物品破坏方块需要的时间
GetLiquidBlock服务端获取某个位置的方块所含流体的信息
GetTopBlockHeight服务端获取某一位置最高的非空气方块的高度
GetTopBlockHeight客户端获取当前维度某一位置最高的非空气方块的高度
SetBlockNew服务端设置某一位置的方块
SetJigsawBlock服务端在某一位置放置拼图方块
SetLiquidBlock服务端设置某一位置的方块的extraBlock,可在此设置方块含水等
SetSnowBlock服务端设置某一位置的方块含雪

生物生成

接口
描述
GetEntityLimit服务端获取世界最大可生成实体数量上限。可生成实体的含义见SetEntityLimit
SetEntityLimit服务端设置世界最大可生成实体数量上限。可生成实体指具有spawnrule的实体。当前世界上被加载的可生成实体数量超过这个上限时,生物就不会再通过spawnrule刷出。
SpawnCustomModule服务端设置自定义刷怪

配方

接口
描述
AddBrewingRecipes服务端添加酿造台配方的接口
AddRecipe服务端动态注册配方,支持配方类型详见[配方类型说明]
GetRecipeResult服务端根据配方id获取配方结果。仅支持合成配方
GetRecipesByInput服务端通过输入物品查询配方
GetRecipesByInput客户端通过输入物品查询配方
GetRecipesByResult服务端通过输出物品查询配方所需要的输入材料
GetRecipesByResult客户端通过输出物品查询配方所需要的输入材料
RemoveRecipe服务端动态禁用配方

方块组合

接口
描述
CreateMicroBlockResStr服务端生成微缩方块资源Json字符串
GetBlankBlockPalette服务端获取一个空白的方块调色板。
GetBlankBlockPalette客户端获取一个空白的方块调色板。
GetBlockPaletteBetweenPos服务端根据输入的两个方块位置创建并获取一个方块调色板,方块调色板用于描述和记录世界中的多个方块的组合。这个方块调色板包含了这两个位置之间的所有方块及其相对位置。
GetBlockPaletteBetweenPos客户端根据输入的两个位置创建并获取一个方块调色板,该接口会搜索这两个位置之间的所有方块创建方块调色板,方块调色板用于描述和记录世界中的多个方块的组合。这个方块调色板包含了这两个位置之间的所有方块及其相对位置。
GetBlockPaletteFromPosList服务端根据输入的方块位置列表创建并获取一个方块调色板,方块调色板用于描述和记录世界中的多个方块的组合。创建的方块调色板包含了这个位置列表中的所有方块及其相对位置。
GetBlockPaletteFromPosList客户端根据输入的方块位置列表创建并获取一个方块调色板,方块调色板用于描述和记录世界中的多个方块的组合。创建的方块调色板包含了这个位置列表中的所有方块及其相对位置。
RegisterBlockPatterns服务端注册特殊方块组合
SetBlockByBlockPalette服务端根据输入的方块调色板内容,将调色板内记录的所有方块设置为实际的方块。

渲染

接口
描述
AddTerrainDestroyParticleEffect客户端在指定位置播放指定方块被开始破坏时的粒子效果(如果有)。
AddUseItemParticleEffect客户端在指定位置播放指定物品被开始使用时的粒子效果(如果有)。
GetAmbientBrightness客户端获取环境光亮度,影响天空亮度,不影响实体与方块光照
GetFogColor客户端获取当前雾效颜色
GetFogLength客户端获取雾效范围
GetMoonRot客户端获取月亮角度
GetSkyColor客户端获取天空颜色
GetSkyTextures客户端获取当前维度天空盒贴图,天空盒共6张贴图
GetStarBrightness客户端获取星星亮度
GetSunRot客户端获取太阳角度
GetUseAmbientBrightness客户端判断是否在mod设置了环境光亮度
GetUseFogColor客户端判断当前是否开启设置雾效颜色,该值默认为False,使用mod传入的颜色值后为True
GetUseFogLength客户端判断当前是否开启设置雾效范围,该值默认为False,使用mod传入的范围值后为True
GetUseMoonRot客户端判断是否在mod设置了月亮角度
GetUseSkyColor客户端判断是否在mod设置了天空颜色
GetUseStarBrightness客户端判断是否在mod设置了星星亮度
GetUseSunRot客户端判断是否在mod设置了太阳角度
HideNameTag客户端隐藏场景内所有名字,包括玩家名字,生物的自定义名称,物品展示框与命令方块的悬浮文本等
IsHideNameTag客户端获取是否隐藏场景内所有名字
RemoveTerrainDestroyParticleEffect客户端停止指定位置播放的方块被开始破坏时的粒子效果。
RemoveUseItemParticleEffect客户端停止指定位置播放的物品被开始使用时的粒子效果。
ResetAmbientBrightness客户端重置环境光亮度
ResetFogColor客户端重置雾效颜色
ResetFogLength客户端重置雾效范围
ResetMoonRot客户端重置月亮角度
ResetSkyColor客户端重置天空颜色
ResetSkyTextures客户端重置当前维度天空盒贴图。如果有使用addon配置贴图则会使用配置的贴图,否则为游戏内默认无贴图的情况
ResetStarBrightness客户端重置星星亮度
ResetSunRot客户端重置太阳角度
SetAmbientBrightness客户端设置环境光亮度,影响天空亮度,不影响实体与方块光照
SetFogColor客户端设置雾效颜色
SetFogLength客户端设置雾效范围
SetMoonRot客户端设置月亮所在角度
SetSkyColor客户端设置天空颜色
SetSkyTextures客户端设置当前维度天空盒贴图,天空盒需要6张贴图
SetStarBrightness客户端设置星星亮度,白天也可以显示星星
SetSunRot客户端设置太阳所在角度
SkyTextures客户端修改太阳、月亮、云层分布、天空盒的贴图。使用addon配置,非python接口。

时间

接口
描述
GetLocalDoDayNightCycle服务端获取维度是否打开昼夜更替
GetLocalTime服务端获取维度的时间
GetLocalTime客户端获取当前维度的时间
GetTime服务端获取当前世界时间
GetTime客户端获取当前世界时间
GetUseLocalTime服务端获取某个维度是否设置了使用局部时间规则
SetLocalDoDayNightCycle服务端设置使用局部时间规则的维度是否打开昼夜更替
SetLocalTime服务端设置使用局部时间规则维度的时间
SetLocalTimeOfDay服务端设置使用局部时间规则维度在一天内所在的时间
SetTime服务端设置当前世界时间
SetTimeOfDay服务端设置当前世界在一天内所在的时间
SetUseLocalTime服务端让某个维度拥有自己的局部时间规则,开启后该维度可以拥有与其他维度不同的时间与是否昼夜更替的规则

天气

接口
描述
GetDimensionLocalWeatherInfo服务端获取独立维度天气信息(必须先使用SetDimensionUseLocalWeather接口设置此维度拥有自己的独立天气)
GetDimensionUseLocalWeather服务端获取某个维度是否拥有自己的天气规则
IsRaining服务端获取是否下雨
IsThunder服务端获取是否打雷
SetDimensionLocalDoWeatherCycle服务端设置某个维度是否开启天气循环(必须先使用SetDimensionUseLocalWeather接口设置此维度拥有自己的独立天气)
SetDimensionLocalRain服务端设置某个维度下雨(必须先使用SetDimensionUseLocalWeather接口设置此维度拥有自己的独立天气)
SetDimensionLocalThunder服务端设置某个维度打雷(必须先使用SetDimensionUseLocalWeather接口设置此维度拥有自己的独立天气)
SetDimensionUseLocalWeather服务端设置某个维度拥有自己的天气规则,开启后该维度可以拥有与其他维度不同的天气和天气更替的规则
SetRaining服务端设置是否下雨
SetThunder服务端设置是否打雷

游戏规则

接口
描述
AddBannedItem服务端增加禁用物品
AddBlockProtectFieldApollo设置一个方块无法被玩家/实体破坏的区域
CleanBlockProtectFieldApollo取消全部已设置的方块无法被玩家/实体破坏的区域
ClearBannedItems服务端清空禁用物品
DisableVineBlockSpread服务端设置是否禁用藤曼蔓延生长
ForbidLiquidFlow服务端禁止/允许地图中的流体流动
GetBannedItemList服务端获取禁用物品列表
GetGameDiffculty服务端获取游戏难度
GetGameRulesInfoServer服务端获取游戏规则
GetGameType服务端获取默认游戏模式
GetLevelGravity服务端获取重力因子
GetPistonMaxInteractionCount服务端获取活塞/粘性活塞最多推动的方块数量,默认为12个方块,可能被其他开发者修改。
GetPistonMaxInteractionCount客户端获取活塞/粘性活塞最多推动的方块数量,默认为12个方块,可能被其他开发者修改。
GetSeed服务端获取存档种子
IsDisableCommandMinecart服务端获取当前是否允许运行命令方块矿车内置逻辑指令,当前仅Apollo网络服可用
IsLockDifficulty服务端获取当前世界的游戏难度是否被锁定
IsLockGameRulesInfo服务端获取当前世界的游戏规则是否被锁定
IsLockGameType服务端获取当前世界的游戏类型是否被锁定,包括默认游戏类型和个人游戏类型
LockDifficulty服务端锁定当前世界游戏难度(仅本次游戏有效),锁定后任何玩家在游戏内都无法通过指令或暂停菜单修改游戏难度
LockGameRulesInfo服务端锁定当前世界游戏规则(仅本次游戏有效),玩家无法通过指令、游戏菜单或api修改游戏规则(包括SetGameRulesInfoServer示例中列举的规则)
LockGameType服务端锁定当前世界游戏类型(仅本次游戏有效),玩家无法通过指令、游戏菜单或相关api如SetPlayerGameTypeSetDefaultGameType修改游戏类型,包括默认游戏类型和个人游戏类型
OpenCityProtectApollo开启城市保护,包括禁止破坏方块,禁止对方块使用物品,禁止怪物攻击玩家,禁止玩家之间互相攻击,禁止日夜切换,禁止天气变化,禁止怪物群落刷新
RemoveBannedItem服务端移除禁用物品
RemoveBlockProtectFieldApollo取消一个方块无法被玩家/实体破坏的区域
SetCanActorSetOnFireByLightning服务端禁止/允许闪电点燃实体
SetCanBlockSetOnFireByLightning服务端禁止/允许闪电点燃方块
SetDefaultGameType服务端设置默认游戏模式
SetDisableCommandMinecart服务端设置停止/开启运行命令方块矿车内置逻辑指令,当前仅Apollo网络服可用
SetDisableContainers服务端禁止所有容器界面的打开,包括玩家背包,各种包含背包界面的容器方块如工作台与箱子,以及包含背包界面的实体交互如马背包与村民交易
SetDisableDropItem服务端设置禁止丢弃物品
SetDisableGravityInLiquid服务端是否屏蔽所有实体在液体(水、岩浆)中的重力
SetDisableHunger服务端设置是否屏蔽饥饿度
SetGameDifficulty服务端设置游戏难度
SetGameRulesInfoServer服务端设置游戏规则。所有参数均可选。
SetHurtCD服务端设置全局受击间隔CD
SetLevelGravity服务端设置重力因子
SetPistonMaxInteractionCount服务端设置活塞/粘性活塞最多推动的方块数量,默认为12个方块。该设置不存档。

自定义数据

接口
描述
CleanExtraData服务端清除实体的自定义数据或者世界的自定义数据,清除实体数据时使用对应实体id创建组件,清除世界数据时使用levelId创建组件
GetExtraData服务端获取实体的自定义数据或者世界的自定义数据,某个键所对应的值。获取实体数据时使用对应实体id创建组件,获取世界数据时使用levelId创建组件
GetWholeExtraData服务端获取完整的实体的自定义数据或者世界的自定义数据,获取实体数据时使用对应实体id创建组件,获取世界数据时使用levelId创建组件
SaveExtraData服务端用于保存实体的自定义数据或者世界的自定义数据
SetExtraData服务端用于设置实体的自定义数据或者世界的自定义数据,数据以键值对的形式保存。设置实体数据时使用对应实体id创建组件,设置世界数据时使用levelId创建组件

指令

接口
描述
GetCommandPermissionLevel服务端返回设定使用/op命令时OP的权限等级(对应server.properties中的op-permission-level配置)
GetDefaultPlayerPermissionLevel服务端返回新玩家加入时的权限身份(对应server.properties中的default-player-permission-level配置)
SetCommand服务端使用游戏内指令
SetCommandPermissionLevel服务端设置当玩家使用/op命令时OP的权限等级(对应server.properties中的op-permission-level配置)
SetDefaultPlayerPermissionLevel服务端设置新玩家加入时的权限身份(对应server.properties中的default-player-permission-level配置)

消息

接口
描述
NotifyOneMessage服务端给指定玩家发送聊天框消息
SendMsg服务端模拟玩家给所有人发送聊天栏消息
SendMsgToPlayer服务端模拟玩家给另一个玩家发送聊天栏消息
SetLeftCornerNotify客户端客户端设置左上角通知信息
SetNotifyMsg服务端设置消息通知
SetOnePopupNotice服务端在具体某个玩家的物品栏上方弹出popup类型通知,位置位于tip类型消息下方,此功能更建议客户端使用game组件的对应接口SetPopupNotice
SetOneTipMessage服务端在具体某个玩家的物品栏上方弹出tip类型通知,位置位于popup类型通知上方,此功能更建议在客户端使用game组件的对应接口SetTipMessage
SetPopupNotice服务端在所有玩家物品栏上方弹出popup类型通知,位置位于tip类型消息下方
SetPopupNotice客户端在本地玩家的物品栏上方弹出popup类型通知,位置位于tip类型消息下方
SetPopupState客户端设置Popup消息栏状态
SetTipMessage服务端在所有玩家物品栏上方弹出tip类型通知,位置位于popup类型通知上方
SetTipMessage客户端在本地玩家的物品栏上方弹出tip类型通知,位置位于popup类型通知上方

记分板

接口
描述
GetAllPlayerScoreboardObjects服务端获取玩家记分项
GetAllPlayerScoreboardObjects客户端获取玩家记分项
GetAllScoreboardObjects服务端获取所有记分板项
GetAllScoreboardObjects客户端获取所有记分板项

实体类型

接口
描述
GetEngineType服务端获取实体类型,主要用于判断实体是否属于某一类型的生物。
GetEngineType客户端获取实体类型,主要用于判断实体是否属于某一类型的生物。
GetEngineTypeStr服务端获取实体的类型名称
GetEngineTypeStr客户端获取实体的类型名称
GetEntityDefinitions服务端获取实体的命名空间ID及其当前和之前的定义组件群
GetEntityNBTTags服务端获取实体的NBT标签

附加值

接口
描述
GetAuxValue服务端获取射出的弓箭或投掷出的药水的附加值
GetAuxValue客户端获取射出的弓箭或投掷出的药水的附加值

属性

接口
描述
ChangeEntityDimension服务端传送实体
GetAllComponentsName服务端获取实体所拥有的原版组件list
GetAttrMaxValue服务端获取实体的引擎属性的最大值
GetAttrMaxValue客户端获取属性最大值,包括生命值,饥饿度,移速等
GetAttrValue服务端获取实体的引擎属性
GetAttrValue客户端获取属性值,包括生命值,饥饿度,移速
GetBodyRot客户端获取实体的身体的角度
GetCurrentAirSupply服务端生物当前氧气储备值
GetCurrentAirSupply客户端玩家当前氧气储备值
GetDeathTime服务端获取生物死亡后持续的时间(刻,1秒20刻),用于控制死亡动画。0表示生物未死亡。
GetEntitiesBySelector服务端传入目标选择器,获取对应实体id (最大范围是所有已加载的实体)
GetEntityDamage服务端获取生物(包括玩家)的攻击力
GetEntityDimensionId服务端获取实体所在维度
GetEntityFallDistance服务端获取实体的坠落高度,越大的值会给予实体更大的坠落伤害,建议在OnGroundServerEvent事件中调用
GetEntityLinksTag服务端获取实体相连接的实体,如获取entityId为马,会返回骑乘者的信息
GetEntityOwner服务端获取实体的属主(包括可驯服生物的主人,或者掉落物的丢弃者,弹射物的发射者等)
GetFootPos服务端获取实体脚所在的位置
GetFootPos客户端获取实体脚所在的位置
GetGravity服务端获取实体的重力因子,当生物重力因子为0时则应用世界的重力因子
GetLoadActors服务端获取已加载的实体id
GetMarkVariant服务端获取实体的标记变种属性值
GetMaxAirSupply服务端获取生物最大氧气储备值
GetMaxAirSupply客户端玩家最大氧气储备值
GetMobColor服务端获取生物的颜色,截止至网易2.9版本,只对羊和热带鱼有效
GetMobStrength服务端获取生物的强度,截止至网易2.9版本,只对羊驼有效,强度越大羊驼驮运的箱子时格子数量越多
GetMobStrengthMax服务端获取生物强度的最大值,截止至网易2.9版本,只对羊驼有效,强度越大羊驼驮运的箱子时格子数量越多,SetMobStrength无法超过SetMobStrengthMax的值
GetName服务端获取生物的自定义名称(即使用命名牌或者SetName接口设置的名称),或者玩家的名字。
GetName客户端获取生物的自定义名称(即使用命名牌或者SetName接口设置的名称),或者玩家的名字。
GetPos服务端获取实体位置
GetPos客户端获取实体位置
GetRiderId客户端获取玩家坐骑entityid
GetRot服务端获取实体头与水平方向的俯仰角度和竖直方向的旋转角度,获得角度后可用GetDirFromRot接口转换为朝向的单位向量 MC坐标系说明
GetRot客户端获取实体头与水平方向的俯仰角度和竖直方向的旋转角度,获得角度后可用GetDirFromRot接口转换为朝向的单位向量 MC坐标系说明
GetSize服务端获取实体的包围盒
GetSize客户端获取实体的包围盒
GetTradeLevel服务端获取村民的交易等级
GetTypeFamily服务端获取生物行为包字段 type_family
GetUnitBubbleAirSupply服务端单位气泡数对应的氧气储备值
GetVariant服务端获取实体的变种属性值
HasChest服务端判断生物是否背负了箱子,截止至网易2.9版本,只对羊驼、驴、骡生效
HasComponent服务端判断实体是否有原版组件
HasSaddle服务端判断实体是否装备了鞍
IsAngry服务端判断实体是否处于激怒状态
IsBaby服务端判断实体是否为幼年
IsConsumingAirSupply服务端获取生物当前是否在消耗氧气
IsIllagerCaptain服务端判断实体是否为袭击队长,截止至网易2.9版本,只对掠夺者和卫道士有效
IsNaturallySpawned服务端获取生物是否为自然生成的
IsOutOfControl服务端判断实体是否处于失控状态,截止至网易2.9版本,只对船有效
IsPregnant服务端获取生物是否怀孕,截止至网易2.9版本,只对海龟有效
IsSheared服务端判断实体是否被剃毛,截止至网易2.9版本,只对羊有效
IsSitting服务端判断实体是否处于坐下状态
IsTamed服务端判断实体是否被驯服
LockLocalPlayerRot客户端在分离摄像机时,锁定本地玩家的头部角度
PromoteToIllagerCaptain服务端晋升实体为袭击队长,截止至网易2.9版本,只对掠夺者和卫道士有效
ResetToDefaultValue服务端重置实体引擎属性到默认值
ResetToMaxValue服务端重置实体引擎属性到最大值
SetAngry服务端设置实体是否处于激怒状态
SetAsAdult服务端设置实体为成年体
SetAttrMaxValue服务端设置实体的引擎属性的最大值
SetAttrValue服务端设置实体的引擎属性
SetChest服务端设置生物是否背负了箱子,截止至网易2.9版本,只对羊驼、驴、骡生效
SetCurrentAirSupply服务端设置生物氧气储备值
SetEntityLookAtPos服务端设置非玩家的实体看向某个位置
SetEntityOwner服务端设置实体的属主(包括可驯服生物的主人,或者掉落物的丢弃者,弹射物的发射者等)
SetFootPos服务端设置实体脚底所在的位置
SetGravity服务端设置实体的重力因子,当生物重力因子为0时则应用世界的重力因子
SetMarkVariant服务端设置实体的标记变种属性值
SetMaxAirSupply服务端设置生物最大氧气储备值
SetMobColor服务端设置生物的颜色,截止至网易2.9版本,只对羊和热带鱼有效
SetMobStrength服务端设置生物的强度,截止至网易2.9版本,只对羊驼有效,强度越大羊驼驮运的箱子时格子数量越多
SetMobStrengthMax服务端设置生物强度的最大值,截止至网易2.9版本,只对羊驼有效,强度越大羊驼驮运的箱子时格子数量越多,SetMobStrength无法超过SetMobStrengthMax的值。由于引擎限制,在羊驼被打时候会reload组件,strengthMax会恢复成llama.json中的配置值(minecraft:strength)
SetName服务端用于设置生物的自定义名称,跟原版命名牌作用相同,玩家和新版流浪商人暂不支持
SetOutOfControl服务端设置实体是否处于失控状态,截止至网易2.9版本,只对船有效
SetPersistent服务端设置实体不会因为离玩家太远而被清除
SetPlayerLookAtPos客户端设置本地玩家看向某个位置
SetPos服务端设置实体位置
SetRecoverTotalAirSupplyTime服务端设置恢复最大氧气量的时间,单位秒
SetRot服务端设置实体头与水平方向的俯仰角度和竖直方向的旋转角度 MC坐标系说明
SetRot客户端设置实体头与水平方向的俯仰角度和竖直方向的旋转角度 MC坐标系说明
SetSheared服务端设置实体是否被剃毛,截止至网易2.9版本,只对羊有效
SetSitting服务端设置生物是否坐下
SetSize服务端设置实体的包围盒
SetTradeLevel服务端设置村民的交易等级
SetVariant服务端设置实体的变种属性值
isEntityInLava客户端实体是否在岩浆中
isEntityOnGround客户端实体是否触地

行为

接口
描述
AddActorComponent服务端给指定实体自定义添加实体Component
AddActorComponentGroup服务端给指定实体添加实体json中配置的ComponentGroup
AddEntityAroundEntityMotion服务端给实体(不含玩家)添加对实体环绕运动器
AddEntityAroundPointMotion服务端给实体(不含玩家)添加对点环绕运动器
AddEntitySeat服务端增加坐骑座位
AddEntityTrackMotion服务端给实体(不含玩家)添加轨迹运动器
AddEntityVelocityMotion服务端给实体(不含玩家)添加速度运动器
ChangeRiderSeat服务端设置骑乘者在当前坐骑上的序号
DeleteEntitySeat服务端删除坐骑座位
GetAttackTarget服务端获取仇恨目标
GetAttackTarget客户端获取仇恨目标
GetBlockControlAi服务端获取生物原生AI是否被屏蔽
GetComponents服务端获取指定实体的生效Components
GetCustomGoalCls服务端用于获取服务器自定义行为节点的基类。实现新的行为节点时,需要继承该接口返回的类
GetEntityMotions服务端获取实体(不含玩家)身上的所有运动器
GetJumpPower服务端获取生物跳跃力度,0.42表示正常水平
GetLeashHolder服务端获取实体被使用拴绳牵引时牵引者的ID
GetMotion服务端获取生物(含玩家)的瞬时移动方向向量
GetMotion客户端获取生物的瞬时移动方向向量。与服务端不同,客户端不会计算摩擦等因素,获取到的是上一帧的向量,与服务器获取到的值会不相等
GetOwnerId服务端获取驯服生物的主人id
GetOwnerId客户端获取驯服生物的主人id
GetRiders服务端获取坐骑上的骑乘者信息
GetStepHeight服务端返回玩家前进非跳跃状态下能上的最大台阶高度
Hurt服务端设置实体伤害
ImmuneDamage服务端设置实体是否免疫伤害(该属性存档)
IsEating服务端判断非玩家实体是否在进食
IsEntityOnFire服务端获取实体是否着火
IsLootDropped服务端获取生物是否生成掉落物
IsPersistent服务端判断是否为持久性生物
IsRoaring服务端判断是否处于咆哮状态,截止至网易2.9版本,仅对劫掠兽有效
IsStunned服务端判断是否处于眩晕状态,截止至网易2.9版本,仅对劫掠兽有效
RemoveActorComponent服务端删除指定实体的指定Component
RemoveActorComponentGroup服务端移除指定实体在实体json中配置的ComponentGroup
RemoveEntityMotion服务端移除实体(不含玩家)身上的运动器
ResetAttackTarget服务端清除仇恨目标
ResetMotion服务端重置生物(不含玩家)的瞬时移动方向向量
ResetStepHeight服务端恢复引擎默认玩家前进非跳跃状态下能上的最大台阶高度
SetActorCollidable服务端设置实体是否可碰撞
SetActorPushable服务端设置实体是否可推动
SetAttackTarget服务端设置仇恨目标
SetBlockControlAi服务端设置屏蔽生物原生AI
SetCanOtherPlayerRide服务端设置其他玩家是否有权限骑乘,True表示每个玩家都能骑乘,False只有驯服者才能骑乘
SetControl服务端设置该生物无需装备鞍就可以控制行走跳跃
SetEntityInteractFilter服务端设置与生物可交互的条件
SetEntityLockRider服务端设置坐骑上的实体是否锁定序号
SetEntityOnFire服务端设置实体着火
SetEntityRide服务端驯服可骑乘生物
SetEntitySeat服务端设置坐骑座位的位置、旋转以及允许实体旋转范围
SetEntityShareablesItems服务端设置生物可分享/可拾取的物品列表
SetEntityTamed服务端设置生物驯服,需要配合 entityEvent组件使用。该类驯服不包含骑乘功能。
SetJumpPower服务端设置生物跳跃力度,0.42表示正常水平
SetLeashHolder服务端为实体添加牵引者,与原版拴绳的作用相同,详见基岩版栓绳介绍
SetLootDropped服务端设置生物是否生成掉落物
SetMobKnockback服务端设置击退的初始速度,需要考虑阻力的影响
SetMotion服务端设置生物(不含玩家)的瞬时移动方向向量
SetMotion客户端设置瞬时的移动方向向量,用于本地玩家
SetMoveSetting服务端寻路组件
SetPersistence服务端设置实体是否持久化。
SetRidePos服务端设置生物骑乘位置
SetRiderRideEntity服务端设置实体骑乘生物(或者船与矿车)
SetStepHeight服务端设置玩家前进非跳跃状态下能上的最大台阶高度, 默认值为0.5625,1的话表示能上一个台阶
StartEntityMotion服务端启动实体(不含玩家)身上的某个运动器
StopEntityMotion服务端停止实体(不含玩家)身上的某个运动器
StopEntityRiding服务端强制骑乘者下坐骑。
TriggerCustomEvent服务端触发生物自定义事件

状态效果

接口
描述
AddEffectToEntity服务端为实体添加指定状态效果,如果添加的状态已存在则有以下集中情况:1、等级大于已存在则更新状态等级及持续时间;2、状态等级相等且剩余时间duration大于已存在则刷新剩余时间;3、等级小于已存在则不做修改;4、粒子效果以新的为准
GetAllEffects服务端获取实体当前所有状态效果
GetAllEffects客户端获取实体当前所有状态效果
GetLoadEffects服务端获取所有已加载的状态效果
HasEffect服务端获取实体是否存在当前状态效果
HasEffect客户端获取实体是否存在当前状态效果
RemoveEffectFromEntity服务端为实体删除指定状态效果

渲染

接口
描述
AddActorAnimation客户端增加生物渲染动画
AddActorAnimationController客户端增加生物渲染动画控制器
AddActorBlockGeometry客户端为实体添加方块几何体模型。
AddActorGeometry客户端增加生物渲染几何体
AddActorParticleEffect客户端增加生物特效资源
AddActorRenderController客户端增加生物渲染控制器
AddActorRenderControllerArray客户端增加生物渲染控制器列表中字典arrays元素
AddActorRenderMaterial客户端增加生物渲染需要的材质
AddActorScriptAnimate客户端在生物的客户端实体定义(minecraft:client_entity)json中的scripts/animate节点添加动画/动画控制器
AddActorSoundEffect客户端增加生物音效资源
AddActorTexture客户端增加生物渲染贴图
AddAnimationControllerToOneActor客户端增加单个生物渲染动画控制器
AddAnimationToOneActor客户端增加单个生物渲染动画
AddGeometryToOneActor客户端增加单个生物渲染几何体
AddParticleEffectToOneActor客户端增加生物特效资源
AddRenderControllerToOneActor客户端增加单个生物的渲染控制器
AddRenderMaterialToOneActor客户端增加单个生物渲染需要的材质
AddScriptAnimateToOneActor客户端在单个生物的客户端实体定义(minecraft:client_entity)json中的scripts/animate节点添加动画/动画控制器
AddSoundEffectToOneActor客户端增加单个生物的音效资源
AddTextureToOneActor客户端增加单个生物的渲染贴图
BindEntityToEntity客户端绑定骨骼模型跟随其他entity,如果当前entity是本地玩家,摄像机也跟随其他entity
ClearActorBlockGeometry客户端删除实体中所有的方块几何体模型。
CopyActorGeometryFromPlayer客户端将渲染几何体从某个玩家拷贝到某类生物identifier上
CopyActorRenderMaterialFromPlayer客户端将渲染材质从某个玩家拷贝到某类生物identifier上
CopyActorTextureFromPlayer客户端将贴图从某个玩家拷贝到某类生物identifier上
CopyPlayerGeometryToOneActor客户端将渲染几何体从某个玩家拷贝到某个生物上
CopyPlayerRenderMaterialToOneActor客户端将渲染材质从某个玩家拷贝到某个生物上
CopyPlayerTextureToOneActor客户端将贴图从某个玩家拷贝到某个生物上
DeleteActorBlockGeometry客户端删除实体中指定方块几何体模型。
GetActorRenderParams客户端获取实体(包括玩家)渲染参数
GetEntityExtraUniforms客户端获取在实体shader当中使用的自定义变量的值。该自定义变量包含EXTRA_ACTOR_UNIFORM1,EXTRA_ACTOR_UNIFORM2,EXTRA_ACTOR_UNIFORM3,EXTRA_ACTOR_UNIFORM4,总共4组,每组为一个vec4(float, float, float ,float)类型的向量。
GetEntityRenderDistance客户端获取玩家的实体可渲染距离。玩家周围的实体指这个区块内的实体,也包含玩家自身。实体的渲染距离指,实体的位置到玩家相机位置的距离。可渲染距离指,如果实体的渲染距离在可渲染距离之内,则实体会被渲染出来,如果在距离以外,则实体不会被渲染出来。仅对本地玩家有效。
GetEntityUIExtraUniforms客户端获取在实体shader当中使用的UI自定义变量的值,该变量可在微软UI纸娃娃(paperdoll)及网易版纸娃娃(neteasepaperdoll)上使用identifier渲染某一类生物实体时使用。该自定义变量包含EXTRA_ACTOR_UNIFORM1,EXTRA_ACTOR_UNIFORM2,EXTRA_ACTOR_UNIFORM3,EXTRA_ACTOR_UNIFORM4,总共4组,每组为一个vec4(float, float, float ,float)类型的向量。
GetNotRenderAtAll客户端获取实体是否不渲染
IsShowName客户端获取生物名字是否按照默认游戏逻辑显示(包括玩家)
RebuildActorRender客户端重建生物的数据渲染器(该接口不支持玩家,玩家请使用RebuildPlayerRender)
RebuildRenderForOneActor客户端使用完entity类渲染接口后,重建单个生物渲染控制器(该接口不支持玩家,玩家请使用RebuildPlayerRender)
RemoveActorAnimationController客户端移除生物渲染动画控制器
RemoveActorGeometry客户端删除生物渲染几何体
RemoveActorRenderController客户端删除生物渲染控制器
RemoveActorTexture客户端删除生物渲染贴图
RemoveAnimationControllerForOneActor客户端移除单个生物渲染动画控制器
RemoveGeometryForOneActor客户端删除单个生物的渲染几何体
RemoveRenderControllerForOneActor客户端删除单个生物的渲染控制器
RemoveTextureForOneActor客户端删除单个生物的渲染贴图
ResetActorRender客户端重置实体渲染接口,包括动画、动画控制器、渲染控制器、贴图、材质、特效资源、音效资源等。
ResetBindEntity客户端取消目标entity的绑定实体,取消后不再跟随任何其他entity
ResetRenderForOneActor客户端将调用OneActor类渲染接口(CopyPlayerTextureToOneActor、CopyPlayerRenderMaterialToOneActor等)的生物重置回种群
SetActorAllBlockGeometryVisible客户端设置实体中所有的方块几何体模型是否显示。
SetActorBlockGeometryVisible客户端设置实体中指定的方块几何体模型是否显示。
SetAlwaysShowName客户端设置生物名字是否一直显示,瞄准点不指向生物时也能显示
SetColor客户端设置血条的颜色及背景色
SetEntityExtraUniforms客户端设置可在实体shader当中使用的自定义变量的值。该自定义变量总共可设置EXTRA_ACTOR_UNIFORM1,EXTRA_ACTOR_UNIFORM2,EXTRA_ACTOR_UNIFORM3,EXTRA_ACTOR_UNIFORM4,总共4组,每组为一个vec4(float, float, float ,float)类型的向量,向量的默认值为(1.0,1.0,1.0,1.0)。
SetEntityRenderDistance客户端设置玩家周围的实体的可渲染距离。玩家周围的实体指这个区块内的实体,也包含玩家自身。实体的渲染距离指,实体的位置到玩家相机位置的距离。可渲染距离指,如果实体的渲染距离在可渲染距离之内,则实体会被渲染出来,如果在距离以外,则实体不会被渲染出来。仅对本地玩家有效。
SetEntityUIExtraUniforms客户端设置可在实体shader当中使用的UI自定义变量的值,可在微软UI纸娃娃(paperdoll)及网易版纸娃娃(neteasepaperdoll)上使用identifier渲染某一类生物实体时使用。该自定义变量总共可设置EXTRA_ACTOR_UNIFORM1,EXTRA_ACTOR_UNIFORM2,EXTRA_ACTOR_UNIFORM3,EXTRA_ACTOR_UNIFORM4,总共4组,每组为一个vec4(float, float, float ,float)类型的向量,向量的默认值为(1.0,1.0,1.0,1.0)。
SetHealthBarDeviation客户端设置某个entity血条的相对高度
SetNameDeeptest客户端设置名字是否透视
SetNotRenderAtAll客户端设置是否关闭实体渲染
SetRenderLocalPlayer客户端设置本地玩家是否渲染
SetShowName客户端设置生物名字是否按照默认游戏逻辑显示(包括玩家)
ShowHealth客户端设置某个entity是否显示血条,默认为显示
ShowHealthBar客户端设置是否显示血条

背包

接口
描述
GetEntityItem服务端获取生物物品,支持获取背包,盔甲栏,副手以及主手物品
GetEquItemEnchant服务端获取装备槽位中盔甲的附魔
GetEquItemModEnchant服务端获取装备槽位中盔甲的自定义附魔
SetEntityItem服务端设置生物物品,建议开发者根据生物特性来进行设置,部分生物设置装备后可能不显示但是死亡后仍然会掉落所设置的装备

自定义属性

接口
描述
GetAttr服务端获取SetAttr设置的属性值
GetAttr客户端获取SetAttr设置的属性值
RegisterUpdateFunc客户端注册属性值变换时的回调函数,当属性变化时会调用该函数
SaveAttr服务端保存SetAttr设置的属性值
SetAttr服务端设置属性值。服务端设置后会自动同步到客户端,可以用客户端的GetAttr获取。默认不会存档,需要存档的话可以设置needRestore=True。
SetAttr客户端设置客户端属性值
UnRegisterUpdateFunc客户端反注册属性值变换时的回调函数

自定义数据

接口
描述
CleanExtraData服务端清除实体的自定义数据或者世界的自定义数据,清除实体数据时使用对应实体id创建组件,清除世界数据时使用levelId创建组件
GetExtraData服务端获取实体的自定义数据或者世界的自定义数据,某个键所对应的值。获取实体数据时使用对应实体id创建组件,获取世界数据时使用levelId创建组件
GetWholeExtraData服务端获取完整的实体的自定义数据或者世界的自定义数据,获取实体数据时使用对应实体id创建组件,获取世界数据时使用levelId创建组件
SaveExtraData服务端用于保存实体的自定义数据或者世界的自定义数据
SetExtraData服务端用于设置实体的自定义数据或者世界的自定义数据,数据以键值对的形式保存。设置实体数据时使用对应实体id创建组件,设置世界数据时使用levelId创建组件

molang

接口
描述
EvalMolangExpression服务端在实体上下文上执行molang表达式
EvalMolangExpression客户端在实体上下文上执行molang表达式
Get客户端获取某一个实体计算节点的值,如果不存在返回注册时的默认值
GetMolangValue客户端获取实体molang变量的值
GetStringHash64客户端返回字符串变量的hash64
Register客户端注册实体计算节点
Set客户端设置某一个实体计算节点的值
UnRegister客户端注销实体计算节点

标签

接口
描述
AddEntityTag服务端增加实体标签
EntityHasTag服务端判断实体是否存在某个指定的标签
GetEntityTags服务端获取实体标签列表
RemoveEntityTag服务端移除实体某个指定的标签

抛射物

接口
描述
GetSourceEntityId服务端获取抛射物发射者实体id

经验球

接口
描述
GetOrbExperience服务端获取经验球的经验
SetOrbExperience服务端设置经验球经验

官方伙伴

接口
描述
Disable服务端关闭官方伙伴功能,单人游戏以及本地联机不支持该接口
Enable服务端启用官方伙伴功能,单人游戏以及本地联机不支持该接口

官方聊天扩展

接口
描述
AddCommonPhrases服务端为官方聊天扩展功能添加常用短语。单人模式下单个模组最多添加12条,联机大厅和网络服无条数限制。
Disable服务端关闭官方聊天扩展功能。需要在ClientLoadAddonsFinishServerEvent事件中调用。仅在联机大厅和网络服中生效。
Enable服务端启用官方聊天扩展功能。需要在ClientLoadAddonsFinishServerEvent事件中调用。仅在联机大厅和网络服中生效。
RegisterChatPrefix服务端为游戏内指定玩家注册聊天前缀。仅在主界面消息框和聊天界面游戏频道生效。建议在AddServerPlayerEvent事件中调用,为新玩家添加前缀。
RemoveCommonPhrases服务端为官方聊天扩展功能移除常用短语。
SetShowOfficialPhrases服务端设置是否显示官方的常用聊天短语。仅在联机大厅和网络服中生效。
SetShowSocialNearbyInfo服务端设置是否显示官方聊天社交界面中同一游戏玩家是否在附近信息。

魔法指令

接口
描述
Disable服务端关闭官方魔法指令功能。需要在ClientLoadAddonsFinishServerEvent事件中调用。仅在联机大厅中生效。
Enable服务端启用官方魔法指令功能。需要在ClientLoadAddonsFinishServerEvent事件中调用。仅在联机大厅中生效。

属性

接口
描述
AddPlayerExperience服务端增加玩家经验值
AddPlayerLevel服务端修改玩家等级
CollectOnlineClientData服务端收集在线玩家客户端数据,用于判断玩家是否作弊
GetArmorValue客户端获取玩家护甲值
GetEnchantmentSeed服务端获取玩家的附魔种子,该种子会决定附魔台上准备附魔的装备的附魔项
GetPlayerCurLevelExp客户端获取玩家当前等级需要的经验值
GetPlayerExp服务端获取玩家当前等级下的经验值
GetPlayerExp客户端获取玩家当前等级下的经验值
GetPlayerHealthLevel服务端获取玩家健康临界值,当饥饿值大于等于健康临界值时会自动恢复血量,开启饥饿值且开启自然恢复时有效。原版默认值为18
GetPlayerHealthTick服务端获取玩家自然恢复速度,当饥饿值大于等于健康临界值时会自动恢复血量,开启饥饿值且开启自然恢复时有效。原版默认值为80刻(即每4秒)恢复1点血量
GetPlayerHunger服务端获取玩家饥饿度,展示在UI饥饿度进度条上,初始值为20,即每一个鸡腿代表2个饥饿度。 饱和度(saturation) :玩家当前饱和度,初始值为5,最大值始终为玩家当前饥饿度(hunger),该值直接影响玩家饥饿度(hunger)
1)增加方法:吃食物。
2)减少方法:每触发一次消耗事件,该值减少1,如果该值不大于0,直接把玩家 饥饿度(hunger) 减少1。
GetPlayerHunger客户端获取玩家饥饿度,展示在UI饥饿度进度条上,初始值为20,即每一个鸡腿代表2个饥饿度。 饱和度(saturation) :玩家当前饱和度,初始值为5,最大值始终为玩家当前饥饿度(hunger),该值直接影响玩家饥饿度(hunger)
1)增加方法:吃食物。
2)减少方法:每触发一次消耗事件,该值减少1,如果该值不大于0,直接把玩家 饥饿度(hunger) 减少1。
GetPlayerLevel服务端获取玩家等级
GetPlayerMaxExhaustionValue服务端获取玩家foodExhaustionLevel的归零值,常量值,默认为4。消耗度(exhaustion)是指玩家当前消耗度水平,初始值为0,该值会随着玩家一系列动作(如跳跃)的影响而增加,当该值大于最大消耗度(maxExhaustion)后归零,并且把饱和度(saturation)减少1(为了说明饥饿度机制,我们将此定义为消耗事件
GetPlayerStarveLevel服务端获取玩家饥饿临界值,当饥饿值小于饥饿临界值时会自动扣除血量,开启饥饿值且开启饥饿掉血时有效。原版默认值为1
GetPlayerStarveTick服务端获取玩家饥饿掉血速度,当饥饿值小于饥饿临界值时会自动扣除血量,开启饥饿值且开启饥饿掉血时有效。原版默认值为80刻(即每4秒)扣除1点血量
GetPlayerTotalExp服务端获取玩家的总经验值
GetPlayerTotalExp客户端获取玩家的总经验值
IsPlayerNaturalRegen服务端是否开启玩家自然恢复,当饥饿值大于等于健康临界值时会自动恢复血量,开启饥饿值且开启自然恢复时有效。原版默认开启
IsPlayerNaturalStarve服务端是否开启玩家饥饿掉血,当饥饿值小于饥饿临界值时会自动恢复血量,开启饥饿值且开启饥饿掉血时有效。原版默认开启
SetEnchantmentSeed服务端设置玩家的附魔种子,该种子会决定附魔台上准备附魔的装备的附魔项
SetPlayerHealthLevel服务端设置玩家健康临界值,当饥饿值大于等于健康临界值时会自动恢复血量,开启饥饿值且开启自然恢复时有效.原版默认值为18
SetPlayerHealthTick服务端设置玩家自然恢复速度,当饥饿值大于等于健康临界值时会自动恢复血量,开启饥饿值且开启自然恢复时有效.原版默认值为80刻(即每4秒)恢复1点血量
SetPlayerHunger服务端设置玩家饥饿度。
SetPlayerMaxExhaustionValue服务端设置玩家最大消耗度(maxExhaustion),通过调整 最大消耗度(maxExhaustion) 的大小,就可以调整 饥饿度(hunger) 的消耗速度,当 最大消耗度(maxExhaustion) 很大时,饥饿度可以看似一直不下降
SetPlayerNaturalRegen服务端设置是否开启玩家自然恢复,当饥饿值大于等于健康临界值时会自动恢复血量,开启饥饿值且开启自然恢复时有效.原版默认开启
SetPlayerNaturalStarve服务端设置是否开启玩家饥饿掉血,当饥饿值小于饥饿临界值时会自动扣除血量,开启饥饿值且开启饥饿掉血时有效.原版默认开启
SetPlayerPrefixAndSuffixName服务端设置玩家前缀和后缀名字
SetPlayerStarveLevel服务端设置玩家饥饿临界值,当饥饿值小于饥饿临界值时会自动扣除血量,开启饥饿值且开启饥饿掉血时有效。原版默认值为1
SetPlayerStarveTick服务端设置玩家饥饿掉血速度,当饥饿值小于饥饿临界值时会自动扣除血量,开启饥饿值且开启饥饿掉血时有效.原版默认值为80刻(即每4秒)扣除1点血量
SetPlayerTotalExp服务端设置玩家的总经验值
Swing客户端本地玩家播放原版攻击动作
getUid客户端获取本地玩家的uid

行为

接口
描述
AddPlayerAroundEntityMotion服务端给玩家添加对实体环绕运动器
AddPlayerAroundPointMotion服务端给玩家添加对点环绕运动器
AddPlayerTrackMotion服务端给玩家添加轨迹运动器
AddPlayerVelocityMotion服务端给玩家添加速度运动器
BeginSprinting客户端使本地玩家进入并保持向前疾跑/冲刺状态
ChangePlayerDimension服务端传送玩家
ChangePlayerFlyState服务端给予/取消飞行能力, 并根据enterFly参数确定是否进入飞行状态
EnableKeepInventory服务端设置玩家死亡不掉落物品
EndSprinting客户端使本地玩家结束向前疾跑/冲刺状态
GetEntityRider服务端获取骑乘者正在骑乘的实体的id。
GetEntityRider客户端获取骑乘者正在骑乘的实体的id。
GetInteracteCenterOffset服务端获取玩家服务端交互中心的偏移
GetIsBlocking服务端获取玩家激活盾牌状态
GetPickCenterOffset客户端获取玩家设置的第三人称下客户端交互中心的偏移
GetPickRange客户端获取玩家客户端的交互距离
GetPlayerDestroyTotalTime服务端获取玩家破坏方块需要的时间,受玩家状态(急迫、潮涌、挖掘疲劳)和手持物及手持物附魔(效率)影响
GetPlayerDestroyTotalTime客户端获取玩家破坏方块需要的时间,受玩家状态(急迫、潮涌、挖掘疲劳)和手持物及手持物附魔(效率)影响
GetPlayerExhaustionRatioByType服务端获取玩家某行为饥饿度消耗倍率
GetPlayerInteracteRange服务端获取玩家服务端的交互距离
GetPlayerMotions服务端获取玩家身上的所有运动器
GetPlayerRespawnPos服务端获取玩家复活点
GetRelevantPlayer服务端获取附近玩家id列表
IsEntityRiding服务端检查玩家是否骑乘。
IsInScaffolding客户端获取玩家是否与脚手架有交叉
IsOnLadder客户端获取玩家是否与梯子/藤蔓有交叉
IsPlayerCanFly服务端获取玩家能否飞行
IsPlayerFlying服务端获取玩家是否在飞行
OpenWorkBench服务端在玩家当前位置打开工作台UI,不依赖于工作台方块
PickUpItemEntity服务端某个Player拾取物品ItemEntity
PlayerAttackEntity服务端玩家使用手持武器攻击某个生物
PlayerDestoryBlock服务端使用手上工具破坏方块
PlayerUseItemToEntity服务端玩家使用手上物品对某个生物使用
PlayerUseItemToPos服务端模拟玩家对某个坐标使用物品
RemovePlayerMotion服务端移除玩家身上的运动器
SetBanPlayerFishing服务端设置是否屏蔽玩家钓鱼功能,屏蔽后玩家可以正常抛甩鱼竿,但无法钓起任何物品
SetInteracteCenterOffset服务端设置玩家服务端交互中心的偏移
SetPickCenterOffset客户端设置第三人称下,玩家客户端交互中心的偏移
SetPickRange客户端设置玩家客户端的交互距离
SetPickUpArea服务端设置玩家的拾取物品范围,设置后该玩家的拾取物品范围会在原版拾取范围的基础上进行改变。
SetPlayerAttackSpeedAmplifier服务端设置玩家攻击速度倍数,1.0表示正常水平,1.2表示速度减益20%,0.8表示速度增益20%
SetPlayerExhaustionRatioByType服务端设置玩家某行为饥饿度消耗倍率
SetPlayerInteracteRange服务端设置玩家服务端的交互距离
SetPlayerJumpable服务端设置玩家是否可跳跃
SetPlayerMotion服务端设置玩家的瞬时移动方向向量(可解决SetMotion闪现问题)
SetPlayerMovable服务端设置玩家是否可移动
SetPlayerRespawnPos服务端设置玩家复活的位置与维度
StartPlayerMotion服务端启动玩家身上的某个运动器
StopPlayerMotion服务端停止玩家身上的某个运动器
isGliding客户端是否鞘翅飞行
isInWater客户端是否在水中
isMoving客户端是否在行走
isRiding客户端是否骑乘
isSneaking服务端获取玩家是否处于潜行状态
isSneaking客户端是否潜行
isSprinting客户端是否在疾跑
isSwimming服务端获取玩家是否处于游泳状态。
isSwimming客户端是否游泳
setMoving客户端设置是否行走,只能设置本地玩家(只适用于移动端)
setSneaking客户端设置是否潜行,只能设置本地玩家(只适用于移动端)
setSprinting客户端设置行走模式为疾跑/冲刺,只能设置本地玩家(只适用于移动端)
setUsingShield客户端激活盾牌状态

渲染

接口
描述
AddPlayerAnimation客户端增加玩家渲染动画
AddPlayerAnimationController客户端增加玩家渲染动画控制器
AddPlayerAnimationIntoState客户端在玩家的动画控制器中的状态添加动画或者动画控制器
AddPlayerGeometry客户端增加玩家渲染几何体
AddPlayerParticleEffect客户端增加玩家特效资源
AddPlayerRenderController客户端增加玩家渲染控制器
AddPlayerRenderMaterial客户端增加玩家渲染需要的材质
AddPlayerScriptAnimate客户端在玩家的客户端实体定义(minecraft:client_entity)json中的scripts/animate节点添加动画/动画控制器
AddPlayerSoundEffect客户端增加玩家音效资源
AddPlayerTexture客户端增加玩家渲染贴图
RebuildPlayerRender客户端重建玩家的数据渲染器
RemovePlayerAnimationController客户端移除玩家渲染动画控制器
RemovePlayerGeometry客户端删除玩家渲染几何体
RemovePlayerRenderController客户端删除玩家渲染控制器
ResetSkin客户端还原默认皮肤
SetPlayerItemInHandVisible客户端设置是否隐藏玩家的手持物品模型显示
SetSkin客户端更换原版自定义皮肤

背包

接口
描述
AddEnchantToInvItem服务端给物品栏的物品添加附魔信息
AddModEnchantToInvItem服务端给物品栏中物品添加自定义附魔信息
ChangePlayerItemTipsAndExtraId服务端修改玩家物品的自定义tips和自定义标识符
ChangeSelectSlot服务端设置玩家当前选中快捷栏物品的index
GetCarriedItem客户端获取右手物品的信息
GetInvItemEnchantData服务端获取物品栏的物品附魔信息
GetInvItemModEnchantData服务端获取物品栏的物品自定义附魔信息
GetOffhandItem客户端获取左手物品的信息
GetPlayerAllItems服务端获取玩家指定的槽位的批量物品信息
GetPlayerAllItems客户端获取玩家指定的槽位的批量物品信息,支持获取盔甲栏,副手以及主手物品,背包物品仅支持本地玩家
GetPlayerItem服务端获取玩家物品,支持获取背包,盔甲栏,副手以及主手物品
GetPlayerItem客户端获取玩家物品,支持获取背包(本地玩家),盔甲栏,副手以及主手物品
GetSelectSlotId服务端获取玩家当前选中槽位
GetSlotId客户端获取当前手持的快捷栏的槽id
RemoveEnchantToInvItem服务端给物品栏的物品移除附魔信息
RemoveModEnchantToInvItem服务端给物品栏中物品移除自定义附魔信息
SetInvItemExchange服务端交换玩家背包物品
SetInvItemNum服务端设置玩家背包物品数目
SetPlayerAllItems服务端添加批量物品信息到指定槽位
SpawnItemToPlayerCarried服务端生成物品到玩家右手
SpawnItemToPlayerInv服务端生成物品到玩家背包

摄像机

接口
描述
AddCameraAroundEntityMotion客户端给相机添加对实体环绕运动器
AddCameraAroundPointMotion客户端给相机添加对点环绕运动器
AddCameraTrackMotion客户端给相机添加轨迹运动器
AddCameraVelocityMotion客户端给相机添加速度运动器
DepartCamera客户端分离玩家与摄像机
GetCameraAnchor客户端获取相机锚点
GetCameraMotions客户端获取相机上的所有运动器
GetCameraOffset客户端获取摄像机偏移量
GetCameraPitchLimit客户端获取摄像机上下角度限制值
GetCameraRotation客户端获取摄像机的朝向
GetForward客户端返回相机向前的方向
GetFov客户端获取视野大小
GetFpHeight客户端获取本地玩家当前状态下,第一人称视角时的摄像机高度偏移量。游泳时,滑翔时以及普通状态下会有所不同
GetPerspective客户端获取当前的视角模式
GetPosition客户端返回相机中心
IsModCameraLockPitch客户端是否锁定摄像机上下角度
IsModCameraLockYaw客户端是否锁定摄像机左右角度
LockCamera客户端锁定摄像机
LockModCameraPitch客户端锁定摄像机上下角度(第三人称下生效,锁定后不能上下调整视角)
LockModCameraYaw客户端锁定摄像机左右角度(第三人称下生效,锁定后不能通过鼠标左右调整视角)
LockPerspective客户端锁定玩家的视角模式
RemoveCameraMotion客户端移除相机上的某个运动器
ResetCameraBindActorId客户端将摄像机重新绑定回主角身上
SetCameraAnchor客户端设置相机锚点
SetCameraBindActorId客户端将摄像机绑定到目标实体身上(调用者与目标必须在同一个dimension,同时需要在加载范围之内,若绑定后目标离开了范围或者死亡,则会自动解除绑定)
SetCameraDistanceFixed客户端设置相机弹簧臂固定,即设置当相机遇到阻挡时是否压缩与人物之间的距离
SetCameraOffset客户端设置摄像机偏移量
SetCameraPitchLimit客户端设置摄像机上下角度限制值,默认是(-90,90)
SetCameraPos客户端设置相机中心的位置
SetCameraRotation客户端设定摄像机的朝向
SetFov客户端设置视野大小
SetPerspective客户端设置视角模式
SetPlayerFovScale客户端将渲染实际使用的fov变为设置中的fov乘以fovScale,fovScale越接近0,其效果越接近原版望远镜效果
SetSpeedFovLock客户端是否锁定相机视野fov,锁定后不随速度变化而变化
StartCameraMotion客户端启动相机上的某个运动器
StopCameraMotion客户端停止相机上的某个运动器
UnDepartCamera客户端绑定玩家与摄像机
UnLockCamera客户端解除摄像机锁定

动画

接口
描述
PlayTpAnimation客户端第三人称视角播放玩家通用动作
StopAnimation客户端停止播放玩家通用动作

游戏模式

接口
描述
GetPlayerGameType服务端获取指定玩家的游戏模式
GetPlayerGameType客户端获取指定玩家的游戏模式
SetPlayerGameType服务端设置玩家个人游戏模式

权限

接口
描述
GetPlayerAbilities服务端获取玩家具体权限
GetPlayerOperation服务端获取玩家权限类型信息
SetAttackMobsAbility服务端设置玩家能否攻击生物
SetAttackPlayersAbility服务端设置玩家能否攻击其他玩家
SetBuildAbility服务端设置玩家能否放置方块,该接口的设置会存档,且只影响生存模式
SetMineAbility服务端设置玩家能否摧毁方块,该接口的设置会存档,且只影响生存模式
SetOpenContainersAbility服务端设置玩家能否打开容器
SetOperateDoorsAndSwitchesAbility服务端设置玩家能否与门和开关交互
SetOperatorCommandAbility服务端设置玩家是否具有操作员命令权限
SetPermissionLevel服务端设置玩家权限等级
SetPlayerMute服务端设置玩家是否禁言,该接口的设置不存档
SetTeleportAbility服务端设置玩家能否使用TP指令

导航

接口
描述
GetNavPath客户端获取本地玩家到目标点的寻路路径,开发者可以通过该接口定制自定义的导航系统。
StartNavTo客户端我们提供了一个基于GetNavPath的导航系统实现,做法是在路径上生成序列帧以引导玩家通向目标点,并且当玩家偏离路径会重新进行导航。
StopNav客户端终止当前的导航

方块状态与附加值

接口
描述
GetBlockAuxValueFromStates服务端根据方块名称和方块状态获取方块附加值AuxValue
GetBlockStates服务端获取方块状态
GetBlockStatesFromAuxValue服务端根据方块名称和方块附加值AuxValue获取方块状态
SetBlockStates服务端设置方块状态

属性

接口
描述
GetBlockBasicInfo服务端获取方块基本信息
GetBlockTags服务端获取方块在tags:*中定义的tags列表
GetLoadBlocks服务端获取已经加载的方块id
SetBlockBasicInfo服务端设置方块基本信息
SetChestLootTable服务端设置箱子战利品表

方块实体

接口
描述
CleanBlockTileEntityCustomData服务端清空指定位置的特殊方块(箱子、头颅、熔炉、花盆等)绑定的TileEntity内存储的自定义数据。
CreateFrameEffectForBlockEntity客户端在自定义方块实体上创建序列帧特效,创建后该接口返回序列帧特效的Id,利用该Id可以使用特效/序列帧中的接口对该序列帧特效进行播放、设置位置、大小等操作。与实体的序列帧特效创建方式类似。
CreateParticleEffectForBlockEntity客户端在自定义方块实体上创建粒子特效,创建后该接口返回粒子特效的Id,利用该Id可以使用特效/粒子中的接口对该粒子特效进行播放、设置位置、大小等操作。与实体的粒子特效创建方式类似。若自定义方块实体已存在键值名称相同的特效,则不会创建新的特效,接口返回已有的特效Id。
ExecuteCommandBlock服务端执行一次命令方块
GetBlockEntityData服务端用于获取可操作某个自定义方块实体数据的对象,操作方式与dict类似
GetBlockEntityData服务端用于获取方块(包括自定义方块)的数据,如需修改,请使用setblockentitydata接口
GetBlockEntityData客户端用于获取客户端当前维度中方块(包括自定义方块)的数据,数据只读不可写,无法获取箱子内的物品信息。
GetBlockEntityMolangValue客户端获取自定义方块实体的Molang变量的值。
GetBlockTileEntityCustomData服务端读取指定位置的特殊方块(箱子、头颅、熔炉、花盆等)绑定的TileEntity内存储的自定义数据
GetBlockTileEntityWholeCustomData服务端读取指定位置的特殊方块(箱子、头颅、熔炉、花盆等)绑定的TileEntity内存储的自定义数据字典。
GetCommandBlock服务端获取命令方块的设置内容
GetFrameEffectIdInBlockEntity客户端获取在自定义方块实体中已创建的指定序列帧特效的Id,已创建的特效分为两种:一是通过resource_pack/entity/下的实体json文件中使用“netease_frame_effects”所定义的特效;二是使用接口CreateFrameEffectForBlockEntity创建的特效。 返回的特效Id可以使用特效/序列帧中的接口对该序列帧特效进行播放、设置位置、大小等操作。与实体的序列帧特效创建方式类似。
GetFrameItem服务端获取物品展示框的物品
GetFrameItemDropChange服务端获取物品展示框里物品的掉落几率
GetFrameRotation服务端获取物品展示框里物品的顺时针旋转角度
GetHopperSpeed服务端获取漏斗运输一个物品所需的时间(单位:刻)
GetParticleEffectIdInBlockEntity客户端获取在自定义方块实体中已创建的指定粒子特效的Id,已创建的特效分为两种:一是通过resource_pack/entity/下的实体json文件中使用“netease_particle_effects”所定义的特效;二是使用接口CreateParticleEffectForBlockEntity创建的特效。 返回的特效Id可以使用特效/粒子中的接口对该粒子特效进行播放、设置位置、大小等操作。与实体的粒子特效创建方式类似。
RemoveFrameEffectInBlockEntity客户端移除在自定义方块实体上创建的序列帧特效。移除后的特效Id将会失效。
RemoveParticleEffectInBlockEntity客户端移除在自定义方块实体上创建的粒子特效。移除后的特效Id将会失效。
SetBlockEntityData服务端用于设置方块(包括自定义方块)的数据
SetBlockEntityMolangValue客户端设置自定义方块实体的Molang变量,与实体的molang变量作用相同。目前主要用于控制自定义实体的动画状态转变。Molang变量的定义方式与原版实体的Molang变量定义方法相同。详细可参考自定义方块实体动画的教学文档。
SetBlockTileEntityCustomData服务端设置指定位置的特殊方块(箱子、头颅、熔炉、花盆等)绑定的TileEntity内存储的自定义数据。
SetCommandBlock服务端对命令方块进行内容设置
SetEnableBlockEntityAnimations客户端设置是否开启自定义方块实体的动画效果,开启之后,自定义实体方块会按照实体文件中animation_controller所定义的动画状态机进行动画播放。关闭之后,则会停止所有动画播放。
SetFrameItem服务端设置物品展示框的物品
SetFrameItemDropChange服务端设置点击物品展示框时生成掉落的几率,默认为1
SetFrameRotation服务端设置物品展示框里物品的顺时针旋转角度
SetHopperSpeed服务端设置漏斗运输一个物品所需的时间(单位:红石刻,1秒10刻),默认值为4刻,该设置存档

方块几何体模型

接口
描述
CombineBlockBetweenPosToGeometry客户端根据输入的两个位置,搜索这两个位置之间的所有方块,并将这些方块合并和转换为能用于实体的几何体模型。
CombineBlockFromPosListToGeometry客户端根据输入的方块位置列表,搜索这些位置的所有方块,并将这些方块合并和转换为能用于实体的几何体模型。
CombineBlockPaletteToGeometry客户端将BlockPalette中的所有方块合并并转换为能用于实体的几何体模型。
EnableActorBlockGeometryTransparent客户端设置是否允许实体的方块几何体模型产生透明度,允许开启后通过调节方块几何体的透明度将会使得方块几何体模型变得透明。
GetActorBlockGeometryScale客户端获取实体的方块几何体模型的缩放倍率。
SetActorBlockGeometryOffset客户端设置实体的方块几何体模型的位置偏移。
SetActorBlockGeometryRotation客户端设置实体的方块几何体模型的旋转角度。
SetActorBlockGeometryScale客户端设置实体的方块几何体模型的缩放倍率。
SetActorBlockGeometryTransparency客户端设置实体的方块几何体模型的透明度。注意,只有调用接口EnableActorBlockGeometryTransparent开启了方块几何体模型的透明度后该接口才会生效。

方块调色板

接口
描述
DeleteBlockInBlockPalette服务端
客户端
删除方块调色板BlockPalette中某个类型的方块。
DeserializeBlockPalette服务端
客户端
反序列化方块调色板数据字典中的数据,用于方块调色板在客户端及服务端的事件数据之间传输。
GetBlockCountInBlockPalette服务端
客户端
获取方块调色板BlockPalette中某个类型的方块的数量。
GetLocalPosListOfBlocks服务端
客户端
获取方块调色板中某种方块的相对位置列表。方块调色板记录了多个方块组成的一个三维空间下的方块组合,而相对位置则指的是,以这些方块中最小坐标的方块所在位置作为原点的坐标轴下的相对位置。
GetVolumeOfBlockPalette服务端
客户端
获取方块调色板BlockPalette所占据的长方体的长宽高。长指的是在方块调色板BlockPalette在世界坐标中占据的x轴方向的长度,宽指的是z轴方向的长度,高指的是y轴方向的长度。
ReplaceAirByStructureVoid服务端
客户端
设置是否将方块调色板BlockPalette中所有空气替换为结构空位。
ReplaceBlockInBlockPalette服务端
客户端
替换方块调色板BlockPalette中某个类型的方块。
SerializeBlockPalette服务端
客户端
序列化方块调色板中的数据,用于方块调色板在客户端及服务端的事件数据之间传输。

渲染

接口
描述
AddDropItemToWorld客户端在客户端添加一个掉落物渲染
ChangeBlockTextures客户端替换方块贴图
DeleteClientDropItemEntity客户端删除AddDropItemToWorld创建的客户端掉落物
GetBlockEntityExtraUniforms客户端获取在自定义方块实体的shader当中使用的自定义变量的值,该自定义变量总共可设置EXTRA_ACTOR_UNIFORM1,EXTRA_ACTOR_UNIFORM2,EXTRA_ACTOR_UNIFORM3,EXTRA_ACTOR_UNIFORM4,总共4组,每组为一个vec4(float, float, float ,float)类型的向量。
GetBlockRenderDistance客户端获取玩家周围的可渲染距离
GetBlockTextures客户端获取方块的初始贴图信息
GetClientDropItemEntityIdList客户端获得所有通过AddDropItemToWorld创建的entityId的list
SetBlockEntityExtraUniforms客户端设置可在自定义方块实体的shader当中使用的自定义变量的值,该自定义变量总共可设置EXTRA_ACTOR_UNIFORM1,EXTRA_ACTOR_UNIFORM2,EXTRA_ACTOR_UNIFORM3,EXTRA_ACTOR_UNIFORM4,总共4组,每组为一个vec4(float, float, float ,float)类型的向量,向量的默认值为(1.0,1.0,1.0,1.0)。
SetBlockEntityFramePosOffset客户端设置自定义方块实体中序列帧特效位置偏移值,用于调整序列帧特效相对于方块位置的偏移。与特效/序列帧/SetPos接口不同,该接口调整的是相对于方块位置的位置偏移值,而不是世界坐标。
SetBlockEntityModelPosOffset客户端设置自定义方块实体的实体模型位置偏移值,用于调整实体模型相对于方块位置的偏移。可通过该接口来调整自定义方块实体的实体模型的位置。只有自定义方块实体定义实体模型才生效,实体模型在resource_pack/entity/下定义,详细可参考自定义方块实体动画的教学文档。
SetBlockEntityModelRotation客户端设置自定义方块实体的实体模型在各个轴上的旋转值,可通过该接口来调整自定义方块实体的实体模型的旋转。只有自定义方块实体定义实体模型才生效,实体模型在resource_pack/entity/下定义,详细可参考自定义方块实体动画的教学文档。
SetBlockEntityModelScale客户端设置自定义方块实体的实体模型大小的缩放值,可通过该接口来调整自定义方块实体的实体模型的大小。只有自定义方块实体定义实体模型才生效,实体模型在resource_pack/entity/下定义,详细可参考自定义方块实体动画的教学文档。
SetBlockEntityParticlePosOffset客户端设置自定义方块实体中粒子特效位置偏移值,用于调整粒子特效相对于方块位置的偏移。与特效/粒子/SetPos接口不同,该接口调整的是相对于方块位置的位置偏移值,而不是世界坐标。
SetBlockRenderDistance客户端设置玩家周围方块的可渲染距离

容器

接口
描述
GetBrewingStandSlotItem服务端获取酿造台指定槽位物品
GetChestBoxSize服务端获取箱子容量大小
GetChestPairedPosition服务端获取与箱子A合并成一个大箱子的箱子B的坐标
GetContainerItem服务端获取容器内的物品
GetContainerSize服务端获取容器容量大小
GetEnderChestItem服务端获取末影箱内的物品
GetInputSlotItem服务端获取熔炉输入栏物品, 支持使用下面参数清空特定槽位:itemDict为空,为{}, 或itemName为minecraft:air,或者count为0
GetOpenContainerItem服务端获取开放容器的物品
GetOutputSlotItem服务端获取熔炉输出栏物品
GetPlayerUIItem服务端获取合成容器的物品
SetBrewingStandSlotItem服务端设置酿造台指定槽位物品
SetChestBoxItemExchange服务端交换箱子里物品的槽位
SetChestBoxItemNum服务端设置箱子槽位物品数目
SetInputSlotItem服务端设置熔炉输入栏物品
SetPlayerUIItem服务端设置合成容器的物品
SpawnItemToContainer服务端生成物品到容器方块的物品栏
SpawnItemToEnderChest服务端生成物品到末影箱

红石

接口
描述
GetBlockPoweredState服务端获取某个坐标方块的充能状态
GetStrength服务端获取某个坐标的红石信号强度

告示牌

接口
描述
GetSignBlockText服务端获取告示牌(方块)的文本内容
GetSignTextStyle服务端获取告示牌的文本样式信息
SetSignBlockText服务端设置告示牌(方块)的文本内容
SetSignTextStyle服务端设置告示牌的文本样式

接口
描述
GetBedColor服务端获取床(方块)的颜色
SetBedColor服务端设置床(方块)的颜色

物品

接口
描述
CancelShearsDestoryBlockSpeed服务端取消剪刀对某一方块的破坏速度设置
CancelShearsDestoryBlockSpeedAll服务端取消剪刀对全部方块的破坏速度设置
ChangeArmorTextures客户端修改盔甲在场景中显示和在UI中显示的贴图
ChangeItemTexture客户端替换物品的贴图,修改后所有用到该贴图的物品都会被改变,后续创建的此类物品也会被改变。会同时修改物品在UI界面上的显示,手持时候的显示与场景掉落的显示。
GetAllEnchantsInfo服务端获取目前已注册的所有附魔信息
GetAllEnchantsInfo客户端获取目前已注册的所有附魔信息
GetCustomName服务端获取物品的自定义名称,与铁砧修改的名称一致
GetItemBasicInfo服务端获取物品的基础信息
GetItemBasicInfo客户端获取物品的基础信息
GetItemDefenceAngle服务端获取盾牌物品的抵挡角度范围
GetItemDurability服务端获取指定槽位的物品耐久
GetItemEffectName客户端获取物品的状态描述,如:§7保护 0§r
GetItemFormattedHoverText客户端获取物品的格式化hover文本,如:§f灾厄旗帜§r
GetItemHoverName客户端获取物品的hover名称,如:灾厄旗帜§r
GetItemInfoByBlockName服务端通过方块名称及aux值获取物品信息
GetItemLayer服务端获取物品的叠加贴图。物品叠加贴图详见SetItemLayer
GetItemMaxDurability服务端获取指定槽位的物品耐最大耐久
GetItemTags服务端获取物品在minecraft:tags中定义的tags列表
GetItemTags客户端获取物品在minecraft:tags中定义的tags列表
GetItemTexture客户端获取item_texture.json中物品的贴图路径。
GetLoadItems服务端获取已经加载的物品id
GetUserDataInEvent服务端使物品相关服务端事件的物品信息字典参数带有userData。在mod初始化时调用即可
GetUserDataInEvent客户端使物品相关客户端事件的物品信息字典参数带有userData。在mod初始化时调用即可
LookupItemByName服务端判定指定identifier的物品是否存在
RemoveItemLayer服务端移除物品的叠加贴图。物品叠加贴图详见SetItemLayer
SetAttackDamage服务端设置物品的攻击伤害值
SetCompassEntity客户端设置指南针朝向的实体
SetCompassTarget客户端设置指南针的朝向位置
SetCustomName服务端设置物品的自定义名称,与使用铁砧重命名一致
SetItemDefenceAngle服务端设置盾牌物品的抵挡角度范围
SetItemDurability服务端设置物品的耐久值
SetItemLayer服务端设置物品的叠加贴图,可以在物品的上层与下层叠加自定义贴图。具体使用可参考CustomItemsMod示例。
SetItemMaxDurability服务端设置物品的最大耐久值
SetItemTierLevel服务端设置工具类物品的挖掘等级
SetItemTierSpeed服务端设置工具类物品的挖掘速度(可通过userData中的ModTierSpeed获取挖掘速度)
SetMaxStackSize服务端设置物品的最大堆叠数量(存档)
SetShearsDestoryBlockSpeed服务端设置剪刀对某一方块的破坏速度

通用

接口
描述
DestroyEntity客户端销毁特效

文字面板

接口
描述
CreateTextBoardInWorld客户端创建文字面板
RemoveTextBoard客户端删除文字面板
SetBoardBackgroundColor客户端修改背景颜色
SetBoardBindEntity客户端文字面板绑定实体对象
SetBoardDepthTest客户端设置是否开启深度测试, 默认状态下是开启
SetBoardFaceCamera客户端设置文字面板的朝向
SetBoardPos客户端修改位置
SetBoardRot客户端修改旋转角度, 若设置了文本朝向相机,则旋转角度的修改不会生效
SetBoardScale客户端内容整体缩放
SetBoardTextColor客户端修改字体颜色
SetText客户端修改文字面板内容

序列帧

接口
描述
Bind客户端绑定entity
Bind客户端绑定骨骼模型
CreateEngineSfx客户端创建序列帧特效
CreateEngineSfxFromEditor客户端指使用资源包中effects/xxx.json,按照编辑器中编辑好的参数创建序列帧。支持环状序列帧
GetPos客户端获取序列帧特效的位置
GetRot客户端获取序列帧特效的旋转角度
GetScale客户端获取序列帧特效的缩放值
Pause客户端暂停播放,序列帧定格在当前时刻,再次调用Play时继续播放
Play客户端播放序列帧
SetDeepTest客户端设置序列帧是否透视,默认为否
SetFaceCamera客户端设置序列帧是否始终朝向摄像机,默认为是
SetFadeDistance客户端设置序列帧开始自动调整透明度的距离。序列帧与摄像机之间的距离小于该值时会自动调整序列帧的透明度,距离摄像机越近,序列帧越透明
SetGlobal客户端设置序列帧是否是全局的,默认为否
SetLayer客户端设置序列帧渲染层级,默认层级为1,当层级不为1时表示该特效开启特效分层渲染功能。特效(粒子和帧动画)分层渲染时,层级越高渲染越靠后,层级大的会遮挡层级低的,且同一层级的特效会根据特效的相对位置产生正确的相互遮挡关系。
SetLoop客户端设置序列帧是否循环播放,默认为否
SetMixColor客户端设置序列帧混合颜色
SetPos客户端设置序列帧的位置
SetRot客户端设置序列帧的旋转
SetRotUseZXY客户端设置序列帧的旋转,旋转顺序按照绕z,x,y轴旋转
SetScale客户端设置序列帧的缩放
SetUsePointFiltering客户端设置序列帧是否使用点滤波
Stop客户端停止序列帧(不是暂停)

粒子

接口
描述
Bind客户端绑定entity
Bind客户端绑定骨骼模型
CreateEngineParticle客户端用于创建粒子特效
GetParticleEmissionRate客户端获取粒子发射器每帧发射粒子的频率。
GetParticleMaxNum客户端获取粒子发射器包含的最大粒子数量。
GetParticleMaxSize客户端获取粒子特效中粒子大小的最大值。
GetParticleMinSize客户端获取粒子特效中粒子大小的最小值。
GetParticleVolumeSize客户端获取粒子发射器的体积大小缩放值。
GetPos客户端获取粒子发射器的世界坐标位置
GetRot客户端获取粒子发射器的旋转角度
Pause客户端暂停播放,粒子定格在当前时刻,再次调用Play时继续播放
Play客户端播放粒子特效
SetFadeDistance客户端设置粒子开始自动调整透明度的距离。粒子与摄像机之间的距离小于该值时会自动调整粒子的透明度,距离摄像机越近,粒子越透明
SetGlobal客户端设置粒子发射器是否为全局粒子发射器, 默认是False
SetLayer客户端粒子默认层级为1,当层级不为1时表示该特效开启特效分层渲染功能。特效(粒子和帧动画)分层渲染时,层级越高渲染越靠后,层级大的会遮挡层级低的,且同一层级的特效会根据特效的相对位置产生正确的相互遮挡关系。
SetParticleEmissionRate客户端设置粒子发射器每帧发射粒子的频率,频率越大则每帧发射的粒子数量越多,但粒子数量不会超过粒子发射器的粒子容量,同时由于性能考虑,每帧发射的粒子数量也不会超过100个。
SetParticleMaxNum客户端设置粒子发射器的粒子容量,即粒子发射器所包含的最大粒子数量。该数量并不代表目前粒子发射器所发射的粒子数量,如需要增加发射的粒子数量,需同时改变粒子的发射频率。
SetParticleSize客户端设置粒子特效中粒子大小的最小值及最大值。
SetParticleVolumeSize客户端设置粒子发射器的体积大小缩放,不影响单个粒子的尺寸。粒子发射器的体积越大,则粒子的发射范围越大。
SetPos客户端设置粒子发射器的世界坐标位置
SetRelative客户端当粒子绑定了entity或骨骼模型时,发射出的粒子使用entity坐标系还是世界坐标系。与mcstudio特效编辑器中粒子的“相对挂点运动”选项功能相同。
SetRotUseZXY客户端设置粒子发射器的旋转,旋转顺序按照绕z,x,y轴旋转
SetUsePointFiltering客户端设置粒子材质的纹理滤波是否使用点滤波方法。默认为使用双线性滤波
Stop客户端停止粒子播放

模型特效

接口
描述
CreateEngineEffectBind客户端指用编辑器保存资源包中models/bind/xxx_bind.json生成编辑好的所有挂点的所有特效。生成的特效会自动进行挂接及播放,编辑器中设为不可见的特效也会进行播放。并且使用这种方式创建的特效,开发者不用维护entity进出视野导致的挂接特效被移除,引擎会在entity每次进入视野时自动创建所有特效。
Pause客户端暂停模型特效(即使用CreateEngineEffectBind创建的特效)
Resume客户端继续播放模型特效(即使用CreateEngineEffectBind创建的特效)

微软粒子

接口
描述
BindEntity客户端绑定粒子发射器到指定实体的指定骨骼上
BindModel客户端绑定粒子发射器到指定骨骼模型的指定骨骼上
Create客户端创建粒子发射器, 创建后立即播放
CreateBindEntityNew客户端创建粒子发射器并绑定到指定实体的指定骨骼上, 创建后立即播放
EmitManually客户端手动发射粒子一次
Exist客户端判断指定粒子发射器是否存在
GetActiveDuration客户端获取粒子发射器的激活周期
GetBindingID客户端返回粒子绑定的实体id,没有则返回"0"
GetBindingModelID客户端返回绑定的骨骼模型id 没有则返回-1
GetDuration客户端获取粒子发射器的播放周期(激活+休眠时间)
GetFacingMode客户端返回粒子发射器的粒子朝向模式
GetLoopAge客户端获取粒子发射器当前播放周期内已播放的时间
GetPos客户端获取粒子发射器位置
GetRot客户端获取粒子发射器局部旋转
GetSleepDuration客户端获取粒子发射器的休眠周期
GetTimeScale客户端获取粒子发射器的播放速度
GetVariable客户端获取粒子发射器的Molang变量值
Hide客户端隐藏粒子发射器(不渲染)
IsHiding客户端返回粒子发射器是否正在被隐藏(不渲染)
IsPausing客户端返回粒子发射器的逻辑是否正在被暂停
Pause客户端暂停粒子发射器的逻辑更新,但保持渲染状态
Play客户端播放粒子发射器
PlayAt客户端设置粒子发射器播放时间点
Remove客户端销毁指定粒子发射器
RemoveByName客户端销毁场景中指定名称(粒子发射器json中的identifier)的所有粒子发射器
Replay客户端重播粒子发射器
Resume客户端恢复粒子发射器的逻辑更新,不影响渲染状态
SetPos客户端设置粒子发射器位置
SetRelative客户端设置粒子是否在局部空间进行计算
SetRot客户端设置粒子发射器局部旋转
SetRotUseZXY客户端设置粒子发射器局部旋转,旋转顺序按照绕z,x,y轴旋转
SetTimeScale客户端设置粒子发射器的播放速度
SetVariable客户端设置粒子发射器的Molang变量值
Show客户端显示粒子发射器(开启渲染)
Stop客户端停止粒子发射器播放(不渲染且不更新逻辑)
Unbind客户端解除指定粒子发射器的绑定状态

模型

接口
描述
BindItemToBone客户端将使用了骨骼模型的玩家的手持物绑定到指定的骨骼上
BindModelToEntity客户端实体替换骨骼模型后,再往上挂接其他骨骼模型。
BindModelToModel客户端在骨骼模型上挂接其他骨骼模型
CancelAllBoneMask客户端取消动画中的所有骨骼屏蔽。
CreateFreeModel客户端创建自由的模型(无需绑定Entity)
GetAllBindModelToEntity客户端获取实体上某个骨骼上挂接的所有骨骼模型的id
GetAnimLength客户端获取某个骨骼动画的长度,单位为秒
GetBonePositionFromMinecraftObject客户端获取原版模型的骨骼世界坐标
GetBoneWorldPos客户端获取骨骼的坐标
GetEntityBoneWorldPos客户端获取换了骨骼模型的实体的骨骼坐标
GetEntityScale服务端获取实体的放缩比例大小
GetExtraUniformValue客户端获取在骨骼模型shader中使用的自定义变量Uniform的值
GetModelId客户端获取骨骼模型的Id,主要用于特效绑定骨骼模型
GetModelMaterial客户端获取骨骼模型的正在使用的材质名称,也可获取骨骼模型中指定骨骼所使用的材质名称。如果获取指定骨骼所使用的材质,需要先在netease_model.json下设置"useSplitMeshes"字段为true。
GetModelName服务端获取实体的模型名称
GetModelStyle客户端获取模型类型
GetPlayingAnimList客户端获取指定的骨骼模型中正处于播放状态的骨骼动画名称列表
GetTexture客户端获取骨骼模型的贴图路径
HideModel客户端隐藏纯模型
ModelPlayAni客户端纯骨骼播放动作。 支持骨骼动画混合,可参考SetAnimationBoneMask接口以及RegisterAnim1DControlParam接口说明。
ModelStopAni客户端暂停指定的骨骼动画
PlayAnim客户端播放骨骼动画
RegisterAnim1DControlParam客户端当同时播放多个骨骼动画时,新建用于控制动画进行1D线性混合的参数。目前线性混合仅支持对两个动画进行混合。新建的参数值范围为[0,1]。指定的骨骼将会按照这个参数的值对两个动画进行线性混合。
RegisterAnim1DMultiControlParam客户端当同时播放多个骨骼动画时,注册用于根据权重控制多动画进行混合的参数
RemoveAnim1DMultiControlParam客户端删除用于根据权重控制多动画进行混合的参数
RemoveFreeModel客户端移除自由模型
ResetModel客户端恢复实体为原版模型
SetAnim1DControlParam客户端新建动画的1D控制参数后,使用该接口对相应的参数进行控制。
SetAnim1DMultiControlParam客户端新建动画的1D控制参数后,设置用于根据权重控制多动画进行混合的参数
SetAnimLayer客户端设置骨骼动画的层级,动画层级越大,则优先度越高,骨骼模型的骨骼优先播放优先度最高的动画,相同层级的动画则优先播放率先播放的动画。
SetAnimSpeed客户端设置某个骨骼动画的播放速度
SetAnimationAllBoneMask客户端设置是否屏蔽动画中所有骨骼的动画,若开启骨骼屏蔽后,该骨骼将不再播放该动画中的动作。该接口会对该动画中所有骨骼生效,可通过参数ignoreBoneList来指定不受影响的骨骼名称。通过屏蔽指定骨骼的动画可实现同一个骨骼模型同时在不同骨骼上播放不同的动作动画,从而实现快捷的动作融合。
SetAnimationBoneMask客户端设置是否屏蔽动画中指定的骨骼的动画,若开启骨骼屏蔽后,该骨骼将不再播放该动画中的动作。通过屏蔽指定骨骼的动画可实现同一个骨骼模型同时在不同骨骼上播放不同的动作动画,从而实现快捷的动作融合。
SetBrightness客户端设置实体的亮度
SetEntityOpacity客户端设置骨骼模型的透明度,只能对骨骼模型生效,如果设置的是原版模型,则模型的影子会被隐藏。
SetEntityScale服务端设置实体的放缩比例大小,设置比例过大会导致游戏卡顿,建议控制在20倍以内
SetEntityShadowShow客户端设置实体打开/关闭影子渲染
SetExtraUniformValue客户端设置shader中特定Uniform的值
SetFreeModelAniSpeed客户端设置自由模型动画的播放速度
SetFreeModelBoundingBox客户端设置自由模型的包围盒
SetFreeModelPos客户端设置自由模型的位置
SetFreeModelRot客户端设置自由模型的方向
SetFreeModelScale客户端设置自由模型的大小
SetLegacyBindRot客户端用于修复特效挂接到骨骼时的方向
SetModel服务端设置骨骼模型
SetModel客户端替换实体的骨骼模型
SetModelMaterial客户端设置骨骼模型所使用的的材质,除了可以设置骨骼模型所使用的自定义材质以外,也可对单个骨骼设置所使用的自定义材质。如果需要设置单个骨骼所使用的材质,需要先在netease_model.json下设置"useSplitMeshes"字段为true。
SetModelMultiPassMaterial客户端设置骨骼模型多pass中使用到的材质列表,也可对单个骨骼设置所使用的自定义多Pass材质。如果需要设置单个骨骼所使用的多Pass材质,需要先在netease_model.json下设置"useSplitMeshes"字段为true。
SetModelOffset服务端设置骨骼模型相对于局部坐标系的偏移量,初始值为(0, 0, 0)
SetModelOffset客户端模型增加偏移量
SetModelPartVisible客户端对骨骼模型中指定的骨骼进行渲染屏蔽,屏蔽后该骨骼不会被渲染出来。
SetModelPerspectiveEffect客户端设置模型透视效果。注:只对自定义骨骼模型生效
SetModelTexture服务端设置骨骼模型贴图,该接口与SetTexture功能相同,但属于服务端接口。
SetShowArmModel客户端设置使用骨骼模型后切换至第一人称时是否显示手部模型。需要先为骨骼模型定义arm_model,arm_model的定义可参考demo示例-AwesomeMod中的resourcePack/models/netease_models.json中的大天狗模型定义
SetTexture客户端设置骨骼模型的贴图,该接口与SetModelTexture功能相同,但属于客户端接口。
ShowCommonHurtColor服务端设置挂接骨骼模型的实体是否显示通用的受伤变红效果
ShowCommonHurtColor客户端设置挂接骨骼模型的实体是否显示通用的受伤变红效果
ShowModel客户端显示纯模型
UnBindModelToEntity客户端取消实体上挂接的某个骨骼模型。取消挂接后,这个modelId的模型便会销毁,无法再使用,如果是临时隐藏可以使用HideModel
UnBindModelToModel客户端取消骨骼模型上挂接的某个骨骼模型。取消挂接后,这个modelId的模型便会销毁,无法再使用,如果是临时隐藏可以使用HideModel

原生UI

接口
描述
ChangeSneakState客户端切换潜行状态
ClickInteractGUI客户端模拟点击交互按钮,交互按钮指的在喂食、钓鱼、交易等交互场景出现的按钮
GetOriginAreaOffset客户端获取指定原生UI的offset,包括左上角和右下角
GetScreenSize客户端获取游戏分辨率
GetScreenViewInfo客户端获取游戏视角信息。首先获得当前分辨率下UI放大倍数,计算方式可参考《我的世界》界面适配方法。则当前游戏视角的宽度的计算方式为:若当前分辨率的宽度能被该放大倍数整除,则等于当前分辨率,若不能,则等于当前分辨率加放大倍数再减去当前分辨率对放大倍数求余的结果,当前游戏视角的高度计算方法类似。例:以分辨率为1792,828的手机计算,画布是分辨率的3倍,所以x = 1792 + 3 - 1 = 1794;y = 828,该接口返回的结果为(1794.0, 828.0, 0.0, 0.0)
GetWalkState客户端获取玩家行走/潜行/跑步状态
HideAirSupplyGUI客户端隐藏玩家氧气值界面
HideArmorGui客户端隐藏hud界面的护甲值显示
HideChangePersonGui客户端隐藏切换人称的按钮。隐藏后点击相应位置不会响应
HideChatGUI客户端隐藏聊天按钮原生UI。该接口在开启新版聊天时不生效
HideCrossHairGUI客户端隐藏hud界面的十字准心显示
HideEmoteGUI客户端设置是否开启表情功能,默认PC端关闭,手机端开启,且该接口只能在手机端使用。该接口在开启新版聊天时不生效
HideExpGui客户端非创造者模式下隐藏经验条显示
HideFoldGUI客户端隐藏下拉按钮原生UI。
HideHealthGui客户端隐藏hud界面的血量显示
HideHorseHealthGui客户端隐藏hud界面的坐骑的血量显示
HideHudGUI客户端隐藏HUD游戏界面的游戏原生UI。与原版F1按钮效果一致,只隐藏显示,但点击跳跃键等位置依然会响应
HideHungerGui客户端隐藏hud界面的饥饿值显示
HideInteractGui客户端隐藏交互按钮。隐藏后点击相应位置不会响应
HideJumpGui客户端隐藏游戏中右下角的跳跃按钮。隐藏后点击相应位置不会响应
HideMoveGui客户端隐藏游戏中左下角的移动按钮。隐藏后点击相应位置不会响应
HideNeteaseStoreGui客户端隐藏游戏中的网易商店按钮。隐藏后点击相应位置不会响应
HidePauseGUI客户端隐藏暂停按钮原生UI。
HideReportGUI客户端隐藏举报按钮原生UI。
HideSlotBarGui客户端隐藏游戏中底部中间的物品栏界面
HideSneakGui客户端隐藏游戏中左下角方向键的中心处潜行按钮。隐藏后点击相应位置不会响应
HideSwimGui客户端隐藏游戏中的浮潜按钮。隐藏后点击相应位置不会响应。仅影响十字键操作下的浮潜按钮,摇杆模式上浮=跳跃,下潜=潜行,需要通过HideJumpGui和HideSneakGui来隐藏
HideVoiceGUI客户端隐藏语音按钮原生UI。该接口在开启新版聊天时不生效
HideWalkGui客户端隐藏游戏中跑/走按钮。隐藏后点击相应位置不会响应
OpenChatGui客户端打开原版聊天栏
OpenEmoteGui客户端打开表情界面
OpenFoldGui客户端打开原版下拉界面
OpenInventoryGui客户端打开原版背包界面,并支持选中某个分页(支持自定义分页名称)
OpenNeteaseStoreGui客户端打开游戏中的网易商店购买商品界面
OpenPauseGui客户端打开原版暂停界面
OpenReportGui客户端打开原版举报界面
OpenVoiceGui客户端打开原版语音界面
PlayHudHeartBlinkAnim客户端播放原版受伤时血量变化的动效
SetCrossHair客户端设置是否使用“准星瞄准”
SetEmoteSwitch客户端设置是否开启表情功能,默认PC端关闭,手机端开启,且该接口只能在手机端使用,在原生UI初始化前调用设置
SetHudChatStackPosition客户端设置HUD界面左上小聊天窗口位置
SetHudChatStackVisible客户端设置HUD界面左上小聊天窗口可见性
SetResponse客户端设置原生UI是否响应
SimulateJump客户端模拟跳跃

通用

接口
描述
CheckCanBindUI客户端检查实体是否可以绑定头顶UI,如何将UI与实体绑定详见CreateUI接口
CreateUI客户端创建UI,详见界面创建流程及生命周期
EnableFontBatchRender客户端是否开启字体合批
GetCustomUIControlProxyCls客户端获得原生界面自定义UI代理基类
GetMiniMapScreenNodeCls客户端获取小地图ScreenNode基类
GetNativeScreenManagerCls客户端获得NativeScreenManager类
GetScreenNodeCls客户端获得ScreenNode类
GetTopScreen客户端获取UI堆栈栈顶的UI节点
GetTopUI客户端获取UI栈顶的UI名称
GetTopUINode客户端获取Push进来的最顶层界面,包括原生界面,详见 界面创建流程及生命周期
GetUI客户端获取UI节点,详见界面创建流程及生命周期
GetUIScreenProxyCls客户端获得原生界面Screen代理基类
GetViewBinderCls客户端获得ViewBinder类
GetViewViewRequestCls客户端获得ViewRequest类
OpenDeveloperHomeWindow客户端打开网易资源中心开发者主页。该接口只能在横屏版本手机端使用
OpenResourceCenterDetailWindow客户端打开网易资源中心组件详情界面。该接口只能在横屏版本手机端使用
PopScreen客户端使用堆栈管理的方式关闭UI
PopTopUI客户端弹出UI栈顶的UI
PushScreen客户端使用堆栈管理的方式创建UI
RegisterUI客户端注册UI,创建UI前,需要先注册UI。同一UI只需要注册一次即可。详见界面创建流程及生命周期
RegisterUIAnimations客户端注册UI动画
UnregisterUIAnimation客户端取消UI动画的注册

自定义书本

接口
描述
GetBookManager客户端获取书本管理对象

自定义成就系统

接口
描述
AddNodeProgress服务端增加对应玩家的对应成就节点的成就进度
GetAchievementGatePosition客户端获取自定义成就系统的入口按钮位置
GetChildrenNode服务端获得该成就节点的下一级所有孩子节点的list
GetNodeDetailInfo服务端获取对应玩家的对应节点信息
SetAchievementGatePosition客户端设置自定义成就系统的入口按钮位置
SetNodeFinish服务端设置对应玩家的对应成就节点完成

UI界面

接口
描述
BindVirtualWorldModel客户端绑定虚拟世界中的模型
ChangeBindAutoScale客户端设置已绑定实体的UI是否根据绑定实体与本地玩家间的距离动态缩放,只对已绑定实体的UI界面生效,如何将UI与实体绑定详见CreateUI接口
ChangeBindEntityId客户端修改绑定的实体id,只对已绑定实体的UI界面生效,如何将UI与实体绑定详见CreateUI接口
ChangeBindOffset客户端修改与绑定实体之间的偏移量,只对已绑定实体的UI界面生效,如何将UI与实体绑定详见CreateUI接口
Clone客户端克隆一个已有的控件,修改它的名称,并将它挂接到指定的父节点上,目前文本、图片、按钮控件的克隆控件表现正常,其他复杂控件的克隆控件可能存在运行问题,建议在json编写的过程中,手动复制一份对应控件使用。
Create客户端UI生命周期函数,当UI创建成功时调用。
CreateChildControl客户端在当前画布中创建子控件,如果该子控件已经存在则返回已存在的子控件
Destroy客户端UI生命周期函数,当UI销毁时调用。
GetAllChildrenPath客户端获取所有子节点的路径list
GetBaseUIControl客户端根据路径获取BaseUIControl实例
GetBindAutoScale客户端获取该绑定实体的UI是否动态缩放,未绑定的UI将传回默认值1
GetBindEntityId客户端获取该UI绑定的实体id,未绑定的UI将传回默认值None
GetBindOffset客户端获取该UI绑定实体的偏移量,未绑定的UI将传回默认值(0, 0, 0)
GetBindWorldPosition客户端获取该UI绑定的worldPosition,未绑定返回默认值None
GetChildrenName客户端获取子节点的名称list
GetIsHud客户端获得本界面的输入模式
GetRichTextItem客户端返回一个富文本控件实例
GetScreenName客户端获得本界面的名称
GetSelf客户端获取零件界面自身
OnActive客户端UI生命周期函数,当UI重新回到栈顶时调用。
OnDeactive客户端UI生命周期函数,当栈顶UI有其他UI入栈时调用。
RemoveChildControl客户端移除当前画布中的子控件
RemoveComponent客户端动态删除某一控件
SetBindWorldPosition客户端设置UI绑定的worldPosition
SetIsHud客户端设置本界面的输入模式
SetRemove客户端删除本界面节点
SetScreenVisible客户端设置是否显示本界面
SetSelectControl客户端设置当前焦点所在的控件,当设置控件为文本输入框时会弹出系统小键盘
SetStackGridCount客户端设置StackGrid控件的大小
SetUiEntity客户端设置PaperDoll控件需要显示的生物模型,PaperDoll控件的配置方式详见控件介绍PaperDoll
SetUiModel客户端设置PaperDoll控件需要显示的模型,PaperDoll控件的配置方式详见控件介绍PaperDoll
SetUiModelScale客户端设置PaperDoll控件模型的缩放比例
Update客户端客户端每帧调用,1秒有30帧
UpdateScreen客户端刷新界面,重新计算各个控件的相关数据

UI控件

接口
描述
AddEntityMarker客户端增加实体位置标记
AddEntityTextMarker客户端在小地图上增加实体文本标记
AddHoverEventParams客户端开启按钮的悬浮回调功能,不调用该函数则按钮无悬浮回调
AddOption客户端添加下拉框项,若添加成功则返回True,否则返回False
AddStaticMarker客户端增加地图上静态位置的标记
AddStaticTextMarker客户端在小地图上增加静态文本的标记
AddTouchEventParams客户端开启按钮回调功能,不调用该函数则按钮无回调
ClearOptions客户端清空下拉框
ClearSelection客户端清除当前选中,使下拉框恢复未选中内容状态
DisableTextShadow客户端关闭文本控件显示阴影
EnableTextShadow客户端使文本控件显示阴影
GetAnchorFrom客户端判断控件相对于父节点的哪个锚点来计算位置与大小
GetAnchorTo客户端获取控件自身锚点位置信息
GetChildByName客户端根据子控件的名称获取BaseUIControl实例
GetChildByPath客户端根据相对路径获取BaseUIControl实例
GetClipDirection客户端获取图片控件的裁剪方向
GetClipOffset客户端获取控件的裁剪偏移信息
GetClipsChildren客户端根据控件路径返回某控件是否开启裁剪内容
GetCurrentSliceIndex客户端获取轮盘当前选择的切片的index,一般是在SetHoverCallback和SetTouchUpCallback中使用,表示当前鼠标悬浮或者点击的轮盘切片index
GetEditText客户端获取edit_box输入框的文本信息,获取失败会返回None
GetFullPosition客户端获取控件的锚点坐标,支持比例值以及绝对值
GetFullSize客户端获取控件的大小,支持百分比以及绝对值
GetGlobalPosition客户端获取控件全局坐标
GetGlobalRotateAngle客户端获取图片通过RotateAround函数设置进去的角度值
GetGlobalRotatePoint客户端获取图片通过RotateAround函数设置进去的point值
GetGridItem客户端根据网格位置获取元素控件
GetIsModal客户端判断当前面板是否为模态框
GetIsSwallow客户端判断当前面板输入是否会吞噬事件,isSwallow为Ture时,点击时,点击事件不会穿透到世界。如破坏方块、镜头转向不会被响应
GetMaxSize客户端获取控件所允许的最大的大小值
GetMinSize客户端获取控件所允许的最小的大小值
GetModelId客户端获取渲染的骨骼模型Id
GetOffsetDelta客户端获得点击面板的拖拽偏移量
GetOptionCount客户端获得选项数量
GetOptionIndexByShowName客户端根据展示文本查找对应下拉框项的索引位置,若找不到返回-1
GetOptionShowNameByIndex客户端根据索引位置查找当前栈式文本,若找不到返回None
GetOrientation客户端获取stackPanel的排列方向
GetPath客户端返回当前控件的相对路径,路径从画布节点开始算起
GetPosition客户端获取控件相对父节点的坐标
GetRotateAngle客户端获取图片相对自身的旋转锚点旋转的角度
GetRotatePivot客户端获取图片相对自身的旋转锚点
GetRotateRect客户端获取图片当前的四个边角点
GetScrollViewContentControl客户端返回该scroll_view内容的BaseUIControl实例
GetScrollViewContentPath客户端返回该scroll_view内容的路径
GetScrollViewPercentValue客户端获取当前scroll_view内容的百分比位置
GetScrollViewPos客户端获得当前scroll_view最上方内容的位置
GetSelectOptionIndex客户端获得当前选中项的索引,所无选中项则返回-1
GetSelectOptionShowName客户端获得当前选中项的展示文本,所无选中项则返回None
GetSize客户端获取控件的大小
GetSliceCount客户端获取轮盘可以选择的总切片数量
GetSliderValue客户端获取滑动条的值,失败返回0
GetText客户端获取Label的文本信息,获取失败会返回None
GetTextAlignment客户端获取文本控件的文本对齐方式
GetTextColor客户端获取Label文本颜色
GetTextLinePadding客户端获取文本控件的行间距
GetToggleState客户端获取Toggle开关控件的状态
GetUiItem客户端获取ItemRenderer控件显示的物品,ItemRenderer控件的配置方式详见控件介绍ItemRenderer
GetVisible客户端根据控件路径返回某控件是否已显示
IsAnimEndCallbackRegistered客户端控件是否对名称为animName的动画进行了注册回调
IsTextShadowEnabled客户端判断文本控件是否显示阴影
PauseAnimation客户端暂停动画,暂停后的动画会停在当前的状态
PlayAnimation客户端继续播放动画,从动画当前状态开始播放
RegisterCloseComboBoxCallback客户端注册关闭下拉框事件回调
RegisterOpenComboBoxCallback客户端注册展开下拉框事件回调
RegisterSelectItemCallback客户端注册选中下拉框内容事件回调
RemoveAnimEndCallback客户端移除动画播放结束后的回调
RemoveAnimation客户端删除单一属性的动画,删除后的值与当前状态有关,建议删除后重新设置该属性值
RemoveEntityMarker客户端删除实体位置标记
RemoveEntityTextMarker客户端在小地图上删除实体文本标记
RemoveOptionByIndex客户端根据提供的索引移除对应下拉框项,移除成功则返回True,否则返回False
RemoveOptionByShowName客户端根据提供的展示文本移除对应下拉框项,移除成功则返回True,否则返回False
RemoveStaticMarker客户端删除静态位置标记
RemoveStaticTextMarker客户端在小地图上删除静态文本标记
RenderBlockGeometryModel客户端渲染网格体模型
RenderEntity客户端渲染实体
RenderSkeletonModel客户端渲染骨骼模型(不依赖实体)
RepaintMiniMap客户端重新绘制小地图
Rotate客户端图片相对自身的旋转锚点进行旋转
RotateAround客户端图片相对全局坐标系中某个固定的点进行旋转
SetAlpha客户端设置节点的透明度,仅对image和label控件生效
SetAnchorFrom客户端设置控件相对于父节点的锚点
SetAnchorTo客户端设置控件自身锚点位置
SetAnimEndCallback客户端设置动画播放结束后的回调,每次设置都会覆盖上一次的设置
SetAnimation客户端给单一属性设置动画,已有重复的会设置失败,需要先remove
SetButtonHoverInCallback客户端设置鼠标进入按钮时触发的悬浮回调函数
SetButtonHoverOutCallback客户端设置鼠标退出按钮时触发的悬浮回调函数
SetButtonScreenExitCallback客户端设置按钮所在画布退出时若鼠标仍未抬起时触发回调函数
SetButtonTouchCancelCallback客户端设置触控在按钮范围外弹起时触发的回调函数
SetButtonTouchDownCallback客户端设置按钮按下时触发的回调函数
SetButtonTouchMoveCallback客户端设置按下后触控移动时触发的回调函数
SetButtonTouchMoveInCallback客户端设置按下按钮后进入控件时触发的回调函数
SetButtonTouchMoveOutCallback客户端设置按下按钮后退出控件时触发的回调函数
SetButtonTouchUpCallback客户端设置触控在按钮范围内弹起时的回调函数
SetClipDirection客户端设置图片控件的裁剪方向
SetClipOffset客户端设置控件的裁剪偏移信息
SetClipsChildren客户端设置控件是否开启裁剪内容
SetCurrentSliceIndex客户端设置轮盘选择的切片
SetEditText客户端设置edit_box输入框的文本信息
SetEditTextMaxLength客户端设置输入框的最大输入长度
SetFullPosition客户端设置控件的锚点坐标(全局坐标),支持比例值以及绝对值
SetFullSize客户端设置控件的大小,支持比例形式以及绝对值
SetGridDimension客户端设置Grid控件的大小
SetHighestY客户端设置绘制地图的最大高度
SetHoverCallback客户端设置轮盘选择切片触发回调函数
SetImageAdaptionType客户端设置图片控件的图片适配方式以及信息
SetIsModal客户端设置当前面板是否为模态框
SetIsSwallow客户端设置当前面板输入是否会吞噬事件,isSwallow为Ture时,点击时,点击事件不会穿透到世界。如破坏方块、镜头转向不会被响应
SetLayer客户端设置控件节点的层级,可以通过传入空字符串("")的方式来调整整个JSON的基础层级
SetMaxSize客户端设置控件所允许的最大的大小值
SetMinSize客户端设置控件所允许的最小的大小值
SetOffsetDelta客户端设置点击面板的拖拽偏移量
SetOrientation客户端设置stackPanel的排列方向
SetPosition客户端设置控件相对父节点的坐标
SetRotatePivot客户端设置图片自身旋转锚点,该点并不是固定的点,而是相对于自身位置的点
SetScrollViewPercentValue客户端设置当前scroll_view内容的百分比位置
SetScrollViewPos客户端设置当前scroll_view内容的位置
SetSelectOptionByIndex客户端根据提供的索引选中对应下拉框项
SetSelectOptionByShowName客户端根据提供的展示文本选中对应下拉框项
SetSize客户端设置控件的大小
SetSliderValue客户端设置滑动条的值
SetSprite客户端给图片控件换指定贴图
SetSpriteClipRatio客户端设置图片的裁剪区域比例(不改变控件尺寸)。可以配合image控件的clip_ratio属性控制方向。
SetSpriteColor客户端设置图片颜色
SetSpriteGray客户端给图片控件置灰,比直接SetSprite一张灰图片效率要高
SetSpritePlatformFrame客户端设置图片为我的世界移动端启动器当前帐号的头像框
SetSpritePlatformHead客户端设置图片为我的世界移动端启动器当前帐号的头像
SetSpriteUV客户端设置图片的起始uv,与json中的"uv"属性作用一致
SetSpriteUVSize客户端设置图片的uv大小,与json中的"uv_size"属性作用一致
SetText客户端设置Label的文本信息
SetTextAlignment客户端设置文本控件的文本对齐方式
SetTextColor客户端设置Label文本的颜色
SetTextFontSize客户端设置Label中文本字体的大小
SetTextLinePadding客户端设置文本控件的行间距
SetToggleState客户端设置Toggle开关控件的值
SetTouchEnable客户端设置控件是否可点击交互
SetTouchUpCallback客户端设置轮盘选择切片并且鼠标按下抬起后触发回调函数
SetUiItem客户端设置ItemRenderer控件显示的物品,ItemRenderer控件的配置方式详见控件介绍ItemRenderer
SetValue客户端设置进度条的进度
SetVisible客户端根据控件路径选择是否显示某控件,可以通过传入空字符串("")的方式来调整整个JSON的显示/隐藏
StopAnimation客户端停止动画,动画将恢复到第一段动画片段的from状态
ZoomIn客户端放大地图
ZoomOut客户端缩小地图
ZoomReset客户端恢复地图放缩大小为默认值
asButton客户端将当前BaseUIControl转换为ButtonUIControl实例,如当前控件非button类型则返回None
asGrid客户端将当前BaseUIControl转换为GridUIControl实例,如当前控件非grid类型则返回None
asImage客户端将当前BaseUIControl转换为ImageUIControl实例,如当前控件非image类型则返回None
asInputPanel客户端将当前BaseUIControl转换为InputPanelUIControl实例,如当前控件非inputPanel类型则返回None
asItemRenderer客户端将当前BaseUIControl转换为ItemRenderer实例,如当前控件非custom类型则返回None
asLabel客户端将当前BaseUIControl转换为LabelUIControl实例,如当前控件非Label类型则返回None
asMiniMap客户端将当前BaseUIControl转换为MiniMapUIControl实例,如当前控件非小地图类型则返回None
asNeteaseComboBox客户端将当前BaseUIControl转换为NeteaseComboBoxUIControl实例,如当前控件非panel类型则返回None
asNeteasePaperDoll客户端将当前BaseUIControl转换为NeteasePaperDollUIControl实例,如当前控件非custom类型则返回None
asProgressBar客户端将当前BaseUIControl转换为ProgressBarUIControl实例,如当前控件非panel类型则返回None
asScrollView客户端将当前BaseUIControl转换为ScrollViewUIControl实例,如当前控件非scrollview类型则返回None
asSelectionWheel客户端将当前BaseUIControl转换为SelectionWheelUIControl实例,如当前控件非selectionWheel类型则返回None
asSlider客户端将当前BaseUIControl转换为SliderUIControl实例,如当前控件非滑动条类型则返回None
asStackPanel客户端将当前BaseUIControl转换为StackPanelUIControl实例,如当前控件非stackPanel类型则返回None
asSwitchToggle客户端将当前BaseUIControl转换为SwitchToggleUIControl实例,如当前控件非panel类型或非toggle则返回None
asTextEditBox客户端将当前BaseUIControl转换为TextEditBoxUIControl实例,如当前控件非editbox类型则返回None
resetAnimation客户端重置该控件的动画

音效

接口
描述
DisableOriginMusic客户端停止原生背景音乐
PlayCustomMusic客户端播放场景音效,包括原版音效及自定义音效
PlayCustomUIMusic客户端播放UI音效,包括原版音效及自定义音效
PlayGlobalCustomMusic客户端播放背景音乐
SetCustomMusicLoop客户端设定指定音乐是否循环播放,包括场景音效与背景音乐
SetCustomMusicLoopById客户端设定指定音乐是否循环播放
StopCustomMusic客户端停止音效,包括场景音效与背景音乐,将依据fadeOutTime触发OnMusicStopClientEvent事件
StopCustomMusicById客户端停止场景音效

控制

接口
描述
AddPickBlacklist客户端添加使用camera组件(例如GetChosen接口、PickFacing接口)选取实体时的黑名单,即该实体不会被选取到
ClearPickBlacklist客户端清除使用camera组件(例如GetChosen接口、PickFacing接口)选取实体的黑名单
GetChosen客户端获取屏幕点击位置的实体或方块信息,通常与GetEntityByCoordEvent配合使用
GetChosenEntity客户端获取屏幕点击位置的实体id,通常与GetEntityByCoordEvent配合使用
GetHoldTimeThresholdInMs客户端获取长按判定时间,即按着屏幕多长时间会触发长按操作
GetInputVector客户端获取方向键(移动轮盘)的输入
GetMousePosition客户端获取鼠标位置
GetTouchPos客户端获取点击的屏幕坐标。可以监听TapBeforeClientEvent或TapOrHoldReleaseClientEvent事件,调用本API获取点击坐标。
IsCanAttack客户端获取玩家是否响应攻击
IsCanChat客户端获取玩家是否响应聊天按钮
IsCanDrag客户端获取玩家是否响应屏幕拖动
IsCanInair客户端获取玩家是否响应打上升下降按钮
IsCanJump客户端获取玩家是否响应跳跃(以及在水中浮起)
IsCanMove客户端获取玩家是否响应移动
IsCanOpenInv客户端获取玩家是否响应打开背包按钮
IsCanPause客户端获取玩家是否响应暂停按钮
IsCanPauseScreen客户端获取玩家是否可以打开暂停界面
IsCanPerspective客户端获取玩家是否响应切换视角
IsCanScreenShot客户端获取玩家是否响应截图按钮
IsCanWalkMode客户端获取玩家是否响应切换行走模式
IsTouchWithMouse客户端获取是否正在使用鼠标点击模拟触屏
LockInputVector客户端锁定本地玩家方向键(移动轮盘)的输入,可使本地玩家持续向指定方向前行,且不会再受玩家输入影响
LockVerticalMove客户端模拟上升或下降,调用后一直上升或下降
PickFacing客户端获取准星选中的实体或者方块
SetCanAll客户端同时设置SetCanMove,SetCanJump,SetCanAttack,SetCanWalkMode,SetCanPerspective,SetCanPause,SetCanChat,SetCanScreenShot,SetCanOpenInv,SetCanDrag,SetCanInair
SetCanAttack客户端设置是否响应攻击
SetCanChat客户端设置是否响应聊天按钮
SetCanDrag客户端设置是否响应屏幕拖动
SetCanInair客户端设置是否响应上升下降按钮(飞在空中时右下角的三个按钮)
SetCanJump客户端设置是否响应跳跃(以及在水中浮起)
SetCanMove客户端设置是否响应移动
SetCanOpenInv客户端设置是否响应打开背包按钮
SetCanPause客户端设置是否响应暂停按钮
SetCanPauseScreen客户端设置是否可以打开暂停界面
SetCanPerspective客户端设置是否响应切换视角
SetCanScreenShot客户端设置是否响应截图按钮
SetCanWalkMode客户端设置是否响应切换行走模式
SetControlMode客户端设置控制模式
SetControlModeLock客户端设置控制模式是否可以被改变
SetDeviceVibrate客户端设置设备震动
SetGyroSensorReportRate客户端设置陀螺仪传感器(上报/触发)频率
SetHoldTimeThreshold客户端设置长按判定时间,即按着屏幕多长时间会触发长按操作
SetMoveLock客户端设置是否锁住移动。实际上为是否响应十字键与遥感的操作。
SetShowRideUI服务端设置是否显示马匹的UI界面
SimulateTouchWithMouse客户端模拟使用鼠标控制UI(PC F11快捷键)
ToggleGyroSensor客户端开启或关闭陀螺仪传感器采集
UnLockVerticalMove客户端解除上升或下降状态
UnlockInputVector客户端解锁本地玩家方向键(移动轮盘)的输入

游戏设置

接口
描述
GetControllerLayout客户端获取玩家控制器绑定映射
GetSliderOption客户端获得某个滑动条设置选项的值
GetToggleOption客户端获得某个开关设置值的接口
GetUIProfile客户端获取"UI 档案"模式
HighlightBoxSelection客户端镜头移动时高亮当前视角中心所指的方块
SetSliderOption客户端设置某个滑动条设置选项的值
SetSplitControlCanChange客户端设置是否允许使用准星瞄准按钮
SetToggleOption客户端修改开关型设置的接口
SetUIProfile客户端设置"UI 档案"模式

世界

接口
描述
VirtualWorldCreate客户端创建虚拟世界,虚拟世界只允许存在一个,已经存在虚拟世界的情况下再调用此方法则无效
VirtualWorldDestroy客户端销毁虚拟世界
VirtualWorldSetCollidersVisible客户端设置虚拟世界中模型的包围盒是否显示,主要用于调试,默认为不显示
VirtualWorldSetSkyBgColor客户端设置虚拟世界中天空背景的颜色
VirtualWorldSetSkyTexture客户端设置虚拟世界中天空的贴图
VirtualWorldToggleVisibility客户端设置虚拟世界是否显示

相机

接口
描述
CameraGetClickModel客户端获取相机当前指向的模型的id,会返回离相机最近的,通常与GetEntityByCoordEvent配合使用
CameraGetFov客户端获取相机视野大小
CameraGetPos客户端返回相机位置
CameraGetZoom客户端获取相机的缩放值
CameraLookAt客户端修改相机朝向
CameraMoveTo客户端设置相机移动动画, 会根据当前相机状态与传入参数按时间进行插值显示
CameraSetFov客户端设置相机视野大小
CameraSetPos客户端设置相机位置
CameraSetZoom客户端设置相机缩放
CameraStopActions客户端停止相机移动动画

模型

接口
描述
ModelCancelAllBoneMask客户端取消动画中的所有骨骼屏蔽。
ModelCreateMinecraftObject客户端在虚拟世界中创建微软原版模型
ModelCreateObject客户端在虚拟世界中创建网易骨骼模型
ModelGetPos客户端获取模型的坐标
ModelGetRot客户端返回模型的旋转角度
ModelIsVisible客户端返回模型可见性
ModelMoveTo客户端设置模型平移运动
ModelPlayAnimation客户端模型播放动画,支持动作融合,其功能与模型接口ModelPlayAni相同。
ModelRegisterAnim1DControlParam客户端当同时播放多个骨骼动画时,新建用于控制动画进行1D线性混合的参数。目前线性混合仅支持对两个动画进行混合。新建的参数值范围为[0,1]。指定的骨骼将会按照这个参数的值对两个动画进行线性混合。
ModelRemove客户端销毁虚拟世界中的模型
ModelRotate客户端模型绕某个轴旋转多少度
ModelRotateTo客户端设置模型旋转运动
ModelSetAnim1DControlParam客户端新建动画的1D控制参数后,使用该接口对相应的参数进行控制。
ModelSetAnimAllBoneMask客户端设置是否屏蔽动画中所有骨骼的动画,若开启骨骼屏蔽后,该骨骼将不再播放该动画中的动作。该接口会对该动画中所有骨骼生效,可通过参数ignoreBoneList来指定不受影响的骨骼名称。通过屏蔽指定骨骼的动画可实现同一个骨骼模型同时在不同骨骼上播放不同的动作动画,从而实现快捷的动作融合。
ModelSetAnimBoneMask客户端设置是否屏蔽动画中指定的骨骼的动画,若开启骨骼屏蔽后,该骨骼将不再播放该动画中的动作。通过屏蔽指定骨骼的动画可实现同一个骨骼模型同时在不同骨骼上播放不同的动作动画,从而实现快捷的动作融合。
ModelSetAnimLayer客户端设置骨骼动画的层级,动画层级越大,则优先度越高,骨骼模型的骨骼优先播放优先度最高的动画,相同层级的动画则优先播放率先播放的动画。
ModelSetBoxCollider客户端设置模型的包围盒
ModelSetPos客户端设置模型坐标
ModelSetRot客户端设置模型的旋转角度
ModelSetScale客户端设置模型的缩放值
ModelSetVisible客户端设置模型可见性
ModelStopActions客户端停止模型的移动和旋转运动
ModelStopAnimation客户端停止播放指定的模型动画。
ModelUpdateAnimationMolangVariable客户端更新微软原版模型表达式变量,可控制动作的改变

其它对象

接口
描述
BindModel客户端把对象绑定到模型上, 支持绑定序列帧,粒子,文本和其它模型
MoveToVirtualWorld客户端把对象从主世界移到虚拟世界, 非绑定的序列帧,文本,粒子需要调用该方法后才会出现在虚拟世界中,绑定的可以省略调用该方法。

渐晕

接口
描述
CheckVignetteEnabled客户端检测是否开启了屏幕渐晕(Vignette)效果。
SetEnableVignette客户端设置是否开启屏幕渐晕(Vignette)效果,开启后玩家屏幕周围将出现渐晕,可通过Vignette其他接口设置效果参数。
SetVignetteCenter客户端设置渐晕(Vignette)的渐晕中心位置,可改变屏幕渐晕的位置。
SetVignetteRGB客户端设置渐晕(Vignette)的渐晕颜色,可改变屏幕渐晕的颜色。
SetVignetteRadius客户端设置渐晕(Vignette)的渐晕半径,半径越大,渐晕越小,玩家的视野范围越大。
SetVignetteSmoothness客户端设置渐晕(Vignette)的渐晕模糊系数,模糊系数越大,则渐晕边缘越模糊,模糊的范围也越大

模糊

接口
描述
CheckGaussianBlurEnabled客户端检测是否开启了高斯模糊效果。
SetEnableGaussianBlur客户端设置是否开启高斯模糊效果,开启后玩家屏幕周围被模糊,可通过高斯模糊其他接口设置效果参数。
SetGaussianBlurRadius客户端设置高斯模糊效果的模糊半径,半径越大,模糊程度越大,反之则模糊程度越小。

色彩

接口
描述
CheckColorAdjustmentEnabled客户端检测是否开启了色彩校正效果。
SetColorAdjustmentBrightness客户端调整屏幕色彩亮度,亮度值越大,屏幕越亮,反之则越暗。
SetColorAdjustmentContrast客户端调整屏幕色彩对比度,屏幕对比度值越大,色彩差异则越明显,反之则色彩差异越小。
SetColorAdjustmentSaturation客户端调整屏幕色彩饱和度,屏幕饱和度值越大,色彩则越明显,反之则越灰暗。
SetColorAdjustmentTint客户端调整屏幕色彩的色调,根据输入的色调和强度来调整屏幕色彩,当强度越大时,屏幕整体颜色越偏向输入的色调。
SetEnableColorAdjustment客户端设置是否开启色彩校正效果,开启后可进行屏幕色彩调整,可通过色彩校正效果其他接口设置效果参数。

镜头效果

接口
描述
CheckDepthOfFieldEnabled客户端检测是否开启了景深效果。
CheckLensStainEnabled客户端检测是否开启了镜头污迹效果。
ResetLensStainTexture客户端重置污迹效果使用的贴图为系统默认贴图。
SetDepthOfFieldBlurRadius客户端调整景深效果模糊半径,模糊半径越大,模糊程度越大,反之则越小。
SetDepthOfFieldFarBlurScale客户端调整景深效果远景模糊大小,远景模糊大小越大,远景的模糊程度越大,反之则越小。注意,远景模糊程度的调节依赖于焦点距离,如果焦点处于较近的距离,那么此时远景处于较清晰的状态,模糊程度大小调节不会很明显。
SetDepthOfFieldFocusDistance客户端调整景深效果焦点距离,距离越小,则远处模糊,近处清晰;距离越大,则远处清晰,近处模糊。该距离为实际距离,即以玩家相机为起点的世界坐标距离。
SetDepthOfFieldNearBlurScale客户端调整景深效果近景模糊大小,近景模糊大小越大,近景的模糊程度越大,反之则越小。注意,近景模糊程度的调节依赖于焦点距离,如果焦点处于较近的距离,那么此时近景处于较清晰的状态,模糊程度大小调节不会很明显。
SetDepthOfFieldUseCenterFocus客户端设置景深效果是否开启屏幕中心聚焦模式,开启后聚焦距离将被自动设置为屏幕中心所对应的物体所在的距离。在第一人称视角下,聚焦距离将被自动设置为屏幕准心所对应的物体与相机的距离,即自动聚焦准心所对应的物体。在第三人称视角下,由于屏幕中心总是对应着玩家,因此聚焦距离将被自动设置为玩家与相机的距离,即自动聚焦在玩家自己。
SetEnableDepthOfField客户端设置是否开启景深效果,开启后屏幕出现景深效果,根据焦点距离呈现远处模糊近处清晰或者近处模糊远处清晰的效果。
SetEnableLensStain客户端设置是否开启镜头污迹效果,开启后镜头出现污迹效果,可改变使用的污迹贴图及污迹颜色。
SetLensStainColor客户端调整镜头污迹颜色,根据输入的颜色和强度来调整污迹色彩,当强度越大时,污迹颜色越偏向输入的颜色。
SetLensStainIntensity客户端调整镜头污迹强度,强度越大,污迹越明显,反之则越透明。
SetLensStainTexture客户端开启镜头污迹效果后,污迹效果使用的为系统默认贴图。该接口可改变镜头污迹所使用的贴图。注意贴图最好使用透明背景,否则屏幕将被贴图覆盖。

自定义

接口
描述
AddPostProcess客户端添加后处理效果,与graphics_settings/post_process.json定义的process等效
CheckEnabledByName客户端查询是否开启了自定义后处理效果
GetParameter客户端获取指定自定义后处理参数的值
GetPostProcessOrder客户端获取后处理效果的渲染顺序
InsertPassToPostprocess客户端往自定义后处理的多pass中的指定位置插入自定义pass。多pass指定的是graphics_settings/post_process.json中的"pass_array"渲染pass数组。这个后处理会按照这个数组所定义的pass来逐个渲染,每个pass之间的像素输入输出相互连接,即pass数组中第一个pass所使用的fragment shader中的TEXTURE_0为游戏原始输出到屏幕的像素信息。下一个pass所使用的fragment shader中的TEXTURE_0为上一个Pass的fragment shader的输出。最后一个pass的fragment shader的输出即为输出到游戏屏幕的像素信息。
PopBackPassInPostprocess客户端删除自定义后处理的多pass的最末尾的pass。多pass指定的是graphics_settings/post_process.json中的"pass_array"渲染pass数组。这个后处理会按照这个数组所定义的pass来逐个渲染,每个pass之间的像素输入输出相互连接,即pass数组中第一个pass所使用的fragment shader中的TEXTURE_0为游戏原始输出到屏幕的像素信息。下一个pass所使用的fragment shader中的TEXTURE_0为上一个Pass的fragment shader的输出。最后一个pass的fragment shader的输出即为输出到游戏屏幕的像素信息。
PostPassResultToOtherPass客户端将自定义pass的纹理结果传递到其他自定义pass的fragmentShader指定纹理单元槽位
PushBackPassToPostprocess客户端往自定义后处理的多pass最末尾插入自定义pass。多pass指定的是graphics_settings/post_process.json中的"pass_array"渲染pass数组。这个后处理会按照这个数组所定义的pass来逐个渲染,每个pass之间的像素输入输出相互连接,即pass数组中第一个pass所使用的fragment shader中的TEXTURE_0为游戏原始输出到屏幕的像素信息。下一个pass所使用的fragment shader中的TEXTURE_0为上一个Pass的fragment shader的输出。最后一个pass的fragment shader的输出即为输出到游戏屏幕的像素信息。
RemovePassInPostprocess客户端删除自定义后处理的多pass中指定位置的pass。多pass指定的是graphics_settings/post_process.json中的"pass_array"渲染pass数组。这个后处理会按照这个数组所定义的pass来逐个渲染,每个pass之间的像素输入输出相互连接,即pass数组中第一个pass所使用的fragment shader中的TEXTURE_0为游戏原始输出到屏幕的像素信息。下一个pass所使用的fragment shader中的TEXTURE_0为上一个Pass的fragment shader的输出。最后一个pass的fragment shader的输出即为输出到游戏屏幕的像素信息。
SetEnableByName客户端设置是否开启自定义后处理效果
SetParameter客户端设置自定义后处理shader的自定义参数值

联机大厅

接口
描述
GetPlayerUid服务端获取玩家的uid。只有在线玩家才可获取
LobbyGetStorage服务端获取存储的数据。仅联机大厅可用
LobbyGetStorageBySort服务端排序获取存储的数据。仅联机大厅可用
LobbySetStorageAndUserItem服务端设置订单已发货或者存数据。仅联机大厅可用
QueryLobbyUserItem服务端查询还没发货的订单。仅联机大厅可用

成就

接口
描述
LobbyGetAchievementStorage服务端获取成就节点的存储的数据。
LobbySetAchievementStorage服务端添加成就节点的进度。

商城

接口
描述
CloseShopWindow客户端关闭网易商城窗口
HideShopGate客户端隐藏网易商城入口
OpenItemDetailWindow客户端打开特定商品的详情界面
OpenShopWindow客户端打开网易商城窗口。PC端无效(Apollo的PC端请使用商城插件)
ShowShopGate客户端显示网易商城入口