Kerbal Space Program 2 Modding Wiki - User contributions [en]

Migrating from SpaceWarp 1.x

2025-11-29T02:41:08Z

Munix:

Note: This page is a work in progress.
Redux features a brand new version of SpaceWarp. While it's all shiny and cool, it breaks support with older versions. Now you're probably wondering: How do I migrate to SpaceWarp 2.x? This guide is for you.

'''<big>What's different?</big>'''

Since Redux has SpaceWarp built-in, there's no need to have BepInEx anymore. This means all mods get stored in a dedicated Mods folder in the main KSP2 directory called "mods"... and that you can't use BepInEx's stuff anymore.

The SpaceWarp namespace has been renamed to SpaceWarp2.

'''<big>API</big>'''

SpaceWarp2 now has following classes:

GeneralMod

MonoBehaviourMod

KerbalMod. (technically a Redux thing) It has access to useful game classes like Game, Assets, Messages, etc. Equivalent to BaseSpaceWarpPlugin. Found in Redux.ExtraModTypes

SpaceWarp2 also has a bunch of different members. Some of it has also been split up into ReduxLib and Redux.

SpaceWarp2.API.Configuration = ReduxLib.Configuration

SpaceWarp.API.UI.Appbar = SpaceWarp2.UI.API.Appbar

BepInExConfigFile = JsonConfigFile

'''<big>Example plugin before & after migration:</big>'''

Before:<syntaxhighlight lang="c#">
using System.Reflection;
using BepInEx;
using JetBrains.Annotations;
using SpaceWarp;
using SpaceWarp.API.Assets;
using SpaceWarp.API.Mods;
using SpaceWarp.API.UI.Appbar;
using SpaceWarpModUI.UI;
using UitkForKsp2.API;
using UnityEngine;
using UnityEngine.UIElements;

namespace SpaceWarpModUI;

[BepInPlugin(MyPluginInfo.PLUGIN_GUID, MyPluginInfo.PLUGIN_NAME, MyPluginInfo.PLUGIN_VERSION)]
[BepInDependency(SpaceWarpPlugin.ModGuid, SpaceWarpPlugin.ModVer)]
public class SpaceWarpModUIPlugin : BaseSpaceWarpPlugin
{
// Useful in case some other mod wants to use this mod a dependency
[PublicAPI] public const string ModGuid = MyPluginInfo.PLUGIN_GUID;
[PublicAPI] public const string ModName = MyPluginInfo.PLUGIN_NAME;
[PublicAPI] public const string ModVer = MyPluginInfo.PLUGIN_VERSION;

/// Singleton instance of the plugin class
[PublicAPI] public static SpaceWarpModUIPlugin Instance { get; set; }

// AppBar button IDs
internal const string ToolbarFlightButtonID = "BTN-SpaceWarpModUIFlight";
internal const string ToolbarOabButtonID = "BTN-SpaceWarpModUIOAB";
internal const string ToolbarKscButtonID = "BTN-SpaceWarpModUIKSC";

/// <summary>
/// Runs when the mod is first initialized.
/// </summary>
public override void OnInitialized()
{
base.OnInitialized();

Instance = this;

// Load all the other assemblies used by this mod
LoadAssemblies();

// Load the UI from the asset bundle
var myFirstWindowUxml = AssetManager.GetAsset<VisualTreeAsset>(
// The case-insensitive path to the asset in the bundle is composed of:
// - The mod GUID:
$"{ModGuid}/" +
// - The name of the asset bundle:
"SpaceWarpModUI_ui/" +
// - The path to the asset in your Unity project (without the "Assets/" part)
"ui/myfirstwindow/myfirstwindow.uxml"
);

// Create the window options object
var windowOptions = new WindowOptions
{
// The ID of the window. It should be unique to your mod.
WindowId = "SpaceWarpModUI_MyFirstWindow",
// The transform of parent game object of the window.
// If null, it will be created under the main canvas.
Parent = null,
// Whether or not the window can be hidden with F2.
IsHidingEnabled = true,
// Whether to disable game input when typing into text fields.
DisableGameInputForTextFields = true,
MoveOptions = new MoveOptions
{
// Whether or not the window can be moved by dragging.
IsMovingEnabled = true,
// Whether or not the window can only be moved within the screen bounds.
CheckScreenBounds = true
}
};

// Create the window
var myFirstWindow = Window.Create(windowOptions, myFirstWindowUxml);
// Add a controller for the UI to the window's game object
var myFirstWindowController = myFirstWindow.gameObject.AddComponent<MyFirstWindowController>();

// Register Flight AppBar button
Appbar.RegisterAppButton(
ModName,
ToolbarFlightButtonID,
AssetManager.GetAsset<Texture2D>($"{ModGuid}/images/icon.png"),
isOpen => myFirstWindowController.IsWindowOpen = isOpen
);

// Register OAB AppBar Button
Appbar.RegisterOABAppButton(
ModName,
ToolbarOabButtonID,
AssetManager.GetAsset<Texture2D>($"{ModGuid}/images/icon.png"),
isOpen => myFirstWindowController.IsWindowOpen = isOpen
);

// Register KSC AppBar Button
Appbar.RegisterKSCAppButton(
ModName,
ToolbarKscButtonID,
AssetManager.GetAsset<Texture2D>($"{ModGuid}/images/icon.png"),
() => myFirstWindowController.IsWindowOpen = !myFirstWindowController.IsWindowOpen
);
}

/// <summary>
/// Loads all the assemblies for the mod.
/// </summary>
private static void LoadAssemblies()
{
// Load the Unity project assembly
var currentFolder = new FileInfo(Assembly.GetExecutingAssembly().Location).Directory!.FullName;
var unityAssembly = Assembly.LoadFrom(Path.Combine(currentFolder, "SpaceWarpModUI.Unity.dll"));
// Register any custom UI controls from the loaded assembly
CustomControls.RegisterFromAssembly(unityAssembly);
}
}
</syntaxhighlight>After:<syntaxhighlight lang="c#">
using JetBrains.Annotations;
using Redux.ExtraModTypes;
using SpaceWarp2.UI.API.Appbar;
using SpaceWarpModUI.UI;
using UitkForKsp2.API;
using UnityEngine;
using UnityEngine.UIElements;

namespace SpaceWarpModUI;

public abstract class SpaceWarpModUIPlugin : KerbalMod
{
[PublicAPI] public const string ModGuid = "SpaceWarpModUI"; // ModGuid here
[PublicAPI] public const string ModName = "SpaceWarpUIMod";
//[PublicAPI] public const string ModVer = MyPluginInfo.PLUGIN_VERSION;

/// Singleton instance of the plugin class
[PublicAPI] public static SpaceWarpModUIPlugin Instance { get; set; }

// AppBar button IDs
internal const string ToolbarFlightButtonID = "BTN-SpaceWarpModUIFlight";
internal const string ToolbarOabButtonID = "BTN-SpaceWarpModUIOAB";
internal const string ToolbarKscButtonID = "BTN-SpaceWarpModUIKSC";

/// <summary>
/// Runs before the game is loaded, as early as possible.
/// You would want to use this to register loading actions (like loading JSONs from addressables).
/// </summary>

public override void OnPreInitialized()
{
Debug.Log("Pre Initialized");
}

/// <summary>
/// Runs after the game is loaded and after your mod assets are loaded.
/// </summary>

public override void OnInitialized()
{
Debug.Log("Is Initializing"); // You can use Debug.Log to log things.
Instance = this;

// Load the UI from the asset bundle
var myFirstWindowUxml = Assets.LoadAssetAsync<VisualTreeAsset>(
// The case-insensitive path to the asset in the bundle is composed of:
// - The mod GUID:
$"{ModGuid}/" +
// - The name of the asset bundle:
"SpaceWarpModUI_ui/" +
// - The path to the asset in your Unity project (without the "Assets/" part)
"ui/myfirstwindow/myfirstwindow.uxml"
).Result;

// Create the window options object
var windowOptions = new WindowOptions
{
// The ID of the window. It should be unique to your mod.
WindowId = "SpaceWarpModUI_MyFirstWindow",
// The transform of parent game object of the window.
// If null, it will be created under the main canvas.
Parent = null,
// Whether the window can be hidden with F2.
IsHidingEnabled = true,
// Whether the UI will use the "Scale" option in the settings.
UseStockScale = true,
// Whether to disable game input when typing into text fields.
DisableGameInputForTextFields = true,
MoveOptions = new MoveOptions
{
// Whether the window can be moved by dragging.
IsMovingEnabled = true,
// Whether the window can only be moved within the screen bounds.
CheckScreenBounds = true
}
};

// Create the window
var myFirstWindow = Window.Create(windowOptions, myFirstWindowUxml);
// Add a controller for the UI to the window's game object
var myFirstWindowController = myFirstWindow.gameObject.AddComponent<MyFirstWindowController>();

// Register Flight AppBar button
Appbar.RegisterAppButton(
ModName,
ToolbarFlightButtonID,
Assets.LoadAssetAsync<Texture2D>($"{ModGuid}/images/icon.png").Result,
isOpen => myFirstWindowController.IsWindowOpen = isOpen
);

// Register OAB AppBar Button
Appbar.RegisterOABAppButton(
ModName,
ToolbarOabButtonID,
Assets.LoadAssetAsync<Texture2D>($"{ModGuid}/images/icon.png").Result,
isOpen => myFirstWindowController.IsWindowOpen = isOpen
);

// Register KSC AppBar Button
Appbar.RegisterKSCAppButton(
ModName,
ToolbarKscButtonID,
Assets.LoadAssetAsync<Texture2D>($"{ModGuid}/images/icon.png").Result,
() => myFirstWindowController.IsWindowOpen = !myFirstWindowController.IsWindowOpen
);
}

/// <summary>
/// Runs after all mods have done their 2nd stage initialization.
/// You would want to use this to interact with game systems, since they're guaranteed to be loaded on this stage.
/// </summary>

public override void OnPostInitialized()
{
Debug.Log("Post Initialized");
}

// You can create controls directly in Unity. No need for this method anymore.
//private static void LoadAssemblies()
//{
// // Load the Unity project assembly
// var currentFolder = new FileInfo(Assembly.GetExecutingAssembly().Location).Directory!.FullName;
// var unityAssembly = Assembly.LoadFrom(Path.Combine(currentFolder, "SpaceWarpModUI.Unity.dll"));
// // Register any custom UI controls from the loaded assembly
// CustomControls.RegisterFromAssembly(unityAssembly);
//}
}
</syntaxhighlight>For more examples you can look at some of the "Reduxed" mods we've made for Redux here: https://github.com/orgs/KSP2Community/repositories?type=all

Migrating from SpaceWarp 1.x

2025-11-29T02:40:42Z

Munix:

<blockquote>Note: This page is a work in progress.</blockquote>Redux features a brand new version of SpaceWarp. While it's all shiny and cool, it breaks support with older versions. Now you're probably wondering: How do I migrate to SpaceWarp 2.x? This guide is for you.

'''<big>What's different?</big>'''

Since Redux has SpaceWarp built-in, there's no need to have BepInEx anymore. This means all mods get stored in a dedicated Mods folder in the main KSP2 directory called "mods"... and that you can't use BepInEx's stuff anymore.

The SpaceWarp namespace has been renamed to SpaceWarp2.

'''<big>API</big>'''

SpaceWarp2 now has following classes:

GeneralMod

MonoBehaviourMod

KerbalMod. (technically a Redux thing) It has access to useful game classes like Game, Assets, Messages, etc. Equivalent to BaseSpaceWarpPlugin. Found in Redux.ExtraModTypes

SpaceWarp2 also has a bunch of different members. Some of it has also been split up into ReduxLib and Redux.

SpaceWarp2.API.Configuration = ReduxLib.Configuration

SpaceWarp.API.UI.Appbar = SpaceWarp2.UI.API.Appbar

BepInExConfigFile = JsonConfigFile

'''<big>Example plugin before & after migration:</big>'''

Before:<syntaxhighlight lang="c#">
using System.Reflection;
using BepInEx;
using JetBrains.Annotations;
using SpaceWarp;
using SpaceWarp.API.Assets;
using SpaceWarp.API.Mods;
using SpaceWarp.API.UI.Appbar;
using SpaceWarpModUI.UI;
using UitkForKsp2.API;
using UnityEngine;
using UnityEngine.UIElements;

namespace SpaceWarpModUI;

[BepInPlugin(MyPluginInfo.PLUGIN_GUID, MyPluginInfo.PLUGIN_NAME, MyPluginInfo.PLUGIN_VERSION)]
[BepInDependency(SpaceWarpPlugin.ModGuid, SpaceWarpPlugin.ModVer)]
public class SpaceWarpModUIPlugin : BaseSpaceWarpPlugin
{
// Useful in case some other mod wants to use this mod a dependency
[PublicAPI] public const string ModGuid = MyPluginInfo.PLUGIN_GUID;
[PublicAPI] public const string ModName = MyPluginInfo.PLUGIN_NAME;
[PublicAPI] public const string ModVer = MyPluginInfo.PLUGIN_VERSION;

/// Singleton instance of the plugin class
[PublicAPI] public static SpaceWarpModUIPlugin Instance { get; set; }

// AppBar button IDs
internal const string ToolbarFlightButtonID = "BTN-SpaceWarpModUIFlight";
internal const string ToolbarOabButtonID = "BTN-SpaceWarpModUIOAB";
internal const string ToolbarKscButtonID = "BTN-SpaceWarpModUIKSC";

/// <summary>
/// Runs when the mod is first initialized.
/// </summary>
public override void OnInitialized()
{
base.OnInitialized();

Instance = this;

// Load all the other assemblies used by this mod
LoadAssemblies();

// Load the UI from the asset bundle
var myFirstWindowUxml = AssetManager.GetAsset<VisualTreeAsset>(
// The case-insensitive path to the asset in the bundle is composed of:
// - The mod GUID:
$"{ModGuid}/" +
// - The name of the asset bundle:
"SpaceWarpModUI_ui/" +
// - The path to the asset in your Unity project (without the "Assets/" part)
"ui/myfirstwindow/myfirstwindow.uxml"
);

// Create the window options object
var windowOptions = new WindowOptions
{
// The ID of the window. It should be unique to your mod.
WindowId = "SpaceWarpModUI_MyFirstWindow",
// The transform of parent game object of the window.
// If null, it will be created under the main canvas.
Parent = null,
// Whether or not the window can be hidden with F2.
IsHidingEnabled = true,
// Whether to disable game input when typing into text fields.
DisableGameInputForTextFields = true,
MoveOptions = new MoveOptions
{
// Whether or not the window can be moved by dragging.
IsMovingEnabled = true,
// Whether or not the window can only be moved within the screen bounds.
CheckScreenBounds = true
}
};

// Create the window
var myFirstWindow = Window.Create(windowOptions, myFirstWindowUxml);
// Add a controller for the UI to the window's game object
var myFirstWindowController = myFirstWindow.gameObject.AddComponent<MyFirstWindowController>();

// Register Flight AppBar button
Appbar.RegisterAppButton(
ModName,
ToolbarFlightButtonID,
AssetManager.GetAsset<Texture2D>($"{ModGuid}/images/icon.png"),
isOpen => myFirstWindowController.IsWindowOpen = isOpen
);

// Register OAB AppBar Button
Appbar.RegisterOABAppButton(
ModName,
ToolbarOabButtonID,
AssetManager.GetAsset<Texture2D>($"{ModGuid}/images/icon.png"),
isOpen => myFirstWindowController.IsWindowOpen = isOpen
);

// Register KSC AppBar Button
Appbar.RegisterKSCAppButton(
ModName,
ToolbarKscButtonID,
AssetManager.GetAsset<Texture2D>($"{ModGuid}/images/icon.png"),
() => myFirstWindowController.IsWindowOpen = !myFirstWindowController.IsWindowOpen
);
}

/// <summary>
/// Loads all the assemblies for the mod.
/// </summary>
private static void LoadAssemblies()
{
// Load the Unity project assembly
var currentFolder = new FileInfo(Assembly.GetExecutingAssembly().Location).Directory!.FullName;
var unityAssembly = Assembly.LoadFrom(Path.Combine(currentFolder, "SpaceWarpModUI.Unity.dll"));
// Register any custom UI controls from the loaded assembly
CustomControls.RegisterFromAssembly(unityAssembly);
}
}
</syntaxhighlight>After:<syntaxhighlight lang="c#">
using JetBrains.Annotations;
using Redux.ExtraModTypes;
using SpaceWarp2.UI.API.Appbar;
using SpaceWarpModUI.UI;
using UitkForKsp2.API;
using UnityEngine;
using UnityEngine.UIElements;

namespace SpaceWarpModUI;

public abstract class SpaceWarpModUIPlugin : KerbalMod
{
[PublicAPI] public const string ModGuid = "SpaceWarpModUI"; // ModGuid here
[PublicAPI] public const string ModName = "SpaceWarpUIMod";
//[PublicAPI] public const string ModVer = MyPluginInfo.PLUGIN_VERSION;

/// Singleton instance of the plugin class
[PublicAPI] public static SpaceWarpModUIPlugin Instance { get; set; }

// AppBar button IDs
internal const string ToolbarFlightButtonID = "BTN-SpaceWarpModUIFlight";
internal const string ToolbarOabButtonID = "BTN-SpaceWarpModUIOAB";
internal const string ToolbarKscButtonID = "BTN-SpaceWarpModUIKSC";

/// <summary>
/// Runs before the game is loaded, as early as possible.
/// You would want to use this to register loading actions (like loading JSONs from addressables).
/// </summary>

public override void OnPreInitialized()
{
Debug.Log("Pre Initialized");
}

/// <summary>
/// Runs after the game is loaded and after your mod assets are loaded.
/// </summary>

public override void OnInitialized()
{
Debug.Log("Is Initializing"); // You can use Debug.Log to log things.
Instance = this;

// Load the UI from the asset bundle
var myFirstWindowUxml = Assets.LoadAssetAsync<VisualTreeAsset>(
// The case-insensitive path to the asset in the bundle is composed of:
// - The mod GUID:
$"{ModGuid}/" +
// - The name of the asset bundle:
"SpaceWarpModUI_ui/" +
// - The path to the asset in your Unity project (without the "Assets/" part)
"ui/myfirstwindow/myfirstwindow.uxml"
).Result;

// Create the window options object
var windowOptions = new WindowOptions
{
// The ID of the window. It should be unique to your mod.
WindowId = "SpaceWarpModUI_MyFirstWindow",
// The transform of parent game object of the window.
// If null, it will be created under the main canvas.
Parent = null,
// Whether the window can be hidden with F2.
IsHidingEnabled = true,
// Whether the UI will use the "Scale" option in the settings.
UseStockScale = true,
// Whether to disable game input when typing into text fields.
DisableGameInputForTextFields = true,
MoveOptions = new MoveOptions
{
// Whether the window can be moved by dragging.
IsMovingEnabled = true,
// Whether the window can only be moved within the screen bounds.
CheckScreenBounds = true
}
};

// Create the window
var myFirstWindow = Window.Create(windowOptions, myFirstWindowUxml);
// Add a controller for the UI to the window's game object
var myFirstWindowController = myFirstWindow.gameObject.AddComponent<MyFirstWindowController>();

// Register Flight AppBar button
Appbar.RegisterAppButton(
ModName,
ToolbarFlightButtonID,
Assets.LoadAssetAsync<Texture2D>($"{ModGuid}/images/icon.png").Result,
isOpen => myFirstWindowController.IsWindowOpen = isOpen
);

// Register OAB AppBar Button
Appbar.RegisterOABAppButton(
ModName,
ToolbarOabButtonID,
Assets.LoadAssetAsync<Texture2D>($"{ModGuid}/images/icon.png").Result,
isOpen => myFirstWindowController.IsWindowOpen = isOpen
);

// Register KSC AppBar Button
Appbar.RegisterKSCAppButton(
ModName,
ToolbarKscButtonID,
Assets.LoadAssetAsync<Texture2D>($"{ModGuid}/images/icon.png").Result,
() => myFirstWindowController.IsWindowOpen = !myFirstWindowController.IsWindowOpen
);
}

/// <summary>
/// Runs after all mods have done their 2nd stage initialization.
/// You would want to use this to interact with game systems, since they're guaranteed to be loaded on this stage.
/// </summary>

public override void OnPostInitialized()
{
Debug.Log("Post Initialized");
}

// You can create controls directly in Unity. No need for this method anymore.
//private static void LoadAssemblies()
//{
// // Load the Unity project assembly
// var currentFolder = new FileInfo(Assembly.GetExecutingAssembly().Location).Directory!.FullName;
// var unityAssembly = Assembly.LoadFrom(Path.Combine(currentFolder, "SpaceWarpModUI.Unity.dll"));
// // Register any custom UI controls from the loaded assembly
// CustomControls.RegisterFromAssembly(unityAssembly);
//}
}
</syntaxhighlight>For more examples you can look at some of the "Reduxed" mods we've made for Redux here: https://github.com/orgs/KSP2Community/repositories?type=all

Setting up Unity

2025-10-15T21:47:20Z

Munix: Removed link to Lux's Notion (broken)

This page will help you install everything you need to use Unity for KSP2 modding.

== Installing Unity ==

# Download Unity Hub from https://unity.com/download.
# Download Unity 2022.3.5f1 by clicking on the '''Install this version with Unity Hub''' link on this page: https://unity.com/releases/editor/whats-new/2022.3.5.
# Download and install Git from https://git-scm.com/downloads.

== Initializing the Unity project ==
# Open '''Unity Hub'''.
# Click on '''New Project''' at the top right of the window.
# At the top of the new interface, set the '''Editor Version''' to <code>2022.3.5f1</code>. You can keep the project template set to '''3D (Core)'''.
# Set the '''Project name''', it can be whatever you want, for example <code>MyModId.Unity</code>.
# Set the '''Location''' to the folder you want the Unity project to be saved in.
# Click '''Create project'''.

== Configuring the Unity project ==

=== Installing the Addressables package ===
Unity doesn’t come with this package natively, so we need to install it first:

# Open the Package Manager by clicking '''Window>Package Manager''' in the toolbar at the top of Unity.
# This will open a new window where you can manage most of the packages in your project.
# Go where it says '''Packages: In Project''' and change that to '''Unity Registry'''.
# In the search bar, look for '''Addressables'''. Select it and click '''Install'''. It will show a couple pop-ups, and once it is finished, it will show a green checkmark next to the '''Addressables''' package version.

=== Installing ThunderKit ===
''ThunderKit'' is a package for Unity which we use to import the game's components into the Unity editor. However, it is not hosted in the official Unity package repository and needs to be installed directly from its GitHub repository.

# Go to '''Window>Package Manager''' and click on the '''+''' sign in the top left corner of the window that opens, after that click on '''Add Package from Git URL''', paste <code>https://github.com/PassivePicasso/ThunderKit.git</code> and click '''Add'''.
# The ''ThunderKit'' Settings window should open, if it doesn’t, just go to '''Tools>ThunderKit>Settings''' in the toolbar at the top of Unity.
# Go to '''Import Configuration''' and in '''Import Project Settings,''' change the dropdown value to '''Everything.'''
# Go to '''ThunderKit Settings''' and in '''Locate and load game files for project,''' click on '''Browse''' and select your main Kerbal Space Program 2 executable found at <code><KSP2 root folder>/KSP2_x64.exe</code>.
# Click '''Import''' and wait for KSP2 to be imported. If asked, click '''I made a backup, Go Ahead'''.
# If Unity asks you to restart your project, confirm it by clicking on '''Restart Project'''.
# After the process is finished, to check if the game was correctly imported, select or create any game object and in the inspector click '''Add Component''' and search for '''Core Part Data'''.

=== Installing KSP2 Unity Tools ===

# Go to '''Window>Package Manager''' and click on the '''+''' sign in the top left corner of the window that opens, after that click on '''Add Package from Git URL''', paste <code>https://github.com/KSP2Community/KSP2UnityTools.git</code> and click '''Add'''.
If you have previously installed an older version of KSP2 Unity Tools manually from a .unitypackage file, you will need to delete the whole "KSP2UnityTools" folder from your Assets folder and then do the installation.

=== Setting up swinfo.json and addressables ===

# After installing KSP2UnityTools, go to '''Tools>KSP2 Unity Tools.'''
# Follow one of two following steps, depending on which applies for you:
# '''If you have a mod you want to copy addressables into''':
## Set '''Build Mode''' to "'''Copy Assets Only'''".
## In the build path select the <code>addressables</code> folder in your mod's directory.
## At the bottom of the window, press '''Import swinfo.json''' and select your mod's <code>swinfo.json</code>.
# '''If you want to build a full mod from Unity''':
## Set '''Build Mode''' to "'''Everything'''".
## Set build path to where you want to output your packaged mod (you can set this later, just set it before build).
## If you already have a swinfo.json file, you can skip the next steps using the import swinfo.json button as described in the previous section.
## Input your mod's ID (this is critically important).
## Setup the rest of your mod's info (these correspond to the swinfo).
# After following one of the previous two processes, press '''Set Up Addressables From Mod Info''', and it should automatically set up the addressables groups for you.

[[Category:Getting started]]

Part Modding

2025-09-01T20:40:29Z

Munix:

So, you want to make a custom part for KSP2. Great! But where do you start? What tools do you need?

The pages below contain all the information you need to create your very own parts mod. The first step to any modded part is modelling it; most modders use Blender for this. KSP2 uses some standard part sizes you will need to keep in mind while making your model. Next, you will learn how to properly texture your model, including how to make it repaintable in the VAB, using a program like Adobe Substance Painter or similar. Finally, you will set up your part pack mod in Unity, and you will at last have your very own custom part in KSP2. Go wild!

=== Before you go ===

* [[How to name your part]]

=== Modelling ===

* [[Modeling the mesh in Blender]]
* [[Sizes|Standard Part Sizes]]
* [[Size Category|Standard Size Categories]]

=== Texturing ===

* [[Configuring Substance Painter]]
* [[Texturing|Texturing Basics]]
* [[Texturing the mesh in Substance 3D Painter]]

=== Importing in Unity ===

* [[Setting up Unity]]
* [[Configuring the part in Unity|Configuring the part in Unity (deprecated)]]
* [[Parts Pack Production Procedure|Parts Pack Production Procedure In Unity]]
* [[Configuring parts|General info on configuring core part data]]
* [[Family|Setting up a custom Part Family]]
* [[Configuring the reentry effects]]
* [[Creating custom engine plumes]]
* [[Configuring the part animation]]
* [[Part modding videos (tutorials)]]

=== Finishing up ===

*[[Sounds for parts with Wwise and Unity]]
* [[Creating a part icon]]

=== See Also ===
* [[Part Modules]]
* [[Stage Type|Stage Types]]
* [[Staging Icon Asset Address]]
* [[Category|Part Category]]
* [[Family]]
* [[Resources]]