11m03d官网文档同步
This commit is contained in:
kwiilh
2025-11-03 17:09:35 +08:00
parent 6276db64e0
commit fc5d4989a4
47 changed files with 2264 additions and 44 deletions

View File

@@ -0,0 +1,59 @@
---
front: https://nie.res.netease.com/r/pic/20220408/fd58eff7-ab4c-4f98-94b5-87912c6e8e4d.png
hard: 入门
time: 15分钟
selection: true
---
# 多人联机适配规范
## 前言
最近,在山头测试中,我们发现很多开发者的模组明明在单人游戏运行是非常正常的,但在山头、多人联机环境下就会出现功能无效或者异常的情况
后面我们发现,实际上只要遵循 ServerSystem 和 ClientSystem 分离的原则。基本上就能保证开发的模组兼容山头服和多人联机
## 开发范例
> 下方代码仅供参考和通俗化解释,并不能实际运行!
**modClient.py**
```python
import mod.client.extraClientApi as clientApi
class ModClient(clientApi.GetClientSystemCls()):
def Register(self):
self.NotifyToServer("test", {})
print("register successfully")
# TODO
def NoClientApiRegister(self):
print("register successfully")
# TODO
```
**modServer.py**
```python
import mod.client.extraClientApi as serverApi
from xxx.xxx.xxx import ModClient
class ModServer(serverApi.GetServerSystemCls()):
def ServerRegister(self):
ModClient.NoClientApiRegister()
print("register successfully")
# TODO
```
可以看到 上面的 `modClient.py` 引入了 `clientApi`
而 ModServer 这边希望能够调用到 `ModClient` 类里的 `NoClientApiRegister` 方法
虽然这个方法仅仅只是简单的 print并不涉及 `clientApi` 里的任何方法
但由于 `ModClient` import了 `clientApi`,此时 `ModServer` 在初始化的时候就会报错,类里的方法都不会被正常执行
由上述例子可以得出
在开发模组时,应该避免在 ServerSystem 下的子类引用客户端的接口和方法
如果无法满足要求,可以前往**开发者平台-反馈与建议** 或者 **[Github接口建议](https://github.com/MCNeteaseDevs/SDK-Campaign/issues) 提出接口建议
当你遵循上述开发原则,即客户端和服务端分离,您开发的模组基本天然兼容多人联机和我的山头的环境

View File

@@ -0,0 +1,10 @@
---
front: https://nie.res.netease.com/r/pic/20220408/fd58eff7-ab4c-4f98-94b5-87912c6e8e4d.png
hard: 入门
time: 15分钟
selection: true
---
# 模型规范指南
[点击前往快捷链接](https://mc.163.com/dev/mcmanual/mc-dev/mcguide/16-%E7%BE%8E%E6%9C%AF/6-%E6%A8%A1%E5%9E%8B%E5%92%8C%E5%8A%A8%E4%BD%9C/%E6%A8%A1%E5%9E%8B%E8%A7%84%E8%8C%83%E6%8C%87%E5%8D%97.html?catalog=1)

View File

@@ -0,0 +1,10 @@
---
front: https://nie.res.netease.com/r/pic/20220408/fd58eff7-ab4c-4f98-94b5-87912c6e8e4d.png
hard: 入门
time: 15分钟
selection: true
---
# 性能优化规范
[点击前往快捷链接](https://mc.163.com/dev/mcmanual/mc-dev/mcguide/20-%E7%8E%A9%E6%B3%95%E5%BC%80%E5%8F%91/18-%E6%80%A7%E8%83%BD%E4%BC%98%E5%8C%96/%E4%BB%A3%E7%A0%81%E4%BC%98%E5%8C%96.html?catalog=1)

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 93 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

View File

@@ -0,0 +1,473 @@
{
"format_version": "1.12.0",
"minecraft:geometry": [
{
"description": {
"identifier": "geometry.standard_steve",
"texture_width": 64,
"texture_height": 64,
"visible_bounds_width": 3,
"visible_bounds_height": 4,
"visible_bounds_offset": [0, 1, 0]
},
"bones": [
{
"name": "root",
"pivot": [0, 0, 0]
},
{
"name": "waist",
"parent": "root",
"pivot": [0, 12, 0]
},
{
"name": "body",
"parent": "waist",
"pivot": [0, 24, 0],
"cubes": [
{
"origin": [-4, 16, -2],
"size": [8, 8, 4],
"uv": {
"north": {"uv": [20, 20], "uv_size": [8, 8]},
"east": {"uv": [16, 20], "uv_size": [4, 8]},
"south": {"uv": [32, 20], "uv_size": [8, 8]},
"west": {"uv": [28, 20], "uv_size": [4, 8]},
"up": {"uv": [20, 16], "uv_size": [8, 4]},
"down": {"uv": [28, 20], "uv_size": [8, -4]}
}
}
]
},
{
"name": "head",
"parent": "body",
"pivot": [0, 24, 0],
"cubes": [
{
"origin": [-4, 24, -4],
"size": [8, 8, 8],
"uv": {
"north": {"uv": [8, 8], "uv_size": [8, 8]},
"east": {"uv": [0, 8], "uv_size": [8, 8]},
"south": {"uv": [24, 8], "uv_size": [8, 8]},
"west": {"uv": [16, 8], "uv_size": [8, 8]},
"up": {"uv": [8, 0], "uv_size": [8, 8]},
"down": {"uv": [16, 8], "uv_size": [8, -8]}
}
}
]
},
{
"name": "hat",
"parent": "head",
"pivot": [0, 24, 0],
"cubes": [
{
"origin": [-4, 24, -4],
"size": [8, 8, 8],
"inflate": 0.25,
"uv": {
"north": {"uv": [40, 8], "uv_size": [8, 8]},
"east": {"uv": [32, 8], "uv_size": [8, 8]},
"south": {"uv": [56, 8], "uv_size": [8, 8]},
"west": {"uv": [48, 8], "uv_size": [8, 8]},
"up": {"uv": [40, 0], "uv_size": [8, 8]},
"down": {"uv": [48, 8], "uv_size": [8, -8]}
}
}
]
},
{
"name": "cape",
"parent": "body",
"pivot": [0, 24, 3]
},
{
"name": "leftArm",
"parent": "body",
"pivot": [5, 22, 0],
"cubes": [
{
"origin": [4, 18, -2],
"size": [4, 6, 4],
"uv": {
"north": {"uv": [36, 52], "uv_size": [4, 6]},
"east": {"uv": [32, 52], "uv_size": [4, 6]},
"south": {"uv": [44, 52], "uv_size": [4, 6]},
"west": {"uv": [40, 52], "uv_size": [4, 6]},
"up": {"uv": [36, 48], "uv_size": [4, 4]},
"down": {"uv": [40, 52], "uv_size": [4, -4]}
}
}
]
},
{
"name": "leftArmDown",
"parent": "leftArm",
"pivot": [5, 18, 0],
"cubes": [
{
"origin": [4, 12, -2],
"size": [4, 6, 4],
"uv": {
"north": {"uv": [36, 58], "uv_size": [4, 6]},
"east": {"uv": [32, 58], "uv_size": [4, 6]},
"south": {"uv": [44, 58], "uv_size": [4, 6]},
"west": {"uv": [40, 58], "uv_size": [4, 6]},
"up": {"uv": [40, 48], "uv_size": [4, 4]},
"down": {"uv": [40, 52], "uv_size": [4, -4]}
}
}
]
},
{
"name": "leftSleeveDown",
"parent": "leftArmDown",
"pivot": [5, 18.25, 0],
"cubes": [
{
"origin": [4, 12, -2],
"size": [4, 6, 4],
"inflate": 0.25,
"uv": {
"north": {"uv": [52, 58], "uv_size": [4, 6]},
"east": {"uv": [48, 58], "uv_size": [4, 6]},
"south": {"uv": [60, 58], "uv_size": [4, 6]},
"west": {"uv": [56, 58], "uv_size": [4, 6]},
"up": {"uv": [56, 48], "uv_size": [4, 4]},
"down": {"uv": [56, 52], "uv_size": [4, -4]}
}
}
]
},
{
"name": "leftItem",
"parent": "leftArmDown",
"pivot": [6, 15, 1]
},
{
"name": "leftSleeve",
"parent": "leftArm",
"pivot": [5, 22, 0],
"cubes": [
{
"origin": [4, 18, -2],
"size": [4, 6, 4],
"inflate": 0.25,
"uv": {
"north": {"uv": [52, 52], "uv_size": [4, 6]},
"east": {"uv": [48, 52], "uv_size": [4, 6]},
"south": {"uv": [60, 52], "uv_size": [4, 6]},
"west": {"uv": [56, 52], "uv_size": [4, 6]},
"up": {"uv": [52, 48], "uv_size": [4, 4]},
"down": {"uv": [56, 52], "uv_size": [4, -4]}
}
}
]
},
{
"name": "rightArm",
"parent": "body",
"pivot": [-5, 22, 0],
"cubes": [
{
"origin": [-8, 18, -2],
"size": [4, 6, 4],
"uv": {
"north": {"uv": [40, 52], "uv_size": [-4, 6]},
"east": {"uv": [44, 52], "uv_size": [-4, 6]},
"south": {"uv": [48, 52], "uv_size": [-4, 6]},
"west": {"uv": [36, 52], "uv_size": [-4, 6]},
"up": {"uv": [40, 48], "uv_size": [-4, 4]},
"down": {"uv": [44, 52], "uv_size": [-4, -4]}
}
}
]
},
{
"name": "rightArmDown",
"parent": "rightArm",
"pivot": [-5, 18, 0],
"cubes": [
{
"origin": [-8, 12, -2],
"size": [4, 6, 4],
"uv": {
"north": {"uv": [40, 58], "uv_size": [-4, 6]},
"east": {"uv": [44, 58], "uv_size": [-4, 6]},
"south": {"uv": [48, 58], "uv_size": [-4, 6]},
"west": {"uv": [36, 58], "uv_size": [-4, 6]},
"up": {"uv": [44, 48], "uv_size": [-4, 4]},
"down": {"uv": [44, 52], "uv_size": [-4, -4]}
}
}
]
},
{
"name": "rightISleeveDown",
"parent": "rightArmDown",
"pivot": [-5, 18.25, 0],
"cubes": [
{
"origin": [-8, 12, -2],
"size": [4, 6, 4],
"inflate": 0.25,
"uv": {
"north": {"uv": [48, 42], "uv_size": [-4, 6]},
"east": {"uv": [52, 42], "uv_size": [-4, 6]},
"south": {"uv": [56, 42], "uv_size": [-4, 6]},
"west": {"uv": [44, 42], "uv_size": [-4, 6]},
"up": {"uv": [52, 32], "uv_size": [-4, 4]},
"down": {"uv": [52, 36], "uv_size": [-4, -4]}
}
}
]
},
{
"name": "rightItem",
"parent": "rightArmDown",
"pivot": [-6, 15, 1],
"locators": {
"lead_hold": [-6, 15, 1]
}
},
{
"name": "rightSleeve",
"parent": "rightArm",
"pivot": [-5, 22, 0],
"cubes": [
{
"origin": [-8, 18, -2],
"size": [4, 6, 4],
"inflate": 0.25,
"uv": {
"north": {"uv": [48, 36], "uv_size": [-4, 6]},
"east": {"uv": [52, 36], "uv_size": [-4, 6]},
"south": {"uv": [56, 36], "uv_size": [-4, 6]},
"west": {"uv": [44, 36], "uv_size": [-4, 6]},
"up": {"uv": [48, 32], "uv_size": [-4, 4]},
"down": {"uv": [52, 36], "uv_size": [-4, -4]}
}
}
]
},
{
"name": "jacket",
"parent": "body",
"pivot": [0, 24, 0],
"cubes": [
{
"origin": [-4, 16, -2],
"size": [8, 8, 4],
"inflate": 0.25,
"uv": {
"north": {"uv": [20, 36], "uv_size": [8, 8]},
"east": {"uv": [16, 36], "uv_size": [4, 8]},
"south": {"uv": [32, 36], "uv_size": [8, 8]},
"west": {"uv": [28, 36], "uv_size": [4, 8]},
"up": {"uv": [20, 32], "uv_size": [8, 4]},
"down": {"uv": [28, 36], "uv_size": [8, -4]}
}
}
]
},
{
"name": "bodyDown",
"parent": "waist",
"pivot": [0, 16, 0],
"cubes": [
{
"origin": [-4, 12, -2],
"size": [8, 4, 4],
"uv": {
"north": {"uv": [20, 28], "uv_size": [8, 4]},
"east": {"uv": [16, 28], "uv_size": [4, 4]},
"south": {"uv": [32, 28], "uv_size": [8, 4]},
"west": {"uv": [28, 28], "uv_size": [4, 4]},
"up": {"uv": [28, 16], "uv_size": [8, 4]},
"down": {"uv": [28, 20], "uv_size": [8, -4]}
}
}
]
},
{
"name": "jacketDown",
"parent": "bodyDown",
"pivot": [0, 16.25, 0],
"cubes": [
{
"origin": [-4, 12, -2],
"size": [8, 4, 4],
"inflate": 0.25,
"uv": {
"north": {"uv": [20, 44], "uv_size": [8, 4]},
"east": {"uv": [16, 44], "uv_size": [4, 4]},
"south": {"uv": [32, 44], "uv_size": [8, 4]},
"west": {"uv": [28, 44], "uv_size": [4, 4]},
"up": {"uv": [0, 4], "uv_size": [8, 4]},
"down": {"uv": [0, 4], "uv_size": [8, -4]}
}
}
]
},
{
"name": "leftLeg",
"parent": "root",
"pivot": [1.9, 12, 0],
"cubes": [
{
"origin": [-0.1, 6, -2],
"size": [4, 6, 4],
"uv": {
"north": {"uv": [20, 52], "uv_size": [4, 6]},
"east": {"uv": [16, 52], "uv_size": [4, 6]},
"south": {"uv": [28, 52], "uv_size": [4, 6]},
"west": {"uv": [24, 52], "uv_size": [4, 6]},
"up": {"uv": [20, 48], "uv_size": [4, 4]},
"down": {"uv": [24, 52], "uv_size": [4, -4]}
}
}
]
},
{
"name": "leftPants",
"parent": "leftLeg",
"pivot": [1.9, 12, 0],
"cubes": [
{
"origin": [-0.1, 6, -2],
"size": [4, 6, 4],
"inflate": 0.25,
"uv": {
"north": {"uv": [4, 52], "uv_size": [4, 6]},
"east": {"uv": [0, 52], "uv_size": [4, 6]},
"south": {"uv": [12, 52], "uv_size": [4, 6]},
"west": {"uv": [8, 52], "uv_size": [4, 6]},
"up": {"uv": [4, 48], "uv_size": [4, 4]},
"down": {"uv": [8, 52], "uv_size": [4, -4]}
}
}
]
},
{
"name": "leftLegDown",
"parent": "leftLeg",
"pivot": [1.9, 6, 0],
"cubes": [
{
"origin": [-0.1, 0, -2],
"size": [4, 6, 4],
"uv": {
"north": {"uv": [20, 58], "uv_size": [4, 6]},
"east": {"uv": [16, 58], "uv_size": [4, 6]},
"south": {"uv": [28, 58], "uv_size": [4, 6]},
"west": {"uv": [24, 58], "uv_size": [4, 6]},
"up": {"uv": [24, 48], "uv_size": [4, 4]},
"down": {"uv": [24, 52], "uv_size": [4, -4]}
}
}
]
},
{
"name": "leftPantsDown",
"parent": "leftLegDown",
"pivot": [1.9, 6.25, 0],
"cubes": [
{
"origin": [-0.1, 0, -2],
"size": [4, 6, 4],
"inflate": 0.25,
"uv": {
"north": {"uv": [4, 58], "uv_size": [4, 6]},
"east": {"uv": [0, 58], "uv_size": [4, 6]},
"south": {"uv": [12, 58], "uv_size": [4, 6]},
"west": {"uv": [8, 58], "uv_size": [4, 6]},
"up": {"uv": [8, 48], "uv_size": [4, 4]},
"down": {"uv": [8, 52], "uv_size": [4, -4]}
}
}
]
},
{
"name": "rightLeg",
"parent": "root",
"pivot": [-1.9, 12, 0],
"cubes": [
{
"origin": [-3.9, 6, -2],
"size": [4, 6, 4],
"uv": {
"north": {"uv": [24, 52], "uv_size": [-4, 6]},
"east": {"uv": [28, 52], "uv_size": [-4, 6]},
"south": {"uv": [32, 52], "uv_size": [-4, 6]},
"west": {"uv": [20, 52], "uv_size": [-4, 6]},
"up": {"uv": [24, 48], "uv_size": [-4, 4]},
"down": {"uv": [28, 52], "uv_size": [-4, -4]}
}
}
]
},
{
"name": "rightPants",
"parent": "rightLeg",
"pivot": [-1.9, 12, 0],
"cubes": [
{
"origin": [-3.9, 6, -2],
"size": [4, 6, 4],
"inflate": 0.25,
"uv": {
"north": {"uv": [8, 36], "uv_size": [-4, 6]},
"east": {"uv": [12, 36], "uv_size": [-4, 6]},
"south": {"uv": [16, 36], "uv_size": [-4, 6]},
"west": {"uv": [4, 36], "uv_size": [-4, 6]},
"up": {"uv": [8, 32], "uv_size": [-4, 4]},
"down": {"uv": [12, 36], "uv_size": [-4, -4]}
}
}
]
},
{
"name": "rightLegDown",
"parent": "rightLeg",
"pivot": [-1.9, 6, 0],
"cubes": [
{
"origin": [-3.9, 0, -2],
"size": [4, 6, 4],
"uv": {
"north": {"uv": [24, 58], "uv_size": [-4, 6]},
"east": {"uv": [28, 58], "uv_size": [-4, 6]},
"south": {"uv": [32, 58], "uv_size": [-4, 6]},
"west": {"uv": [20, 58], "uv_size": [-4, 6]},
"up": {"uv": [28, 48], "uv_size": [-4, 4]},
"down": {"uv": [28, 52], "uv_size": [-4, -4]}
}
}
]
},
{
"name": "rightPantsDown",
"parent": "rightLegDown",
"pivot": [-1.9, 6.25, 0],
"cubes": [
{
"origin": [-3.9, 0, -2],
"size": [4, 6, 4],
"inflate": 0.25,
"uv": {
"north": {"uv": [8, 42], "uv_size": [-4, 6]},
"east": {"uv": [12, 42], "uv_size": [-4, 6]},
"south": {"uv": [16, 42], "uv_size": [-4, 6]},
"west": {"uv": [4, 42], "uv_size": [-4, 6]},
"up": {"uv": [12, 32], "uv_size": [-4, 4]},
"down": {"uv": [12, 36], "uv_size": [-4, -4]}
}
}
]
}
]
}
]
}

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.8 KiB