You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 4689f73
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: docs/camera.md
+3Lines changed: 3 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,6 +26,9 @@ Three per-device render modes under **Viewport — this device**:
26
26
|**Shaded + AO**| Adds ambient occlusion — soft contact shadows in creases and corners (the default on a desktop; phones and tablets start in plain **Shaded**). |
27
27
|**Wireframe**| Shows every edge. |
28
28
29
+
<kbd>Z</kbd> in the 3D view cycles them: Shaded → Shaded + AO → Wireframe (Shaded + AO is skipped when the scene's own
30
+
look already sets ambient occlusion). Rebind it in **Settings ▸ Shortcuts**.
31
+
29
32
Ambient occlusion and wireframe are **desktop-only** and never shown to peers. AO detail follows your shadow-quality setting (below), so lowering shadow quality also lightens the AO cost.
30
33
31
34
These are SHADING modes — they are not how you see the scene's own look. A
Copy file name to clipboardExpand all lines: docs/controls.md
+62-21Lines changed: 62 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,7 +33,7 @@ If the guess is still wrong on your hardware, pick it yourself: right-click the
33
33
### Edit and Interact
34
34
35
35
The editor has two click modes. Switch with the **Interact mode** cell on the bottom bar (it sits
36
-
between the transform tools and Play — the default order is Move, Rotate, Scale, Interact, Play,
36
+
between the transform tools and Play — the default order is Move, Rotate, Scale, Pivot, Interact, Play,
37
37
Object list, Node editor, Explorer, Animation), or press **I**:
38
38
39
39
-**Edit** (the default) — every click selects, so every object, module pieces included, can
@@ -128,6 +128,17 @@ nothing while it has the keys.
128
128
129
129
<kbd>↓</kbd> in the list's **Search objects…** box drops you into the results. Type-ahead matches what you typed first, so a Cyrillic name is reachable by its own letters, and falls back to the physical key so a Latin name is still reachable on a non-Latin layout.
130
130
131
+
### Dragging a selection in the object list
132
+
133
+
Drag any **selected** row in the object list and the whole selection comes along:
134
+
135
+
- drop it on a **group** and they move into it;
136
+
- drop it on **any other object** and they become its children;
137
+
- drop it on the list's empty area or its header and they go back to the top level.
138
+
139
+
World positions are kept and a drop is one undo step. An object cannot be dropped into its own child. Local-only objects
140
+
(ones not shared with the session) dropped onto a shared parent become shared, as before.
141
+
131
142
### What double-click does
132
143
133
144
Opening properties is the default, but it is a setting: **Settings ▸ Scene ▸ Selection ▸ Double-click action** offers *Open properties*, *Edit mesh*, *Focus and isolate* and *Select same type*.
@@ -201,9 +212,26 @@ copying, rather than half-linked.
201
212
202
213
### Editing a multi-selection
203
214
204
-
The properties panel edits **everything you have selected**, not just the last object you clicked. Change a colour, a material, a shadow flag or a physics setting and it applies to the whole set as a **single undo step**; a row whose objects disagree shows a dash until you set it.
215
+
Select several objects (<kbd>Shift</kbd>+click, box select, <kbd>Ctrl</kbd>+<kbd>A</kbd>) and open **Properties**: the
216
+
panel says **Editing N objects**, and every row applies to all of them.
205
217
206
-
Transform rows on a multi-selection drive the selection's **origin** rather than each object's absolute position — typing a value moves the set as a whole instead of collapsing it onto one plane. Name, uuid and geometry stay single-object: click the one object for those.
218
+

219
+
220
+
-**Shared values show; differing values show a dash.** A slider, number or list whose objects disagree reads **—**, a
221
+
checkbox shows the in-between state, and a material or emission colour says *(mixed)* under the picker.
222
+
-**Setting a dashed row sets every object** to the new value — type into a dashed Roughness, tick an in-between
223
+
**Cast shadow**, pick any entry in a dashed list.
224
+
-**One edit is one undo step** for the whole selection, and <kbd>Ctrl</kbd>+<kbd>Z</kbd> puts each object back to
225
+
*its own* previous value. Since 1.26 **Visible**, **Cast / Receive shadow**, **Render order**, **Frustum culled** and
-**Several lights** selected together are edited together; a row only some light types have (a spot light's
228
+
**Angle**) reaches the lights that have it.
229
+
- Your peers see the change **in one step**: the whole selection's edit travels as one message.
230
+
231
+
Name, uuid, LOD, Water and particle emitters stay single-object, and **Geometry** reaches only the objects of one shape
232
+
type (the panel says which) — click the one object for those. Transform rows on a multi-selection move, turn and scale
233
+
the **set** about its [pivot](#the-pivot-of-a-multi-selection) rather than each object's own numbers: typing a value
234
+
moves the set as a whole instead of collapsing it onto one plane.
207
235
208
236
## Transform gizmo
209
237
@@ -239,16 +267,22 @@ The origin travels with the object: it replicates, saves, undoes, and is baked i
239
267
240
268
### The pivot of a multi-selection
241
269
242
-
With several objects selected, what the set rotates and scales about is a choice. The **Pivot** dropdown in the Transform section — or right-click ▸ **Pivot point** — offers:
270
+
With several objects selected, what the set rotates and scales about is a choice — one setting, in three places:
271
+
272
+
- the **Pivot** button on the [toolbar](#the-toolbar), next to Scale: its icon and tooltip name the current mode, and a
273
+
click steps to the next one;
274
+
- the **Pivot** dropdown in the properties panel's Transform section, or right-click ▸ **Pivot point**;
275
+
- in VR, **Settings ▸ Editing ▸ Pivot point** (see [Grabbing a selection](vr.md#grabbing-a-selection)).
243
276
244
277
| Mode | Turns about |
245
278
|---|---|
246
279
|**Median point**| the centre of the selection (the default) |
247
-
|**Active object**| the origin of the object you picked last |
248
-
|**Parent origin**| the origin of the parent they all share — greyed out when they do not share one |
280
+
|**Active object**| the origin of the object you picked last — in VR, the one you grip |
249
281
|**Individual origins**| each object's own origin, so a row of doors all swing on their own hinges |
282
+
|**Parent origin**| the origin of the parent they all share — offered only when they share one |
250
283
251
-
The gizmo drag and the typed rows both obey it. Moving is never per-object: a translation moves the set as one. An origin you placed by hand with **Move origin** overrides the mode while it stands.
284
+
The gizmo drag, the typed rows and a VR grip all obey it. Moving is never per-object: a translation moves the set as
285
+
one. An origin you placed by hand with **Move origin** overrides the mode until you select again.
252
286
253
287
### Numeric fields
254
288
@@ -309,6 +343,18 @@ landed on wiggles to say so.
309
343
Docking is **desktop only** — on a touch screen there is no room for a full-height side panel
310
344
and it would fight scrolling, so windows there simply stay floating.
311
345
346
+
### Workspace layouts
347
+
348
+
Save the windows you have open — which panels, docked or floating, their sizes, the side and bottom docks, tab groups —
349
+
under a name, and switch between arrangements in one click.
350
+
351
+
-**Where:****Menu ▸ Layouts**, or **Settings ▸ Interface ▸ Windows & chrome ▸ Workspace layouts**.
352
+
-**Save:** arrange the windows, type a name, press **Save**. Saving under a name you already have (in any case)
353
+
updates that layout.
354
+
-**Use:** click a saved layout to apply it. Rename or delete it from the same list.
355
+
356
+
Layouts are kept on this device. A reload still starts with a clean slate: a layout is applied only when you pick one.
357
+
312
358
## The toolbar
313
359
314
360
Pressing a toolbar button never takes the keyboard: the keys stay with whatever had them — this holds for the bottom
@@ -334,19 +380,9 @@ game to its menu and starts from the Start screen. See [Build a Game Loop](build
334
380
335
381
## The Settings window
336
382
337
-
Since 1.24 **Settings** opens as a window with its **sections listed in a sidebar**: Interface, Controls, Input, Touch
338
-
controls, Scene, Explorer, VR, AI, Export, Connection, Shortcuts and About (plus any section a newer version adds).
339
-
Click a section to show it; <kbd>↑</kbd> / <kbd>↓</kbd> move between sections, and the window reopens on the section you
340
-
used last. Links that open Settings at a section — *File settings*, *Connection settings*, the AI button — land on that
341
-
section.
342
-
343
-

344
-
345
-
**Search** still looks through *every* section: while you type, all matching rows are shown together, the sidebar lists
346
-
only the sections that have matches, and clicking one jumps to it. <kbd>Esc</kbd> clears the search; a second
347
-
<kbd>Esc</kbd> closes Settings.
348
-
349
-
On a phone the sidebar becomes a row of section chips above the settings.
383
+
**Settings** (logo menu ▸ Settings) is a window with a grouped menu of categories on the left — on a phone, a list you
384
+
tap into — a search box in the header, and one row per setting. Changes save as you make them. Since 1.26 it has its
385
+
own page: see [Settings](settings.md).
350
386
351
387
## Keyboard shortcuts
352
388
@@ -357,7 +393,11 @@ The keys in the table are the **3D view's**: they fire while the 3D view has foc
357
393
**Every keyboard layout works.** A letter shortcut is matched by the letter printed on the key when there is one — AZERTY, Dvorak and QWERTZ keep their own labels — and by the key's **physical position** otherwise, so <kbd>G</kbd>, <kbd>F</kbd>, <kbd>Ctrl</kbd>+<kbd>Z</kbd> and <kbd>W</kbd><kbd>A</kbd><kbd>S</kbd><kbd>D</kbd> work on Russian, Greek, Hebrew, Arabic and CJK layouts without switching. Where the browser can tell, **Settings ▸ Shortcuts** shows your layout's own label beside each letter (*п on your layout*); where it cannot, a note says letter shortcuts follow the QWERTY position.
358
394
359
395
!!! tip "Finding a setting"
360
-
Settings is grouped into **Interface** (theme, [your character](avatars.md), notifications, windows, lists and menus), **Controls** (keyboard, mouse and trackpad), **Input** (gamepad and the node editor's mouse bindings), **Touch controls**, **Scene** (grid, shadows, autosave, [checkpoints](checkpoints.md) and everything about the scene itself), **Explorer**, then **VR**, **AI**, **Export**, **Connection**, **Shortcuts** and **About** — one sidebar entry each ([above](#the-settings-window)). If you don't know which one holds what you want, type in the search box at the top. Rows match by their name, their group (*Grid*), their section (*VR*) and by keywords the labels do not say — search **dark** to find the theme, **quest** for the VR rows, **caustics** or **refraction** for Water quality, **tutorial** or **welcome** for the [Tours](tours.md), **wheelchair** for the VR Stance, **remap** for the VR buttons — and matches are highlighted. <kbd>Esc</kbd> clears the search; a second <kbd>Esc</kbd> closes Settings.
396
+
Settings is grouped into **General** (Interface, Controls, Input, Touch controls, Shortcuts), **Workspace** (Scene,
397
+
Explorer, Node types, Export) and **Devices & services** (VR, AI, Connection), with **About & what's new** at the
398
+
bottom. If you don't know which one holds what you want, type in the search box: it matches names, descriptions and
399
+
the words people use — **dark** finds the theme, **southpaw** finds Swap sticks. See
400
+
[Finding your way](settings.md#finding-your-way).
361
401
362
402
| Keys | Action |
363
403
|---|---|
@@ -373,6 +413,7 @@ The keys in the table are the **3D view's**: they fire while the 3D view has foc
373
413
| <kbd>Alt</kbd>+click | Cycle the selection through everything under the cursor ([inside and behind water](#inside-and-behind-water)) |
374
414
| <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+click |[Ping](notifications.md#pinging) a spot for everyone |
375
415
| <kbd>Esc</kbd> | Leave isolation |
416
+
| <kbd>Z</kbd> | Cycle the [render mode](camera.md#render-mode-view): Shaded → Shaded + AO → Wireframe |
376
417
| <kbd>Tab</kbd> | Enter [mesh edit](mesh-editing.md) mode — inside it <kbd>Tab</kbd> cycles Vertices / Edges / Faces; <kbd>Esc</kbd> exits |
377
418
| <kbd>I</kbd> |[Edit / Interact](#edit-and-interact) mode — in Interact, clicks play with the scene instead of selecting |
378
419
| <kbd>M</kbd> | Toggle element [snapping](snapping.md)|
Copy file name to clipboardExpand all lines: docs/explorer.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -202,7 +202,7 @@ Right-click an object in the viewport ▸ **Save as…** and choose the format.
202
202
203
203
## Storage
204
204
205
-
The chip in the Explorer header reads *used / granted* for everything this app keeps in your browser. Click it — or **Storage used…** under **Disk** in the right-click menu, or **Settings ▸ Explorer ▸ Storage used** — for the **Storage** breakdown: library files, old scene versions, deleted files, saved scenes and projects, autosave, prefabs, installed modules and the rest, each with a size. Tick what you want gone and press **Reclaim**; nothing is removed until you do, and it asks once more.
205
+
The chip in the Explorer header reads *used / granted* for everything this app keeps in your browser. Click it — or **Storage used…** under **Disk** in the right-click menu, or **Settings ▸ Explorer ▸ Storage used** — for the **Storage** breakdown: library files, old scene versions, deleted files, saved scenes and projects, autosave, prefabs, [material presets](materials.md), installed modules and the rest, each with a size. Tick what you want gone and press **Reclaim**; nothing is removed until you do, and it asks once more.
0 commit comments