Version 2.4

Version 2.4 is a major update to VVVVVV, starting development on August 31st, 2021. It is currently in development and is scheduled to have localization and input rebinding.

Custom Levels

 * A feature was added to support custom text box colors in the  command (and the new   command). Text box colors are stored in the   XML tag in the level file, and each entry looks like the following:

Scripting

 * and  were added.
 * destroys moving platforms (instead of being bugged and only stopping them and making them invisible, like ).
 * specifically destroys disappearing platforms.
 * and  were added, allowing users to change the color and text of the next activity zone which appears.
 * The text which  uses is the text on the next line.
 * was added.
 * This command changes the color the player respawns with upon death.
 * A feature was added where text boxes can now contain up to 26 lines (from the previous limit of 11) if the line amount is suffixed with, e.g..

Technical

 * Save file migration from 2.0 data to 2.2 data was removed.
 * WebAssembly is now a supported build target.
 * is used to detect Unix-like platforms, meaning many platforms don't need any changes to VVVVVV to work.
 * The following debug statements were added:
 * Values of the xoshiro RNG generator.
 * Achievements being unlocked (even if not already unlocked).
 * The CMake config option  was added to remove potentially-sensitive absolute paths from the compiled binary, if supported by the compiler. It was enabled by default.

General

 * The  command-line argument was added to print the version number (e.g. "v2.4") and build type (e.g. "[M&P]") of the executable, as well as the hash, date, and branch of the commit it was built from if the executable has that information.
 * The window title will display the branch name the game was built from in brackets, and the branch name will also be displayed on the title screen, if the executable has that information.

Visual

 * Misa Kai's name was moved from the "super" GitHub contributors list to the C++ developers list.
 * All time strings were made more uniform. Centiseconds are now always separated by a period, and the first unit of the timestamp always no longer has a leading zero.
 * Launching the game in Big Picture or on the Steam Deck will now force the game to fullscreen, with windowing options removed from the graphics menu.
 * The game was made to default to integer scaling mode when launched for the first time.
 * The selector characters around the names of scripts in the script editor were made to be the same as the selector characters on the title screen.

Custom Levels

 * assets were removed due to disuse.
 * Custom level zips were made more forgiving. They no longer require level names to be the same name as the zip, and can have multiple level files in one zip sharing assets.

Scripting

 * When the game is attempting to convert a string to a color (ex. ), it now attempts to treat it like a numerical color ID if the string cannot be converted.
 * The 50-line limit on the amount of lines /  can take in was removed.

Technical

 * Loading music tracks from separate audio files was added. If neither  nor   exist, the game will load music from the   folder.
 * Logging was completely overhauled.
 * Output was made prefixed with,  ,  , or  , including bold and colors (if available).
 * All  and   logs were made to properly go to STDERR, instead of STDOUT.
 * logs were disabled by default.
 * Command-line options were added to customize logging output:
 * disables output entirely.
 * or  forces colors to be on.
 * or  forces colors to be off.
 * enables debug logs.
 * disables info logs.
 * disables warning logs.
 * disables error logs.
 * Logging and error handling was added for error conditions that previously silently failed, such as being unable to draw to the screen.
 * The command-line option  was added, for Windows systems only, to spawn a console window that will capture all console output of the game.
 * Output of loading/saving XML files was streamlined and was made to print TinyXML-2's error output in case of an error.
 * The minimum SDL version was upgraded to 2.24.0.
 * The game's audio system was migrated from SDL_mixer to FAudio.
 * This minimizes the number of libraries ("DLLs" on Windows) needed to run the game (in officially shipped builds).
 * Users have reported that the audio quality is no longer crushed when played through certain speakers.
 * Loop point support in music has been extended, mirroring the same changes that were made to SDL_mixer before the game was migrated to FAudio:
 * Tags can now start with  or   instead of   (e.g.   instead of just  )
 * Start and end times can now be in the format, instead of just sample counts
 * Upon startup, the game will only create the window after all assets have been successfully loaded (and if using command-line playtesting, after STDIN has been closed). In case of an error (like an invalid playtesting level name provided), then the window won't be created at all.
 * This has enabled Ved, starting from 1.10.0, to "pre-load" the game in the background during the screen to choose the playtesting starting point.
 * The game's rendering was shifted over from being mostly CPU-based to being mostly GPU-based (via SDL's 'render' subsystem), providing a performance boost.

General

 * The level folder path in the levels menu was made to be hidden behind a "show level folder path" menu option. The option warns the user they may leak sensitive information if they are streaming.
 * On Windows, the game no longer needs users to install Visual C++ redistributables in order to run it.
 * The default window size if no settings file is present is now 640 by 480 instead of 320 by 240.
 * The minimum size of the window was restricted to 320 by 240.

Gameplay

 * Spikes are no longer considered to be solid by moving platforms and entities if invincibility mode is enabled.
 * A bug was fixed where the post-game teleport animation back to the ship from the map menu could be interrupted in various different ways.
 * A bug was fixed where the player was able to flip in mid-air when loading in to a level if they exited to the menu while standing on a surface (along with other state that persisted).
 * A regression from 2.3 was fixed where playing through No Death Mode (and never going to the options menu) would also give you the Flip Mode trophy.

Visual



 * While nearly unnoticeable to the naked eye, the colors used by the Time Trial trophies in the Secret Lab were mistakenly using BGR format instead of RGB, which was fixed.
 * A rare chance where a glitchy tileset would be drawn during finalstretch was fixed.
 * The name of the author of Vertex Vortex was updated.

Custom Levels

 * A bug was fixed where  could copy-paste all its entries over and over if you selected the "play a level" option multiple times and then went and completed a level.
 * A bug was fixed where using STDIN playtesting (e.g. playtesting a level within Ved) and then completing it would write a  entry to the   file.
 * A bug was fixed where the map screen could be brought up during in-editor playtesting if the player pressed ENTER on a terminal while dying and having the interact key set to ENTER.
 * The minimap displayed on the  screen was changed to use the custom level minimap if applicable.
 * Trinkets that exist out of bounds were made to no longer be drawn on the minimap.

Scripting

 * Script names containing spaces or capitals were made possible to be jumped to via  or similar. To prevent disruption to existing levels, the implementation attempts to load the processed name first (with spaces removed and capitals lowercased) before attempting to load the literal name.

Technical

 * Duplicate player entities were made to have the same momentum as the true player entity.
 * The workaround used to make the VSync toggle work was fixed, making it more reliable on some systems that might have had problems with it previously.
 * The game now checks that  is loaded and decoded properly before dereferencing, fixing a potential source of crashes.

General

 * The game learned to not explicitly write /  if it hadn't attempted to load them yet, preventing overwriting perfectly good save data. Previously, this was handled implicitly and was still theoretically possible in a number of cases involving the game aborting upon startup.

Localization
This version received a localization overhaul, adding support for the following languages:


 * Esperanto by Reese Rivers
 * Dutch by Dav999
 * Catalan by Eduard Ereza Martínez

A language menu select appears on first launch if you've never selected a language before. This menu is also accessible from the options menu.

Each language is stored in a folder named after its two-letter code (e.g.  for English) in a new   folder. Each folder contains the following:


 * : Contains information about the translation.
 * : Contains general strings for the interface and some parts of the game.
 * : Contains strings with plural forms.
 * : Contains all numbers from 0 to 100 written out in word form.
 * : Contains nearly all cutscenes that appear in the main game.
 * : Contains nearly all room names that appear in the main game.
 * : Contains special names, such as area names and glitch names.

Support has also been added for different fonts, such as CJK fonts (Chinese/Japanese/Korean) in the  directory. Custom level creators can set the font for their level in level options.

The following command-line arguments were added relating to localization:


 * sets the language directory to the given directory.
 * sets the fonts directory to the given directory.
 * enables the translator menu if not already enabled (see below).

The following gamestates were added, all used in the translator 'explore game' mode:


 * 3090: Returns to the main menu.
 * 3091: Waits 60 frames before proceeding to the next state.
 * 3092: Returns to the main menu.

The following script commands (both internal and simplified) were added:


 * : Jump to script if the current game language is a certain language.
 * : In custom levels, load the given language.
 * : In custom levels, set the font to the given font.
 * : Set the text case for the following text box.

TODO add screenshot of language screen (and other things) when release is finalized

Translator menu
A menu for translator authors and translation maintenance was added. The translator menu only appears on the main menu and is accessible if any of the following are true:


 * The  command-line argument is used.
 * The  folder is not next to , the game is running somewhere inside a folder named  , and a   folder is found inside  . This usually corresponds with running the game from a source code environment (e.g. doing development work).
 * is defined during compilation.

The menu also contains the following options:


 * A menu to sync language files with any new added English strings.
 * Room name translator mode (see below).
 * Previews of every text box in every cutscene, as well as every menu.
 * Check (roughly) if any string overflows a limit.
 * Open the language folder.
 * Statistics counting any untranslated strings.

Room name translator mode
Room name translator mode is accessible from the translator menu. It enables viewing and editing room names and room name explanations while in-game.


 * Pressing  toggles invincibility. If enabled during a time trial, the time trial is sabotaged by adding an hour to the time and adding 100 deaths.
 * Pressing Tab switches between playing and editing.
 * In editing mode, pressing /Enter edits the room name or explanation.
 * Ctrl+ switches to explanation mode.
 * Ctrl+F1 shows the help.

There is also a separate 'explore game' menu that lets the user quickly travel to any of the following areas:


 * Space Station 1
 * Laboratory
 * The Tower
 * Space Station 2
 * The Warp Zone
 * Intermission 1
 * Intermission 2
 * The Final Level

Beating the area returns the player to the menu.

Trivia

 * Misa Kai streamed her review of the localization pull requests on Twitch.
 * First localization pull request (YouTube VOD playlist)