Troubleshooting

"No .pkg files found." Un-Banished cannot find the game data. Give the WinData folder on the command line, put the program next to WinData, or run tools/extract-assets.sh.

tools/extract-assets.sh says that it cannot find Banished. Set BANISHED_DIR to the folder that contains WinData, and run the script again.

The browser page still shows the loading screen. Select all four .pkg files at the same time. If the page reports a parse error, one of the files is damaged or incomplete. In Steam, right-click Banished, choose Properties → Installed Files → Verify integrity of game files, and try again.

The window is black, or a graphics error appears at start. Update your graphics drivers. On Linux, check that the Vulkan drivers are installed: vulkaninfo must show your graphics card.

There is no sound in the browser. Browsers play sound only after you click or type on the page. Click the game once.

The browser version is slow. In the game's Options, set Resolution to 75 % or 50 %, and lower the Refresh rate. A browser without WebGPU uses WebGL 2, which is slower; Chrome and Edge have WebGPU.

The first tutorial stops at the first house. In versions before 0.3.0, the Wood House stayed greyed out after you opened the Housing menu (#11). Update Un-Banished; from 0.3.0, the click on the menu, or its key (F3), counts.

After an update, my Un-Banished settings look wrong. Delete the settings file (see Settings).

Reporting a difference from the original

The goal of Un-Banished is to work exactly like Banished 1.0.7. If something looks, sounds or works differently, or does not work, please open an issue. The forms there ask for the information we need:

Parity difference: what the original does, what Un-Banished does, and how to see it.
Bug report: something broken or impossible to do.
Performance problem: stutters, slowdowns, long loads.

Screenshots or a short video from both games are very useful. Do not attach the game's own files (.pkg, .exe, or extracted art or sound).

DEVIATIONS.md lists the known, intentional differences. PARITY-AUDIT.md shows what has been checked.

Troubleshooting ​