Support

Support

Answers to common questions, steps to fix most problems, and how to report a bug.

Frequently asked questions

Windows says "Windows protected your PC" when I run the installer.

The installer is not code-signed yet, so Microsoft Defender SmartScreen warns about it. Click More info, then Run anyway. Only do this for the file you downloaded from this site or from GitHub releases.

The engine won’t start (the status dot in the top bar stays grey or red, the viewport is empty).

Close Tessera completely and start it again: the app starts its engine hidden in the background and stops it when you close the window. If it still fails, open %APPDATA%\Tessera\engine.log; the last lines say why (for example a missing library or a blocked port). Tessera uses port 7419 and moves to the next free port if it is taken. If an engine started by Claude Code (MCP) is already running, the app reuses it. Still stuck? Open an issue with the log attached.

The AI panel says the provider is not found.

Each provider uses an app you install yourself. Claude needs the Claude Code CLI (claude on your PATH or in %USERPROFILE%\.local\bin), signed in once. GPT needs the Codex desktop app (or the codex CLI), signed in with ChatGPT. Tessera AI needs Ollama and at least one pulled model. Install, sign in, then restart Tessera so it finds the new app. See Using the AI.

The AI stopped with an error about usage limits or credits.

Claude and GPT run under your own subscription, so their usage limits apply. When a limit is reached the provider’s message appears in the AI log. Wait until your limit resets, switch to another provider in the picker, or use the offline Tessera AI, which has no limits. Your graph is kept: everything the AI built so far stays in the project and can be undone or edited.

The local AI is very slow.

Local models run on your GPU’s video memory (VRAM). If Unreal, a game or another 3D app is using the GPU, the model may not fit and runs partly on the CPU, which is much slower. Tessera picks the best installed model that fits in the free VRAM (for example qwen3-coder 30B when the GPU is free, qwen3.5 9B next to Unreal). Close other GPU-heavy apps, pull a smaller model, or choose one explicitly in the model menu.

Unreal: "No Unreal editor found".

In Unreal, enable the Python Editor Script Plugin, then turn on Project Settings > Plugins > Python > Enable Remote Execution and restart the editor. Keep the project open, then press Refresh in Tessera’s Unreal panel. Windows Firewall may ask about Unreal or Tessera the first time; local discovery uses multicast on this PC only. If the link is bound to another project, pick the editor in the Unreal panel. See Unreal live link.

Where are my files saved?

Everything is in %USERPROFILE%\Tessera: projects (autosaves of open tabs), scenes (saved .tsr files), exports, renders, recipes, unreal (meshes sent to Unreal) and session.json (which tabs were open). The engine log is %APPDATA%\Tessera\engine.log.

How do I back up my projects?

Save each project you care about with Save (Ctrl+S); it becomes a .tsr file in %USERPROFILE%\Tessera\scenes. Back up the whole %USERPROFILE%\Tessera folder (copy it, or include it in your backup tool). Scene files are small JSON; caches and exports can be large and are re-creatable.

How much GPU and memory do I need?

16 GB RAM is recommended. Sculpting, big fairy villages with the sculpted switch (around 700k triangles per house) and high-resolution simulations use several GB. Keep simulation resolutions moderate while you iterate and raise them for the final result. The viewport needs a GPU with WebGL2; the offline AI wants as much free VRAM as possible.

How do I uninstall or reset Tessera?

Uninstall from Settings > Apps > Installed apps > Tessera. Your data folder is kept. To reset without uninstalling, close Tessera and rename %USERPROFILE%\Tessera\session.json (Tessera then opens with a fresh session and your files untouched). To remove everything, delete %USERPROFILE%\Tessera and %APPDATA%\Tessera after uninstalling.

Can I use Tessera without any AI?

Yes. The node graph, parameters, viewport, simulations, export and the Unreal link all work by hand. The AI is a fast way to build graphs, not a requirement.

Is Tessera free? Do I need an account?

Tessera is free and needs no account. AI providers other than the local one use your own Claude or ChatGPT subscription.

Quick troubleshooting

  1. Look at the Log tab in the bottom dock (it shows a badge when there are new messages) and the red error text on the failing node’s parameter panel.
  2. Read the engine log: %APPDATA%\Tessera\engine.log.
  3. Restart the engine by closing Tessera completely and opening it again. This also clears all in-memory caches, including simulation caches.
  4. Safe reset: close Tessera and rename %USERPROFILE%\Tessera\session.json to session.old.json. Tessera starts with a clean session; your saved scenes and project autosaves stay on disk.
  5. Check the troubleshooting guide for specific problems.
Open the log folder (Win+R)
%APPDATA%\Tessera

How to report a bug

Open an issue on GitHub Issues and include:

Open a new issue

Other questions

For business enquiries and everything else, visit Athian Games.