# 多人联机适配规范

# 前言

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

后面我们发现,实际上只要遵循 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接口建议 (opens new window) 提出接口建议

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

https://nie.res.netease.com/r/pic/20220408/fd58eff7-ab4c-4f98-94b5-87912c6e8e4d.png

入门

15分钟

true

前言

开发范例