Magic Another Game Engine
Find a file
Artemis Kearney 41874b0b4b
new feature: Emblem Cards (#10498)
* new feature: Emblem Cards

Allows match/tournament creator to specify cards to give each player
emblem versions of (or just the starting player for symmetric effects).

Technical details:
- new UI for specifying emblem cards (.dck files)
  - available for all match/tournament types
- new class `EmblemOfCard`
- new method `copyWithZone` on `AbilityImpl` (used to make abilities
  work from command zone)
- new fields on `GameOptions` and `MatchOptions` for emblem cards
- emblems are granted after mulligans, before first turn (technically
  after Planechase starting plane creation)

* fixes

* defaults for emblem cards in match options (fixes quick game buttons)

* minor fixes

* use DeckCardInfo instead of Card for emblem cards options

* restore accessible parent properties

* fix images for card emblems

* look up cards in a way that preserves which art

* fix typos; make Emblem.sourceObject protected

* add descriptions to planechase and emblem cards

* fixes

* add some unit tests for known working cards

* fix author name

* add explanation comment

* fix up tests

* copyWithZone: no longer modifies zone for singleton abilities

* directly check for MageSingleton
2023-09-26 22:47:13 -04:00
.github don't card fetch on PRs since it fails 2023-07-04 18:15:10 -04:00
Mage new feature: Emblem Cards (#10498) 2023-09-26 22:47:13 -04:00
Mage.Client new feature: Emblem Cards (#10498) 2023-09-26 22:47:13 -04:00
Mage.Common new feature: Emblem Cards (#10498) 2023-09-26 22:47:13 -04:00
Mage.Plugins [DEV] JDK 11+ support. All builds still target Java 1.8. 2022-08-05 00:17:00 -04:00
Mage.Server new feature: Emblem Cards (#10498) 2023-09-26 22:47:13 -04:00
Mage.Server.Console Refactor: added auto-generated readable readme file to releases 2023-03-12 13:56:29 +04:00
Mage.Server.Plugins Tweak the Pillar of the Paruns format (#11197) 2023-09-24 22:09:38 -04:00
Mage.Sets fix #11211 (CR 602.3) 2023-09-26 22:46:01 -04:00
Mage.Tests new feature: Emblem Cards (#10498) 2023-09-26 22:47:13 -04:00
Mage.Verify Add new Set files, as well as add new entries to mtg-cards-data.txt (#11193) 2023-09-23 20:24:44 -04:00
repository/com/googlecode/jspf/jspf-core
Utils Add new Set files, as well as add new entries to mtg-cards-data.txt (#11193) 2023-09-23 20:24:44 -04:00
.gitignore gitignore: other logs from local testing 2023-08-04 22:25:12 -04:00
.travis.yml Build: clean travis config 2023-04-26 00:10:01 +04:00
clean_dbs.sh
LICENSE.txt
pom.xml Refactor: added auto-generated readable readme file to releases 2023-03-12 13:56:29 +04:00
readme.md docs: updated readme to actual info and card stats (closes #10405) 2023-05-24 00:47:21 +04:00
RemoveHeaders.java
sonar-project.properties

XMage — Magic, Another Game Engine

Build Status Lines of Code Coverage Technical Debt latest release commints since latest release Join the chat at https://gitter.im/magefree/mage

XMage allows you to play Magic against one or more online players or computer opponents. It includes full rules enforcement for over 25 000 unique cards and more than 65 000 reprints from different editions. You can also find custom sets like Star Wars. All regular sets have nearly all implemented cards.

It supports single matches and tournaments with dozens of game modes like duel, multiplayer, standard, modern, commander, pauper, oathbreaker, historic, freeform, richman and much more.

Local server supports a special test mode for testing combos and other game situations with pre-defined conditions.

There are public servers where you can play XMage against other players. You can also host your own server to play against the AI and/or your friends.

XMage community and resources:

Servers status:

Beta server with un-released or under development features:

Features

  • Multiplatform app: Windows, Linux, MacOS;
  • Deck editor (support multiple deck formats and deck sources);
  • Two player duel or a multiplayer free-for-all game with up to 10 players;
  • Computer AI opponents;
  • Players rating system (Glicko);
  • Supports special formats like Commander (up to 10 players), 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:
    • Booster (also Cube) draft tournaments (4-16)
    • Sealed (also from Cube) tournaments (2-16)

Bug report / feature request

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

Installation / running

Wiki page contains detail information about private or public server setup.

Server options

The XMage server locates by default the configuration file from the current working directory to the relative path config/config.xml (config\config.xml in Windows). To change this location, start the server with the property xmage.config.path set to the desired location, for example -Dxmage.config.path=config/otherconfig.xml. The option can be set from the XMageLauncher in Settings > Java > Server java options.

Troubleshooting / FAQ

Github issues page contain popular problems and fixes:

Performance tweaks

If you have a good GPU, it's very likely you'll be able increase performance by a lot through extra Java flags.

XMage runs on JRE 8, so this link should give you the available flags.

How to enable the extra flags

  1. Launch XMage
  2. In the menu bar from the launcher, click on "Settings", which will open up the Settings Window
  3. Go to the "Java" tab
  4. You can pass extra flags by editing the "Client java options" text field

Linux tweaks

Enable OpenGL

More info about OpenGL:

  • -Dsun.java2d.opengl=true

Possible problems:

  • Caveat: There's a bug with the file chooser when OpenGL is enabled (you use the file chooser when you, for instance, try to load a deck from disk). The suggested workaround will make the game crash, so it's not an option.
  • Workaround: When using i3, you're able to work around the bug by toggling the "floating" capabilities of the window and forcing it to re-render.

Enable XRender

More info about XRender:

  • -Dsun.java2d.xrender=true

Increase memory usage

This is not guaranteed to yield improvements, but it depends on your use-case. If you have a lot of RAM to spare, you can increase the initial heap size for good measure. More details about memory settings:

  • -Xms1G -Xmx2G

Developer

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

First steps for Xmage's developers:

Torch icons created by Freepik - Flaticon