Skip to content
An ESP8266 project implementing an RFID reading to send actions to Gloomhaven Helper app
C++ Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Gloomhaven Helper RFID

Connect an RFID reader to your Gloomhaven Helper app, and scan tags to interface with Gloomhaven Helper app.

Gloomhaven Helper app is about reducing the number of components on the board when playing Gloomhaven Board Game. The problem with the app is that it takes the focus off the board, and onto a screen (if you play a boardgame, you kind of want to avoid screens, otherwise you could just play a video game).

This project is about using the board game to interface with the app by placing rfid taggs onto tokens, cards, standees, minis etc. Then you can scan the tag and send an action to Gloomhaven Helper app.


- Scan your ability card and automatically set your initiative to that cards initiative (visible ass ?? in the app until round begins)
- Scan miniature/standee/card and automatically add new enemy.
- Scan Element tokens to put the element to strong.
- Scan Summon token to summon with preset HP, attack, move, range

Video of scanning a tag/card and changing initiative

The app has access to the entire game state, so any action is possible. Each tag can be programmed to perform a specific action.

To implement this, an LR rfid, 125kHz (rmd6300/rmd630) reader is used with an ESP8266 Wifi enabled microcontroller (tested with Wemos Mini lite).

It would be nice if NFC tags (HF 13.56MHz rfid tags) could be used. This would require another rfid reader and other tags. These tags are smaller (requires smaller antenna), can write data (EM4100 only holds 4 static bytes) and is compatible with most nfc enabled phones. If you want to contribute send a pull request.

Development setup:

Use platformio. If you have problems setting up your develop environment, building the software or similar, open an issue, and we can improve the docs from there.

Components needed:

- Wemos mini lite (basically an ESP8266 with a few Accessible GPIO:s)
- RMD6300 125kHz EM4100 rfid scanner
- 3pcs 10kOhm-30kOhm resistors (rmd6300 uses 5V, we want 3.3V for ESP8266)
- 1pcs led
- wire
- Alot of EM4100 compatible RFID tags


- When tag is scanned, use the id of the tag and perform action based on id
- Programming of tags (web interface?)
- Document Schematics
- Write build guide
- Design a case
- Print the case


- Add support for different app versions (v7.6 and v8.0 works)
- Communicate with RFID reader (rmd6300)
- Connect to tcp server when a client connects (hard coded to port 58888)
- Read game state from Gloomhaven Helper tcp server
- Write game state to Gloomhaven Helper tcp server when a card is scanned.

License: MIT


- Robin Grönberg
You can’t perform that action at this time.