After flagging a breaking change to the A Township Tale's API service with the Alta team and hearing nothing for 90 days, I have decided to discontinue the Voodoo Mod. It was never a secret that Alta doesn't prioritise the support for bot development by the community, and so I took on a risk. A risk I thought was worth it for the last two years of running Voodoo. But after the breaking changes introduced late February 2023, I have lost faith that bot developers for this game are supported appropriately or will be in the future. I've poured uncountable hours of my free time into this project, so it's with a heavy heart that I decided to abandon it. My appetite for maintaining Voodoo has soured to the point where I just don't experience satisfaction from working on it compared to the frustrations I'm facing when interacting with Alta. Thank you all for enjoying Voodoo when it worked. It was never perfect, but I like to think that it brought you all some additional gameplay while it lasted.
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 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. Alta 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.
- 🕹️ Guide for players
- 🧰 Guide for server owners
- ✨ Casting spells
- 📖 Spellbook
- 👩🏻🎓 Voodoo Vocabulary
- 💬 Discord server
Why is Voodoo not authenticating? It's stuck.
Make sure your system time is correct. Voodoo validates tokens retrieved from Alta and it compares the token's expiration date with your system time.
I can't awaken Voodoo. Why is it not picking up my voice?
Voodoo currently relies on Windows speech recognition which uses Windows language packs. Make sure you have English (United States) configured as one of your Windows languages. To configure your Windows languages:
- Go to Windows Settings.
- Click the Time & Language tile.
- Click the Language tab.
- In the Preferred Languages section, add English (United States).
- Restart Voodoo.
If Voodoo is still not picking up your voice, you must make sure that your Default Input Device is set to the microphone you're using before you start Voodoo:
Why has Voodoo misheard what I said?
Speech recognition is tricky. Your accent might play a role as well (I'm not a native English speaker myself and it doesn't always correctly recognise what I said). The good news is, Windows speech recognition can be trained. Search online for ideas on how to train your speech recognition to more accurately understand the way you speak English.
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:
- Fork this repository.
- Create your feature branch (git checkout -b my-new-feature).
- Commit your changes (git commit -am 'Add some feature').
- Push to the branch (git push origin my-new-feature).
- 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.
