This is a DLL file that adds turbo functionality to freeware Cave Story. It works similarly to existing "mod loader" projects, by spoofing a system DLL (in this case, version.dll) to inject extra functionality into the game's code at runtime.

1. Download a release from the Releases page and unzip it.
2. Rename the .dll file to "version.dll" (without quotes) and place it in the same folder as Doukutsu.exe.
   DO NOT OVERWRITE THE VERSION.DLL IN YOUR SYSTEM FOLDER!!!
3. That's it!

This mod turns the Shift key into a turbo button. There are three main modes of operation:

• Text mashing mode: Hold Shift during a cutscene and the game will automatically advance through all of the text. Additionally:
  • Yes/No prompts can be answered automatically by holding left/right (respectively) during the prompt
  • Hold down to automatically interact with whatever you are standing on when the cutscene ends. (This is useful for entering a door immediately after an event, etc.)
• Standard turbo mode: Hold Shift to automatically fire your current weapon at the game's maximum allowed rate (once per 4 frames, or 12.5 Hz).
• Smart turbo mode: Hold Shift+X to activate. In this mode, the following will occur in this order of precedence:
  • Curly's Nemesis will attempt to fire every other frame (25 Hz)
  • Spur level 2 and 3 will automatically perform the "infinite Spur" technique by pause-buffering to fire lasers without expending its charge
  • Autofire weapons (Machine Gun, Bubbler level 2/3) will fire at their maximum possible (non-pause-buffered) rate (2 shots every 5 frames, or 20 Hz average)
  • Non-autofire weapons that are one swap away from an autofire weapon will automatically twiddle between those two weapons to take advantage of autofire shots (this allows for shooting 2 shots every 4 frames, effectively 25 Hz)
  • All other weapons will fire every 4 frames (12.5 Hz).

Project files for Visual Studio 2019 are included in the repo. Because of some MSVC-specific macro definitions, the code is unlikely to compile in GCC.