0.13.2
The test checklist on every scene's system bar (answer it in a headset), one Export… for the character builder whose GLB also carries the whole character and its rig, smaller exported pictures, held things on either side or the forearm, gamepad and keyboard focus in panels, pager3d, and fields that wrap.
Size: barrel (min, packages external) 1798.2 KB raw / 626.1 KB gz, up 90.7 KB / 32.1 KB gz (+5.3%) on 0.13.1: conversations, NPCs, doors, chests, pickups, trade and the checklist.
Added
- The dev server's test checklist (tosijs-ui ≥ 1.19,
tosijs-checklist post) on every scene's system bar, so it can be answered in a headset: one item at a time, 👍 / 👎 and a comment by the scene keyboard, saved through the same endpoint as the page's panel. Nothing runs off the dev server.checklistPanelbuilds the content alone (b3d-checklist). pager3d, one page at a time: ‹ ›, a dot per page (tap to jump,dotColorper page),3 / 20pastmaxDots. For a panel that would otherwise scroll.inputField({ lines }): the field wraps and grows as text is typed, up to that many lines, then keeps the caret's line in view.setValuewith the text the field already holds changes nothing (the caret stays). Apanel3d's hostrelayoutnow re-measures its rows and takes the new height in place (it did nothing), so a row that changes height grows the panel and its plane.- Exports can make their pictures smaller, two choices: pictures scales to a longest side of 2048, 1024 or 512, and compress pictures (with quality) turns opaque PNGs into JPEGs when smaller; with neither, pictures go out exactly as made, and a JPEG within the limit is never re-encoded:
compactGlbTextures,replaceGlbImagesandcompactCharacterTextures(tosijs-3d/glb-textures).exportFormis the export as a modal (name, format, the GLB's options). - The character builder's export carries the whole character file (settings with grips, held and stowed items, cloth, tailor outlines, own garments, body source, pictures, clips) in
asset.extras.tosijsCharacter, so the GLB is also a save:readGlbCharacter(bytes)reads it and the builder's import opens the GLB.exportBody's target takesextras. riggedBodyGlbwrites itsrecipewhole intoasset.extras.tosijsRigRecipeandreadGlbRigRecipe(bytes)reads it back, so a T-posed export still carries the hand-placed rig; the rig tool's load takes such a GLB as well as a recipe JSON.playback3dhas a backwards button at the end of its row (the character builder's clip transport): the speed's sign is the direction, so backwards at ×0.5 ishandleSpeed(-0.5), and a negative speed fromread()lights it.- A class can be worn somewhere other than its own place: the character builder's held item has worn (hand, forearm) beside side, kept per class with the character's grips (
place:<class>), with a grip of its own for that place (gripKey, starting fromPLACE_GRIPS).placeIn(name, kept);holdMountandholdGriptake aplace. The Biped Playground follows it for the left hand (a buckler gripped in the fist). - Held things go on either side. A hold class rides in the hand or on the forearm (
holdPlace), on its own side unless told (holdSide: the right hand; a bow's left hand; a shield's and the newwristclass's left forearm), andholdGrip(name, adjusted, classes, side)mirrors a grip set for one side to the other (mirrorGripinhand-socket;ownSideGripstores an adjustment made on the other side). Each forearm has an anatomical socket like the hands' (forearmSocket; on UAL it is the lower arm bone, so a shield's numbers mean what they did);mountNode(skeleton, holdMount(class, side))gives the node to hang a thing from. The character builder's held item has a side (auto, right, left); the Biped Playground draws whatever is in the left hand (a dagger in the off hand, a shield on the forearm). - Focus in panels, for a gamepad and the keyboard. When a panel opens its default control takes the focus (
button3d({ default: true }),asDefault(widget)for any widget; else the first), and a popup inside it does the same. Up and down, and Tab / shift-Tab, step through the controls and cycle; left and right move a slider, change a choice, move a text box's caret, else go to the control beside it. The keyboard's ring shows from the first Tab until the mouse is used. Gamepad UI mode, flat: hold D-pad up to reach the system bar, left and right step along it, B presses, down goes into the open panel; hold up in a panel to close it (focus goes back to its button on the bar), and on the bar to go back to playing. A panel that pops up while the pad was the last thing used takes the pad, and gives it back when it closes (hold up closes it). A modal (the pause, a respawn panel) takes the focus from what it covers, on its first button, so B answers it. While the mode is on the D-pad and B belong to the UI (padUiOwns;HardwareGamepadSource.poll(true)reads them anyway).b3d.padUiActive,b3d.setPadUi(on); pure inpad-ui(padNavigator); widget semantics gainisDefaultandnudge;createFocusPulsetakesrepeat. The inventory and the trade panel are reachable too: in the inventory B picks a thing up and B on a slot or the bag puts it down (while you carry it the D-pad skips the places that will not take it; a focused thing shows its info); in a trade B moves the thing straight across, the next one takes the focus, and a chest opens on take all.inventoryPanel,inventoryDockandtradePanelgaincontrols(); widget semantics gainfocus(on); a box gainsfocusTo(i, { ring })andvisibleRect(i). - A conversation's replies can be chosen on a gamepad: the D-pad steps through them (cycling), B picks. The pad's choice wears the panels' focus ring and is its own, apart from the mouse's hover; it starts on the first reply, and a first press (D-pad or B) only shows it.
gamepadFocustakesactivateandback(which buttons confirm and back out; the defaults are unchanged). - Aiming is finer and sticky. While a biped aims, the sticks follow a response curve (
aimCurve, default 2), the aim slows as it crosses something that can be hurt (aimAssist, default 0.5; 0 turns all of this off), and a sweep near a target with the stick belowaimBreakout(default 0.7) LOCKS onto it: the aim eases onto its body and follows it as it or you move, a lighter stick slides the aim slowly across it (onto the head), and a push past the breakout lets go. Targets behind something solid are not locked. Pure helpers inaim-assist(stickCurve,aimFriction,stickyAim). <tosi-b3d-launcher sound="pistol|rifle|heavy|bow">plays a synthesised shot at the muzzle on everyfire()(gunshot(scene, at, kind)ingun-sound; no files). The Biped Playground's guns have them.trade.offer(currency)(what changes hands, and whether they are short) andtrade.deal(currency, { upTo: true })(one payment of what it comes to, capped at what they have). An inventory move withpayandamountand no item is a payment alone;pay.holder: ''is money from outside the world (a reward, coins found).- In the Biped Playground, a pile of 50 gold by the gate chest, and the shopkeeper says "Please, take a look." before the shop opens, in the middle of the view.
- The default AR session (
xr-passthrough) scales you to the scene: you arrive with what the flat view showed a step ahead, one grip drags the scene, both grips resize and turn it, and the sticks walk at your scale.b3d.xrFrame(centre, radius)puts any point in front of you at a chosen size;b3d.xrSupportsays whether the device offers VR and AR. Pure maths inxr-grab. In the Solar System, look at brings a body in front of you, and the passthrough toggle shows only where AR exists, outside a session. <tosi-b3d xr-passthrough="on">: Enter VR starts an AR session where the device has passthrough (a Quest): the room shows behind the scene, with no sky and no floor grid. Elsewhere it enters VR. The scene dispatchesxrenter(detail.passthrough) andxrexit. The Solar System demo has a passthrough (AR) toggle: the system stands a metre and a half across in your room.- The Biped Playground's shopkeeper speaks his lines (
speech/shopkeeper-*.mp3, voiced locally with Qwen3-TTS, a direction per line; deploy static-assets first). Their manifest isbin/speech-shopkeeper.json. <tosi-b3d-conversation>: nest it in a biped, give it ascriptand ahost(the game's inventory), andstart(player). The speaker turns to face you and talks or gestures (talk,yes,no,give,show,surprise,foldArmsinualAnimationStates); its line and your replies are in a speech balloon over its head (click, a controller, or the reply's number key), your line in one over you; a line'saudioplays; atradeeffect opens the game's shop and the talk resumes when it closes; walking away ends it.B3dBiped.perform(state, seconds)holds a clip that long (a loop loops), andendPerform()stops it. In the Biped Playground, E at the counter talks to the shopkeeper: he sells, and pays rifle rounds for the potion in the gate chest.UAL1_core.glbcarries the talking and gesture clips (10.9 MB, was 9.0) once static-assets is deployed.startConversation(script, host): a conversation as data and a clock. Nodes of lines (speaker, text, audio, gesture, interruptible) and replies (a label, the player's spoken line, awhenon what they carry or flags, athenof effects: goto, end, give, take, trade, set a flag). Replies appear as the last line nears its end, a pick cuts an interruptible line, a trade pauses the talk until it closes, and every line goes intranscript. Effects go through the host (the game's inventory). Pure; the 3D staging comes next.- A Bow and a Kite Shield in
tonio/weapons-classic(library?v=3, once static-assets is deployed). A bow is held in the LEFT hand (holdMount('bow')ishand_l's socket; a launcher takessocket: 'left-hand'), upright along the aim; the kite shield is a shield. The character builder holds a bow in the left hand (its row is now in hand). In the Biped Playground a bow lies by the start, arrows are in the gate chest and the shop, the shop sells the kite shield, and with the bow up the hero plays UAL's bow clips. The bow is untextured and its string does not draw yet. - A biped in gunplay SHOULDERS a long gun (a
riflebyholdClassOf, or a model with a_foregripnode): the shoulders blade, the stock goes to the right shoulder with the barrel along the aim, and the left palm cradles the foregrip. It plays the pistol aim corrected by arm IK, since no CC0 set has rifle clips;_stockand_foregripnodes place it exactly, else it is read off the model's shape. New:twoBoneIk(pure; the retargeter's leg IK now uses it), andreachLimb,setWorldRotation,turnAboutin aim-ik. B3dBiped.setAimClips(AIM_CLIPS.bow)switches the gunplay states (stance, aim up/level/down, shoot, reload) to UAL2's bow set;AIM_CLIPS.pistolis the default.UAL1_core.glbcarries the bow clips once static-assets is deployed.- Mounts beyond the right hand. A shield is strapped to the LEFT FOREARM (
holdMount(class):lowerarm_l, in the bone's frame), and anything stowed rides on the BACK across the shoulders (STOW_MOUNT, the upper spine;stowGrip(name), blades hilt up, long guns barrel up). The character builder's Hold section has on the back beside right hand, each with its manipulator and per-class numbers (a character keeps stowed places asstow:<class>ingrips, and a newstowedsetting). In the Biped Playground the buckler goes in the left hand (not the right) and is drawn on the forearm, and whatever is on the back is drawn there. - A shopkeeper in the Biped Playground: a stand-in mannequin behind a counter; E at the counter opens a priced trade (ammo by the box, buy at value, sell at half).
tradePaneltakesmoveFor, andtradecounts what crossed by kind and quantity, so stacks split and joined in a trade are paid for correctly (TradeChangeis now{ kind, qty, from, to }). - The rig tool's
dragginghas moves the joint alone: a shoulder moved without carrying its elbow and wrist.RigToolApi.skeletonis the model's skeleton now. - Magazines and reloading.
<tosi-b3d-launcher reload-time>gives a launcher a magazine ofammorounds, refilled fromammoSource(count(),take(n): the game's, an inventory) afterreloadTimeseconds;reload(),loaded,reloading, andempty/reloading/reloadedevents. An empty gun reloads when the trigger is pulled. WithoutreloadTimea launcher regenerates as before.magazineis the pure model.ControlInput.reload(d-pad left, J on a keyboard) makes a biped reload what it holds. B3dBiped.heal(amount).<tosi-b3d-pickup>gainsqty(a box of 30 rounds is one pickup) andrefuse(by)(a reason it can't be taken now: a potion at full health), withwhenRefusedand arefusedevent.currency: how money is written,formatMoney(amount, { id, label, position })(€12,12 gold,12 gp). An inventory takescurrencies, and its panel's purse line, an item's value in the info floater and a trade'syou pay …are written with them.<tosi-b3d-door>and<tosi-b3d-chest>. A door swings open away from whoever opens it (interact or a click), is solid shut and blocks sight; a chest's lid lifts while the player playschestOpen(UAL'sChest_Open). Either can have alock(a key kind);hasKey(key, by)is the game's answer, a refusal comes back with its reason, a key unlocks it for good.tradePanel(inventory-trade) is the take-and-leave panel a chest opens, and a shop's: with apriceit shows which way the money goes (you pay 12 gold,you receive 6 gold) and settles through the inventory's rules (trade, pure). The demo loadout takes extraholders, apurseand aprice. The Biped Playground has a walled yard behind the start: the key is in the chest by its locked door, and the chest inside holds the rocket launcher.- Hit locations.
<tosi-b3d-launcher direct-hit="on">makes a round damage what it hits and say where (Cause.at); a biped places it withhitRegion(point)(head round the head bone, trunk near the hips-to-neck axis, limbs elsewhere, moving with a crouch) and scales it byhitScale(head 2.5, trunk 1, limb 0.5), playinghitHead,hitChest/hitStomachorhitShoulderL/R.DestroyableBehavior.damageScaleis the hook. The Biped Playground's guns hit directly (the rocket launcher still bursts).UAL1_corealso carriesHit_Shoulder_L/R. <tosi-b3d-npc>: nest it in a biped and the biped is an enemy. It stands guard (or wanders, or walks apatrolroute), oblivious until it notices the player: in front within 50 m with a clear line, behind within 10 m, a third of each when the player crouches; a noise sends it to look where the noise was. Then it chases (to where you were, between thoughts), attacks within reach, loses you, searches, and goes back.npc-brain(the decisions) andsensorium(the senses) are pure and seeded;noise(makeNoise) records shots, blasts and tossed things.<tosi-b3d-pickup>gainstoss(to)andnoise. A biped dispatcheshurtwhen damaged and stands where its attributes say from its first frame. The Biped Playground has a guard and a patroller, and dropping an item throws it.<tosi-b3d-pickup item>: a library model lying in the world that the player picks up with interact (or a click). The biped kneels for it, it leaves at the moment the hand reaches it, andwhenPickedUp({ item, by })and a bubblingpickedupevent hand it to the game.B3dBiped.perform(state)plays a one-off clip and holds still (pickups, chests, hits). The demo loadout'shandleDropputs a dropped item in the world. In the Biped Playground a rifle, a sword and a buckler lie by the start, and what you drop lands at your feet.<tosi-b3d-biped health>: hit points (0, the default, means it can't be hurt). A hurt biped is a target for warheads like any destroyable; each hit plays a hit clip (chest, stomach and head in turn, a knockback for a blast) and holds it still; at 0 it playsdeathand dispatchesdestroyed, which<tosi-b3d-death>answers without exploding it.healthRegenheals afterhealthRegenDelay.hp,damage()andaimTarget(a chest-height node for turrets and AI).DestroyableBehaviorgainswhenDamagedandflash: false. The Biped Playground has a turret past the cover line and a health readout.- Falls on
<tosi-b3d-biped>. Walking off a ledge plays the air loop; a landing from more thanhardLandingmetres (auto: 1.5 body heights) playshardLand(UAL'sRoll) and holds you still;lethalFall(metres, off by default) kills on landing: thedeathclip where you land and a bubblingcrashevent (detail: { cause: 'fall', drop }).<tosi-b3d-death>answers it without an explosion for an entity that shows its own death (diesInPlace). The Biped Playground's tower kills, and Respawn puts you back at the start.fallholds the rules. mirroronbakeClip,retargetClip,retargetSourceClipand retargeting: the clip played left to right, each bone moving as its partner on the other side did, reflected. In the character builder it is Mirrored in the Animation menu, and an exported clip carries it as "(mirrored)".
Changed
- Default grips: one-handed blades, pistols and forearm shields, and a bow and a shield on the back, were placed by hand in the character builder (rifles, two-handed blades and poles unchanged). A character's own adjustments still win.
- Character builder: the panel's Export section is gone; Export… in the Character menu asks for the name and format (a GLB, which also carries the character, or the character file) and the GLB's options. Import… opens either.
- Tosijs-ui ^1.19.1 (dev dependency): the dev server serves the checklist endpoints.
- The rig tool's
move jointstoggle and its drag select are one icon picker, drag: markers, joints (with what hangs from them), alone, turn. - Character builder: while rigging, Pause (Animation, on the bar) holds the clip where it is, in perspective; Rest pose is its own item (pause used to stand the body at rest in an orthographic view). A manipulator turned on while rigging pauses the rig tool's clip (it paused only the builder's). The builder's settings panel drops the scene Pause, which read as the clip's.
<tosi-b3d panel-pause="off">leaves it out of any scene's panel; the rig tool's API hasfrozen. - Things stowed on the back sit as they should: a long gun is slung barrel up over the right shoulder, flat against the back (it pointed forward through the chest); a spear rides point up (it hung point down), a bow upright. The spear has its own hold class,
pole(it wasmelee2h): a character'smelee2hgrip adjustment no longer applies to it. - Tooltips and info cards in a scene are their own surfaces: a panel's tooltip (an icon button's name) and the inventory's and trade panel's info card (shown on hover or D-pad focus) open in front of every panel and popup, beside or under what they describe, so the panel's edge no longer cuts them off, and they are never picked (a ray or click passes through).
showTipSurface(root, sheet, anchor, side)inpanel-layer;openPopup({ tip: true }). A panel only on the page draws them in itself, as before. - ⚠️ the D-pad no longer zooms the biped's camera (it is for UI navigation; XR controllers have none). The mouse wheel still zooms, through a new optional
VirtualGamepad.zoomaxis, not the d-pad. - ⚠️ the biped's gamepad layout. A attacks (fires with the weapon raised, the right trigger still does; swings a melee weapon), B uses (doors, chests, lifts, pickups, talking) and, with the weapon raised, ducks instead, so it can never fire; clicking the right stick jumps (it toggled the weapon; the right bumper still does); X is a use alias. In a car B gets out as well as X. The keyboard is unchanged (space jumps, E uses, F attacks): a mapping's
keyboardtransform moves the keys. Pure inbipedMapping; labels inbipedMappingDescriptor. - A chest's trade panel closes itself 0.7 s after take all takes everything.
- Biped Playground: the HUD is smaller, at the bottom middle, translucent, and can be dragged anywhere. In a headset a
bottom/rightpercentage pin places a system panel astop/leftdo. - A shop's trade panel no longer shows their purse. Yours is under your list, and the line under both reads
you'll pay 12 gold,you'll receive 6 gold, or, when they cannot pay what yours fetch,you'll receive 200 gold (all he can offer)withhe can't offer more than 200 gold. Deal then takes all they have. New optionthey(how the other side is named in a sentence, default'they'). - The Biped Playground shows health, ammo and messages in a panel at the top right (flat and in a headset) instead of a line of text under the scene; what each enemy is doing is in Perf Stats (
#debug). UAL1_core.glbis asked for as?v=5(the bow clips), so deploy static-assets before loading a page.- The character builder's clips include UAL's zombie idle, walk, run, scratch and bite (once static-assets is deployed).
- In the character builder, the grip and hair manipulators turn off when the clip plays or changes, and the held item stays in hand while rigging (on the rig tool's body), so arm space can be judged with it.
- The Biped Playground's guns have magazines (pistol 12, SMG and rifle 30, rocket launcher 1) loaded from ammo in the bag; ammo boxes, a potion and a heart lie about; the hero has a purse and the weapons have values.
quaternius/UAL1_core.glbcarriesDeath01,Death02,Roll,Hit_Chest,Hit_Head,Hit_Stomach,PickUp_Kneeling,NinjaJump_Land,Hit_KnockbackandChest_Open(8.0 MB, was 6.9); the library asks for it as?v=4.
Fixed
- The scene checklist talks to the dev server through its own client: the library never imports tosijs-ui, a dev dependency, so an app without it still loads. An app with its own checklist server calls
setChecklistEndpoint(fromtosijs-3d/b3d-checklist). - Opening a modal with a text field (the builder's save-as name) no longer focuses its hidden screen-reader input: on an iPhone that brought up the system keyboard, which blurred and paused the scene and vanished. Focus goes to its first button, and the scene's keyboard types into the drawn field.
- A long tooltip wraps at 220 units instead of running off as one line (in a scene it was a plane several panels wide, stretched and blurred).
- Scene checklist: answers given elsewhere update the scene's panel in place, so a comment being typed keeps its caret; answers not yet saved win over a poll's older copy; an answer in the scene shows in the page's panel even while its comment box has focus. Comments wrap to four lines.
- A menu in a scene panel (any select) could not be chosen from while the camera was more than 10 km away, as the rig tool's orthographic views put it: every press on the menu counted as outside it and closed it. A select's menu now ticks the current option.
- Biped Playground: a character from the builder holds and wears things where the builder placed them (its per-class grips, its shield and the places on its back); every hero used the defaults. The mannequin still does.
- A manipulator grabs only with its own handles, and none while hidden: with two on a page (the character builder's item and hair handles), a press to orbit the view could start a move of the hidden one, whose invisible handles stayed at the scene's middle.
- Inventory dock: a drop whose swap is refused sends what it displaced to the list (a shield moved from the off hand onto a back holding a two-handed spear, with a sword in the other hand).
inventoryPaneltakesspill. - The character builder's JSON export of an unnamed character is
character.json(it wascharacter.character.json). - City Drive's cars: some drew black and mangled, others as nothing but their lamps. Babylon's
Mesh.MergeMeshesappends into the first part's index array in place, and the parts shared their geometry with the library's, so each merge grew the library's wheel and every car built after it was corrupt.<tosi-b3d-city>gives each part its own geometry before merging. - A biped's nameplate is hidden while it is in a conversation (it sat behind the balloon).
- Rig tool: a marker joint (elbow, wrist, knee) dragged with
draggingset to move the joint alone, by its joint dot or its marker, no longer carries what hangs from it (the joints below stay where they are drawn), and a joint drag that moves markers too (a collar carrying the elbow and wrist) is one undo step, not two. - A launcher finds who is holding it at each shot (it cached the first answer, so after a respawn the new hero's own shots hit him).
- In a headset, a system panel pinned by a percentage of the screen (
left: '50%',top: '50%', a centredanchor) goes that far across the view in front of you; it hung under the system bar, 66° up (the trade panel was in the sky). The biped's third-person camera in a headset stays this side of walls, as the flat one does. pickup.toss(to)called before the pickup has joined the scene (just appended) waits for it instead of doing nothing (a dropped item hung in mid-air), and without ato.yit lands on whatever is under the spot, not at y 0.- A tossed pickup stops at the foot of a wall in its way, and lands on what is under its arc, never on top of a wall higher than it flew. The Biped Playground throws a dropped item 3 m to the right front, low.
- The biped's follow camera in doorways and small rooms: its wall check runs from what it looks at to where the camera really sits (it ran from the waist, through the doorway, while the camera sat over the wall), ignores invisible hulls, and when a wall pulls it in, or stands between it and you, the camera goes straight there instead of easing through the wall.
- An open flat system panel follows a new active camera (it is opened again on it). One opened at scene start, before a biped's follow camera, was never drawn.
- A biped killed by damage or a fall stays down. When the death clip ended, the loop it died in stood the body back up. Killed with a gun up, its upper-body aim layer kept looping over the corpse; it is dropped too.
- In the Biped Playground, Respawn brings the hero back; before, it removed him and added nobody. The line under the scene now says how to draw and fire. The enemies see 25 m (was 50) and the guard stands beyond the cover line, so neither notices you at the start, the shop or the things lying about.
- In a scaled XR session a controller's ray reaches the system bar (it stopped 1000 units out).
- In a session with a WebXR
worldScalingFactor, panels on the head-following frames (the system bar, the settings panel) keep their size (XrFramestakesworldScale). - Closing the Biped Playground's chest or shop panel with its × ends the trade (a chest no longer stays open).
- Scene panels and modals work by touch on a phone. The screen-reader copies laid over them took every tap, so a menu opened Android's own picker instead of the drawn one. They now take touches only once a screen reader is in use (
ariaMirror's newtouchableoption), and a long press no longer counts as a screen reader. - A
barMenusubmenu (the character builder's Select and Delete, the Animation menu's groups) opens and stays open. The list it replaced still answered the panel's lastleaveand repainted itself over the new one, so a submenu flashed and vanished or never appeared. - Typing in a text field on a scene modal (the character builder's save and rename prompts) shows each key as it is typed. The modal's screen-reader copy holds focus, and its typing reached the drawn field only on Enter or blur; it now passes every keystroke through, Enter is the field's Enter, and the old text is selected so a new name replaces it.