This project allows you to play MECCG or other Collectible Card Games.
Middle-earth CCG and LotR are trademarks of Middle-earth Enterprises and/or Iron Crown Enterprises. This is not affiliated with Middle-earth Enterprises or Iron Crown Enterprises.
MECCG assets are not included in this repository. Please respect the copyright and trademak.
Tip
I, the project's maintainer very strongly believe that no financial harm is done to any trademark, since this game has been out of print for over two decades and actively published Lord of the Rings card games are successfully being produced and sold.
What is more, many (if not even the vast majority) of the MECCG players also play such contemporary card games.
However, this website will be taken down willingly if requested by the rights holders. Yet, please consider that this is a 100% non-commercial and non-profit project made by fans so that MECCG community can continue to enjoy this very special game.
Make sure to check out the meccg related resoures
- Setting up Standard/Multiplayer: https://youtu.be/5wwK6E0CamU
- Setting up ARDA: https://youtu.be/33UvkKAMbmI
- Interface: https://youtu.be/QjLWo26ik-g
- Turn progression: https://youtu.be/JbntAqz3J7A
This project aims to provide an easy way to setup and maintain a card game server to allow you and your friends to play your favourite card game online.
Although the gameplay is guided by Middle-earth Collectible Card Game, you can easily adapt it to your own game.
Generic sample data is provided to play around a bit.
However, you will need to provide additional card data and its images for the full experience. See section below on how to start.
Here is a step by step guide how to set everything up. Detailed information can also be found in the development guide.
2 decks are provided to test play. The data files included are not suitable for deckbuilding and doing more than just playtesting.
The platform supports English, French and Spanish. Please read the translations document to find out about how that is achieved and how you may help.
The project allows you to
- Play Games (Singleplayer, Multiplayer 2+, Arda Format)
- Save/Restore games
- Deckbuilder (gccg compatible format if card codes match)
- Browse cards
- Import decks (copy&paste, gccg and cardnum compatible)
- Browse maps and edit position markers
Here are some essential features of this project:
- Intuitive gameplay via drag and drop.
- All works in-memory (no persistence necessary).
- No user identity management needed (database server is not needed).
- Strict CSP header policy
- Import cards from GCCG or other 3rd party card data provider.
Special information about development can be accessed in a dedicated README_development.md.
This is a non-profit project made by fans entirely. Middle-earth CCG and LotR are trademarks of Middle-earth Enterprises and/or Iron Crown Enterprises. The rights belong to their respective owners. MECCG assets are not included in this repository.
Make sure you have Node.js installed. You will find further details about development and adaptation at the end of this page.
Open your terminal and access this project folder.
Then run the following commands to develop backend or frontend modules:
npm install
npm run build #run only once
npm run dev_server #develop server module
npm run dev_client #develop client module
Then run the following commands:
npm install
npm run build
npm start
Your app should now be running on localhost:8080.
PORT
sets the app's port (8080)
Card data and images are not part of this project and included via a third-party service.
The project does have a very low resource profile:
- About 50 MB RAM
- Single Core CPU is enough
By default, the project does does not spawn separate processes, because room/game management via socket.io does not consider a multi-thread approach.
Spontaneous browser checks also showed a super low profile:
- about 150 MB used for the tab (after 4 hours of 5 player ARDA game)
- about 38 MB of allocated JS heap
This project does not require any databases or other storage containers. Everything is held in memory only.
All card images are requested from a content delivery server (CDS) to keep images and this application separate.
To avoid cross-site-scripting attacks from the game participant's, the following Content-Security-Policy and X-Content-Security-Policy are applied in a game:
- default-src 'self'
- img-src 'self' (and the CDS)
Content-Security-Policy violation attempts can be reported if you provide such an endpoint and additional configuration setting.
All usernames will be evaluated and the following rules applied:
- Leading and ending whitespaces will be removed.
- The username will be reduced to 30 characters if necessary.
- It will be stripped from any quotes characters.
A username will be rejected if it contains HTML breaking characters <
or >
and the login attempt will fail.
It is assumed that the app runs locally at localhost:8080
. Screenshots may not represent the current state of the screen design, so please be aware of possible changes.
Note
The screenshots shown below are very likely to not represent the actual ui anymore. The general concepts, however, have not changed and those images suffice.
You start in the lobby. Here, you will find a list of active games, release notes and you will be able to start your own game.
Depending on the games' setup, you may join and/or watch active games. If the hosts want to keep their games private, you may only see an active game but will neither be able to join nor watch it.
There are 2 ways to start a new game:
- Guided via
localhost:8080/
- Direct via
localhost:8080/play/yourgamename
Each game will be identified by its name in the URL (see yourgamename above). The guided method will automatically create such a URL.
You will be asked for a username and a deck to use. These are required.
If you are the first player to join a table, you are considered the table's host.
You can join a game simply by accessing the direct URL or via the list provided on the site's home page. A game's host may deny access to watch or join their game, so please of such restrictions.
Once you chose a username and a deck, you can join the game and will be redirected accordingly.
You will be asked if you want to start the audio chat. This is not supported at the moment but would simply open another browser tab and load the meetings url.
When you enter the table, you will be greeted with an introduction popup telling you about chat opportunites and the drag and drop gameplay.
Once closed, the table will look like this:
The center top panel contains
- information about players currently at the table
- icon to access to settings
- icon to quit game
- icon to allow/deny players to join (host only)
- icon to allow/deny watchers to join (host only)
The center bottom panel contains
- dice rolling action (right click to change them)
- change background setting
- Turn / Phase indicator
The lower right contains in-game MP settings.
Playing cards works via drag & drop. Once you drag the card, target drop zones will appear where you can drop the respective card.
You can drag the card over each of the drop zones and drop it to put it into play (or to any pile). Each potential drop zone will have a tooltip appearing which indicates the action type.
A character may create a new company or join an existing company under general influence or follow a character under direct influence. As a player, you have to make sure that the action is legitimate, i.e. there is enough general or direct influence available.
Splitting and reoganizing companies is easy as well. Simply drag the character and perform the action. If they have followers, they will continue to follow as well.
A company is indicated by a dotted line, above which there is a mountain icon. Clicking on this will open the map where hyou can select your home site.
The map will appear with red markers on it. Such a marker is called a region marker. Clicking on it will show all available sites in that region. Clicking on such a site will automatically set it as starting site.
After having clicked on the site, the map window closes and the site is set.
To plan your movement, click on the mountain icon again to open the map. Similar to start site selection, choose your target site.
The sitepath will have to be chosen manually. To do so, click on a region and add it to the sitepath. To remove it again, click on the card in the sitepath.
To confirm this movement, click on the green icon and close the winodw again. To reval the movement to your opponent, click on the "eye" icon.
Hazards can be either events or creatures.
- Usually, events are added to the staging area.
- Hazards may also be attached to a specific chraracter, e.g. corruption cards.
- To force a company or character to face hazard, drop it onto the regions and it will appear next to the site.
- If you want to play a card "on guard", simply drop it onto the destiation site and it will appear face fown.
To obtain marshalling points, simply drag a card onto your vicotry pile.
This will open a window that lets you choose the category and amount of points.
You can signal the end of your hazard play against a company by clicking on the target site. This set the destination site as current site and remove the region cards.
This action will reduce the sitepath to the destiation site only. On guard cards will be kept attached to the site.
You will find your score sheet at the lower right corner. There, you can adjust your points as needed during the game.
To alter the card state, you may click on it. This will tap, wound or ready the card. Alternatively, hover over the card and right click on it.
The context menu provides all available actions.
The discard pile will be reshuffled automatically once your playdeck is out of cards. You do not need to do this yourself.
The following shortcuts are available:
r
to roll the diced
to draw a cardDoubleclick
to tap a cardDoubleclick
+ALT
to untap a cardDoubleclick
+CTRL
to highlight card for 5 seconds
- Sometimes you may not hit the drop zone to play a card. Just retry.
- You may reload the page if it seems necessary.
- Open the browsers inspection tool console to check for errors. This should usually not happen but you never know. Chrome's shortcut is
CTRL+SHIFT+J
You can access certain options via the options icon.
You can reveal cards to your opponent by opening the respective pile and selecting the action via right click context menu.
If you are out of cards, simply draw a new card. All cards from you discard pile will be added to your play deck and are reshuffled automatically.
To store cards, move them to your marshaling points pile. A popup will ask you to specify how (and if) this card should be stored.
You can finish the game via the game preferences menu (see above). This will automatically bring up a score sheet with the oval results.
The game will end automatically.
The Arda gameplay differes from the standard games a bit. The rules will not be discussed.
Simply choose an arda deck from the right deck offerings (or provide your own deck) and check the "Arda game type" checkbox.
As the game's host, you will find a setup wizard at the upper left part of the screen which guides you through the preparation process.
Please be aware that you should wait until all players have joined. Playsers can join the game later, of course, but choosing possible starting characters etc. will be a lot more time consuming and not randomised.
Once all players have joined the table (see below) you can randomly assign the 10 starting characters by clicking on the respective box at the right of the screen.
Clicking on this option adds 10 characters to each players hand according to the Arda mechanism. This option is only available once and will add random characters to the players' hand without removing the cards currently held there.
Once everybody has chosen their starting characters, you may proceed to the minor item draft. Click on the respective link in the setup wizard. As a consequence, all cards in the players' hand will be discarded and shuffled into the play decks - no need to discard them manually.
Now each player picks their minor items from the minor item offering deck at the upper right of the screen.
To start the game and finish the preparation process, click on the link in the wizard dialog. As a consequence, 8 cards will be dealt to each player and the game can start.
To join an Arda game, simply click on the game from the game list.
You will be asked to provide only a user name so your fellow players know who you are.
The platform supports English, Spanish and French and the navigation offers an accessible language switcher.
While playing your game, you can exchange messages with your opponents. A dedicated text section with predefined texts allows you to communicate with players who may not speak your language or do not feel confident enough.
Of cource, this project would not be possible without the work of others, and credit should be given.
The following third-party libraries. Be aware of their respective licenses.
- Node.JS - express (MIT License)
- Node.JS - express cookie-parser (MIT License)
- Node.JS - socket.io (MIT License)
- Node.JS - winston (MIT License)
- jQuery 3.5.1 (MIT License), only used in connection to jQuery UI
- jQuery UI v1.12.1 - 2021-03-20 (widget.js, data.js, scroll-parent.js, widgets/draggable.js, widgets/droppable.js, widgets/mouse.js, MIT License)
- jQuery UI Touch Punch (MIT License)
- leafletjs 1.7.1 (BSD 2-Clause "Simplified" License)
- Font Awesome Free, see https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License)
- Open Sans, see https://fonts.google.com/specimen/Open+Sans/about (Open Font License)
- All icon licenses are "free for commercial use" with no link back Icons were taken from https://www.iconfinder.com/
- The background image was taken from https://www.pexels.com/ Unfotunately, I cannot remember the link exactly anymore.
This program is provided under the GNU General Public License version 2 only. See this license file for more information.
All contributions to this program are subject to this license model.
In addition, other licenses may also apply, for example, see third party library section for more details.
Middle-earth CCG and LotR are trademarks of Middle-earth Enterprises and/or Iron Crown Enterprises. This is not affiliated with Middle-earth Enterprises or Iron Crown Enterprises.
MECCG assets are not included in this repository. Please respect the copyright and trademak.