Troubleshooting¶

Runtime issues¶

Commons¶

I only see my game window, I don't see any output of my `print` or `error` functions!¶

Are you running Nutshell from a terminal?

Nutshell will not open by itself a terminal window. Ensure you are running Nutshell from a command prompt, terminal or PowerShell.

If running from PowerShell, be sure to launch .\nutshell.exe | Out-Host to wait for process termination and correctly view its output.

Linux¶

Debian¶

My game behave wrongly with the shared flavor and Squirrel system libraries.¶

Wrong version of Squirrel Library

On Debian 14 (Forky), the Squirrel library is packaged with version 3.1. Nutshell requires version 3.2. As such, it is advised to either use the Squirrel libraries provided with the shared bundle, or provide your own compatible version in the Nutshell binary directory.

Windows¶

Windows 10¶

`terminal_read()` seems unreliable¶

In cmd.exe

cmd.exe assumes that it has control back immediately after spawning a process. You must indicate it to wait for the end of the Nutshell process via:

start /wait .\nutshell.exe path\to\your\project

In Powershell

In Powershell, you must spawn your process through

Start-Process -FilePath ".\nutshell.exe" -Wait

or

cmd /c start /wait .\nutshell.exe path\to\your\project

Any other issue?¶

This is not much of a FAQ yet.

See the Contact page if you want to reach the Nutshell community!