# Known issues (tester build 0.7)

Thanks for testing. These are the problems we know about in this build, with a way round each one, so
you don't have to report them again (but do tell us if one hurts you). Labels are from `docs/FEATURES.md`.
If you hit something that isn't here, use **Help ▸ Report a bug…** and tell us roughly what time it happened.

## Signing in and the launcher

- **Sign in can fail with a network error.** The sign-in service isn't open to everyone yet.
  *Workaround:* if your invite came with a tester token, paste it under **Use a tester token instead**
  (on the **Projects** tab, under **Sign in**). It works until you sign in with your account.
- **"Windows protected your PC" appears when you run the installer or a game you downloaded.** The files
  are new, so Windows hasn't seen them yet. *Workaround:* choose **More info**, then **Run anyway**.

## The editor

- **If the editor closes unexpectedly**, open the project again: it offers back the work you hadn't saved.
  Save often anyway while this is new, and tell us the time it happened.
- **A new first-person project can look dark and flat.** *Workaround:* in **World Settings**, raise
  **Exposure** or **Ambient**, or ask your AI to brighten the scene.

## Working with your AI

- **HUD text set directly, such as a lap counter "1/3", can show up in double brackets: `[[1/3]]`.**
  *Workaround:* ask your AI to set the value as a number, as the Kart Starter does (`ctx.hud.set("lap", 2)`
  shows the lap), or to use a text key from the game's strings instead of the raw text.

## Vehicles (Kart Starter and karts you build)

- **Driving nose-first into a wall with the wheel turned can pin the kart there**, and clipping a thin post
  with its edge can spin it round. *Workaround:* press **R** (**Y** on a pad), or wait 3 seconds and it puts
  you back on the road by itself.
- **A kart your AI builds doesn't put itself back when it gets stuck or rolls over** unless it has a
  `recovery` block (off when absent). *Workaround:* ask your AI to add `"recovery": { "to": "road" }` to
  the vehicle, as the vehicles guide shows.
- **The vehicle "assists" settings (traction control, stability control, steering assist) do nothing yet**,
  even though the descriptions your AI reads list them. *Workaround:* leave them out; tune the tyres' grip
  (`tyres.muLat`, `tyres.muLong`) and the steering lock (`steering.maxAngle`) instead.

## Exported games

- **Export says "payload path given twice" or "payload path not allowed".** Not a bug: a game must work on
  Windows, so two files whose names differ only in capital letters (`Logo.png` and `logo.png`), names with
  `< > " | ? *`, names ending in a dot or a space, and Windows device names (`CON`, `AUX`, `NUL`, `COM1`,
  `LPT1` and so on, even as `aux.txt`) are refused. *Workaround:* rename the file the message names, or ask
  your AI to.
- **Export says `project-path-missing` for a file you can see.** Check the capital letters: a scene that
  names `Textures/Grass.png` doesn't find `textures/grass.png`, on any computer. The message names the
  file that is there. *Workaround:* change the name in the scene to match the file exactly.
- **The first launch of a new game can take a few seconds while Windows checks the `.exe`**, and a little
  longer the first time a game on a new engine version runs, because that engine is unpacked once (the game
  itself is read straight from the `.exe`, with no unpack step). Later launches take about 1 second.

## Linux

- **This tester build is for Windows.** A Linux x64 build is a tarball with the editor and the engine, but
  no launcher and no samples: the samples come only from the Windows launcher today. See START-HERE.md,
  "On Linux".
- **A game exported for Linux needs the ALSA sound library** on a fresh Ubuntu: without it the game doesn't
  start and says nothing. Install it with `sudo apt install libasound2t64` (Ubuntu 24.04).

## Other

- **Arabic text that starts with a number can lose the number.** Only games shown in Arabic are affected.

## Features

- **Beta** (works, below our quality bar): terrain, water (lakes, rivers, shores, waterline), foliage
  (including the fern preset), lighting and global illumination, characters and animation, vehicles, effects, the editor itself.
- **Experimental** (off unless a project lists it in `"experimental"`): waterfalls, the forest-floor
  ground cover, lip-sync, the Android exporter, asset generation.
- **Tested on desktop graphics cards** (NVIDIA RTX); laptops and integrated graphics are not tested yet.