Prerequisites

Note

Before following this guide, make sure you've installed and set up MDK Hub. The Hub handles .NET SDK installation, template setup, and project management for you.

Warning

If you have the original MDK (version 1) installed, you should uninstall it. MDK² works quite differently, and keeping the original around may cause conflicts.

Creating a New Project

  1. Open Visual Studio.

  2. Click "Create a new project" (or File → New → Project).

  3. Search for "MDK" in the template search box.

  4. Select "Programmable Block Script (MDK2)".

    image

    The URL shown in the screenshot (https://github.com/malware-dev/MDK-SE) is outdated. The current repository is https://github.com/malforge/mdk2.

  5. Choose a name and location for your project, then click "Create".

Note

Make sure you select the Script project template, not the Mixin project. Mixin projects are for advanced shared code libraries.

Tip

Having trouble? If you can't find the MDK templates or encounter issues creating a project, you can use the Hub to create projects instead. Just click "New Project" in the Hub dashboard.

Building Your Script

  1. Make your code changes in Program.cs or add new .cs files as needed.
  2. Build the project (Ctrl+Shift+B or Build → Build Solution).
  3. MDK will automatically:
    • Combine all your .cs files into a single script
    • Apply minification (if configured)
    • Deploy the script to your Space Engineers IngameScripts folder
    • Show a notification when complete (if Hub is running)

Your compiled script will be available in Space Engineers under Programmable Block → Edit → Browse Scripts (the folder icon).

Next Steps