netease-bedrock-wiki/mcguide/9-规范开发/5-多人联机适配规范.md

front, hard, time, selection

front	hard	time	selection
https://nie.res.netease.com/r/pic/20220408/fd58eff7-ab4c-4f98-94b5-87912c6e8e4d.png	入门	15分钟	true

多人联机适配规范

前言

最近，在山头测试中，我们发现很多开发者的模组明明在单人游戏运行是非常正常的，但在山头、多人联机环境下就会出现功能无效或者异常的情况

只要遵循 ServerSystem 与 ClientSystem 严格分离 的原则，大部分兼容性问题都能自然消失。

开发范例

下方代码为错误示范。仅供参考和通俗化解释，并不能实际运行！

modClient.py

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

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接口建议 提出接口建议

当你遵循上述开发原则，即客户端和服务端分离，您开发的模组基本天然兼容多人联机和我的山头的环境