Skip to main content

Troubleshooting

The editor does not start / "This project does not have any source code"​

You opened the .uproject file directly. Start the editor with Run_QZSim_Editor.bat instead.

"uplugin missing engine version" / the mod is rejected​

Package with the Package Mods tool, or add EngineVersion and GameVersion manually (see Versioning). The .uplugin must be UTF-8 without BOM.

"bUseIoStore values mismatch"​

Your mod needs a UGC Metadata asset in its Content with Io Store Enabled = true. Create Mods adds it.

I updated the mod file but the game shows the old one​

Content already loaded into the current level will not swap in place. Return to the main menu and re-enter the campaign. If it is still stale, restart the game.

The mod packages fine but does nothing in game​

You created assets in the base project content (/Game/...) instead of inside your mod. Packaging only includes what is under your plugin's Content folder; anything in QZSim\Content is left out. To fix it:

  1. Select those assets in the Content Browser and Move them into your plugin's Content folder.
  2. Right-click the old folders and choose Fix Up Redirectors.
  3. Make sure nothing of yours is left under QZSim\Content.
  4. Run Package Mods again.

"Another plugin of the same name"​

Two copies of the mod are visible, for example a local copy in QZSim\Modio plus a mod.io subscription. Remove one.

Packaging fails with "referenced by DLC"​

The asset you reference is not part of the shipped game. See Cooked content limitations.

"Mods need an update" in the main menu​

The mod has no GameVersion or an old one. Re-package with the current Creator Kit and upload the new file.