Mod Template and Gay Sex

This is a template repository to build new Space Engineers mods.

Prerequisites

• Space Engineers
• Space Engineers - Mod SDK *
• Python 3.x **
• .NET Framework 4.8.1 Developer Pack

* Install the Mod SDK via Steam. It is listed under Tools in your Library. You may need to enable listing the Tools in the drop-down at the top of the left side list.

** Python is required only for the project setup. Tested with Python 3.12.

Create your plugin project

1. Click on Use this template (top right corner on GitHub) and follow the wizard to create your repository
2. Clone your repository to have a local working copy
3. Run ReplaceGuidsAndRename.py, enter the name of your mod project in CapitalizedWords format
4. Edit and run Edit-and-run-before-opening-solution.bat to link the ModSDK folder
5. Open the solution in Microsoft Visual Studio or JetBrains Rider
6. Build the solution, it should deploy as a local mod into the %APPDATA%\SpaceEngineers\Mods folder
7. Add the local mod to a world you will use to test it during development
8. Delete ReplaceGuidsAndRename.py from the Solution Items folder of the solution (it is not needed anymore)
9. Replace the contents of this file with the description of your mod intended for developers, link your workshop mod once it is published
10. Write the code of your mod in the ModTemplate project, follow the TODO comments, see tutorials and the source code of other mods as examples
11. Fill the SteamDescription.txt file with the description intended for players (use this when you publish the mod)
12. Create a good thumbnail image in Mod/Data/thumb.jpg (use this when you publish the mod)
13. Once you have published your mod, copy the modinfo.sbmi file from the published mod folder into the Mod subdirectory of the ModTemplate project and commit it into the repository, so it won't be deleted by deployments

Good luck!

Troubleshooting

The game does not pick up my source code changes

You have to rebuild the project or invoke Deploy.bat manually to have your changes deployed into the %APPDATA%\SpaceEngineers\Mods\ModTemplate folder.

Once deployed, you need to load a world which has your local mod included. It will not work in multiplayer until you publish it on Steam.

Accidentally deleted the modinfo.sbmi file

Recreate the file from this template, fill the missing IDs accordingly:

<?xml version="1.0"?>
<MyObjectBuilder_ModInfo xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SteamIDOwner>YOUR-STEAM-ID</SteamIDOwner>
  <WorkshopId>0</WorkshopId>
  <WorkshopIds>
    <WorkshopId>
      <Id>WORKSHOP-ID-OF-YOUR-MOD</Id>
      <ServiceName>Steam</ServiceName>
    </WorkshopId>
  </WorkshopIds>
</MyObjectBuilder_ModInfo>

You can get the IDs from the Steam URLs. Your Steam profile link has your Steam ID in it. The link to your mod has an id URL parameter.