https://github.com/mmaulwurff/typist.pk3
typing tutor mod for GZDoom
https://github.com/mmaulwurff/typist.pk3
doom gzdoom heretic mod typing zscript
Last synced: about 1 month ago
JSON representation
typing tutor mod for GZDoom
- Host: GitHub
- URL: https://github.com/mmaulwurff/typist.pk3
- Owner: mmaulwurff
- License: gpl-3.0
- Created: 2019-06-17T16:36:42.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2025-11-17T02:03:34.000Z (7 months ago)
- Last Synced: 2025-11-17T04:20:37.340Z (7 months ago)
- Topics: doom, gzdoom, heretic, mod, typing, zscript
- Language: Shell
- Homepage: https://forum.zdoom.org/viewtopic.php?f=43&t=66042
- Size: 2.06 MB
- Stars: 22
- Watchers: 1
- Forks: 2
- Open Issues: 34
-
Metadata Files:
- Readme: Readme.md
- License: copying.txt
Awesome Lists containing this project
README
# Typist.pk3
Project moved to https://github.com/mmaulwurff/doom-toolbox/
[YouTube](https://www.youtube.com/playlist?list=PL13LmqbAWk2cE8d3vkG0zDuCiwSVlKtUZ)
Typist.pk3 is a mod for Doom engine games that turns them into typing exercises.
There are several lessons, including user-defined lessons.
## How To Play
Load it with [GZDoom](https://zdoom.org/index).
There are two game modes: Combat and Exploration. They are switched
automatically.
### Exploration Mode (blue)
Your familiar mode. You can walk, open doors, turn switches, etc.
### Combat Mode (red)
This mode is for fighting enemies. Instead of aiming and shooting, you type
answers for your targets. When the answer is ready, press Space or Enter, or
hold for continuous fire.
- press Ctrl+Backspace to erase the whole answer.
- press Escape to force Exploration mode. After this, you can return to
automatic mode switching with Unlock Game Mode key assigned in Typist options.
Because you cannot move normally in Combat mode, the following commands are
available:
- `dl` - dash to the left,
- `dr` - dash to the right,
- `df` - dash forward,
- `db` - dash backward.
- `rl` - reload weapon (if it has reloading).
Commands are configurable.
## Key setup
The mod doesn't require any special key setup. However, for smoother experience,
it may be worth playing keyboard-only with the following assigned keys:
- E - move forward
- S - strafe left
- D - move backward
- F - strafe right
- I - center view
- J - turn left
- K - turn around
- L - turn right
This way, you'll waste no time switching from mouse to keyboard and back, and
your fingers are almost at the right typing position!
## How To Set Up Custom Text Lesson
1. Find any text or book in ASCII .txt file (UTF-8 may also work).
2. If a file is supposed to be in ASCII but actually is not, use `grep -P
"[^\x00-\x7F]" file.txt` to find non-ASCII characters.
3. Rename text file to `typist_custom_text.txt`.
4. Load `typist_custom_text.txt` with GZDoom alongside Typist.pk3.
5. Select Custom Text in Typist options menu.
## Incompatible Mods
- Guncaster. Reason: Guncaster reads player input directly from player, so
weapon firing cannot be emulated like for other mods. Guncaster support cannot
be added without modifications in Guncaster or GZDoom.
- Guncaster Vindicated. Reason: the same as Guncaster.
## Compilation
Actually, you don't need to compile this. The repository contains everything
that is needed to run this mod. But if you want to develop Typist.pk3 with
maximum comfort, set up the compilation.
### Linux
Required tools:
- Git
- Bash
- Python 3
- pylint3
- aspell with English (UK) dictionaries
- ShellCheck
```
./scripts/build.sh
```
To run tests:
```
./scripts/test.sh
```
(Test script also builds.)
### Windows
It may be possible to compile this on Windows. Install Msys or something. You're on your own :)
## Software Used
- [Emacs](https://www.gnu.org/software/emacs/)
- [Slade](https://github.com/sirjuddington/SLADE)
## Acknowledgments
### Credits
- [libeye](https://forum.zdoom.org/viewtopic.php?f=105&t=64566#p1102157) (Level
and screen projections): KeksDose
- [Clematis](https://github.com/ZippeyKeys12/clematis) (Basic ZScript unit test
framework for GZDoom): ZippeyKeys12 (Zain Aamer). Clematis is under the [BSD 3-Clause
License](https://github.com/ZippeyKeys12/clematis/blob/master/LICENSE).
- [miniwad.wad](https://github.com/fragglet/miniwad) (BSD license): fraggle
- [1000 basic English words](https://en.wiktionary.org/wiki/Appendix:1000_basic_English_words) (tt_1000.txt) (actually, 1008) CC BY-SA 3.0
- [Frequency dictionary of the modern Russian language](https://en.wiktionary.org/wiki/Appendix:Frequency_dictionary_of_the_modern_Russian_language_(the_Russian_National_Corpus)) (tt_1000_ru.txt) CC BY-SA 3.0
- Sound design: Captain J. See credits for each sound effect in credits-sounds.md
### Thanks
- LGR for [Sega's Typing of the Dead: A Zombie-Slaying Education](https://youtu.be/iamxvTe9Z5g) video
- Marrub for [ZScript documentation](https://github.com/marrub--/zscript-doc)
- Accensus for inviting into Discord server and for bug reports
- Accensus, Tapwave, and IKA for patience in testing and development of certain
under-the-hood tech, which is also used in [War Trophies](https://forum.zdoom.org/viewtopic.php?f=43&t=67054#p1132997)
- kadu522 for support
- dard22 for bug reports
- Jarewill for bug reports
- SphericalCube for bug reports