Para Studio on a Mac
How to start Para Studio on a Mac by double-clicking one file. It needs nothing installed first: the file checks what your Mac has, and for anything missing it says exactly what it would install, from where and into which folder, then asks a plain yes or no before it does anything. It tells you in plain words what it is doing.
Status: this was written and tested on Linux only. Nobody has run it on a Mac yet, and opening the game window has never been checked on macOS. You are the first, so please send the captain what you see if anything looks different from this page.
Starting from nothing? The one-line installer (Install with one line) makes the
parastudio folder and runs this same launcher for you. This page is for when you already have
the folder.
What you need
- A Mac (Apple chip or Intel) with an internet connection.
- The
parastudiofolder from the captain, on your Mac. Anywhere in your home folder is fine (Documents or the Desktop, for example). A copy made withgit cloneis best, because it lets you bring in engine updates later. A zip file works too. Either way your game, made bypara new, is a git repository of its own insidegames/, so save points only need git to be installed. - Some patience the first time (the downloads and the first build take several minutes). Later starts take seconds.
First time
-
Open the
parastudiofolder in Finder. -
Right-click (or hold Control and click)
Paraloop-Studio.command, choose Open, then click Open in the box that appears. macOS warns about any file that came from the internet ("cannot be opened because it is from an unidentified developer", or "Apple could not verify..."). Choosing Open from the right-click menu is how you tell macOS you trust it. You only do this once.-
If the box has no Open button (newer macOS): click Done, open System Settings > Privacy & Security, scroll down to the line about
Paraloop-Studio.commandand click Open Anyway, then try again. -
If it still will not open, or says you do not have permission, open Terminal (press Command+Space, type
Terminal, press Return) and paste these two lines, one at a time, with the real folder instead of~/Documents/parastudio:xattr -dr com.apple.quarantine ~/Documents/parastudio chmod +x ~/Documents/parastudio/Paraloop-Studio.commandThen double-click the file again. The first line removes the "downloaded from the internet" mark from the folder; the second makes the file runnable.
-
-
A Terminal window opens and prints numbered steps. Each says what it is doing. When something is missing it first lists what it would install (What), the exact link or command (From or Command), the folder it goes into (Where) and how big it is (Size), then asks a question ending in
(y/n, Enter means no). Onlyy(oryes) and Return installs it; just Return,nor anything else installs nothing and stops, saying how to do it yourself instead.Step What you see What to do 1 Apple's command line tools Usually "ok". If they are missing: what they are, xcode-select --install, and "Open Apple's installer now?"Type yand press Return. A window pops up from Apple: click Install, wait until it says it is done, then double-clickParaloop-Studio.commandagain. This is not an error. The tools come from Apple and go into/Library/Developer/CommandLineTools; Apple's window shows the size and may ask for your Mac password.2 git "ok" Nothing (git comes with Apple's tools). 3 Nim 2.2.10 "ok", or what it would download and "Download and install Nim 2.2.10 now?" Type yand press Return. It downloads Nim fromhttps://nim-lang.org/download/(about 15 MB), checks the download against the checksum nim-lang.org publishes, and unpacks it into.paraloop/nim-2.2.10in your home folder. No password is asked and nothing outside your home folder changes; Nim's folder is added to the PATH for this run only, not to your shell settings. If the checksum does not match it stops and installs nothing.4 Game libraries "working" with dots, a few minutes Wait. It is working even when nothing moves. 5 Building para "working" with dots, a few minutes Wait. 6 Claude or Codex Which it found, then the same startup checks the Studio page shows (installed, signed in, folder trusted), each "ok" or with one fix line; or where to install one See "The producer's chat" below. These never stop Studio from opening. 7 Starting Studio Studio opens in your browser Keep the Terminal window open while you use Studio. The first time it says there is no game yet: in Terminal, in the same folder, run tmp/para new mygame(any name without spaces), then reload the page. -
To stop Studio, press Control+C in the Terminal window, then close it.
Next times
Double-click Paraloop-Studio.command. Steps that are already done say "ok" and are
skipped, so it goes straight to Studio.
The producer's chat (Claude or Codex)
Studio's chat runs the claude or codex program on your Mac. Studio does not install
it, and it never handles sign-in: it never sees or keeps your password or key. If the
launcher says neither is installed, install one from its official page, then open it once
and sign in there, in its own window:
- Claude Code: https://code.claude.com/docs/en/setup
- Codex CLI: https://developers.openai.com/codex/cli
You can start Studio before that; the chat starts working once one is installed and
signed in. The launcher prints the same startup checks as the Studio page before it opens
it (step 6); they only read, and never stop Studio from opening. Claude Code also asks, the first time you open a folder, whether you trust it:
in Terminal, in the parastudio folder, run claude, sign in, and choose Yes, I trust this
folder (the highlighted choice is "No, exit", so move down first). Until you do, Claude
ignores the list of things the producer may do. Studio checks all of this when its page opens and
says "Ready" or what is missing (see studio.md).
If the game window does not open
Press Play in Studio. If your Mac cannot open the game window, Studio says "Your computer could not open the game window. This is usually a graphics or display problem..." Click Show the details and send the captain that message and the lines under it.
If something fails
The launcher stops and prints a block like this:
==============================================================================
Something went wrong. Please send the captain everything between these lines.
------------------------------------------------------------------------------
Step: 5 of 7, build para
Problem: Building para failed. The log has the compiler's words.
Computer: macOS 15.1, arm64
Log file: /Users/you/Documents/parastudio/tmp/launcher.log (attach this file too)
Last lines of the log:
| ...
==============================================================================
Send the captain that whole block (select it in Terminal, copy, paste), and attach the
file named on the Log file: line. The log is plain text: what each step printed, and
nothing secret (Studio's own output, which carries its private link, is not in it).
What the launcher does and does not do
- It installs nothing without asking first, and only
yoryescounts as yes. If the window cannot take an answer at all, that counts as no. - On a Mac it never uses
sudoand never asks for your password itself (Apple's own installer window may, if you say yes to it). - It never runs a script downloaded from the internet. Nim comes as the release archive from nim-lang.org, checked against the published checksum.
- It does not edit your shell settings. It finds Nim in
~/.paraloop/nim-2.2.10,~/.nimble/bin, Homebrew and the usual places on its own each time. - It talks to the internet only to download Nim (and its checksum) from nim-lang.org, through Apple's installer if you say yes to it, to let nimble fetch the game libraries, and through git. No telemetry.
- It does not read, copy or change any login or setting of Claude or Codex. The startup
checks in step 6 are
tmp/para studio --check, the same read-only checks the page runs. - To see what it would do and what it would offer without changing or asking anything,
run
bash tools/launcher/launch.sh --dry-run(or--check, the same) in Terminal from theparastudiofolder.
Linux and Windows
- Linux: run
./paraloop-studio.shfrom theparastudiofolder; see linux.md. - Windows: double-click
Paraloop-Studio.batinstead; see windows.md. It offers the same way (winget for the C compiler and git, the nim-lang.org zip for Nim), and it is not verified on a real Windows PC. The command-by-command route is windows-first-game.md; opening the game window on Windows has never been checked either.