@dcl-regenesislabs/opendcl 0.1.3-22334161920.commit-0b218cb → 0.1.3-22336024830.commit-25ca9bb

package/README.md

@@ -31,7 +31,7 @@ The result: **more creators building more scenes, faster.**
 - **18 built-in skills** — scaffolding, 3D models, interactivity, UI, animations, multiplayer, authoritative server, audio/video, deployment (Genesis City & Worlds), optimization, smart items, camera control, lighting, player/avatar, NFT/blockchain, advanced rendering, advanced input
 - **Integrated commands** — `/init` to scaffold, `/preview` to launch the dev server, `/tasks` to manage running processes, `/review` to audit code
 - **TypeScript validation** — catches type errors immediately after writing code
-- **Free 3D asset catalogs** — 2,700+ Creator Hub models and 900+ CC0-licensed models the agent proactively suggests when building scenes
+- **Free asset catalogs** — 2,700+ Creator Hub 3D models, 900+ CC0-licensed models, and 50 audio files the agent proactively suggests when building scenes
 - **Permission gate** — prompts for confirmation before destructive bash commands or writes to sensitive files
 - **Compact tool output** — write shows path + size instead of file content, read shows a 5-line preview instead of 10
 - **Session persistence** — pick up where you left off across sessions
@@ -134,7 +134,7 @@ OpenDCL is built on [pi-coding-agent](https://github.com/badlogic/pi-mono), the
 - **System prompt** with SDK7 architecture knowledge (ECS, QuickJS sandbox, parcel constraints)
 - **Extensions** that detect your project, inject context, validate TypeScript, and provide slash commands
 - **Skills** with detailed guides for every common scene development task
-- **Reference docs** (87KB SDK reference, component tables, code examples, 3D asset catalogs)
+- **Reference docs** (87KB SDK reference, component tables, code examples, 3D asset and audio catalogs)
 
 The agent has full access to standard coding tools (read, write, edit, bash, grep, find) and uses them to understand and modify your scene code.
 

package/context/audio-catalog.md

@@ -0,0 +1,97 @@
+# Decentraland Audio Catalog
+
+Free audio files from the official Decentraland Creator Hub asset packs. All sounds are free to use in Decentraland scenes.
+
+**Total**: 50 sounds across 5 categories
+
+**How to use**:
+1. Find a sound below that matches your scene
+2. Download it: `curl -o sounds/filename.mp3 "URL"`
+3. Reference it: `AudioSource.create(entity, { audioClipUrl: 'sounds/filename.mp3', playing: true, loop: false })`
+
+> **Important**: `AudioSource` only works with local files. Always download audio into the scene's `sounds/` directory first.
+
+---
+
+## Music (16 sounds)
+
+| Name | Download As | Tags | Download |
+|------|-------------|------|----------|
+| Ambient 1 | ambient_1.mp3 | ambient, music, atmospheric, background, relaxing | `curl -o sounds/ambient_1.mp3 "https://builder-items.decentraland.org/contents/bafybeic4faewxkdqx67dloyw57ikgaeibc2e2dbx34hwjubl3gfvs2r4su"` |
+| Ambient 2 | ambient_2.mp3 | ambient, music, atmospheric, background, relaxing | `curl -o sounds/ambient_2.mp3 "https://builder-items.decentraland.org/contents/bafybeieacous2r32mksrm5pfchkqdx3cr2fmi4kqoqfg6amqawmgqbl7fm"` |
+| Ambient 3 | ambient_3.mp3 | ambient, music, atmospheric, background, relaxing | `curl -o sounds/ambient_3.mp3 "https://builder-items.decentraland.org/contents/bafybeiaqntn2bbz7zim2yknrxqvdio4fbsvrzebxjc5vvbplog27w2ldke"` |
+| Dance Club 1 | dance_club_1.mp3 | dance, club, music, electronic, party | `curl -o sounds/dance_club_1.mp3 "https://builder-items.decentraland.org/contents/bafybeichm74dfce2eg2yvlswnycqm3gfze3jonzwxpelcmnenfke4q5rha"` |
+| Dance Club 2 | dance_club_2.mp3 | dance, club, music, electronic, party | `curl -o sounds/dance_club_2.mp3 "https://builder-items.decentraland.org/contents/bafybeid26wrmsnr7ipiotq2eb5kpeuabc2iiuwaqfjnhlomfg4m65seajm"` |
+| Dance Club 3 | dance_club_3.mp3 | dance, club, music, electronic, party | `curl -o sounds/dance_club_3.mp3 "https://builder-items.decentraland.org/contents/bafybeidwlpepugim4l5lvvkodwwyl2uskuiczgrbqo7jc4xtxg3ksdnpvm"` |
+| Lo-Fi 1 | low-fi_1.mp3 | lo-fi, music, chill, relaxing, study | `curl -o sounds/low-fi_1.mp3 "https://builder-items.decentraland.org/contents/bafybeih7o2fy5b5ycpnj4tgobiebhvzi2jx2nbzvs2wjgzeomqhoogd3je"` |
+| Lo-Fi 2 | low-fi_2.mp3 | lo-fi, music, chill, relaxing, study | `curl -o sounds/low-fi_2.mp3 "https://builder-items.decentraland.org/contents/bafybeiayjocpmonxwbhotjzfunhyfxeghdqslerzwhch4i3vzp3v52e7dq"` |
+| Medieval 1 | medieval_1.mp3 | medieval, music, fantasy, historical, period | `curl -o sounds/medieval_1.mp3 "https://builder-items.decentraland.org/contents/bafybeidjn6livlyd5zaggmzmcu3cxrlgntiusjg37atvsuf2blene56sii"` |
+| Medieval 2 | medieval_2.mp3 | medieval, music, fantasy, historical, period | `curl -o sounds/medieval_2.mp3 "https://builder-items.decentraland.org/contents/bafybeihfy3k4ratx3bi4543swlojrkgjlim2pzlvnbl665par4lsi3ripa"` |
+| Puzzle 1 | puzzle_1.mp3 | puzzle, music, game, intellectual, thinking | `curl -o sounds/puzzle_1.mp3 "https://builder-items.decentraland.org/contents/bafybeibhsv5amqjxd3teoulwh2ypknrg5wpqfhhza6lwpxa252rd6aumui"` |
+| Puzzle 2 | puzzle_2.mp3 | puzzle, music, game, intellectual, thinking | `curl -o sounds/puzzle_2.mp3 "https://builder-items.decentraland.org/contents/bafybeifilpjamoof5bgphkxrmcawjkphbtswgtzqqvzoatlzpqwyaye2q4"` |
+| Sci-Fi Adventure 1 | sci-fi_adventure_1.mp3 | sci-fi, adventure, music, space, futuristic | `curl -o sounds/sci-fi_adventure_1.mp3 "https://builder-items.decentraland.org/contents/bafybeic4vat46w5it6ehddxjfsrs24nudw5lhqrufmsamqafsul4xbrtre"` |
+| Sci-Fi Adventure 2 | sci-fi_adventure_2.mp3 | sci-fi, adventure, music, space, futuristic | `curl -o sounds/sci-fi_adventure_2.mp3 "https://builder-items.decentraland.org/contents/bafybeiekvrs6hgau63k4bwcnyqgw7wqettpnrlqeoz6e2mjlwxlw6u4fee"` |
+| Upbeat 1 | upbeat_1.mp3 | upbeat, music, energetic, positive, happy | `curl -o sounds/upbeat_1.mp3 "https://builder-items.decentraland.org/contents/bafybeigjz3xmuv3zhrbfgbrqdnnotrz5hjyqjglrf27ng7jgvkebr4pp3u"` |
+| Upbeat 2 | upbeat_2.mp3 | upbeat, music, energetic, positive, happy | `curl -o sounds/upbeat_2.mp3 "https://builder-items.decentraland.org/contents/bafybeigzn2c5te3pilflwkentm4fszvsqwone2cqxxk6guvw6ckhkpg2sy"` |
+
+---
+
+## Ambient Sounds (6 sounds)
+
+| Name | Download As | Tags | Download |
+|------|-------------|------|----------|
+| Forest Birds | birds.mp3 | birds, nature, ambient, sound, soundscape | `curl -o sounds/birds.mp3 "https://builder-items.decentraland.org/contents/bafkreibe6k3y3alhohcsqrbnsuznnacx47gajfmiwlu6uoch2kfwde2api"` |
+| City Traffic | city.mp3 | city, ambient, sound, soundscape | `curl -o sounds/city.mp3 "https://builder-items.decentraland.org/contents/bafkreicmi2xfzrg2xq4qkzcevgo5ka7x3dwjpbgwimbvbjdiespor4upk4"` |
+| Factory | factory.mp3 | factory, ambient, sound, soundscape | `curl -o sounds/factory.mp3 "https://builder-items.decentraland.org/contents/bafkreibcetvcemf4ukfcswlfolszw4bycg2nz7ynsewhvavt6gocdcyyxu"` |
+| Meadow Birds | field.mp3 | birds, nature, ambient, sound, soundscape | `curl -o sounds/field.mp3 "https://builder-items.decentraland.org/contents/bafkreicztuvsqj6nkee76kzocfj2335puepx52p7mbqzhttzs56vdbyfgm"` |
+| Crickets | swamp.mp3 | crickets, nature, ambient, sound, soundscape | `curl -o sounds/swamp.mp3 "https://builder-items.decentraland.org/contents/bafkreicrc5c6v6bihmkudw7ou5s6f72xnnih6w3jxp2qzydl5ymx4ozffi"` |
+| Market | town.mp3 | town, ambient, sound, soundscape | `curl -o sounds/town.mp3 "https://builder-items.decentraland.org/contents/bafkreibdhdarvbcb4f64fnmpx5savczz4gojn5lalwh7slq27zqrswoiti"` |
+
+---
+
+## Interaction Sounds (15 sounds)
+
+| Name | Download As | Tags | Download |
+|------|-------------|------|----------|
+| Padlock | button_press.mp3 | padlock, lock, puzzle, interactive, genesis | `curl -o sounds/button_press.mp3 "https://builder-items.decentraland.org/contents/bafkreiharw4cgog5gdjplmf7tdqnrkvt63fvzgiuiwjrsmkwnrjcjpm6ca"` |
+| Button Chest | button-chest-close.mp3 | chest, metal, button, switch | `curl -o sounds/button-chest-close.mp3 "https://builder-items.decentraland.org/contents/bafkreidczh3kzyrk4tcmkjoveuotf6tseb7e7b7ed5ppatzvdj5zaen6ku"` |
+| Button Chest | button-chest-open.mp3 | chest, metal, button, switch | `curl -o sounds/button-chest-open.mp3 "https://builder-items.decentraland.org/contents/bafkreidgqczqmgcq5kcybi7yy2er7ai6crwn3qufwfm3aqhwhy7kk3hytu"` |
+| Black Button + 13 more | button-sound.mp3 | button, switch, toggle, activate, photo | `curl -o sounds/button-sound.mp3 "https://builder-items.decentraland.org/contents/bafkreifzmhe2n6lslneawyejfdurlk43oiuqygt523fva7k46irgahlwza"` |
+| Chests sound (4 variants) | chest-close.mp3 | chest, treasure, loot, open, fuse box | `curl -o sounds/chest-close.mp3 "https://builder-items.decentraland.org/contents/bafkreia56qk3ve572n7afqsw5b64mprlohlnp2xdgdxpyaklofnlekohau"` |
+| Chests sound (4 variants) | chest-open.mp3 | chest, treasure, loot, open, fuse box | `curl -o sounds/chest-open.mp3 "https://builder-items.decentraland.org/contents/bafkreihm7mbapjtv4d642d34pjclamohqykh7ekxyglltaeqh3xqvezizy"` |
+| Doors sound (10 variants) | door-sound.mp3 | door, cyberpunk, neon, sliding, hatch | `curl -o sounds/door-sound.mp3 "https://builder-items.decentraland.org/contents/bafkreigsbmn4irzhgeeodmisbab4plhqkez6sau4vvgjcriej27yurnpxu"` |
+| Fantasy Lever | fantasy-lever-sound.mp3 | lever, handle, pull, push | `curl -o sounds/fantasy-lever-sound.mp3 "https://builder-items.decentraland.org/contents/bafkreidau4zhmal6tavfyeegbbnqgsrrvf5bav64po22efb4nmivglqi3i"` |
+| Keyboard | keyboard.mp3 | keyboard, button, switch, toggle, activate | `curl -o sounds/keyboard.mp3 "https://builder-items.decentraland.org/contents/bafkreifzbkehod7os4exq5s3nlh2grdvv75spftr3ivi6ox4x75kc4vlbm"` |
+| Pirate Lever / Toy Lever | lever-sound.mp3 | lever, handle, pull, push, open | `curl -o sounds/lever-sound.mp3 "https://builder-items.decentraland.org/contents/bafkreif46fywk4uq3efsmo4k4ryvvs4lglww4slzhykmcq7axjmpody55e"` |
+| Padlock | resolve.mp3 | padlock, lock, puzzle, interactive, genesis | `curl -o sounds/resolve.mp3 "https://builder-items.decentraland.org/contents/bafkreiazk2acgeqscwl57r5qrycal2hhkdsgr7kh7surtizzuwanq7a4t4"` |
+| Rising Pillar Genesis City / Rising Pillar Temple | rising-pillar.mp3 | platform, rising, pillar, elevator, lift | `curl -o sounds/rising-pillar.mp3 "https://builder-items.decentraland.org/contents/bafkreigpw6yuaam3t7owfwbei2kno27cygzage26lgwfunl7uouiuvnbye"` |
+| SciFi Chest | sci-fi-chest-close.mp3 | chest, sci-fi, open, close | `curl -o sounds/sci-fi-chest-close.mp3 "https://builder-items.decentraland.org/contents/bafkreierkhf2ez2rp3lfak7slsmwtxnf4nzstzxezhbeweb7zhgttnuqni"` |
+| SciFi Chest | sci-fi-chest-open.mp3 | chest, sci-fi, open, close | `curl -o sounds/sci-fi-chest-open.mp3 "https://builder-items.decentraland.org/contents/bafkreihaewwvrhf5qf7quc7pdqe5tphh5rcf23zyovbzrbknm6dwyvpetm"` |
+| SciFi Lever / SciFi Lever Console | sci-fi-lever-sound.mp3 | lever, handle, pull, push, open | `curl -o sounds/sci-fi-lever-sound.mp3 "https://builder-items.decentraland.org/contents/bafkreiefmfeg27qf6ym3omdne6iyfmco5ymbecl2owidph3sa2bq5dk6ie"` |
+
+---
+
+## Sound Effects (7 sounds)
+
+| Name | Download As | Tags | Download |
+|------|-------------|------|----------|
+| Bell | bell.mp3 | bell, sound, alarm, church | `curl -o sounds/bell.mp3 "https://builder-items.decentraland.org/contents/bafkreidmnbdd6rsvrposfh5izdvofkslb7zvgxdyotkunskeylusv2yzg4"` |
+| explosion / Sunny Spinner | explosion.mp3 | explosion, detonation, boom, blast, light | `curl -o sounds/explosion.mp3 "https://builder-items.decentraland.org/contents/bafkreigc4xzu3bo3zyqq3tc6t3ciosgevpgq54oza26aukphjvbqozwbn4"` |
+| Confetti / Fireworks | fireworkexplode.mp3 | confetti, explosion, party, fireworks, celebration | `curl -o sounds/fireworkexplode.mp3 "https://builder-items.decentraland.org/contents/bafkreidnd4er62s3riligyrfyyleigd3vhzgcnlfgpu5rdz4qbgc2iehvu"` |
+| Fireworks | fireworklaunch.mp3 | explosion, party, celebration | `curl -o sounds/fireworklaunch.mp3 "https://builder-items.decentraland.org/contents/bafkreicxhfwepx43y4lkztx5avfi2ajjj5recfziuzshaencnmzz3pqrlm"` |
+| Open/Closed Sign | neon-tube.mp3 | sign, open, closed | `curl -o sounds/neon-tube.mp3 "https://builder-items.decentraland.org/contents/bafkreigkyzfpdrvkeo3ublm7z527dzvpqyeucoyfi227r7lhj6eimo3x3m"` |
+| Parrot | parrot.mp3 | parrot, bird, sound, alarm, warning | `curl -o sounds/parrot.mp3 "https://builder-items.decentraland.org/contents/bafkreiemcubbbqlzycmoidn7tlmthg3lira2qio63xdb3wdamrpvao7mi4"` |
+| Siren / Siren Sci-fi | siren.mp3 | alarm, siren, warning, alert, sci-fi | `curl -o sounds/siren.mp3 "https://builder-items.decentraland.org/contents/bafkreiat5ij5buolim3hcsgknmiq4a4zguahlcsy7axobq4e3mx7dicot4"` |
+
+---
+
+## Game Mechanics (6 sounds)
+
+| Name | Download As | Tags | Download |
+|------|-------------|------|----------|
+| Wooden Fence | fall.mp3 | health, damage, breakable, wood, wooden | `curl -o sounds/fall.mp3 "https://builder-items.decentraland.org/contents/bafkreidpbmyl6obtzmbfp4loa7qybv5uug3ljxq634edijqgethue543vi"` |
+| Game Over | gameover.mp3 | game mechanics, defeat, loss | `curl -o sounds/gameover.mp3 "https://builder-items.decentraland.org/contents/bafkreiddpbqdki2qkenqe4dfxk7gnx7tumuklyj5g2iar3nghkjyypobuq"` |
+| Healing Pad | heal.mp3 | health, healing, pad | `curl -o sounds/heal.mp3 "https://builder-items.decentraland.org/contents/bafkreicbpz6d5mjdzebwgp7dq33f5ezjphth23v4ova5xp4d436hjus4ai"` |
+| Respawn Pad | spawn.mp3 | health, respawn, spawn, pad | `curl -o sounds/spawn.mp3 "https://builder-items.decentraland.org/contents/bafkreig7ndrpblob577zmuokv5kjvxbxdin2qdia742bgpbotdeplyfowa"` |
+| Spikes | spikes.mp3 | health, enemy, damage | `curl -o sounds/spikes.mp3 "https://builder-items.decentraland.org/contents/bafkreicyb3fdwmyjmmgvgg4cisttzeu4codckr2qakfjxwwvfnqd7zizfi"` |
+| You Win | wingame.mp3 | game mechanics, victory, celebration, announcement, announce | `curl -o sounds/wingame.mp3 "https://builder-items.decentraland.org/contents/bafkreifboogkwotg3qz4hyssbvruy5murtsjxrv5vbrhi6n66y6772waci"` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcl-regenesislabs/opendcl",
-  "version": "0.1.3-22334161920.commit-0b218cb",
+  "version": "0.1.3-22336024830.commit-25ca9bb",
   "description": "AI coding assistant for Decentraland SDK7 scene development",
   "type": "module",
   "bin": {
@@ -66,5 +66,5 @@
     "prompts/",
     "context/"
   ],
-  "commit": "0b218cbd9244cde7009c99d2b61ec9824fe7c2af"
+  "commit": "25ca9bb8d37e779a6f340e2045fbfe5e88bb6e59"
 }

package/skills/audio-video/SKILL.md

@@ -200,6 +200,33 @@ Audio in Decentraland is **spatial by default** — it gets louder as the player
 
 To make audio non-spatial (same volume everywhere), there's no built-in flag — keep the volume low and place the audio at the scene center.
 
+## Free Audio Files
+
+Always check the audio catalog before creating placeholder sound file references. It contains 50 free sounds from the Creator Hub asset packs.
+
+Read `context/audio-catalog.md` for music tracks (ambient, dance, medieval, sci-fi, etc.), ambient sounds (birds, city, factory, etc.), interaction sounds (buttons, doors, levers, chests), sound effects (explosions, sirens, bells), and game mechanic sounds (win/lose, heal, respawn, damage).
+
+To use a catalog sound:
+```bash
+# Download from catalog
+mkdir -p sounds
+curl -o sounds/ambient_1.mp3 "https://builder-items.decentraland.org/contents/bafybeic4faewxkdqx67dloyw57ikgaeibc2e2dbx34hwjubl3gfvs2r4su"
+```
+```typescript
+// Reference in code — must be a local file path
+AudioSource.create(entity, { audioClipUrl: 'sounds/ambient_1.mp3', playing: true, loop: true })
+```
+
+### How to suggest audio
+
+1. Read the audio catalog file
+2. Search for sounds matching the user's description/theme
+3. Suggest specific sounds with download commands
+4. Download selected sounds into the scene's `sounds/` directory
+5. Reference them in code with local paths
+
+> **Important**: `AudioSource` only works with **local files**. Never use external URLs for the `audioClipUrl` field. Always download audio into `sounds/` first.
+
 ## Important Notes
 
 - Audio files must be in the project's directory (relative paths from project root)

package/skills/create-scene/SKILL.md

@@ -26,8 +26,9 @@ Before writing scene code, check both asset catalogs for free models that match
 
 1. Read `context/asset-packs-catalog.md` (2,700+ Creator Hub models — furniture, structures, decorations, nature, etc.)
 2. Read `context/open-source-3d-assets.md` (991 CC0 models — cyberpunk, medieval, nature, sci-fi, etc.)
-3. Suggest matching models to the user
-4. Download selected models into the scene's `models/` directory:
+3. Read `context/audio-catalog.md` (50 free sounds — music, ambient, SFX, game mechanics, etc.)
+4. Suggest matching models and sounds to the user
+5. Download selected models into the scene's `models/` directory:
    ```bash
    mkdir -p models
    curl -o models/arcade_machine.glb "https://builder-items.decentraland.org/contents/bafybei..."