nanahira/ygopro-server

SRVPro

镜像概述和主要用途

SRVPro是一个YGOPro服务器，现用于萌卡、YGOPro 233服和YGOPro Koishi服，提供在线卡牌对战服务及相关管理功能。

核心功能和特性

支持功能

• Linux和Windows系统运行
• 玩家输入同一房名约战
• 玩家不指定房间名时自动匹配在线玩家
• 房间列表JSON接口
• 广播消息功能
• 召唤台词展示
• 先行卡一键更新
• WindBot在线AI对战
• 萌卡用户登陆支持
• 竞赛模式锁定玩家卡组
• 竞赛模式后台保存录像
• 竞赛模式自动加时赛系统（规则可调）：
  • 0：正常加时赛规则
  • 1：YGOCore战队联盟第十二届联赛使用规则
  • 2：正常加时赛规则 + 1胜规则
  • 3：2018年7月适用的OCG/TCG加时赛规则
• 断线重连功能

不支持功能

• 在线聊天室

使用场景和适用范围

适用于搭建YGOPro在线对战平台，支持玩家对战、AI对战、竞赛组织等场景，可满足卡牌游戏爱好者在线切磋、举办比赛等需求。

详细使用方法和配置说明

Docker镜像信息

• 镜像地址：https://hub.docker.com/r/nanahira/ygopro-server/

镜像标签

• nanahira/ygopro-server:latest：完整镜像，包含所有功能
• nanahira/ygopro-server:lite：基本镜像，云录像和人机对战功能需配合redis和nanahira/windbot镜像使用

端口映射

• 7911：YGOPro服务端口
• 7922：管理后台端口

数据卷

• /ygopro-server/config：SRVPro配置文件数据卷
• /ygopro-server/ygopro/expansions：YGOPro额外卡片数据卷
• /ygopro-server/decks：竞赛模式卡组数据卷
• /ygopro-server/replays：竞赛模式录像数据卷

Docker部署示例

基本运行（完整镜像）

bash
docker run -d \
  -p 7911:7911 \
  -p 7922:7922 \
  -v /path/to/config:/ygopro-server/config \
  -v /path/to/expansions:/ygopro-server/ygopro/expansions \
  -v /path/to/decks:/ygopro-server/decks \
  -v /path/to/replays:/ygopro-server/replays \
  --name ygopro-server \
  docker.xuanyuan.run/nanahira/ygopro-server:latest

竞赛模式启动

bash
docker run -d \
  -p 7911:7911 \
  -p 7922:7922 \
  -v /path/to/config:/ygopro-server/config \
  -v /path/to/expansions:/ygopro-server/ygopro/expansions \
  -v /path/to/decks:/ygopro-server/decks \
  -v /path/to/replays:/ygopro-server/replays \
  --name ygopro-tournament \
  docker.xuanyuan.run/nanahira/ygopro-server:latest \
  pm2-docker start /ygopro-server/data/pm2-docker-tournament.js

基本镜像（需配合其他服务）

yaml
# docker-compose.yml示例
version: '3'
services:
  redis:
    image: docker.xuanyuan.run/redis
    restart: always
  windbot:
    image: docker.xuanyuan.run/nanahira/windbot
    restart: always
  ygopro-server:
    image: docker.xuanyuan.run/nanahira/ygopro-server:lite
    ports:
      - "7911:7911"
      - "7922:7922"
    volumes:
      - /path/to/config:/ygopro-server/config
      - /path/to/expansions:/ygopro-server/ygopro/expansions
      - /path/to/decks:/ygopro-server/decks
      - /path/to/replays:/ygopro-server/replays
    depends_on:
      - redis
      - windbot
    restart: always

管理控制台

• 简易控制台：[] 或 []
• 先行卡更新控制台：[] 或 []

高级功能

• 待补充说明

开发计划

• 重做CTOS和STOC部分
• 模块化附加功能：
  • 房名代码
  • 随机对战
  • 召唤台词
  • WindBot
  • 云录像
  • 比赛模式
  • 先行卡更新
• 用户账号系统和管理员账号系统
• 云录像更换存储方式

TODO

• 重构CTOS和STOC
• 将功能改为模块化：
  • 房间名解析
  • 随机对战
  • 召唤台词
  • WindBot
  • 云录像
  • 竞赛模式
  • 扩展更新器
• 用户和管理员账号系统
• 云录像新数据库

License

SRVPro

Copyright (C) 2013-2018 MoeCube Team

本程序是自由软件：您可以根据自由软件基金会发布的GNU Affero通用公共许可证（第三版或更高版本）的条款重新分发和/或修改它。

本程序的分发旨在希望它有用，但不提供任何明示或暗示的担保，包括但不限于适销性和特定用途适用性的担保。有关更多详细信息，请参见GNU Affero通用公共许可证。

您应已收到本程序随附的GNU Affero通用公共许可证副本。如果没有，请参见https://www.gnu.org/licenses/。