xiaokun/netease-modsdk-wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新3.4API

Browse Source
This commit is contained in:
boybook
2025-06-27 23:59:47 +08:00
parent c0f98b179b
commit 12738a142c
52 changed files with 1146 additions and 292 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
docs/mcdocs/1-ModAPI/接口/世界/地图.md
View File

@@ -202,7 +202,7 @@ method in mod.server.component.explosionCompServer.ExplosionComponentServer
| 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
| :--- | :--- | :--- |
| pos | tuple(float,float,float) | 爆炸位置 |
| radius | int | 爆炸威力，具体含义可参考[wiki](https://minecraft-zh.gamepedia.com/%E7%88%86%E7%82%B8)对爆炸的解释 |
| radius | int | 爆炸威力，具体含义可参考[wiki](https://zh.minecraft.wiki/w/%E7%88%86%E7%82%B8)对爆炸的解释 |
| fire | bool | 是否带火 |
| breaks | bool | 是否破坏方块 |
| sourceId | str | 爆炸伤害源的实体id |
@@ -1344,7 +1344,7 @@ method in mod.server.component.featureCompServer.FeatureCompServer
- 描述
与[/locate指令](https://minecraft-zh.gamepedia.com/%E5%91%BD%E4%BB%A4/locate)相似，用于定位<a href="../../../../mcguide/20-玩法开发/15-自定义游戏内容/4-自定义维度/4-自定义特征.html#特征规则（feature-rules）">网易自定义特征规则</a>
与[/locate指令](https://zh.minecraft.wiki/w/%E5%91%BD%E4%BB%A4/locate)相似，用于定位<a href="../../../../mcguide/20-玩法开发/15-自定义游戏内容/4-自定义维度/4-自定义特征.html#特征规则（feature-rules）">网易自定义特征规则</a>
- 参数
@@ -1384,7 +1384,7 @@ method in mod.server.component.featureCompServer.FeatureCompServer
- 描述
与[/locate指令](https://minecraft-zh.gamepedia.com/%E5%91%BD%E4%BB%A4/locate)相似，用于定位原版的部分结构，如海底神殿、末地城等。
与[/locate指令](https://zh.minecraft.wiki/w/%E5%91%BD%E4%BB%A4/locate)相似，用于定位原版的部分结构，如海底神殿、末地城等。
- 参数
@@ -1566,7 +1566,7 @@ method in mod.server.component.gameCompServer.GameComponentServer
- 描述
放置特征，与[/placefeature指令](https://minecraft.fandom.com/zh/wiki/%E5%91%BD%E4%BB%A4/placefeature)相似
放置特征，与[/placefeature指令](https://zh.minecraft.wiki/w/%E5%91%BD%E4%BB%A4/placefeature)相似
- 参数
@@ -1706,7 +1706,7 @@ method in mod.server.component.chunkSourceComp.ChunkSourceCompServer
- 备注
- key必须唯一，若添加区域时key已存在将添加失败。
- 该方式创建的常加载区域不会tick，即实体，方块实体，随机刻都不会进行更新。若需要区域被tick，请使用原版[tickingarea指令](https://minecraft-zh.gamepedia.com/%E5%91%BD%E4%BB%A4/tickingarea)。
- 该方式创建的常加载区域不会tick，即实体，方块实体，随机刻都不会进行更新。若需要区域被tick，请使用原版[tickingarea指令](https://zh.minecraft.wiki/w/%E5%91%BD%E4%BB%A4/tickingarea)。
- 将当前未加载的区块设置为常加载区块时，不会从存档加载生物。但如果是当前已加载的区块，则玩家远离区块后，区块内的实体会一直保持加载。
- 常加载区块内可以使用api创建实体、放置方块、放置结构、修改方块实体数据。
- 由于区块加载算法的特性，不保证最小到最大坐标的区块完全加载并可用（即CheckChunkState接口返回True），建议将操作位置的四周外延80格的区域都设置为常加载，例如需要在(0,5,0)的位置生成生物/放置方块，需要将(-80,0,-80)到(80,0,80)的区域设置为常加载。
@@ -1942,11 +1942,11 @@ method in mod.server.component.gameCompServer.GameComponentServer
- 备注
- 同时设置dimensionId与pos时，出生点被设置在对应维度的对应坐标。
只设置dimensionId，而pos为None时，出生点设置为对应维度，而坐标将通过[基岩版世界生成搜索](https://minecraft.fandom.com/zh/wiki/%E7%94%9F%E6%88%90#.E5.9F.BA.E5.B2.A9.E7.89.88.E4.B8.96.E7.95.8C.E7.94.9F.E6.88.90.E6.90.9C.E7.B4.A2)决定。
只设置dimensionId，而pos为None时，出生点设置为对应维度，而坐标将通过[基岩版世界生成搜索](https://zh.minecraft.wiki/w/%E7%94%9F%E6%88%90#%E7%8E%A9%E5%AE%B6%E7%94%9F%E6%88%90)决定。
只设置pos，而dimensionId为None，则出生点设置为当前出生维度的对应坐标，与setworldspawn指令相同。
- 将pos的y轴设置为65535，表示出生到xz坐标轴的最高实心方块上。
- 当出生维度的类型是地狱和末地时，不会像主世界一样寻找一个安全的位置出生。
- 关于世界出生点与个人出生点的规则，详见[玩家的生成](https://minecraft.fandom.com/zh/wiki/%E7%94%9F%E6%88%90#.E7.8E.A9.E5.AE.B6.E7.9A.84.E7.94.9F.E6.88.90)
- 关于世界出生点与个人出生点的规则，详见[玩家的生成](https://zh.minecraft.wiki/w/%E7%94%9F%E6%88%90#%E7%8E%A9%E5%AE%B6%E7%94%9F%E6%88%90)
- 注意:如果和/spawnpoint一起使用，则/spawnpoint的优先级更高，SetSpawnDimensionAndPosition将失效
- 示例

7
docs/mcdocs/1-ModAPI/接口/世界/实体管理.md
View File

@@ -713,7 +713,7 @@ method in mod.server.component.gameCompServer.GameComponentServer
- 备注
- 注意，如果检测的实体所在的区块被卸载，则该接口返回False。因此，需要注意实体所在的区块是否被加载。
- 区块卸载：游戏只会加载玩家周围的区块，玩家移动到别的区域时，原来所在区域的区块会被卸载，参考[区块介绍](https://minecraft-zh.gamepedia.com/%E5%8C%BA%E5%9D%97)
- 区块卸载：游戏只会加载玩家周围的区块，玩家移动到别的区域时，原来所在区域的区块会被卸载，参考[区块介绍](https://zh.minecraft.wiki/w/%E5%8C%BA%E5%9D%97)
- 示例
@@ -748,7 +748,7 @@ method in mod.client.component.gameCompClient.GameComponentClient
- 备注
- 注意，如果检测的实体所在的区块被卸载，则该接口返回False。因此，需要注意实体所在的区块是否被加载。
- 区块卸载：游戏只会加载玩家周围的区块，玩家移动到别的区域时，原来所在区域的区块会被卸载，参考[区块介绍](https://minecraft-zh.gamepedia.com/%E5%8C%BA%E5%9D%97)
- 区块卸载：游戏只会加载玩家周围的区块，玩家移动到别的区域时，原来所在区域的区块会被卸载，参考[区块介绍](https://zh.minecraft.wiki/w/%E5%8C%BA%E5%9D%97)
- 示例
@@ -886,9 +886,10 @@ method in mod.server.component.blockInfoCompServer.BlockInfoComponentServer
| pos | tuple(int,int,int) | 掉落位置 |
| aux | int | 方块的附加值 |
| probability | float | 掉落概率，范围为[0, 1]，0为不掉落，1为100%掉落 |
| bonusLootLevel | int | [时运等级](https://minecraft-zh.gamepedia.com/时运)，默认为0 |
| bonusLootLevel | int | [时运等级](https://zh.minecraft.wiki/w/时运)，默认为0 |
| dimensionId | int | 掉落方块的维度，默认值为-1，传入非负值时用于获取产生方块掉落的维度；否则将随机挑选一个存在玩家的维度产生掉落 |
| allowRandomness | bool | 是否允许随机采集，默认为True，如果为False，掉落概率probability无效 |
| spawnOrb | bool | 是否生成经验球，默认都不生成，设成True时按原版采集逻辑进行经验球掉落，如矿石类方块会产生随机数量的经验球 |
- 返回值

2
docs/mcdocs/1-ModAPI/接口/世界/方块管理.md
View File

@@ -446,7 +446,7 @@ method in mod.server.component.blockInfoCompServer.BlockInfoComponentServer
| oldBlockHandling | int | 0：替换，1：销毁，2：保留，默认为0 |
| dimensionId | int | 方块所在维度，必需参数 |
| isLegacy | bool | 是否设置为传统的aux，建议设置为True，即aux对应的state不随着版本迭代而变化。默认为False |
| updateNeighbors | bool | 是否给相邻的方块触发[方块更新](https://minecraft.fandom.com/zh/wiki/%E6%96%B9%E5%9D%97%E6%9B%B4%E6%96%B0?variant=zh)以及BlockNeighborChangedServerEvent事件。默认为True触发。若选择不触发可节省约30%的性能消耗。 |
| updateNeighbors | bool | 是否给相邻的方块触发[方块更新](https://zh.minecraft.wiki/w/%E6%96%B9%E5%9D%97%E6%9B%B4%E6%96%B0)以及BlockNeighborChangedServerEvent事件。默认为True触发。若选择不触发可节省约30%的性能消耗。 |
- 返回值

2
docs/mcdocs/1-ModAPI/接口/世界/消息.md
View File

@@ -19,7 +19,7 @@ method in mod.server.component.msgCompServer.MsgComponentServer
| :--- | :--- | :--- |
| playerId | str | 指定玩家id |
| msg | str | 消息内容 |
| color | str | 颜色样式代码字符串，可参考wiki[样式代码](https://minecraft-zh.gamepedia.com/%E6%A0%B7%E5%BC%8F%E4%BB%A3%E7%A0%81)，默认为白色 |
| color | str | 颜色样式代码字符串，可参考wiki[样式代码](https://zh.minecraft.wiki/w/%E6%A0%BC%E5%BC%8F%E5%8C%96%E4%BB%A3%E7%A0%81)，默认为白色 |
- 返回值

6
docs/mcdocs/1-ModAPI/接口/世界/索引.md
View File

@@ -60,13 +60,13 @@ sidebarDepth: 1
| [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)相似，用于定位原版的部分结构，如海底神殿、末地城等。 |
| [LocateNeteaseFeatureRule](地图.md#locateneteasefeaturerule) | <span style="display:inline;color:#ff5555">服务端</span> | 与[/locate指令](https://zh.minecraft.wiki/w/%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://zh.minecraft.wiki/w/%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)相似 |
| [PlaceFeature](地图.md#placefeature) | <span style="display:inline;color:#ff5555">服务端</span> | 放置特征，与[/placefeature指令](https://zh.minecraft.wiki/w/%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> | 设置区块的常加载 |