法师 - XMage 万智牌引擎

项目说明

XMage — Magic, Another Game Engine

![Build Status]()
![Latest release]()
![Commits since latest release]()

XMage is a full rules-enforcement 引擎 for playing Magic against other players or computer AI,
online or on your own 服务端. It supports over 32 000 unique cards and more than 91 000 reprints across official sets, plus custom sets like Star Wars.

Local ser a special test mode for testing combos and other 游戏 situations with pre-defined conditions.

There are public servers where you can play XMage against other players.
You can also host your own 服务端 to play against the AI and/or your friends — including fully offline, with no internet connection required.

XMage community and resources:
* Official XMage support and feature request on github;
* Reddit XMage group;
* Reddit XMage discord channel;
* Latest news;
* Latest releases;
* Project documentation.

Official public server with released :
*

Other servers and status:
* (temporarily out of service)

Features

* The most tested open-源码 rules enforcement 引擎: ~9000 unit tests, ~80% co;
* Cross-platform support: Windows, Linux, MacOS;
* Two-player duels or multiplayer games (Commander and others) with up to 10 players;
* Drafts, tournaments and single games with sideboarding supported;
* Smart and fast AI opponents for both games and draft/deck-building;
* Cheat-proof by design: all rules and hidden information are enforced ser — clients never see or act on data they're not authorized to;
* Deck editor (support deck import from multiple apps and services);
* Players rating system (Glicko);
* Supports dozens of formats and 游戏 modes like Commander, Oathbreaker, Cube, Tiny Leaders, Super Standard, Historic Standard and more;
* Single matches or tournaments supported (elimination or swiss type handling), which can be played with up to 16 players;

Bug report / feature request

The best way to report bug or feature request is github's issues page.

Installation / running

* Download files and follow install instructions on
* You need to have Ja 8 or later to run launcher;
* Recommended folder to unpack/install: D:\games\xmage (don't use Program Files or Download folders);
* If you want to play with AI opponents then must run "服务端" app via the launcher and connect to it ;

Wiki page contains detailed information about private or public ser, de onboarding and other useful things

Troubleshooting / FAQ

Github issues page contain popular problems and fixes:
* Any: program freezes on startup (white/blue/black screen);
* Any: can't download images or it stops after some time;
* Any: can't run 客户端, could not open ...jvm.cfg;
* Any: no texts or small buttons in launcher;
* Windows: ugly cards, buttons or other 界面 drawing artifacts;
* Windows: pixilated images, icons and texts;
* MacOS: can't open launcher;
* MacOS: can't run on M1/M2;
* MacOS: 客户端 freezes in 界面 (on connect dialog, on new match);
* Linux: run on non-standard OS or hardware like Raspberry Pi;
* Linux: ugly GUI and drawing artifacts;

Performance tweaks

The main way to increase performance or fix micro-freezes -- increase max memory usage by special java flag:
1. Run launcher -> Settings -> Java tab -> 客户端 ja text field;
2. Add or change existing flag to -Xmx3000m or another value based on your free memory stats (recommended settings: 2000m for 1080p desktop, 3000m for 4k desktop). It's useless to give 5+ GB memory;
3. If you play many AI games then it's recommended to change 服务端 ja with same value too;

De

Full project documentation and instructions for de can be found in wiki pages.

First steps for XMage's de:
* Setting up your De En
* De Testing Tools
* De Workflow
* De HOWTO Guides

Torch icons created by Freepik - Flaticon

技术栈

开发语言：Java

项目类型：XMage 万智牌引擎

Star 数：2372

功能特点

这是一套XMage 万智牌引擎，代码结构清晰，适合开发者学习游戏的客户端渲染、服务端逻辑、场景管理与资源加载。项目涵盖了游戏的核心玩法、界面交互、地图与角色系统等模块，对理解游戏开发的完整流程具有较高的参考价值。

从技术实现角度看，游戏项目的难点在于：游戏循环与状态管理、资源加载与渲染优化、客户端与服务端的协议同步、以及多平台适配。本项目在这些方面提供了可运行的实现，开发者可以在此基础上进行二次开发或学习研究。

部署说明

1. 下载源码压缩包，解压到本地开发环境。

2. 根据项目类型准备对应的运行环境（Node.js / Go / C# / Unity / Godot 等）。

3. 按照 README 中的步骤配置依赖、数据库和配置文件。

4. 先启动服务端，再运行客户端，即可进入游戏进行测试。

注意：本项目仅供学习研究使用，请勿用于商业或非法用途。

学习价值

对于想进入游戏开发领域的开发者来说，这套源码是一个很好的入门参考。通过阅读代码，可以学习到游戏的核心玩法实现、场景与资源管理、网络协议设计、以及渲染优化等关键技术点。

同时，项目中的代码组织方式和模块划分，也展示了游戏项目在工程化方面的实践经验，值得开发者深入研究和借鉴。理解一个完整游戏项目的架构，对后续开发其他类型游戏也很有帮助。

免责声明

本资源来源于开源社区，仅供学习研究和技术交流使用，请勿用于任何商业或违法违规用途。使用本项目产生的一切后果由使用者自行承担。若涉及第三方权益，请联系删除。