Voodoo is a community-made magic mod for A Township Tale, a VR MMORPG game.

Voodoo consists of a Voodoo Client application (the repository you're looking at right now), Voodoo Server, and a hidden Voodoo Spellbook.

Voodoo Client is a speech recognition application for A Township Tale that lets you invoke magic spells with your voice on game servers that support Voodoo.

Voodoo Server is our bot that listens to all the Voodoo Clients out there and sends console commands to the servers they are playing on.

Voodoo Spellbook is a hidden repository that Voodoo Server uses to compare a list of spells to what players are invoking. Because the Spellbook is hidden, players need to discover the right combination of incantations and material components for each spell on their own!

• Voodoo sometimes doesn't connect to a server even when that server has just invited Voodoo Mod. This happens because sometimes the Alta API does not inform the bot of new invites, or otherwise prevents the bot from connecting to the newly added server. When this happens you must wait ~24 hours until Voodoo Mod restarts automatically. When restarting, Voodoo Mod re-accepts all server invites and your server should start working.
• Voodoo can say "Not near a Spellcrafting Conduit" even when you're standing next to a green crystal cluster. When this happens it means the ATT server's select find <player> command has broken and the server needs to be restarted. Joel is aware of this bug.
• Acid Bolt rarely connects with players or enemies. This doesn't appear to be a bug with Voodoo, as the mod doesn't change any wyrm spit properties.
• After acquiring a session in Voodoo, the app can sometimes jump back to the Ready! screen and get stuck here. We're currently still investigating what is causing this.
  Work-around: restart Voodoo.

• 🕹️ Guide for players
• 🧰 Guide for server owners
• ✨ Casting spells
• 📖 Spellbook
• 👩🏻‍🎓 Voodoo Vocabulary
• 💬 Discord server

Poi's work unraveling the mysteries of A Township Tale's save strings was instrumental in building Voodoo. Poi didn't directly work on Voodoo, but Voodoo would not exist without his help. Thank you for sharing your secrets!

CJ's mountain of experience with speech recognition helped shape the way you interact with Voodoo. His knowledge has informed the best way to deal with voice commands and how to handle or work around false positives.

• Marc Dingena (owner)

For bug fixes, documentation changes, and small features:

1. Fork this repository.
2. Create your feature branch (git checkout -b my-new-feature).
3. Commit your changes (git commit -am 'Add some feature').
4. Push to the branch (git push origin my-new-feature).
5. Create a new Pull Request.

For larger new features: Do everything as above, but first also make contact with the project maintainers to be sure your change fits with the project direction and you won't be wasting effort going in the wrong direction.