PULSAR Mod Loader Adaptor

Adaptor which injects PULSAR Mod Loader using BepInEx whenever PULSAR: Lost Colony runs.

Currently, the adaptor is only used for loading PulsarModLoader and non-BepInEx mods. In the future, changes will be made to download the most recent PulsarModLoader and a template will be added for BepInEx plugins to be made and use the mod loaders addons.

For PULSAR: Lost Colony Version 1.2.10

Adaptor Version 1.0.0 -- Developed by Mest

Included Pulsar Mod Loader Version v0.12.3.31 -- Developed by TomRichter, Dragon, 18107. With contributions from Badryuner, Pokegustavor

➕ Pulsar Mod Loader Features (Currently for non-BepInEx mods)

• ✔ Method to inject mods into the game
• ✔ Indicator for modded sessions
• ✔ Mod requirement management
• ✔ Zip folder mod loading
• ✔ Utilities to create local chat commands
• ✔ Utilities to create public chat commands
• ✔ Autofill for chat commands and names
• ✔ Onscreen exception warning messages
• ✔ Mod Messages which allow mods to share data
• ✔ Keybinds
• ✔ Transpiler patch assist methods
• ✔ Subscribable events for mods to use
• ✔ Utilities to save data based on session or locally
• ✔ User Interface to interact with mods (Unloading, config etc)
• ✔ Utilities to create new components
• ✔ Utilities to create new items
• ❌ Utilities to create new talents
• ❌ Utilities to create new ships
• ❌ Utilities to create new shops
• ❌ Utilities to create new avatars/clothing

🎮 Client Usage

• F5 ingame will bring up a menu which lists all installed Pulsar Mod Loader plugins and their mod settings.
• / is the prefix for client commands. /help lists all commands available.
• ! is the prefix for public commands. !help lists all public commands available.

🔧 Install Instructions

Before attempting to mod, ensure your Pulsar installation is a Mono build. On Steam you can change this by right clicking Pulsar: lost colony in your steam library and selecting [properties > betas > mono].

Ensure that you have BepInEx 5 (stable version 5 MONO) installed and PulsarModLoader and PulsarModLoader Adaptor downloaded.

✔️ Mod installation

Place PulsarModLoader.dll and PulsarModLoader.Adaptor.dll into the BepInEx \patchers folder. Then run PULSAR normally, if it is installed, using F5 will bring up a UI interface.

You can also place PulsarModLoader into the PULSARLostColony\Managed directory, however it will prioritise loading from the patcher location.

❌ Removal

Disable the patcher or remove PulsarModLoader.dll and PulsarModLoader.Adaptor.dll from \patchers

⁉ Where Are The Mods

There are numerous non-BepInEx mods which can be found on the Pulsar Lost Colony: Crew Matchup Server and are supported, just place them into the PulsarLostColony/Mods directory or the BepInEx/Plugins directory.

For backwards support of non-BepInEx mods, HarmonyX is altered to not normalise transpiler instructions. Therefore, some BepInEx mods (which are unaware of this) may not patch properly as OpCodes.Beq_S for instance will not be changed to OpCodes.Beq and might not behave properly!

In the future, changes will be made to allow BepInEx plugins to use the mod loaders addons.

🤔 Development Guide

Check out the wiki for basic instructions on creating mods.