← Paracosm·Docs/Reference
Contents · Viewer patches

Firestorm-Paracosm: the viewer patches

A downstream modified build of Firestorm for private OpenSimulator worlds (and an AI resident's viewer). Not an official Firestorm release; not supported by the Firestorm team or by Linden Lab.

Base

upstream https://github.com/FirestormViewer/phoenix-firestorm
base commit 3125052b (master, 2026-09-25, "Add launch new viewer instance option to dock on macOS")
branch in our tree paracosm (one commit per patch, on top of the base)

Apply order

git clone https://github.com/FirestormViewer/phoenix-firestorm && cd phoenix-firestorm
git checkout -b paracosm 3125052b
git am /path/to/viewer-patches/00*.patch
file patch what it does
0001 Paracosm 0001 its own settings, cache and saved logins (ParacosmViewer_x64), never shared with an installed Firestorm; the default cache really follows the app name
0002 Paracosm 0002 LEAP setCameraPosAndFocus: camera placement for an AI resident's viewer
0003 Paracosm 0003 LEAP snapshot format (png, or jpeg/bmp) and size
0004 Paracosm 0005 no phone-home by default (FSDataDownload off, grid-list download off, empty Search/Marketplace defaults)
0005 Paracosm 0006 an official Linden Lab grid takes a stern DOUBLE opt-in (once per session), recognised at the click by name and login URI, an unconfirmed Linden login refused before anything is sent; no LEAP helper runs there
0006 Paracosm 0007 voice off by default, and Vivox never posts crash dumps (a private world has no Vivox)
0007 Paracosm 0009 a local login page shipped with the viewer, loaded directly, in place of Firestorm's site (Linden grids) and the legacy /app/login/ guess
0008 Paracosm 0004 reconnect mode: after a disconnect (a region restart) the viewer restarts itself, waits for the grid and logs back in to the same place; never on a Linden grid
0009 Paracosm 0010 LEAP relog and disconnect_state on the LLAppViewer event API
0010 Paracosm 0011 local crash minidumps in the viewer's own logs folder, nothing sent anywhere

Each change's follow-up fixes were folded into it before the first release (the development history is the paracosm-dev branch). The files apply in their own order; the Paracosm numbers are the order the changes were planned in (0004 was built last; there is no 0008).

Build (Windows)

../viewer-build/configure.bat then ../viewer-build/build.bat (paths from environment variables; see the scripts). Toolchain the current build was made with: VS 2022 Build Tools (MSVC 14.44.35207), CMake 4.3.4, Python 3.12.10, autobuild 3.10.3.dev9, llbase 1.3.1, fs-build-variables c17312d3. Configure flags: --opensim --chan Paracosm, LL_TESTS=FALSE; no FMOD, Havok or KDU (nothing licensed is needed).

Licences

The viewer is LGPL 2.1 (LICENSE, doc/LGPL-license.txt in the Firestorm tree); these patches are distributed as source under the same terms. Linden Lab artwork: doc/LICENSE-logos.txt.