Control your VRChat avatar with NFC tags!
Summoner was developed against this hardware. I cannot guaruntee compatibility with other scanners/tags.
You should be able to find these easily on your favorite online marketplace.
The easiest way to install Summoner is via the Microsoft Store. Currently there is an issue where the app crashes instantly when installed from the store. See #17.
You can also head to the releases page and download non-packaged builds for your platform from there.
Click Add Parameter to add parameters to set on your avatar anytime the tag is scanned while the app is open.
Parameters can be a integer, float, or boolean type.
The Write Tag button will be enabled if all parameters are valid and a tag is detected on a compatible reader. You can also use the Set Value button to test your parameters without overwriting a tag or without a tag present. Be aware that placing a tag on the scanner will load its values into the UI so make sure you place the tag down before you start making your edits otherwise they may be lost.
Summoner's UI is built on Windows App SDK + WinUI 3 with .NET 6. The app talks to your NFC reader using pcsc-sharp and to VRChat via VRCOscLib. Data is serialized using MessagePack.
Data is stored on the tags in 4-byte blocks using the following arrangement:
| Block | Usage |
|---|---|
| 4 | Identifying Signature |
| 5 | Content Size Header |
| 6.. | Serialized Content |
Summoner sets a couple of parameters in addition to what you specify in the UI that you can use to drive animations.
Gv/Summoner/Triggered: Switches to true for 100ms anytime Summoner sets a value.
Gv/Summoner/Present: Set to true while an NFC tag is detected on your reader.