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 e181fa1
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: docs/animation.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
@@ -9,7 +9,7 @@ Give any object a **clip**: a named animation made of keyframes. Open a door, ru
9
9
10
10
## Opening the timeline
11
11
12
-
Select an object, then open the **+ Animation** tab — it sits with Flow and the UV editor in the bottom dock, and undocks into a floating window with the ⧉ button.
12
+
Select an object, then open the **+ Animation** tab — it sits with Flow and the UV editor in the bottom dock, and the dock's **Undock** button (right end of the tab strip) takes it out as a floating window.
Copy file name to clipboardExpand all lines: docs/avatars.md
+30-7Lines changed: 30 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,21 +14,44 @@ Nine characters ship with the app: **Knight**, **Mage**, **Rogue**, **Hooded rog
14
14
15
15

16
16
17
-
If you never pick one, you get **Surprise me**: a character chosen from your id, so everyone sees the same one for you.
17
+
If you never pick one, you get **Auto**: a character chosen from your id, so everyone sees the same one for you.
18
18
The same characters are also an Explorer pack, **Packs ▸ Adventurers**, that you can place in a scene as animated
19
19
models (see [Packs](packs.md#adventurers-124)).
20
20
21
21
## Customize Character
22
22
23
23
Profile menu (your picture, top right) ▸ **Customize Character** — also **Settings ▸ Interface ▸ Avatars ▸ Customize
24
-
character…**. A side panel opens and the camera moves to **your own character**, standing where you are, so you see
25
-
yourself the way other people do.
24
+
character…**. A drawer opens (a bottom sheet on a phone) and puts **your own character** in a plain **studio**: a
25
+
neutral backdrop in your theme's colours, a floor disc and a soft key light.
26
26
27
-

27
+

28
+
29
+
### The studio
30
+
31
+
The scene is hidden from *your* view only while you customise — nothing in it changes, and other people in the session
32
+
keep seeing the scene (and you) as before.
33
+
34
+
-**Orbit** — drag in the free part of the view to turn the camera around your character like a turntable; the wheel or
35
+
a pinch zooms.
36
+
-**Show in scene** — the switch at the top of the panel previews your character in the current scene instead, handy to
37
+
check how a colour reads against the world. The choice is remembered for next time.
38
+
- Your whole character **stays in view** whatever the screen does: resize the drawer or the window, rotate a phone, or
39
+
fold or unfold a foldable — the camera re-frames on every layout change.
40
+
41
+
### Choosing a look
42
+
43
+
-**Presets** — **Auto** (picked from your id), the nine rigged characters (step through them with ‹ ›) and the
44
+
**Classic head**. Picking one shows *its* defaults: its own head, no hat, its own outfit colours.
45
+
-**Custom** — change any part (head, hat, outfit or head colour) and a **Custom** entry appears and is selected.
46
+
Picking a preset again resets to that preset; picking **Custom** brings your edits back.
47
+
-**Surprise me** — a new random character on every press: body, head, hat and colours, never the same one twice in a
48
+
row. A surprise you like is your Custom look; press **Apply** to keep it.
49
+
50
+
The name label and your ping colour and sound are your own preferences: presets and Surprise me leave them alone.
28
51
29
52
| Section | What you choose |
30
53
|---|---|
31
-
|**Character**| one of the nine — step through them with ‹ › — or **Surprise me** or **Classic head**|
54
+
|**Character**|a preset — **Auto**, one of the nine, or **Classic head**— or **Surprise me**; your own edits are **Custom**|
32
55
|**Head**| the character's own head, a stylised **Sphere**, **Box**, **Capsule** or **Cone** in your colour, or **My photo** (your profile picture on a card; needs a profile photo) |
33
56
|**Hat**| None, Cap, Top hat or Crown — it sits on whatever head you chose |
34
57
|**Colours**|**Outfit** recolours the character's clothes (skin and face keep theirs; **Original** puts them back); **Head** colours a stylised head or the classic avatar |
@@ -40,8 +63,8 @@ narrower — the keyboard works too (focus the edge, then the arrow keys; <kbd>S
40
63
camera keeps your character in the part of the screen the drawer leaves free. The size is remembered on this device.
41
64
42
65
Every change shows on your character at once; nothing reaches other people until you press **Apply**, which saves it and
43
-
shows it to everyone. **Cancel**, <kbd>Esc</kbd>or ✕ throw the changes away. Either way the camera returns exactly to
44
-
where your view was before you opened it.
66
+
shows it to everyone. **Cancel**, <kbd>Esc</kbd>, ✕ or swiping the sheet away throw the changes away. Either way the
67
+
camera and the scene come back exactly as they were before you opened it.
Copy file name to clipboardExpand all lines: docs/connection.md
+38-7Lines changed: 38 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,10 +13,41 @@ It has two halves:
13
13
-**📋 Your ID** — the button on the left shows your own peer ID. Click it to **copy your invite link** (your app URL with your ID attached, e.g. `https://theprototype.app/#AB12CD`) to the clipboard. Until the connection to the signaling server is ready it reads *Generating…*.
14
14
-**Connect field** — paste a peer's ID into *Enter peer ID to connect* and press **Connect** to request a connection.
15
15
16
-
Since 1.30, once you are connected the bar **collapses to a compact chip** — a status dot, the session, the avatars
17
-
of who is here and your mic; click it to open the full bar again (its collapse button folds it back). While the signaling link
18
-
is down the status badge says how long it has been trying (*Reconnecting · 2 min*); the attempt count is in the drawer's
19
-
**Info** tab. On a phone the bar is always the chip — tap it for your ID, the join field, Info and Toasts.
16
+
Since 1.30, once you are connected the bar **collapses to a compact chip** — the status dot, the avatars of who is here
17
+
and your mic; click it to open the full bar again (its collapse button folds it back). On a phone the bar is always the
18
+
chip — tap it for your ID, the join field, Info and Toasts. The signaling link's attempt count is in the drawer's
19
+
**Info** tab.
20
+
21
+
### The status dot
22
+
23
+
Since 1.32 the connection status is a **coloured dot**. On a computer the full bar keeps your invite ID and the peer-ID
24
+
field, with the dot at its left end. On a phone the chip at the top of the screen says the state beside the dot —
25
+
**Connected**, **Connecting…** or **Offline** — whenever the top bar has room. When the bar is crowded (people are
26
+
connected and you are in a call, so the peers button and the microphone take the space) it shrinks back to the dot and
27
+
a ▾ (and the microphone while you are in a call).
28
+
29
+
| Dot | Means |
30
+
|---|---|
31
+
| grey | not connected |
32
+
| yellow, pulsing | connecting, waiting for someone to approve, or reconnecting to the peer server |
33
+
| green | connected |
34
+
| red | the peer server cannot be reached (the app keeps retrying) |
35
+
36
+
Point at the dot — or press and hold it on a touch screen — for the full sentence, such as *Connected to 2 peers*;
37
+
while the signaling link is down it also says how long it has been trying. On a phone a tap on the chip opens the full
38
+
connection details.
39
+
40
+
{ width="420" }
41
+
42
+
### Who is here: the peers panel
43
+
44
+
The peers button in the top bar (beside the bell, with the number of people) opens the **Connected** panel. Its header
45
+
matches the notification centre's, and each person is **one row**: their avatar, their name (shortened with … — point
46
+
at it for the full name), a second line with where they are and their role, and their actions on the right — **Watch**,
47
+
**Go to** or the role list. On a computer the panel is 320–420 px wide and grows with long names, so nothing wraps or
48
+
breaks. On a phone it opens as a sheet like the notifications: a grab bar on top, and a swipe down closes it.
49
+
50
+
{ width="515" }
20
51
21
52
### Inviting someone
22
53
@@ -123,7 +154,7 @@ A momentary network blip no longer throws you out, either. A peer that drops for
123
154
124
155
## When the signaling link drops
125
156
126
-
The link to the signaling server is not the link to your peers — losing it does not end a session you are already in, it only stops new people finding you. When it drops the app reconnects on its own, backing off a little further between tries and **never giving up**, and the Connect pill carries a chip while it is retrying so a dead link does not read as a dead app. Coming back online, or returning to the tab, retries immediately instead of waiting out the backoff. A peer connection that closed is rebuilt rather than abandoned.
157
+
The link to the signaling server is not the link to your peers — losing it does not end a session you are already in, it only stops new people finding you. When it drops the app reconnects on its own, backing off a little further between tries and **never giving up**, and the [status dot](#the-status-dot) pulses yellow while it is retrying so a dead link does not read as a dead app. Coming back online, or returning to the tab, retries immediately instead of waiting out the backoff — and since 1.32 it does so **silently**: switching apps on a phone and coming back no longer toasts. If the server stays unreachable for about a minute, the dot turns red and **one** entry appears in the notification centre; the retries carry on. A peer connection that closed is rebuilt rather than abandoned.
127
158
128
159
## Diagnostics you can copy
129
160
@@ -172,5 +203,5 @@ It carries an **Open Settings** button that jumps straight to **Settings ▸ Con
172
203
|*AB12 declined your connection request*| The host pressed **Reject**. Ask them before dialling again. |
173
204
|*AB12's session is full (16 people)*| Everyone connects to everyone, so a session has a ceiling. Someone has to leave before another person can join — **Try again** on the toast re-asks. |
174
205
|*Could not reach … — back on your previous peer server.*|**Apply** could not open the server you picked, so nothing changed — check the host, port and path. |
175
-
|*Lost the peer server - reconnecting...* / *The peer server closed the link - reconnecting...*| The link to the signaling server dropped; the app retries on its own and never gives up. *Reconnected to the peer server.* confirms it is back. Your open session keeps going meanwhile. |
176
-
|*Cannot reach the signaling server - the connection request was not sent.*| You pressed **Connect** while the signaling link is down. Wait for the reconnect chip to clear, or switch servers in Settings ▸ Connection. |
206
+
|A **red** status dot, and one *Can't reach the peer server — still retrying.* entry in the notification centre | The link to the signaling server has been down for about a minute; the app keeps retrying on its own and never gives up, and the dot turns green or grey again once it is back. Shorter drops — a tab switch, a moment offline — reconnect silently. Your open session keeps going meanwhile. |
207
+
|*Cannot reach the signaling server - the connection request was not sent.*| You pressed **Connect** while the signaling link is down. Wait for the status dot to stop pulsing, or switch servers in Settings ▸ Connection. |
0 commit comments