Tactile Studio
All game surfaces use the rounded blue world floor, patterned sky and shared studio lighting by default, including games in chat. Microscene previews retain their transparent backdrop. The house recipe provides camera fitting and coordinated interaction effects using the existing model catalog.
/* JSX <Scene> maps to the serialized `game` tag. */
game {
presentation: studio-v1;
backdrop: teal;
feel-flourish: 1;
}
Piece { material-finish: satin; }
Slot { material-finish: matte; }
Card { material-finish: paper; }Load this stylesheet through the game's stylesheets manifest list. Chess, solitaire, and tic-tac-toe are runnable examples.
presentation: studio-v1remains supported. Game stages use the house recipe by default; the authored root selects the palette and material treatment.backdrop: cobalt | teal | plumchooses the root palette; cobalt is the default within Studio.material-finish: satin | matte | paperinherits from the nearest declaration. Explicit object colors remain authoritative. Card geometry uses the paper shader.feel-flourish: 0on the root disables decorative motion, freezes the backdrop, and retains static legal-move cues.
Gameplay framing and the backdrop stay still while thinking and interacting. Explicit ambient previews may drift slowly; hidden and lightweight stages do not. Available objects use stationary ivory contours, selection uses a thicker amber contour and a small lift, and destinations use saturated cyan landing footprints with a white drop arrow, a contrasting edge and a four-logical-pixel border (six on hover). Card footprints match the landing card; other footprints follow authored target bounds or the selected mesh dimensions. A translucent preview appears only at the hovered destination. Ordinary arrivals have one quiet contact sound and no dust or neighbor displacement. Special trails last 80 ms. Victory uses one bounded confetti burst, leaves the board still and remains tap-through.
Keep card indices and board markings unobscured. Avoid overriding every role with one glow color: the preset deliberately preserves distinct selection and destination treatments.
Supply presentation and board bases
Use model: none to suppress a node’s visual model without removing its logical identity. Place the supply override after per-type model rules:
box > Piece { model: none; feel-flourish: 0; }
Board { model: TILE; width: 5.55; depth: 0.16; material-finish: satin; }
Slot { model: TILE; width: 0.65; height: 0.65; depth: 0.055; material-finish: matte; }Existing model rules restore pieces when they leave the supply. none applies to the node, not its children. On TILE prefabs, depth controls thickness independently of footprint; a drawable grid base seats beneath its children. Studio backdrops add quiet three-level tinting; confetti uses curved, tumbling strips, while meaningful impacts use brief local flecks.
Host preferences
Web hosts can set independent preferences after connecting the player:
await player.setPresentationPreferences({
reducedMotion: true,
sound: true,
haptics: false,
showDragTether: false,
});Native hosts call PlayerBridge_configurePresentation(instance, reducedMotion, disableSound, disableHaptics, displayScale, showDragTether). Scale is framebuffer
pixels per logical pixel. iOS EngineMetalView and Android EngineGLView expose
matching properties and inherit system reduced-motion settings. Static selection
and destination cues remain visible with reduced motion.
ReadFeelClip supplies mono float32 little-endian samples at 44100 Hz. Native
callers provide a 128 KiB output buffer; an invalid clip ID returns zero bytes.
Feel events carry clip ID, pitch and independent sound/haptic mute flags. Cache
the bank before play, then drain events once after each engine render tick.
The embedded bank combines recorded CC0 Kenney Casino Audio foley with original
special and victory accents. Clip IDs 0–7 cover card contact, token contact,
special accent, riffle, silent camera channel, victory, paper pickup and dice.
Sources, license and export recipe live in player/resources/audio/SOURCE.md.
Routine transfers take 220–380 ms, deals 200–260 ms, flips 280 ms and drag settling 140 ms. Shuffle remains a compact 700 ms riffle. A neutral pending marker appears when a submitted action waits longer than 300 ms; it does not imply acceptance.
Round results remain readable after the bounded celebration finishes. Local turn reminders, timer readouts, pending replies and score counters belong to their stage. Reduced motion retains those static cues and useful audio; it clears the optional 1.5% result camera push.
Active drag swooshes use a solid amber-to-cyan ribbon, contrasting edge and rounded caps with moving texture flowing toward the destination. The shaft scales with the piece footprint and narrows for smaller targets; the texture flows into the hovered target. The ribbon is enabled by default (showDragTether) and clears on release. Decorative trails retain their separate additive treatment.
Drag connectors meet the rounded card outline or transformed mesh/target bounds and resolve parent layout frames. Their thickness follows the footprint across travel. Overlapping footprints hide the connector; active drag cues take priority over decorative trails. Texture flow stays in the object’s drag plane, including vertical and tilted surfaces.
To support a one-tap play and an explicit drag destination together, offer both branches with the existing action API:
const action = await player.act({
play: { tap: playableCards },
place: { pick: playableCards, targets: [discardPile] },
});
action.node.returnTo(discardPile, 0);The action retires the losing queries. Crazy Eights uses this pattern; the same legal cards and destination apply to both inputs.
Deck shuffle order comes from the driver’s seeded Fisher-Yates Move sequence. The Shuffle operation supplies riffle presentation only; it cannot reorder the deck. The riffle ends with a quiet card contact. Coalesced material sounds preserve the strongest contact’s clip, and routine feedback ducks beneath capture and victory accents.
A display: flow tray with explicit width greater than height spreads cards horizontally and compresses spacing to fit its width. Taller trays retain the vertical tableau cascade. Set card dimensions and corner radius separately from the tray. Cards entering through a deal become actionable on landing; selection and destination cues remain available for settled cards.

