addons | ||
scenes | ||
.gitignore | ||
.gitmodules | ||
LICENSE | ||
project.godot | ||
README.md |
Godot Accessible Starter
This starter project sets up Godot with the accessibility and TTS plugins so the editor is accessible.
Supported platforms
- Linux via Speech Dispatcher
- Windows via Tolk, including SAPI support for anyone not using a screen reader (not yet tested but code is written)
- Android
Usage
$ git clone --recursive https://gitlab.com/lightsoutgames/godot-accessible-starter yourgame
$ cd yourgame
$ git remote rm origin
$ # Any release from https://github.com/lightsoutgames/godot-tts/releases/ should do.
$ wget https://github.com/lightsoutgames/godot-tts/releases/download/v0.3.1/godot-tts.zip -O addons/godot-tts.zip
$ unzip -d addons addons/godot-tts.zip
Finally run:
$ godot -e
from within this repository and start building your game!
What's in the box?
- The accessibility plugin is automatically loaded, eliminating the need to use the inaccessible editor to enable it.
- TTS is loaded in a global script which is available in every node. Run
TTS.speak("Text to speak", interrupt)
from anywhere in your code to speak something. See scenes/Main.gd as an example. ScreenReader
is also loaded as a global node, making in-game user interfaces automatically accessible.- A Main scene with a script is created, and set as the launch scene.
Accessibility tips
- Navigate to Editor -> Editor Settings -> External Editor, check the box, and enter a path to an accessible text editor. The embedded Godot script editor is not currently accessible, and may not be for a long time or at all. VSCode is a good option.
Testing
To ensure that speech works, once the editor has launched, pressing F5 should speak "Hello, world." Note that at this point the game is running and there's no way to quit. To get accessible functionality back, you'll need to alt-tab back to the editor window and press F1, F2 or F3 until your screen is changed. Launching a game from the editor removes focus from all nodes, and keyboard focus doesn't return until another is focused. These screen-switching commands set a focus and, in turn, get you up and running again.
Updating
The accessibility plugin is a work in progress. As such, periodically you'll want to run this from within your game:
$ cd addons/godot-accessibility
$ git pull
$ cd ..
$ git commit godot-accessibility -m "Update accessibility plugin."
or something similar. Likewise, you'll also likely want to upgrade the godot-tts plugin from time to time, and check this starter for current suggested best practices.