Known issues (tester build 0.7)
Since 0.7
Thanks for testing.
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
recoveryblock (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.pngandlogo.png), names with< > " | ? *, names ending in a dot or a space, and Windows device names (CON,AUX,NUL,COM1,LPT1and so on, even asaux.txt) are refused. Workaround: rename the file the message names, or ask your AI to. - Export says
project-path-missingfor a file you can see. Check the capital letters: a scene that namesTextures/Grass.pngdoesn't findtextures/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.