英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

XMage——魔法牌，另一个游戏引擎

XMage 是一个完整规则执行引擎，可用于与其他玩家或计算机 AI 在线或在您自己的服务器上玩《魔法牌》。它支持超过 32,000 张独特卡牌和超过 91,000 张官方版本重印卡牌，以及像《星球大战》这样的自定义套牌。

本地服务器支持特殊测试模式，用于在预定义条件下测试组合和其他游戏情况。

有公共服务器可供您与其他玩家一起玩 XMage。您也可以托管自己的服务器来对抗 AI 和/或您的朋友——包括完全脱机模式，无需互联网连接。

XMage 社区与资源：

• 官方 XMage 支持和功能请求（GitHub）;
• Reddit XMage 小组;
• Reddit XMage Discord 频道;
• 最新新闻;
• 最新版本;
• 项目文档.

已发布版本的官方公共服务器：

• https://xmage.today/

其他服务器和状态：

• https://xmage.today/servers/ （暂时停止服务）

功能

• 最受测试的开源规则执行引擎：约9000个单元测试，覆盖率约80%；
• 跨平台支持：Windows、Linux、MacOS；
• 双人对战或多玩家游戏（指挥官及其他模式），最多支持10名玩家；
• 支持选秀、锦标赛和带有副牌的单局游戏；
• 智能且快速的AI对手，适用于游戏和选秀/套牌构建；
• 设计上防作弊：所有规则和隐藏信息在服务器端执行——客户端永远无法查看或操作未授权的数据；
• 套牌编辑器（支持从多个应用和服务导入套牌）；
• 玩家评级系统（Glicko）；
• 支持多种格式和游戏模式，如指挥官、誓约破坏者、方块、微型领袖、超级标准、历史标准等；
• 支持单局比赛或锦标赛（淘汰赛或瑞士轮处理），可最多支持16名玩家参加；

错误报告 / 功能请求

报告错误或功能请求的最佳方式是GitHub 的问题页面。

安装 / 运行

• 下载文件并按照 https://xmage.today/ 上的安装说明进行操作
• 您需要安装 Java 8 或更高版本 才能运行启动器；
• 推荐的解压/安装文件夹：D:\games\xmage（不要使用 Program Files 或下载文件夹）；
• 如果您想与 AI 对手对战，则必须通过启动器运行“服务器”应用程序并通过 localhost 连接它；

维基页面 包含关于私有或公共服务器设置、开发者入门及其他有用信息的详细介绍

故障排除 / 常见问题

Github 问题页面包含常见问题及解决方法：

• Any: 程序在启动时冻结（白屏/蓝屏/黑屏）;
• Any: 无法下载图片或者下载一段时间后停止;
• Any: 无法运行客户端，无法打开 ...jvm.cfg;
• Any: 启动器中没有文本或按钮过小;
• Windows: 卡片、按钮或其他 GUI 绘图异常;
• Windows: 图片、图标和文字像素化;
• MacOS: 无法打开启动器;
• MacOS: 无法在 M1/M2 上运行;
• MacOS: 客户端在 GUI 中冻结（连接对话框、新游戏时）;
• Linux: 在非标准操作系统或硬件上运行，例如 Raspberry Pi;
• Linux: GUI 丑陋和绘图异常;

性能调整

提高性能或修复微卡顿的主要方法——通过特殊的 Java 参数增加最大内存使用量：

1. 运行启动器 -> 设置 -> Java 标签 -> 客户端 Java 选项文本框；
2. 添加或更改现有参数为 -Xmx3000m 或根据你的可用内存调整为其他值（推荐设置：1080p 桌面 2000m，4k 桌面 3000m）。分配 5GB 内存无效；
3. 如果你玩很多 AI 游戏，建议也在服务器 Java 选项中使用相同的值；

开发

完整的项目文档和开发者指南可以在 wiki 页面 中找到。

XMage 开发者的第一步：

• 设置开发环境
• 开发测试工具
• 开发工作流程
• 开发 HOWTO 指南

Torch 图标由 Freepik 创建 - Flaticon