xiaokun/netease-modsdk-wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
d1803d3bd571a8d0acb7fe4cde3410ff925fd635
netease-modsdk-wiki/docs/mcdocs/1-ModAPI/接口/世界/索引.md
boybook 481c844a80 更新3.3
2025-03-18 14:46:12 +08:00

331 lines
45 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
sidebarDepth: 1
---
# 索引
---
- [地图](#地图)
- [实体管理](#实体管理)
- [方块管理](#方块管理)
- [生物生成](#生物生成)
- [配方](#配方)
- [方块组合](#方块组合)
- [渲染](#渲染)
- [时间](#时间)
- [天气](#天气)
- [游戏规则](#游戏规则)
- [自定义数据](#自定义数据)
- [指令](#指令)
- [消息](#消息)
- [记分板](#记分板)
### 地图
| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [CanSee](地图.md#cansee) | <span style="display:inline;color:#ff5555">服务端</span> | 判断起始对象是否可看见目标对象,基于对象的Head位置判断 |
| [CanSee](地图.md#cansee) | <span style="display:inline;color:#7575f9">客户端</span> | 判断起始对象是否可看见目标对象,基于对象的Head位置判断 |
| [CheckBlockToPos](地图.md#checkblocktopos) | <span style="display:inline;color:#ff5555">服务端</span> | 判断位置之间是否有方块 |
| [CheckChunkState](地图.md#checkchunkstate) | <span style="display:inline;color:#ff5555">服务端</span> | 判断指定位置的chunk是否加载完成 |
| [CreateDimension](地图.md#createdimension) | <span style="display:inline;color:#ff5555">服务端</span> | 创建新的dimension |
| [CreateExplosion](地图.md#createexplosion) | <span style="display:inline;color:#ff5555">服务端</span> | 用于生成爆炸 |
| [DeleteAllArea](地图.md#deleteallarea) | <span style="display:inline;color:#ff5555">服务端</span> | 删除所有常加载区域 |
| [DeleteArea](地图.md#deletearea) | <span style="display:inline;color:#ff5555">服务端</span> | 删除一个常加载区域 |
| [DetectStructure](地图.md#detectstructure) | <span style="display:inline;color:#ff5555">服务端</span> | 检测自定义门的结构 |
| [DoTaskOnChunkAsync](地图.md#dotaskonchunkasync) | <span style="display:inline;color:#ff5555">服务端</span> | 异步加载指定范围区块，加载完成后调用输入的回调函数。 |
| [GetAllAreaKeys](地图.md#getallareakeys) | <span style="display:inline;color:#ff5555">服务端</span> | 获取所有常加载区域名称列表 |
| [GetBiomeInfo](地图.md#getbiomeinfo) | <span style="display:inline;color:#ff5555">服务端</span> | 获取群系天气相关参数 |
| [GetBiomeName](地图.md#getbiomename) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某一位置所属的生物群系信息 |
| [GetBiomeName](地图.md#getbiomename) | <span style="display:inline;color:#7575f9">客户端</span> | 获取客户端当前维度已加载区域某一位置所属的生物群系信息 |
| [GetBlockLightLevel](地图.md#getblocklightlevel) | <span style="display:inline;color:#ff5555">服务端</span> | 获取方块位置的光照等级 |
| [GetChunkEntites](地图.md#getchunkentites) | <span style="display:inline;color:#ff5555">服务端</span> | 获取指定位置的区块中，全部的实体和玩家的ID列表 |
| [GetChunkMaxPos](地图.md#getchunkmaxpos) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某区块最大点的坐标 |
| [GetChunkMinPos](地图.md#getchunkminpos) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某区块最小点的坐标 |
| [GetChunkMobNum](地图.md#getchunkmobnum) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某区块中的生物数量（不包括玩家，但包括盔甲架） |
| [GetChunkPosFromBlockPos](地图.md#getchunkposfromblockpos) | <span style="display:inline;color:#ff5555">服务端</span> | 通过方块坐标获得该方块所在区块坐标 |
| [GetChunkPosFromBlockPos](地图.md#getchunkposfromblockpos) | <span style="display:inline;color:#7575f9">客户端</span> | 通过方块坐标获得该方块所在区块坐标 |
| [GetCurrentDimension](地图.md#getcurrentdimension) | <span style="display:inline;color:#7575f9">客户端</span> | 获取客户端当前维度 |
| [GetEntitiesAround](地图.md#getentitiesaround) | <span style="display:inline;color:#ff5555">服务端</span> | 获取区域内的entity列表 |
| [GetEntitiesAround](地图.md#getentitiesaround) | <span style="display:inline;color:#7575f9">客户端</span> | 获取区域内的entity列表 |
| [GetEntitiesAroundByType](地图.md#getentitiesaroundbytype) | <span style="display:inline;color:#ff5555">服务端</span> | 获取区域内的某类型的entity列表 |
| [GetEntitiesAroundByType](地图.md#getentitiesaroundbytype) | <span style="display:inline;color:#7575f9">客户端</span> | 获取区域内的某类型的entity列表 |
| [GetEntitiesInSquareArea](地图.md#getentitiesinsquarearea) | <span style="display:inline;color:#ff5555">服务端</span> | 获取区域内的entity列表 |
| [GetEntitiesInSquareArea](地图.md#getentitiesinsquarearea) | <span style="display:inline;color:#7575f9">客户端</span> | 获取区域内的entity列表 |
| [GetLevelId](地图.md#getlevelid) | <span style="display:inline;color:#ff5555">服务端</span> | 获取levelId。某些组件需要levelId创建，可以用此接口获取levelId。其中level即为当前地图的游戏。 |
| [GetLevelId](地图.md#getlevelid) | <span style="display:inline;color:#7575f9">客户端</span> | 获取levelId。某些组件需要levelId创建，可以用此接口获取levelId。其中level即为当前地图的游戏。 |
| [GetLoadedChunks](地图.md#getloadedchunks) | <span style="display:inline;color:#ff5555">服务端</span> | 获取指定维度当前已经加载完毕的全部区块的坐标列表 |
| [GetSpawnDimension](地图.md#getspawndimension) | <span style="display:inline;color:#ff5555">服务端</span> | 获取世界出生维度 |
| [GetSpawnPosition](地图.md#getspawnposition) | <span style="display:inline;color:#ff5555">服务端</span> | 获取世界出生点坐标 |
| [GetStructureSize](地图.md#getstructuresize) | <span style="display:inline;color:#ff5555">服务端</span> | 获取结构体的长宽高 |
| [IsChunkGenerated](地图.md#ischunkgenerated) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某个区块是否生成过。 |
| [IsSlimeChunk](地图.md#isslimechunk) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某个区块是否是史莱姆区块。 |
| [LocateNeteaseFeatureRule](地图.md#locateneteasefeaturerule) | <span style="display:inline;color:#ff5555">服务端</span> | 与[/locate指令](https://minecraft-zh.gamepedia.com/%E5%91%BD%E4%BB%A4/locate)相似，用于定位<a href="../../../../mcguide/20-玩法开发/15-自定义游戏内容/4-自定义维度/4-自定义特征.html#特征规则（feature-rules）">网易自定义特征规则</a> |
| [LocateStructureFeature](地图.md#locatestructurefeature) | <span style="display:inline;color:#ff5555">服务端</span> | 与[/locate指令](https://minecraft-zh.gamepedia.com/%E5%91%BD%E4%BB%A4/locate)相似，用于定位原版的部分结构，如海底神殿、末地城等。 |
| [MayPlace](地图.md#mayplace) | <span style="display:inline;color:#ff5555">服务端</span> | 判断方块是否可以放置 |
| [MayPlaceOn](地图.md#mayplaceon) | <span style="display:inline;color:#ff5555">服务端</span> | 判断物品是否可以放到指定的位置上 |
| [MirrorDimension](地图.md#mirrordimension) | <span style="display:inline;color:#ff5555">服务端</span> | 复制不同dimension的地形 |
| [OpenClientChunkGeneration](地图.md#openclientchunkgeneration) | <span style="display:inline;color:#ff5555">服务端</span> | 开启/关闭客户端区块生成功能，需要在LoadServerAddonScriptsAfter事件触发时调用。开启客户端区块生成功能时，如果使用了netease:structure_feature或修改了大部分地图，会导致客户端和服务端地图不一致的问题。此时可以通过关闭客户端区块生成功能解决该问题。 |
| [PlaceFeature](地图.md#placefeature) | <span style="display:inline;color:#ff5555">服务端</span> | 放置特征，与[/placefeature指令](https://minecraft.fandom.com/zh/wiki/%E5%91%BD%E4%BB%A4/placefeature)相似 |
| [PlaceNeteaseLargeFeature](地图.md#placeneteaselargefeature) | <span style="display:inline;color:#ff5555">服务端</span> | 放置<a href="../../../../mcguide/20-玩法开发/15-自定义游戏内容/4-自定义维度/6-自定义大型特征.html#自定义大型特征">网易版大型结构特征</a> |
| [PlaceStructure](地图.md#placestructure) | <span style="display:inline;color:#ff5555">服务端</span> | 放置结构 |
| [SetAddArea](地图.md#setaddarea) | <span style="display:inline;color:#ff5555">服务端</span> | 设置区块的常加载 |
| [SetBiomeByPos](地图.md#setbiomebypos) | <span style="display:inline;color:#ff5555">服务端</span> | 设置某一位置所属的生物群系信息 |
| [SetBiomeByPosList](地图.md#setbiomebyposlist) | <span style="display:inline;color:#ff5555">服务端</span> | 设置所有列表中位置所属的生物群系信息 |
| [SetBiomeByVolume](地图.md#setbiomebyvolume) | <span style="display:inline;color:#ff5555">服务端</span> | 设置长方体空间中所属的生物群系信息 |
| [SetBiomeInfo](地图.md#setbiomeinfo) | <span style="display:inline;color:#ff5555">服务端</span> | 设置群系天气相关参数 |
| [SetMergeSpawnItemRadius](地图.md#setmergespawnitemradius) | <span style="display:inline;color:#ff5555">服务端</span> | 设置新生成的物品是否合堆 |
| [SetSpawnDimensionAndPosition](地图.md#setspawndimensionandposition) | <span style="display:inline;color:#ff5555">服务端</span> | 设置世界出生点维度与坐标 |
| [UpgradeMapDimensionVersion](地图.md#upgrademapdimensionversion) | <span style="display:inline;color:#ff5555">服务端</span> | 提升指定地图维度的版本号，版本号不符的维度，地图存档信息将被废弃。使用后存档的地图版本均会同步提升至最新版本，假如希望使用此接口清理指定维度的地图存档，需要在保证该维度区块都没有被加载时调用。 |
### 实体管理
| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [CreateClientEntityByTypeStr](实体管理.md#createcliententitybytypestr) | <span style="display:inline;color:#7575f9">客户端</span> | 创建客户端实体 |
| [CreateEngineEntityByNBT](实体管理.md#createengineentitybynbt) | <span style="display:inline;color:#ff5555">服务端</span> | 根据nbt数据创建实体 |
| [CreateEngineEntityByTypeStr](实体管理.md#createengineentitybytypestr) | <span style="display:inline;color:#ff5555">服务端</span> | 创建指定identifier的实体 |
| [CreateEngineItemEntity](实体管理.md#createengineitementity) | <span style="display:inline;color:#ff5555">服务端</span> | 用于创建物品实体（即掉落物），返回物品实体的entityId |
| [CreateEntityAOI](实体管理.md#createentityaoi) | <span style="display:inline;color:#ff5555">服务端</span> | 注册感应区域，有实体进入时和离开时会触发回调函数func |
| [CreateExperienceOrb](实体管理.md#createexperienceorb) | <span style="display:inline;color:#ff5555">服务端</span> | 创建专属经验球 |
| [CreateProjectileEntity](实体管理.md#createprojectileentity) | <span style="display:inline;color:#ff5555">服务端</span> | 创建抛射物（直接发射） |
| [DeleteEntityAOI](实体管理.md#deleteentityaoi) | <span style="display:inline;color:#ff5555">服务端</span> | 删除使用[CreateEntityAOI](实体管理.md#createentityaoi)注册的感应区 |
| [DestroyClientEntity](实体管理.md#destroycliententity) | <span style="display:inline;color:#7575f9">客户端</span> | 销毁客户端实体 |
| [DestroyEntity](实体管理.md#destroyentity) | <span style="display:inline;color:#ff5555">服务端</span> | 销毁实体 |
| [GetDroppedItem](实体管理.md#getdroppeditem) | <span style="display:inline;color:#ff5555">服务端</span> | 获取掉落物的物品信息 |
| [GetEngineActor](实体管理.md#getengineactor) | <span style="display:inline;color:#ff5555">服务端</span> | 获取所有维度中已加载的所有实体（不包含玩家）。 |
| [GetEngineActor](实体管理.md#getengineactor) | <span style="display:inline;color:#7575f9">客户端</span> | 获取客户端当前维度中已加载的所有实体（不包含玩家）。 |
| [GetLocalPlayerId](实体管理.md#getlocalplayerid) | <span style="display:inline;color:#7575f9">客户端</span> | 获取本地玩家的id |
| [GetLootItems](实体管理.md#getlootitems) | <span style="display:inline;color:#ff5555">服务端</span> | 指定战利品表获取一次战利品，返回的物品与json定义的概率有关 |
| [GetPlayerList](实体管理.md#getplayerlist) | <span style="display:inline;color:#ff5555">服务端</span> | 获取所有维度中的全部玩家的id列表 |
| [GetPlayerList](实体管理.md#getplayerlist) | <span style="display:inline;color:#7575f9">客户端</span> | 获取所有维度中的全部玩家的id列表 |
| [HasEntity](实体管理.md#hasentity) | <span style="display:inline;color:#7575f9">客户端</span> | 判断 entity 是否存在 |
| [IsEntityAlive](实体管理.md#isentityalive) | <span style="display:inline;color:#ff5555">服务端</span> | 判断生物实体是否存活或非生物实体是否存在 |
| [IsEntityAlive](实体管理.md#isentityalive) | <span style="display:inline;color:#7575f9">客户端</span> | 判断生物实体是否存活或非生物实体是否存在 |
| [KillEntity](实体管理.md#killentity) | <span style="display:inline;color:#ff5555">服务端</span> | 杀死某个Entity |
| [SpawnLootTable](实体管理.md#spawnloottable) | <span style="display:inline;color:#ff5555">服务端</span> | 使用生物类型模拟一次随机掉落，生成的物品与json定义的概率有关 |
| [SpawnLootTableWithActor](实体管理.md#spawnloottablewithactor) | <span style="display:inline;color:#ff5555">服务端</span> | 使用生物实例模拟一次随机掉落，生成的物品与json定义的概率有关 |
| [SpawnResources](实体管理.md#spawnresources) | <span style="display:inline;color:#ff5555">服务端</span> | 产生方块随机掉落（该方法不适用于实体方块） |
| [SpawnResourcesSilkTouched](实体管理.md#spawnresourcessilktouched) | <span style="display:inline;color:#ff5555">服务端</span> | 模拟方块精准采集掉落 |
| [getEntitiesOrBlockFromRay](实体管理.md#getentitiesorblockfromray) | <span style="display:inline;color:#ff5555">服务端</span> | 从指定位置发射一条射线，获取与射线相交的实体和方块 |
| [getEntitiesOrBlockFromRay](实体管理.md#getentitiesorblockfromray) | <span style="display:inline;color:#7575f9">客户端</span> | 从指定位置发射一条射线，获取与射线相交的实体和方块 |
### 方块管理
| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [GetBlock](方块管理.md#getblock) | <span style="display:inline;color:#7575f9">客户端</span> | 获取某一位置的block |
| [GetBlockClip](方块管理.md#getblockclip) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某一位置方块当前<a href="../../../../mcguide/20-玩法开发/15-自定义游戏内容/2-自定义方块/1-JSON组件.html#netease-aabb">clip的aabb</a> |
| [GetBlockClip](方块管理.md#getblockclip) | <span style="display:inline;color:#7575f9">客户端</span> | 获取指定位置方块当前clip的aabb |
| [GetBlockCollision](方块管理.md#getblockcollision) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某一位置方块当前collision的aabb |
| [GetBlockCollision](方块管理.md#getblockcollision) | <span style="display:inline;color:#7575f9">客户端</span> | 获取指定位置方块当前collision的aabb |
| [GetBlockNew](方块管理.md#getblocknew) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某一位置的block |
| [GetDestroyTotalTime](方块管理.md#getdestroytotaltime) | <span style="display:inline;color:#ff5555">服务端</span> | 获取使用物品破坏方块需要的时间 |
| [GetDestroyTotalTime](方块管理.md#getdestroytotaltime) | <span style="display:inline;color:#7575f9">客户端</span> | 获取使用物品破坏方块需要的时间 |
| [GetLiquidBlock](方块管理.md#getliquidblock) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某个位置的方块所含流体的信息 |
| [GetTopBlockHeight](方块管理.md#gettopblockheight) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某一位置最高的非空气方块的高度 |
| [GetTopBlockHeight](方块管理.md#gettopblockheight) | <span style="display:inline;color:#7575f9">客户端</span> | 获取当前维度某一位置最高的非空气方块的高度 |
| [SetBlockNew](方块管理.md#setblocknew) | <span style="display:inline;color:#ff5555">服务端</span> | 设置某一位置的方块 |
| [SetJigsawBlock](方块管理.md#setjigsawblock) | <span style="display:inline;color:#ff5555">服务端</span> | 在某一位置放置拼图方块 |
| [SetLiquidBlock](方块管理.md#setliquidblock) | <span style="display:inline;color:#ff5555">服务端</span> | 设置某一位置的方块的extraBlock，可在此设置方块含水等 |
| [SetSnowBlock](方块管理.md#setsnowblock) | <span style="display:inline;color:#ff5555">服务端</span> | 设置某一位置的方块含雪 |
### 生物生成
| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [GetEntityLimit](生物生成.md#getentitylimit) | <span style="display:inline;color:#ff5555">服务端</span> | 获取世界最大可生成实体数量上限。可生成实体的含义见[SetEntityLimit](生物生成.md#setentitylimit) |
| [SetEntityLimit](生物生成.md#setentitylimit) | <span style="display:inline;color:#ff5555">服务端</span> | 设置世界最大可生成实体数量上限。可生成实体指具有spawnrule的实体。当前世界上被加载的可生成实体数量超过这个上限时，生物就不会再通过spawnrule刷出。 |
| [SpawnCustomModule](生物生成.md#spawncustommodule) | <span style="display:inline;color:#ff5555">服务端</span> | 设置自定义刷怪 |
### 配方
| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [AddBrewingRecipes](配方.md#addbrewingrecipes) | <span style="display:inline;color:#ff5555">服务端</span> | 添加酿造台配方的接口 |
| [AddRecipe](配方.md#addrecipe) | <span style="display:inline;color:#ff5555">服务端</span> | 动态注册配方，支持配方类型详见<a href="../../../../mcguide/20-玩法开发/15-自定义游戏内容/5-自定义配方.html#配方类型说明">[配方类型说明]</a> |
| [GetRecipeResult](配方.md#getreciperesult) | <span style="display:inline;color:#ff5555">服务端</span> | 根据配方id获取配方结果。仅支持合成配方 |
| [GetRecipesByInput](配方.md#getrecipesbyinput) | <span style="display:inline;color:#ff5555">服务端</span> | 通过输入物品查询配方 |
| [GetRecipesByInput](配方.md#getrecipesbyinput) | <span style="display:inline;color:#7575f9">客户端</span> | 通过输入物品查询配方 |
| [GetRecipesByResult](配方.md#getrecipesbyresult) | <span style="display:inline;color:#ff5555">服务端</span> | 通过输出物品查询配方所需要的输入材料 |
| [GetRecipesByResult](配方.md#getrecipesbyresult) | <span style="display:inline;color:#7575f9">客户端</span> | 通过输出物品查询配方所需要的输入材料 |
| [RemoveRecipe](配方.md#removerecipe) | <span style="display:inline;color:#ff5555">服务端</span> | 动态禁用配方 |
### 方块组合
| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [CreateMicroBlockResStr](方块组合.md#createmicroblockresstr) | <span style="display:inline;color:#ff5555">服务端</span> | 生成微缩方块资源Json字符串 |
| [GetBlankBlockPalette](方块组合.md#getblankblockpalette) | <span style="display:inline;color:#ff5555">服务端</span> | 获取一个空白的方块调色板。 |
| [GetBlankBlockPalette](方块组合.md#getblankblockpalette) | <span style="display:inline;color:#7575f9">客户端</span> | 获取一个空白的方块调色板。 |
| [GetBlockPaletteBetweenPos](方块组合.md#getblockpalettebetweenpos) | <span style="display:inline;color:#ff5555">服务端</span> | 根据输入的两个方块位置创建并获取一个方块调色板，方块调色板用于描述和记录世界中的多个方块的组合。这个方块调色板包含了这两个位置之间的所有方块及其相对位置。 |
| [GetBlockPaletteBetweenPos](方块组合.md#getblockpalettebetweenpos) | <span style="display:inline;color:#7575f9">客户端</span> | 根据输入的两个位置创建并获取一个方块调色板，该接口会搜索这两个位置之间的所有方块创建方块调色板，方块调色板用于描述和记录世界中的多个方块的组合。这个方块调色板包含了这两个位置之间的所有方块及其相对位置。 |
| [GetBlockPaletteFromPosList](方块组合.md#getblockpalettefromposlist) | <span style="display:inline;color:#ff5555">服务端</span> | 根据输入的方块位置列表创建并获取一个方块调色板，方块调色板用于描述和记录世界中的多个方块的组合。创建的方块调色板包含了这个位置列表中的所有方块及其相对位置。 |
| [GetBlockPaletteFromPosList](方块组合.md#getblockpalettefromposlist) | <span style="display:inline;color:#7575f9">客户端</span> | 根据输入的方块位置列表创建并获取一个方块调色板，方块调色板用于描述和记录世界中的多个方块的组合。创建的方块调色板包含了这个位置列表中的所有方块及其相对位置。 |
| [RegisterBlockPatterns](方块组合.md#registerblockpatterns) | <span style="display:inline;color:#ff5555">服务端</span> | 注册特殊方块组合 |
| [SetBlockByBlockPalette](方块组合.md#setblockbyblockpalette) | <span style="display:inline;color:#ff5555">服务端</span> | 根据输入的方块调色板内容，将调色板内记录的所有方块设置为实际的方块。 |
### 渲染
| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [AddTerrainDestroyParticleEffect](渲染.md#addterraindestroyparticleeffect) | <span style="display:inline;color:#7575f9">客户端</span> | 在指定位置播放指定方块被开始破坏时的粒子效果（如果有）。 |
| [AddUseItemParticleEffect](渲染.md#adduseitemparticleeffect) | <span style="display:inline;color:#7575f9">客户端</span> | 在指定位置播放指定物品被开始使用时的粒子效果（如果有）。 |
| [GetAmbientBrightness](渲染.md#getambientbrightness) | <span style="display:inline;color:#7575f9">客户端</span> | 获取环境光亮度，影响天空亮度，不影响实体与方块光照 |
| [GetFogColor](渲染.md#getfogcolor) | <span style="display:inline;color:#7575f9">客户端</span> | 获取当前雾效颜色 |
| [GetFogLength](渲染.md#getfoglength) | <span style="display:inline;color:#7575f9">客户端</span> | 获取雾效范围 |
| [GetMoonRot](渲染.md#getmoonrot) | <span style="display:inline;color:#7575f9">客户端</span> | 获取月亮角度 |
| [GetSkyColor](渲染.md#getskycolor) | <span style="display:inline;color:#7575f9">客户端</span> | 获取天空颜色 |
| [GetSkyTextures](渲染.md#getskytextures) | <span style="display:inline;color:#7575f9">客户端</span> | 获取当前维度天空盒贴图，天空盒共6张贴图 |
| [GetStarBrightness](渲染.md#getstarbrightness) | <span style="display:inline;color:#7575f9">客户端</span> | 获取星星亮度 |
| [GetSunRot](渲染.md#getsunrot) | <span style="display:inline;color:#7575f9">客户端</span> | 获取太阳角度 |
| [GetUseAmbientBrightness](渲染.md#getuseambientbrightness) | <span style="display:inline;color:#7575f9">客户端</span> | 判断是否在mod设置了环境光亮度 |
| [GetUseFogColor](渲染.md#getusefogcolor) | <span style="display:inline;color:#7575f9">客户端</span> | 判断当前是否开启设置雾效颜色，该值默认为False，使用mod传入的颜色值后为True |
| [GetUseFogLength](渲染.md#getusefoglength) | <span style="display:inline;color:#7575f9">客户端</span> | 判断当前是否开启设置雾效范围,该值默认为False，使用mod传入的范围值后为True |
| [GetUseMoonRot](渲染.md#getusemoonrot) | <span style="display:inline;color:#7575f9">客户端</span> | 判断是否在mod设置了月亮角度 |
| [GetUseSkyColor](渲染.md#getuseskycolor) | <span style="display:inline;color:#7575f9">客户端</span> | 判断是否在mod设置了天空颜色 |
| [GetUseStarBrightness](渲染.md#getusestarbrightness) | <span style="display:inline;color:#7575f9">客户端</span> | 判断是否在mod设置了星星亮度 |
| [GetUseSunRot](渲染.md#getusesunrot) | <span style="display:inline;color:#7575f9">客户端</span> | 判断是否在mod设置了太阳角度 |
| [HideNameTag](渲染.md#hidenametag) | <span style="display:inline;color:#7575f9">客户端</span> | 隐藏场景内所有名字，包括玩家名字，生物的自定义名称，物品展示框与命令方块的悬浮文本等 |
| [IsHideNameTag](渲染.md#ishidenametag) | <span style="display:inline;color:#7575f9">客户端</span> | 获取是否隐藏场景内所有名字 |
| [RemoveTerrainDestroyParticleEffect](渲染.md#removeterraindestroyparticleeffect) | <span style="display:inline;color:#7575f9">客户端</span> | 停止指定位置播放的方块被开始破坏时的粒子效果。 |
| [RemoveUseItemParticleEffect](渲染.md#removeuseitemparticleeffect) | <span style="display:inline;color:#7575f9">客户端</span> | 停止指定位置播放的物品被开始使用时的粒子效果。 |
| [ResetAmbientBrightness](渲染.md#resetambientbrightness) | <span style="display:inline;color:#7575f9">客户端</span> | 重置环境光亮度 |
| [ResetFogColor](渲染.md#resetfogcolor) | <span style="display:inline;color:#7575f9">客户端</span> | 重置雾效颜色 |
| [ResetFogLength](渲染.md#resetfoglength) | <span style="display:inline;color:#7575f9">客户端</span> | 重置雾效范围 |
| [ResetMoonRot](渲染.md#resetmoonrot) | <span style="display:inline;color:#7575f9">客户端</span> | 重置月亮角度 |
| [ResetSkyColor](渲染.md#resetskycolor) | <span style="display:inline;color:#7575f9">客户端</span> | 重置天空颜色 |
| [ResetSkyTextures](渲染.md#resetskytextures) | <span style="display:inline;color:#7575f9">客户端</span> | 重置当前维度天空盒贴图。如果有使用addon配置贴图则会使用配置的贴图，否则为游戏内默认无贴图的情况 |
| [ResetStarBrightness](渲染.md#resetstarbrightness) | <span style="display:inline;color:#7575f9">客户端</span> | 重置星星亮度 |
| [ResetSunRot](渲染.md#resetsunrot) | <span style="display:inline;color:#7575f9">客户端</span> | 重置太阳角度 |
| [SetAmbientBrightness](渲染.md#setambientbrightness) | <span style="display:inline;color:#7575f9">客户端</span> | 设置环境光亮度，影响天空亮度，不影响实体与方块光照 |
| [SetFogColor](渲染.md#setfogcolor) | <span style="display:inline;color:#7575f9">客户端</span> | 设置雾效颜色 |
| [SetFogLength](渲染.md#setfoglength) | <span style="display:inline;color:#7575f9">客户端</span> | 设置雾效范围 |
| [SetMoonRot](渲染.md#setmoonrot) | <span style="display:inline;color:#7575f9">客户端</span> | 设置月亮所在角度 |
| [SetSkyColor](渲染.md#setskycolor) | <span style="display:inline;color:#7575f9">客户端</span> | 设置天空颜色 |
| [SetSkyTextures](渲染.md#setskytextures) | <span style="display:inline;color:#7575f9">客户端</span> | 设置当前维度天空盒贴图，天空盒需要6张贴图 |
| [SetStarBrightness](渲染.md#setstarbrightness) | <span style="display:inline;color:#7575f9">客户端</span> | 设置星星亮度，白天也可以显示星星 |
| [SetSunRot](渲染.md#setsunrot) | <span style="display:inline;color:#7575f9">客户端</span> | 设置太阳所在角度 |
| [SkyTextures](渲染.md#skytextures) | <span style="display:inline;color:#7575f9">客户端</span> | 修改太阳、月亮、云层分布、天空盒的贴图。使用addon配置，非python接口。 |
### 时间
| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [GetLocalDoDayNightCycle](时间.md#getlocaldodaynightcycle) | <span style="display:inline;color:#ff5555">服务端</span> | 获取维度是否打开昼夜更替 |
| [GetLocalTime](时间.md#getlocaltime) | <span style="display:inline;color:#ff5555">服务端</span> | 获取维度的时间 |
| [GetLocalTime](时间.md#getlocaltime) | <span style="display:inline;color:#7575f9">客户端</span> | 获取当前维度的时间 |
| [GetTime](时间.md#gettime) | <span style="display:inline;color:#ff5555">服务端</span> | 获取当前世界时间 |
| [GetTime](时间.md#gettime) | <span style="display:inline;color:#7575f9">客户端</span> | 获取当前世界时间 |
| [GetUseLocalTime](时间.md#getuselocaltime) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某个维度是否设置了使用局部时间规则 |
| [SetLocalDoDayNightCycle](时间.md#setlocaldodaynightcycle) | <span style="display:inline;color:#ff5555">服务端</span> | 设置使用局部时间规则的维度是否打开昼夜更替 |
| [SetLocalTime](时间.md#setlocaltime) | <span style="display:inline;color:#ff5555">服务端</span> | 设置使用局部时间规则维度的时间 |
| [SetLocalTimeOfDay](时间.md#setlocaltimeofday) | <span style="display:inline;color:#ff5555">服务端</span> | 设置使用局部时间规则维度在一天内所在的时间 |
| [SetTime](时间.md#settime) | <span style="display:inline;color:#ff5555">服务端</span> | 设置当前世界时间 |
| [SetTimeOfDay](时间.md#settimeofday) | <span style="display:inline;color:#ff5555">服务端</span> | 设置当前世界在一天内所在的时间 |
| [SetUseLocalTime](时间.md#setuselocaltime) | <span style="display:inline;color:#ff5555">服务端</span> | 让某个维度拥有自己的局部时间规则，开启后该维度可以拥有与其他维度不同的时间与是否昼夜更替的规则 |
### 天气
| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [GetDimensionLocalWeatherInfo](天气.md#getdimensionlocalweatherinfo) | <span style="display:inline;color:#ff5555">服务端</span> | 获取独立维度天气信息(必须先使用SetDimensionUseLocalWeather接口设置此维度拥有自己的独立天气) |
| [GetDimensionUseLocalWeather](天气.md#getdimensionuselocalweather) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某个维度是否拥有自己的天气规则 |
| [IsRaining](天气.md#israining) | <span style="display:inline;color:#ff5555">服务端</span> | 获取是否下雨 |
| [IsThunder](天气.md#isthunder) | <span style="display:inline;color:#ff5555">服务端</span> | 获取是否打雷 |
| [SetDimensionLocalDoWeatherCycle](天气.md#setdimensionlocaldoweathercycle) | <span style="display:inline;color:#ff5555">服务端</span> | 设置某个维度是否开启天气循环(必须先使用SetDimensionUseLocalWeather接口设置此维度拥有自己的独立天气) |
| [SetDimensionLocalRain](天气.md#setdimensionlocalrain) | <span style="display:inline;color:#ff5555">服务端</span> | 设置某个维度下雨(必须先使用SetDimensionUseLocalWeather接口设置此维度拥有自己的独立天气) |
| [SetDimensionLocalThunder](天气.md#setdimensionlocalthunder) | <span style="display:inline;color:#ff5555">服务端</span> | 设置某个维度打雷(必须先使用SetDimensionUseLocalWeather接口设置此维度拥有自己的独立天气) |
| [SetDimensionUseLocalWeather](天气.md#setdimensionuselocalweather) | <span style="display:inline;color:#ff5555">服务端</span> | 设置某个维度拥有自己的天气规则，开启后该维度可以拥有与其他维度不同的天气和天气更替的规则 |
| [SetRaining](天气.md#setraining) | <span style="display:inline;color:#ff5555">服务端</span> | 设置是否下雨 |
| [SetThunder](天气.md#setthunder) | <span style="display:inline;color:#ff5555">服务端</span> | 设置是否打雷 |
### 游戏规则
| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [AddBannedItem](游戏规则.md#addbanneditem) | <span style="display:inline;color:#ff5555">服务端</span> | 增加禁用物品 |
| [AddBlockProtectField](游戏规则.md#addblockprotectfield) | <span style="display:inline;color:#ff5555">Apollo</span> | 设置一个方块无法被玩家/实体破坏的区域 |
| [CleanBlockProtectField](游戏规则.md#cleanblockprotectfield) | <span style="display:inline;color:#ff5555">Apollo</span> | 取消全部已设置的方块无法被玩家/实体破坏的区域 |
| [ClearBannedItems](游戏规则.md#clearbanneditems) | <span style="display:inline;color:#ff5555">服务端</span> | 清空禁用物品 |
| [DisableVineBlockSpread](游戏规则.md#disablevineblockspread) | <span style="display:inline;color:#ff5555">服务端</span> | 设置是否禁用藤曼蔓延生长 |
| [ForbidLiquidFlow](游戏规则.md#forbidliquidflow) | <span style="display:inline;color:#ff5555">服务端</span> | 禁止/允许地图中的流体流动 |
| [GetBannedItemList](游戏规则.md#getbanneditemlist) | <span style="display:inline;color:#ff5555">服务端</span> | 获取禁用物品列表 |
| [GetGameDiffculty](游戏规则.md#getgamediffculty) | <span style="display:inline;color:#ff5555">服务端</span> | 获取游戏难度 |
| [GetGameRulesInfoServer](游戏规则.md#getgamerulesinfoserver) | <span style="display:inline;color:#ff5555">服务端</span> | 获取游戏规则 |
| [GetGameType](游戏规则.md#getgametype) | <span style="display:inline;color:#ff5555">服务端</span> | 获取默认游戏模式 |
| [GetLevelGravity](游戏规则.md#getlevelgravity) | <span style="display:inline;color:#ff5555">服务端</span> | 获取重力因子 |
| [GetPistonMaxInteractionCount](游戏规则.md#getpistonmaxinteractioncount) | <span style="display:inline;color:#ff5555">服务端</span> | 获取活塞/粘性活塞最多推动的方块数量，默认为12个方块，可能被其他开发者修改。 |
| [GetPistonMaxInteractionCount](游戏规则.md#getpistonmaxinteractioncount) | <span style="display:inline;color:#7575f9">客户端</span> | 获取活塞/粘性活塞最多推动的方块数量，默认为12个方块，可能被其他开发者修改。 |
| [GetSeed](游戏规则.md#getseed) | <span style="display:inline;color:#ff5555">服务端</span> | 获取存档种子 |
| [IsDisableCommandMinecart](游戏规则.md#isdisablecommandminecart) | <span style="display:inline;color:#ff5555">服务端</span> | 获取当前是否允许运行命令方块矿车内置逻辑指令，当前仅Apollo网络服可用 |
| [IsLockDifficulty](游戏规则.md#islockdifficulty) | <span style="display:inline;color:#ff5555">服务端</span> | 获取当前世界的游戏难度是否被锁定 |
| [IsLockGameRulesInfo](游戏规则.md#islockgamerulesinfo) | <span style="display:inline;color:#ff5555">服务端</span> | 获取当前世界的游戏规则是否被锁定 |
| [IsLockGameType](游戏规则.md#islockgametype) | <span style="display:inline;color:#ff5555">服务端</span> | 获取当前世界的游戏类型是否被锁定，包括默认游戏类型和个人游戏类型 |
| [LockDifficulty](游戏规则.md#lockdifficulty) | <span style="display:inline;color:#ff5555">服务端</span> | 锁定当前世界游戏难度（仅本次游戏有效），锁定后任何玩家在游戏内都无法通过指令或暂停菜单修改游戏难度 |
| [LockGameRulesInfo](游戏规则.md#lockgamerulesinfo) | <span style="display:inline;color:#ff5555">服务端</span> | 锁定当前世界游戏规则（仅本次游戏有效），玩家无法通过指令、游戏菜单或api修改游戏规则（包括[SetGameRulesInfoServer](游戏规则.md#setgamerulesinfoserver)示例中列举的规则） |
| [LockGameType](游戏规则.md#lockgametype) | <span style="display:inline;color:#ff5555">服务端</span> | 锁定当前世界游戏类型（仅本次游戏有效），玩家无法通过指令、游戏菜单或相关api如[SetPlayerGameType](../玩家/游戏模式.md#setplayergametype)和[SetDefaultGameType](游戏规则.md#setdefaultgametype)修改游戏类型，包括默认游戏类型和个人游戏类型 |
| [OpenCityProtect](游戏规则.md#opencityprotect) | <span style="display:inline;color:#ff5555">Apollo</span> | 开启城市保护，包括禁止破坏方块，禁止对方块使用物品，禁止怪物攻击玩家，禁止玩家之间互相攻击，禁止日夜切换，禁止天气变化，禁止怪物群落刷新 |
| [RemoveBannedItem](游戏规则.md#removebanneditem) | <span style="display:inline;color:#ff5555">服务端</span> | 移除禁用物品 |
| [RemoveBlockProtectField](游戏规则.md#removeblockprotectfield) | <span style="display:inline;color:#ff5555">Apollo</span> | 取消一个方块无法被玩家/实体破坏的区域 |
| [SetCanActorSetOnFireByLightning](游戏规则.md#setcanactorsetonfirebylightning) | <span style="display:inline;color:#ff5555">服务端</span> | 禁止/允许闪电点燃实体 |
| [SetCanBlockSetOnFireByLightning](游戏规则.md#setcanblocksetonfirebylightning) | <span style="display:inline;color:#ff5555">服务端</span> | 禁止/允许闪电点燃方块 |
| [SetDefaultGameType](游戏规则.md#setdefaultgametype) | <span style="display:inline;color:#ff5555">服务端</span> | 设置默认游戏模式 |
| [SetDisableCommandMinecart](游戏规则.md#setdisablecommandminecart) | <span style="display:inline;color:#ff5555">服务端</span> | 设置停止/开启运行命令方块矿车内置逻辑指令，当前仅Apollo网络服可用 |
| [SetDisableContainers](游戏规则.md#setdisablecontainers) | <span style="display:inline;color:#ff5555">服务端</span> | 禁止所有容器界面的打开，包括玩家背包，各种包含背包界面的容器方块如工作台与箱子，以及包含背包界面的实体交互如马背包与村民交易 |
| [SetDisableDropItem](游戏规则.md#setdisabledropitem) | <span style="display:inline;color:#ff5555">服务端</span> | 设置禁止丢弃物品 |
| [SetDisableGravityInLiquid](游戏规则.md#setdisablegravityinliquid) | <span style="display:inline;color:#ff5555">服务端</span> | 是否屏蔽所有实体在液体（水、岩浆）中的重力 |
| [SetDisableHunger](游戏规则.md#setdisablehunger) | <span style="display:inline;color:#ff5555">服务端</span> | 设置是否屏蔽饥饿度 |
| [SetGameDifficulty](游戏规则.md#setgamedifficulty) | <span style="display:inline;color:#ff5555">服务端</span> | 设置游戏难度 |
| [SetGameRulesInfoServer](游戏规则.md#setgamerulesinfoserver) | <span style="display:inline;color:#ff5555">服务端</span> | 设置游戏规则。所有参数均可选。 |
| [SetHurtCD](游戏规则.md#sethurtcd) | <span style="display:inline;color:#ff5555">服务端</span> | 设置全局受击间隔CD |
| [SetLevelGravity](游戏规则.md#setlevelgravity) | <span style="display:inline;color:#ff5555">服务端</span> | 设置重力因子 |
| [SetPistonMaxInteractionCount](游戏规则.md#setpistonmaxinteractioncount) | <span style="display:inline;color:#ff5555">服务端</span> | 设置活塞/粘性活塞最多推动的方块数量，默认为12个方块。该设置不存档。 |
### 自定义数据
| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [CleanExtraData](自定义数据.md#cleanextradata) | <span style="display:inline;color:#ff5555">服务端</span> | 清除实体的自定义数据或者世界的自定义数据，清除实体数据时使用对应实体id创建组件，清除世界数据时使用levelId创建组件 |
| [GetExtraData](自定义数据.md#getextradata) | <span style="display:inline;color:#ff5555">服务端</span> | 获取实体的自定义数据或者世界的自定义数据，某个键所对应的值。获取实体数据时使用对应实体id创建组件，获取世界数据时使用levelId创建组件 |
| [GetWholeExtraData](自定义数据.md#getwholeextradata) | <span style="display:inline;color:#ff5555">服务端</span> | 获取完整的实体的自定义数据或者世界的自定义数据，获取实体数据时使用对应实体id创建组件，获取世界数据时使用levelId创建组件 |
| [SaveExtraData](自定义数据.md#saveextradata) | <span style="display:inline;color:#ff5555">服务端</span> | 用于保存实体的自定义数据或者世界的自定义数据 |
| [SetExtraData](自定义数据.md#setextradata) | <span style="display:inline;color:#ff5555">服务端</span> | 用于设置实体的自定义数据或者世界的自定义数据，数据以键值对的形式保存。设置实体数据时使用对应实体id创建组件，设置世界数据时使用levelId创建组件 |
### 指令
| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [GetCommandPermissionLevel](指令.md#getcommandpermissionlevel) | <span style="display:inline;color:#ff5555">服务端</span> | 返回设定使用/op命令时OP的权限等级（对应server.properties中的op-permission-level配置） |
| [GetDefaultPlayerPermissionLevel](指令.md#getdefaultplayerpermissionlevel) | <span style="display:inline;color:#ff5555">服务端</span> | 返回新玩家加入时的权限身份（对应server.properties中的default-player-permission-level配置） |
| [SetCommand](指令.md#setcommand) | <span style="display:inline;color:#ff5555">服务端</span> | 使用游戏内指令 |
| [SetCommandPermissionLevel](指令.md#setcommandpermissionlevel) | <span style="display:inline;color:#ff5555">服务端</span> | 设置当玩家使用/op命令时OP的权限等级（对应server.properties中的op-permission-level配置） |
| [SetDefaultPlayerPermissionLevel](指令.md#setdefaultplayerpermissionlevel) | <span style="display:inline;color:#ff5555">服务端</span> | 设置新玩家加入时的权限身份（对应server.properties中的default-player-permission-level配置） |
### 消息
| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [NotifyOneMessage](消息.md#notifyonemessage) | <span style="display:inline;color:#ff5555">服务端</span> | 给指定玩家发送聊天框消息 |
| [SendMsg](消息.md#sendmsg) | <span style="display:inline;color:#ff5555">服务端</span> | 模拟玩家给所有人发送聊天栏消息 |
| [SendMsgToPlayer](消息.md#sendmsgtoplayer) | <span style="display:inline;color:#ff5555">服务端</span> | 模拟玩家给另一个玩家发送聊天栏消息 |
| [SetLeftCornerNotify](消息.md#setleftcornernotify) | <span style="display:inline;color:#7575f9">客户端</span> | 客户端设置左上角通知信息 |
| [SetNotifyMsg](消息.md#setnotifymsg) | <span style="display:inline;color:#ff5555">服务端</span> | 设置消息通知 |
| [SetOnePopupNotice](消息.md#setonepopupnotice) | <span style="display:inline;color:#ff5555">服务端</span> | 在具体某个玩家的物品栏上方弹出popup类型通知，位置位于tip类型消息下方，此功能更建议客户端使用game组件的对应接口SetPopupNotice |
| [SetOneTipMessage](消息.md#setonetipmessage) | <span style="display:inline;color:#ff5555">服务端</span> | 在具体某个玩家的物品栏上方弹出tip类型通知，位置位于popup类型通知上方，此功能更建议在客户端使用game组件的对应接口SetTipMessage |
| [SetPopupNotice](消息.md#setpopupnotice) | <span style="display:inline;color:#ff5555">服务端</span> | 在所有玩家物品栏上方弹出popup类型通知，位置位于tip类型消息下方 |
| [SetPopupNotice](消息.md#setpopupnotice) | <span style="display:inline;color:#7575f9">客户端</span> | 在本地玩家的物品栏上方弹出popup类型通知，位置位于tip类型消息下方 |
| [SetPopupState](消息.md#setpopupstate) | <span style="display:inline;color:#7575f9">客户端</span> | 设置Popup消息栏状态 |
| [SetTipMessage](消息.md#settipmessage) | <span style="display:inline;color:#ff5555">服务端</span> | 在所有玩家物品栏上方弹出tip类型通知，位置位于popup类型通知上方 |
| [SetTipMessage](消息.md#settipmessage) | <span style="display:inline;color:#7575f9">客户端</span> | 在本地玩家的物品栏上方弹出tip类型通知，位置位于popup类型通知上方 |
### 记分板
| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [GetAllPlayerScoreboardObjects](记分板.md#getallplayerscoreboardobjects) | <span style="display:inline;color:#ff5555">服务端</span> | 获取玩家记分项 |
| [GetAllPlayerScoreboardObjects](记分板.md#getallplayerscoreboardobjects) | <span style="display:inline;color:#7575f9">客户端</span> | 获取玩家记分项 |
| [GetAllScoreboardObjects](记分板.md#getallscoreboardobjects) | <span style="display:inline;color:#ff5555">服务端</span> | 获取所有记分板项 |
| [GetAllScoreboardObjects](记分板.md#getallscoreboardobjects) | <span style="display:inline;color:#7575f9">客户端</span> | 获取所有记分板项 |
Reference in New Issue View Git Blame Copy Permalink