The simplest way to explain how to install mods for Starsandisland Modkit is this: you must place the unzipped mod folders directly into the game's dedicated Mods folder, then activate them from the 'Mod Management' screen on the main menu. If that folder doesn't exist, you'll need to create it. This single step — getting the folder structure right — is where over 90% of modding problems originate.

Unlike games with Steam Workshop integration, Starsandisland uses a manual installation method that gives you more control but also requires more precision. This guide breaks down the entire process, from locating the hidden folder to diagnosing conflicts, ensuring you can customize your island adventure without the headache.

First, Where Does the 'Mods' Folder Go?

The most critical step is finding the correct installation directory. The Starsandisland Modkit doesn't use its main installation folder (e.g., in Steam/steamapps/common) for mods. Instead, it uses a hidden folder within your Windows user profile.

The default path is almost always: C:\Users\[YourUsername]\AppData\LocalLow\CosmicDrift\Starsandisland\Mods

Be sure to replace [YourUsername] with your actual Windows user name. The AppData folder is hidden by default in Windows. To see it, open File Explorer, go to the 'View' tab, and check the box for 'Hidden items'. Once enabled, you can navigate to the path above.

What if the 'Mods' Folder Doesn't Exist?

If you've never installed a mod before, you will likely navigate to ...\CosmicDrift\Starsandisland\ and find that there is no Mods folder inside. This is normal. The game only generates this folder after you've toggled modding settings in-game for the first time, but it's faster and more reliable to create it yourself.

Simply right-click inside the Starsandisland folder, select 'New' -> 'Folder', and name it Mods. The name is case-sensitive, so make sure you capitalize the 'M'. This is now the destination for all your mod files.

The Right Way to Download and Unpack Mods

Now that you have your destination, you need the mods themselves. The most trusted community hub for Starsandisland mods is the Star-Chart Nexus, but always exercise caution. Only download from well-known sources with active comment sections. A mod that hasn't been updated since the 'Whispering Tides' patch, for example, is unlikely to work with the current version of the game.

Mods almost always come in a compressed format, like a .zip or .rar file. You cannot simply drop this compressed file into your Mods folder. You must extract its contents first. This leads to the most common installation error: incorrect folder nesting.

A Step-by-Step Installation Example

Let's walk through installing a popular (fictional) mod, the "Aetherium Tools Pack." It adds glowing, high-efficiency tools crafted from Stardust Shards.

  1. Download the File: You download AetheriumTools_v1.4.zip from a trusted source.
  2. Extract the Contents: Right-click the .zip file and choose 'Extract All...' (or use a tool like 7-Zip). This will create a new folder named AetheriumTools_v1.4.
  3. Check the Folder Structure: Open the new AetheriumTools_v1.4 folder. Inside, you should see the actual mod folder, likely named just AetheriumTools, which contains files like assets.bin, modinfo.json, etc.
  4. Move the Correct Folder: Drag only the inner AetheriumTools folder into your ...\Starsandisland\Mods directory.

The final path should look like this: ...\Mods\AetheriumTools\assets.bin

Do not create an extra layer of folders, like this: ...\Mods\AetheriumTools_v1.4\AetheriumTools\assets.bin

This double-folder structure is the number one reason the game fails to detect a mod.

Comic Grid: Showing the common mistake of incorrect folder nesting when installing mods.

Comic Grid: Showing the common mistake of incorrect folder nesting when installing mods.

How to Activate Mods Inside the Game

Once your mods are in the correct folder, the rest of the process happens inside Starsandisland itself. Launch the game and look at the main menu.

From the main menu, navigate to Options -> Mod Management. This screen is your central command for all installed community content. Here you'll see a list of every mod the game has successfully detected in your Mods folder. If a mod is missing from this list, you have a folder path problem (see the section above).

Each mod in the list will have an activation toggle or checkbox next to it. Simply click it to enable the mod. Some mods may require a game restart to take full effect, which is usually noted in the mod's description.

For players running multiple complex mods, load order is crucial. The list on this screen represents the order in which the game loads the mods, from top to bottom. Mods lower on the list load last and will override any conflicting changes from mods higher up. If you have two mods that alter the recipe for the Coral-Glass Pickaxe, the one loaded last will be the recipe you see in-game. Use the up and down arrows to rearrange mods and resolve these conflicts.

Analysis Report Poster: A breakdown of the in-game Mod Management menu in Starsandisland.

Analysis Report Poster: A breakdown of the in-game Mod Management menu in Starsandisland.

Troubleshooting: When Mods Don't Work

Even with a perfect installation, things can go wrong, especially after a major game update. Here are the most common issues and how to fix them.

  • Issue: The game crashes on startup or loading a save.

    • Cause: This is almost always an outdated mod conflicting with the latest version of the game, or two mods that are fundamentally incompatible (e.g., two different island generation overhauls).
    • Solution: Disable all your mods. If the game launches, you know it's a mod issue. Re-enable them one by one, launching the game each time, until you find the culprit. Check that mod's page for updates or bug reports.

  • Issue: The mod doesn't appear in the in-game 'Mod Management' menu.

    • Cause: This is a folder path problem 99% of the time. You either have a nested folder issue (as described earlier) or you placed the mods in the wrong game directory entirely.
    • Solution: Go back to your ...\LocalLow\CosmicDrift\Starsandisland\Mods folder and meticulously check the structure for every mod you've installed. Ensure there are no extra parent folders.

  • Issue: The mod is active, but its features (items, creatures, etc.) don't appear in-game.

    • Cause: This often points to a missing dependency. Many larger mods require a separate utility or API mod to function, such as the popular "Starlight Core API."
    • Solution: Carefully re-read the mod's description page. The author will almost always list any required files or other mods you must install first for theirs to work correctly.
Infographic: A flowchart for troubleshooting common Starsandisland mod problems.

Infographic: A flowchart for troubleshooting common Starsandisland mod problems.

Frequently Asked Questions (FAQ)

Can I install Starsandisland mods on the console (PlayStation/Xbox) version? No. The Starsandisland Modkit and its associated file structure are exclusive to the PC (Steam, GOG) versions of the game. Console platforms do not support this kind of user-generated file modification.

Is it safe to install mods? Generally, yes, as long as you stick to reputable community sites like the Star-Chart Nexus. Malicious files are rare but possible. As a rule, never run a .exe file from a mod download. More importantly, always back up your save files before installing a new mod. Your saves are located in a separate Saves folder right next to your Mods folder.

How do I update a mod? To update a mod, first delete the old mod's folder from your Mods directory completely. Then, download the new version and follow the standard installation process to place the updated folder in its place. Overwriting files can sometimes leave old, unused files behind that may cause issues.

Will using mods disable achievements? The game detects when a save file is loaded with active mods and automatically disables Steam or GOG achievement progress for that save. This is to ensure achievements are earned using the vanilla game balance. You can still earn them on a separate, un-modded save file.

Final Check

Modding Starsandisland transforms an already deep survival game into a nearly endless sandbox. From adding new terrifying leviathans to the deep ocean trenches to simple quality-of-life tweaks like larger storage chests, the community's creativity is boundless. The manual installation process might seem intimidating, but it boils down to one simple rule: get the folder structure right. Master that, and you've unlocked the game's true potential.