发现问题,我要反馈

GameServer命令行工具

命令行工具简介

matchvs命令行工具是由Matchvs开发平台提供的命令行执行工具,可以在Windows、Linux和Mac系统中使用。 该命令行工具提供了以下功能:创建gameServer、启动服务、重启服务、查看gameServer列表。

命令行工具下载地址 注意:在下载页面的底部

安装说明:

Windows环境

  • 在D盘创建目录 matchvs (这里创建的目录仅仅是个示例,用户可以使用任意的目录名,可以在任何路径下)

  • 将下载的可执行文件 matchvs.exe 放到 D:\matchvs 目录下

  • 修改环境变量:PATH,将 D:\matchvs 追加在变量值后面,与前面的内容用 ;隔开

image

  • 安装完成后,打开DOS窗口,执行 matchvs;结果如下,表示安装成功。

image

Linux环境

  • 将下载的可执行文件matchvs放到随意的目录,比如 /home/test/mvs
  • 添加可执行权限:chmod +x matchvs
  • 修改环境变量: 执行命令:export PATH=$PATH:/home/test/mvs (这种每次打开终端都要执行) 为了在启动终端时都有效,在帐号根目录的文件 .bash_profile 中添加,然后执行 source .bash_profile

image

  • 添加完成后,执行matchvs help,如下图效果表示安装成功

image

Mac环境

参考Linux环境安装配置步骤。

开发者帐号登录

matchvs login

使用在Matchvs官网 注册邮箱gameServer 列表顶部密码进行登录,如果还没有官网账号,请前往Matchvs官网进行注册。

系统生成的账号密码用于登录命令行工具和git仓库:

根据提示输入账号密码进行登录:

F:\>matchvs login
    Email or Mobile phone:                         # 输入官网注册的账号邮箱
    Password:                                     # 输入gameServer列表页的密码
    1 -- Matchvs
    2 -- Cocos
    3 -- Egret(白鹭)
    4 -- 阿里云
    channel(请在上面的渠道列表选择,输入序号):        # 选择账号注册渠道

输入账号和密码,然后命令行工具会提示选择账号注册渠道,这里根据自己的账号类型进行选择:

  • Matchvs:直接在Matchvs官网注册的用户
  • Cocos:Cocos授权登录的用户,登录账号为 Cocos 的注册邮箱
  • Egret:Egret授权登录的用户,登录账号为 Egret 的注册邮箱
  • 阿里云:购买阿里云市场 Matchvs 镜像版的用户

同一个邮箱可以在多个渠道注册,但是数据并不互通。

查看gameServer列表

matchvs list 查看帐号下的gameServer列表 image

查看gameServer详情

matchvs info <GS_key>

查看指定gameServer的详细信息

image

创建gameServer

matchvs create <GS_name> <gameID>

指定游戏ID和gameServer名称,创建一个gameServer

image

发布gameServer

matchvs publish <GS_key>

发布gameServer到镜像仓库,GS_key可通过matchvs list 查看。

注意: 操作前需要将代码上传至Matchvs指定的git仓库。

image

启停gameServer

matchvs run start <GS_key>

启动gameServer服务

注意 : 官网控制台上的启动操作已经包含了发布过程。但命令行工具在gameServer第一次启动时,请务必确认有执行matchvs publish <GS_key>

image

matchvs run stop <GS_key>

停止gameServer服务

image

matchvs run restart <GS_key>

重启gameServer服务

image

开启调试模式

matchvs debug <GS_key>

Matchvs 提供了gameServer的本地调试功能,通过以上命令可以开启调试模式。

image

最后更新于 27th Feb 2019