CDScriptManager

Introduction

Important

To run the application, you need to install .NET Desktop Runtime 8.0.

CDScriptManager (later CDSM) is a tool for fast and handy managing CDScript files for classic Crashday (1.0-1.2). CDSM gives you the opportunity to configure and apply special script files to a game, which open up the possibilities of low-level modding.

Current version - 0.1.5

Important

For the application to work correctly, you must use the executable files "by Steve". Below is a table with unique files data that you can compare with your available EXE files. In any case, you can download the files here. If you want to add support for other EXEs, let me know.

Executable file name	Game version	File size (in bytes)	Checksum (CRC-32)	Checksum (MD-5)
Crashday10.exe	1.0	3347968	498F34B6	EE740F59A3DF76FC68159758A7D78055
Crashday11.exe	1.1	3380224	A38F60B6	1CEA94001C8102582A5C007BDF765646
Crashday11.exe	1.2	3378688	8D452A29	F027022CF84FB0A7A9DB9770545346B9

Installing

CDSM should be located in the game folder (i.e. C:\Games\Crashday). Scripts for the manager must be installed in the scripts folder. (see Files overview)

Links

Click here to see all changelogs

Click here for CDScript files writing tutorial

Program overview

Main

CDSM is a small window that consists of various main elements:

1. "Game" tab. Contains options related to the game itself. (see "Game" tab)
2. "Presets" tab. Contains options related to the script presets. (see "Presets" tab)
3. "About" tab. Contains miscellaneous not really importent stuff. (see "About" tab)
4. Script list. The list shows all scripts, located in scripts folder in the game directory.
5. Script information. The area for displaying the description of the selected script.
6. "Refresh" button. The button to refrest script list.
7. "Configure" button. The button to configure script settings in separated window. The button is enabled only if script has settings to configure. (see "Configuration" window)

"Game" tab

8. "Run game" option. Run the game executable (.exe or .dll).
9. "Set game executable" option. Change the game executable (.exe or .dll).
10. "Set executable arguments" option. Add/remove command-line arguments for Crashday executable.
11. "Create shortcut" option. Create shortcut with preinstalled game executable and script preset via command-line arguments for quick game run. (see Command-line arguments)

"Presets" tab

12. "New preset" option. Create a new script preset. When creating a preset, it is automatically selected as the current one.
13. "Open preset" option. Loads preset file.
14. "Save preset as" option. Works similarly to the "New preset" option, but without preset selection.

"About" tab

15. "Information" option. Opens a separated window, which contains CDSM version.
16. "GitHub page" option. Opens St1ngLeR's GitHub page.

"Configuration" window

17. Settings list. The list of script settings that can be configurated by user. The count of settings is depends on the script.
18. "Reset button". Reset all script settings to the default values.

Command-line arguments

CDSM supports command-line arguments to speed up and simplify the procedure of running the game:

• /preset=(preset_name) - loads specified preset from scripts/presets folder.
• /exec=(executable_file_name) - runs specified executable file (.exe or .dll).
• /execargs=(executable_arguments) - adds specified command-line arguments for specified Crashday executable.

Important

The order of the arguments is important. If you want to start the game with a preset, make sure that the preset is set BEFORE assigning the file to run.

Important

For the correct assignment of the preset and the executable file, it's recommended to enclose their names in quotation marks to avoid malfunctions. This is especially true if there is a space character in their names.

Files overview

Contents

Out of the box, the program consists of one file - the executive file itself. But after the first launch, the program creates some files, which are described below:

cdscript_log.txt

The logging file that captures each action of the program. This file can be useful for script writing. After each launch, the file is written over again.

cdsmanager_settings.ini

The file that contains basic settings for proper work of program.

scripts folder

A folder for CDScript files that CDSM uses to managing them. Initially, the folder does not contain any scripts.

presets folder

A folder inside the scripts folder for script preset files. Initially, the folder contains a default preset.

Structure

Warning

The following files are updated by the program itself, so manual modification is not recommended unless as a last resort.

The files created and used by CDSM have their own structure, which is described below:

cdsmanager_settings.ini

• skipmanager - allow to skip manager on it's launch for quick run game. (default value is 0)
• exec - game executable. (default value is Crashday.exe)
• currentpreset - current selected script preset. (default value is default)

Preset file (scripts/presets/*.ini)

• [(script_name).cdscript] section contains all values related to it's script.
• ~state is the main key that is rensposible for disabling/enabling script to load. (false - disable, true - enable)

The script section can also use other keys if the script has settings that the user can configure in the manager.

3rd-party plugins

The application is using Costura.Fody to compile all resources into a single executable file.