# Third-party assets Every binary shipped in this repository, with its licence and provenance. ## Quest distribution profile The `Quest` branch builds a user-music-only candidate. No podcast catalogue is loaded, no podcast relay is contacted, and no music recording is bundled. The male/female DJs are fictional CC0 characters, selected locally, not named artists or endorsements. The three historical Mixamo GLBs remain in the source repository but are not referenced, loaded or copied to `dist/`. Their former slot ids now use CC0 crowd models. `js/podcasts.js` and the optional Worker's historical podcast utility are also not part of the Quest web build. Do not distribute the source tree as the Quest product. The production build includes this register, the app MIT `LICENSE`, and `licenses/` (Babylon's exact upstream Apache 2.0 licence, CC BY 4.0, CC0, and third-party notices). The Credits & licences disclosure is reachable from VR COMFORT → CREDITS / LICENCES, which returns to the setup panel. Keep these credits and licences in every package. An app purchase does not revoke recipients' CC BY rights over the attributed assets. The MIT licence in `LICENSE` covers the **source code only**. The assets below are third-party works under their own terms, and several carry attribution obligations that must be satisfied in the running product (see `#modelCredits` in `index.html`). > **Maintenance rule:** every `.glb` under `js/models/` and every texture set > under `textures/` must appear in this file. If you add an asset without a > recorded licence, do not ship it. --- ## 3D models | File | Title | Creator | Licence | Attribution shown in-app | |------|-------|---------|---------|--------------------------| | `js/models/djgear/source/pioneer_DJ_console.glb` | [Pioneer DJ Console](https://sketchfab.com/3d-models/pioneer-dj-console-0ba527fa6b164c34aa050dcecbaa2ffb) | TwoPixels.studio () | CC BY 4.0 | Yes, with source and modification notice | | `js/models/paspeakers/source/stage_speaker___black.glb` | [Stage Speaker — Black](https://sketchfab.com/3d-models/stage-speaker-black-f3209a6a45b844df92560099f982a508) | Sousinho () | CC BY 4.0 | Yes, including source and derivative notice | | `js/models/bassbin/source/bass_bin_3.glb` | [Bass Bin 3 - Subwoofer](https://sketchfab.com/3d-models/bass-bin-3-subwoofer-0f5b16da5e704357aa94fbf632a88455) | darksoundlab () | CC BY 4.0 | Yes, including source and derivative notice | | `js/models/barstool/source/bar_stool.glb` | [Metal Stool 03](https://polyhaven.com/a/metal_stool_03) | Flo Tasser, Poly Haven | CC0 1.0 | Credited as courtesy | | `js/models/city/downtown.glb` | [Downtown City MegaKit (Standard)](https://quaternius.com), [Car Pack](https://quaternius.com) and [Ultimate House Interior Pack](https://quaternius.com) | Quaternius () | CC0 1.0 | Credited as courtesy | ### Textures bundled with the models | Directory | Belongs to | Licence | |-----------|-----------|---------| | `js/models/djgear/textures/` | *removed — an unreferenced duplicate of the console textures (12.7 MB); the console's textures are embedded in its GLB* | — | | `js/models/paspeakers/source/authored/textures/` | Stage Speaker — Black (recovered from its original embedded GLB images; applied externally) | CC BY 4.0 (same as the model) | | `textures/barWood/` | Poly Haven [Dark Wood](https://polyhaven.com/a/dark_wood) by Rob Tuytel (1K: diffuse, DirectX normal, and the `arm` map used as the packed `orm.jpg`), for the bar counter, back bar and vestibule desks | CC0 1.0 | | `textures/steelDeck/` | Poly Haven [Metal Plate](https://polyhaven.com/a/metal_plate) by Rob Tuytel (1K, same three maps): mezzanine deck and stair treads | CC0 1.0 | | `textures/steelPanel/` | Poly Haven [Metal Plate 02](https://polyhaven.com/a/metal_plate_02) by Rob Tuytel (resized to 512 px, same three maps): mezzanine fascia, columns and stringers | CC0 1.0 | ### The bass bins One *Bass Bin 3 - Subwoofer* (CC BY 4.0, darksoundlab; 20,561 triangles) hangs under each flown PA speaker. It is an **optimised derivative**, produced by `npm run optimize:models`: its three 1024 px maps become 512 px WebP and its 12 meshes are flattened and joined to 6 (one per material), so a bin is 6 draws; the source was 4.7 MB and the shipped file is 1.6 MB. Geometry and materials are otherwise unchanged. At run time the loader sizes it to 1.2 m wide, hangs it from the speaker's measured underside, faces its mouth the way the speaker faces, and rigs two chains to its lifting eyes (`createBassBinHangingHardware`). Its albedo is darkened to 55% and its emissive floor lowered so the carpet reads black like the cabinet above it. The model's colours of the folded horn (a red bracing) are as authored. ### The mezzanine A steel balcony along the left wall (deck 2.7 x 8.6 m at y 3) with a 16-step stair, rails, columns and X-bracing, a high table and two stools. Textures are the two Poly Haven sets above; the rails use the project's own `steelGirder` preset; the stools are the bar's *Metal Stool 03* instances (no extra download). Everything else is procedural. `node scripts/build-mezzanine-assets.mjs` regenerates both texture sets. ### The street The avenue outside the club's street door is one **baked derivative** of the CC0 Quaternius *Downtown City MegaKit (Standard)*, which is not in this repository (153 pieces and 78 MB of PNG). `node scripts/build-city-assets.mjs --kit "/Exports/glTF (Godot)"` rebuilds `js/models/city/downtown.glb` from it. The script lays the three whole buildings out as two rows facing each other across a four-lane avenue (a far row of six, a near row of two either side of the club), with street and sidewalk tiles, crosswalks, planters and bollards. The forecourt leaves out the four tiles over the club's entrance stair (the club is a basement; the GLB is baked at y = 0 and lifted to street level at runtime). It drops the interior floors, makes the transparent glass an opaque dark pane, lifts the kit's "fake interior" room pictures a few centimetres in front of the glass so lit rooms show, bakes the kit's per-instance tints into vertex colour (so brick, trim and asphalt are one material each), and packs the three room pictures plus a black glass tile into one 1024 px atlas. Each building is simplified by its distance from the door (meshoptimizer: the topological simplifier alone stops near 50% because a facade is thousands of separate window-frame islands; beyond about 22 m the window-frame material also goes through the sloppy simplifier), merged per building and per material, and quantised (14-bit positions, 8-bit normals). Textures become WebP: base colour 1024 px, packed ORM and normals 512 px. `npm run bake:street-props -- --cars "/OBJ" --house "/OBJ"` is the idempotent second bake. It adds three parked cars (`BasicCar`, `SimpleCarShort`, `Taxi`), the two small bins (`Trashcan_Small1`, `Trashcan_Small2`) and one entrance plant (`Houseplant_4`) from those two additional Quaternius CC0 packs. Their flat materials and the cars' 4 px palette textures are baked into vertex colour on one shared opaque material; the source textures are not shipped. Each prop remains a separate node so the runtime can give it one measured collision box. The combined result is about 154k triangles, 8 materials, 7.2 MB and 66 draws. It is only drawn while a guest is near the entrance. The sky dome and the distant towers are procedural (`js/cityDistrict.js`). The kit's licence file asks for nothing, but the creator is credited here. The exact CC0 source archives used for the prop bake have SHA-256 hashes `40B1F046227D1D7D3BC208E6DFFB36803AF71FA62476E371019D76860F08CE07` (Car Pack) and `E59E14F0C2F57C6E5D3A057A77DEEB7416C4FE3A6BDC5F27C8431F8A0BD7BBBB` (Ultimate House Interior Pack). ### The bar The bar and entrance are built from these third-party pieces plus procedural geometry: - **Stools**: Poly Haven *Metal Stool 03* (CC0), geometry untouched (6,576 triangles), its 1K textures re-encoded as 512 px WebP. Five instances stand at the counter. - **Wood**: Poly Haven *Dark Wood* (CC0), above. - **Bartender**: the Quaternius female guest (`club-guest-female.glb`, CC0) loaded as a second container so she can wear a black outfit, playing its `Idle_Talking_Loop`. - **Bottles**: procedural (`js/barProps.js`), twelve generic shapes (vodka, gin, rum, whisky, bourbon, tequila, champagne, three liqueurs, lager, wine) whose labels are drawn at runtime from descriptive words. They are not real brands. `node scripts/build-bar-assets.mjs` regenerates the wood textures and the stool from their Poly Haven sources. ### Derived files Both models are **optimised derivatives** of the originals, produced by `npm run optimize:models` (`scripts/optimize-models.mjs`, idempotent; `npm test` fails if a model drifts back above its budget). The console's embedded textures are resized from 4096 px to 2048 px WebP (normal and emissive maps lossless); the speaker GLB's embedded textures are stripped because the app replaces them with the external set above, which is also resized. Geometry and licences are unchanged. The speaker retains the source's 6,940 triangles. Its albedo and normal maps are 2048 px; its original packed ORM (R=occlusion, G=roughness, B=metallic) is 1024 px, with full-resolution JPEG chroma. These images were recovered from the original download preserved in commit `475c46f`, without changing their glTF UV orientation. The older loose maps had the opposite vertical orientation and incorrectly substituted grayscale roughness for packed ORM. The new directory invalidates returning visitors' IndexedDB texture caches. Runtime material factors are the original 1/1 metallic/roughness multipliers, with glTF normal-map handedness and no uniform emissive visibility floor. The existing speaker-only accent light receives a material slot without increasing the light budget. The flown cabinets keep the horn above the two drivers, with the existing downward and inward aim; the old X-axis half-turn had hung them upside down. When replacing the speaker with its original textured GLB, the optimizer exports these three images before stripping the embedded copies. ## Character models and animations | File | Origin | Licence | |------|--------|---------| | `js/models/avatars/club-dancer-female.glb` | Quaternius Universal Base Characters + Modular Character Outfits - Fantasy + Universal Animation Library (`Dance_Loop`) | CC0 1.0 | | `js/models/avatars/club-dancer-male.glb` | Quaternius Universal Base Characters + Modular Character Outfits - Fantasy + Universal Animation Library (`Dance_Loop`) | CC0 1.0 | | `js/models/avatars/club-dj-male.glb` | Fictional male DJ, derived from `club-guest-male.glb`: beard removed, shortened Universal Base Characters `Hair_Long` added over the cap, CC0 headphones added, `Idle_Loop` retained. Dark-brown hair and grey top through runtime tints | CC0 1.0 | | `js/models/avatars/club-dj-female.glb` | Fictional female DJ, derived from `club-guest-female.glb`: CC0 headphones added, `Idle_Loop` retained. Blond hair and grey top through runtime tints | CC0 1.0 | | `js/models/avatars/club-guest-female.glb` | Quaternius Universal Base Characters + Modular Character Outfits - Fantasy (Ranger outfit without its hood and pauldron) + Universal Animation Library (`Dance_Loop`, `Idle_Talking_Loop`, `Idle_Loop`) + Universal Animation Library 2 (`Yes`, `Idle_FoldArms_Loop`, `Idle_TalkingPhone_Loop`). At runtime it is the bartender (black outfit through a tint); it is also the source the DJ and crowd builds derive from | CC0 1.0 | | `js/models/avatars/club-guest-male.glb` | As `club-guest-female.glb`, male. Not loaded at runtime any more (the guests are the `club-crowd-*` people); kept as the source `scripts/build-dj-glbs.mjs` and `scripts/build-crowd-glbs.mjs` derive from | CC0 1.0 | | `js/models/avatars/Hip Hop Dancing.glb` | Adobe Mixamo character and hip-hop animation | Mixamo terms of use | | `js/models/avatars/house.glb` | Adobe Mixamo character and house-dance animation | Mixamo terms of use | | `js/models/avatars/rumba_dancing_female_character.glb` | Adobe Mixamo character and rumba animation | Mixamo terms of use | ### The DJs' headphones Both DJs wear the **"Headphones"** model by *nisu*, published on OpenGameArt (, CC0 1.0; black over-ear cans with a blue accent, 3,324 triangles, 4K PBR set). Only the OBJ and its base-colour map are used: `scripts/build-dj-glbs.mjs --headphones ""` converts the OBJ (the source file's own units are scaled so the cups come out 7 cm across), moves the cups out to each DJ's measured ears and widens the band to meet them, lifts the band onto the crown, skins the mesh 100% to the `Head` joint (so it follows every head movement with no runtime placement) and ships the colour map at 512 px WebP. One extra draw call per DJ. The brand mark on one cup is tiny and fictional. The download used carries no licence file; the page states CC0. ### The crowd: Modular Women and Modular Men Seventeen people, plus the bouncer at the street door, built by `scripts/build-crowd-glbs.mjs` from the Quaternius **Modular Women** and **Modular Men** packs (the "Individual Characters" glTF downloads), recoloured into a varied cast and carrying the club's own dance and idle clips retargeted onto their rig. The eleven floor dancers also carry eight dance moves (`Groove_*`) that the script authors procedurally onto the rig itself (no third-party animation; see `js/crowdDance.js`). The scripts and tests treat them as `club-crowd-.glb`: | File | Base character | Look | Clips | |------|----------------|------|-------| | `js/models/avatars/club-crowd-f1.glb` | Women / Casual | Deep skin, black hair, white top, navy trousers | `Dance_Loop` | | `js/models/avatars/club-crowd-f2.glb` | Women / Casual | Fair skin, auburn hair, teal top, black trousers | `Dance_Loop` | | `js/models/avatars/club-crowd-f3.glb` | Women / Punk | Tan skin, cyan mohawk and top | `Dance_Loop` | | `js/models/avatars/club-crowd-f4.glb` | Women / Formal | Brown skin, black hair, burgundy dress | `Dance_Loop` | | `js/models/avatars/club-crowd-f5.glb` | Women / Formal | Light skin, blonde hair, royal-blue dress | `Dance_Loop` | | `js/models/avatars/club-crowd-f6.glb` | Women / Suit | Fair skin, silver hair (an older guest), dark suit | all six | | `js/models/avatars/club-crowd-f7.glb` | Women / Suit | Espresso skin, black hair, red blazer | all six + `Idle_Railing_Loop` | | `js/models/avatars/club-crowd-f8.glb` | Women / Casual | Medium skin, dark hair, cream top, plum trousers | all six | | `js/models/avatars/club-crowd-m1.glb` | Men / Casual 2 | Deep skin, black hair, black tee | `Dance_Loop` | | `js/models/avatars/club-crowd-m2.glb` | Men / Casual 2 | Fair skin, silver hair (an older man), slate top | `Dance_Loop` | | `js/models/avatars/club-crowd-m3.glb` | Men / Casual Hoodie | Tan skin, dark hair, forest-green hoodie | `Dance_Loop` | | `js/models/avatars/club-crowd-m4.glb` | Men / Casual Hoodie | Brown skin, black hair, rust hoodie | all six | | `js/models/avatars/club-crowd-m5.glb` | Men / Punk | Light skin, blue mohawk | `Dance_Loop` | | `js/models/avatars/club-crowd-m6.glb` | Men / Suit | Tan skin, silver hair (an older man), charcoal suit, pistol removed | all six | | `js/models/avatars/club-crowd-m7.glb` | Men / Suit | Deep skin, black hair, burgundy suit, pistol removed | `Dance_Loop` | | `js/models/avatars/club-crowd-m8.glb` | Men / Beach | Light skin, blond hair, cream shirt, blue shorts | all six | | `js/models/avatars/club-crowd-m9.glb` | Men / Casual 2 | Medium skin, brown hair, purple tee | `Dance_Loop` | | `js/models/avatars/club-crowd-bouncer.glb` | Men / Suit | The bouncer at the street door: espresso skin, black hair, black suit, shirt and tie, pistol removed | all six | "All six" is `Dance_Loop`, `Idle_Loop`, `Idle_Talking_Loop`, `Idle_FoldArms_Loop`, `Idle_TalkingPhone_Loop` and `Yes`: the guests, who stand and talk instead of dancing, need the idle poses. Every file also keeps the packs' own `Idle`, `Walk`, `Run` and `Wave` clips: they are what the other players in a multiplayer room use (`AvatarManager`), so the Clips column above lists the retargeted extras. Dancers therefore carry six clips and guests ten; `f7` carries the additional procedural railing pose used only on the mezzanine. Each file is one skinned mesh and one material (per-vertex colour, no textures), about 1.0 MB, so a person costs one draw call where the Universal Base Characters cost about six. Source: Quaternius *Modular Women* and *Modular Men* (CC0 1.0, ; the download used carries no licence file, and Quaternius publishes both under CC0). The two archives used have SHA-256 hashes `2E2E7D46E5090CB0F6F62501F0B907EFEDBFA42D57975239CACBD967A0CAA88C` (Modular Women, ten characters) and `49798EC15E0C23B4F540FC4BDCE5C77A071EEB15B9DF2670B8E761B5453F4D22` (Modular Men, eleven). The packs' own clips (Walk, Run, Punch...) include no dancing; Idle, Walk, Run and Wave are kept for networked guests and the rest dropped; the dance and idle clips are the Universal Animation Library ones already inside `club-guest-female.glb` / `club-guest-male.glb`, retargeted by the build script (the two rigs differ: see the header of `scripts/build-crowd-glbs.mjs`); five of the eleven dancers (f2, f4, m1, m3, m7) play the dance mirrored (reflected across the body's midline), so neighbours are not in step. Skin tones, hair and clothes are a per-person palette in that script. Nothing from the packs' hats, helmets, crowns or weapons is shipped. Official sources: , , and . The Standard archives used to build these files have SHA-256 hashes `FDBF1804C90DFC1EA03E992BFF7DA2DFD1A79318E13270A660180F9308455F40` and `CC73FC4E495B82958207316596317A3F40B9FA38065BDE1027937452DA537724` for the base characters and animations, `4008EA208A604773A2B2177D965F0F5D3195498B5BF838C3F5785D68E95F2A68` for Animation Library 2, and `C3468B18871CC8C8F05AB14DF7712BAF22CB9F389CBD870BABF130E595187F70` for the outfits. The checked-in GLBs were combined with `scripts/build-avatar-glb.mjs` and then run through `scripts/optimize-avatars.mjs`: 512 px WebP textures, redundant animation keyframes dropped, and skinned parts that share a skin and a material merged into one mesh (about six draw calls per character instead of a dozen). The skin, joints, weights and clips are unchanged. The three Mixamo-derived GLBs are retained in the historical source only; Quest does not ship them. They are not covered by this repository's MIT licence. Adobe permits Mixamo characters and animations in projects under its published terms, but redistribution of editable or extractable raw character files may be restricted. Confirm that shipping these GLBs is compatible with the intended distribution before a public release. ## Environment / surface textures | Path | Origin | Licence | |------|--------|---------| | `textures/factoryFloor/` | Poly Haven — [Concrete Floor Damaged 01](https://polyhaven.com/a/concrete_floor_damaged_01) by Rob Tuytel (1K JPG: diff, nor_dx, and an `orm.jpg` packed from rough and ao by `scripts/pack-orm.mjs`) | CC0 1.0 (public domain) | | `textures/walls/`, `textures/ceiling/` | Poly Haven | CC0 1.0 (public domain) | | `textures/environment/empty_warehouse_01_256.env` | Poly Haven — [Empty Warehouse 01](https://polyhaven.com/a/empty_warehouse_01) HDRI by Sergej Majboroda, prefiltered (see below) | CC0 1.0 (public domain) | The reflection environment is a derivative: the 1k `.hdr` (MD5 `ab2931b0191b050b97b1e08ab67b0fb0`, from ) loaded as a Babylon `HDRCubeTexture` at 256 px and written with `BABYLON.EnvironmentTextureTools.CreateEnvTextureAsync` as WebP (152 KB). Replace it by the same route; the file name carries the resolution because the service worker and browsers cache by URL. ### Graffiti `textures/graffiti/atlas.webp` (2048 px RGBA WebP, 2.2 MB) is a **derivative** of five Sketchfab decal packs, all *Decal - Graffiti Textures* by **karlwirbelwind** (), **CC BY 4.0**. Two are titled "[CCO]" on Sketchfab, but every listing and every GLB's embedded `asset.extras.license` says CC-BY-4.0, so all five are treated and credited as CC BY. | Atlas cell | Source listing | Painted on | |------------|----------------|------------| | `character` | [37d78e03…](https://sketchfab.com/3d-models/cco-decal-graffiti-textures-37d78e03040041bdb9158c7ce4aa7cd8) | front wall, right of the door | | `tagWall` | [4b3bc244…](https://sketchfab.com/3d-models/decal-graffiti-textures-4b3bc244cccf4acb8d402372d8ce1db0) | left wall, front corner | | `tagCluster` | [69a07e3d…](https://sketchfab.com/3d-models/decal-graffiti-textures-69a07e3d256e4b0490ac49e99ac57896) | right wall, rear corner | | `vaps` | [19b3096f…](https://sketchfab.com/3d-models/cco-decal-graffiti-textures-19b3096fbd9a424484f78b58368a9b8a) | front wall, left of the door | | `klw` | [86d7a898…](https://sketchfab.com/3d-models/decal-graffiti-textures-86d7a89828364880b5397081350455a7) | right wall, front corner | Changes made: each GLB's embedded 1024 px RGBA image was flipped upright, trimmed to its painted area, fitted into its cell and the five were packed into one atlas; the GLB geometry is not shipped. The in-app credit in `#modelCredits` links all five listings, the creator and the licence, and states the change. Sketchfab downloads need an account, so to rebuild, download the five GLBs and run `node scripts/build-graffiti-atlas.mjs ` (packs are matched by the source URL embedded in each GLB, not by file name). ## Runtime libraries | Path | Version | Licence | |------|---------|---------| | `js/vendor/babylon.js` | Babylon.js 9.28.0 | Apache-2.0 | | `js/vendor/babylonjs.loaders.min.js` | Babylon.js 9.28.0 | Apache-2.0 | | `js/vendor/babylonjs.proceduralTextures.min.js` | Babylon.js 9.28.0 | Apache-2.0 | Provenance URLs and SHA-384 integrity hashes for all four are recorded in `scripts/vendor.manifest.json` and re-verified by `npm run check:sri`. --- ## Known gaps These are tracked in `BACKLOG.md` and must be closed before any public release: 1. **Mixamo characters (excluded from Quest)**: redistribution clearance for the three raw GLBs remains unconfirmed; see the character section above. The Stage Speaker creator/source gap is resolved: the user supplied the original listing, identifying Sousinho and CC BY 4.0, and the in-app credit includes both links and the derivative notice. 2. **Provenance evidence**: retain the original graffiti licence metadata/download records and identify the exact Poly Haven wall/ceiling sets before a commercial release. Their recorded licences permit commercial use; this is an evidence gap, not a finding that they require payment. 3. **Non-copyright rights**: asset licences do not confer brand/trademark or artist endorsement rights. The Quest UI does not name artists; review any prominent product branding before store marketing.