add scene for testing physics impulse

dcl-workspace.json

@@ -123,6 +123,9 @@
     {
       "path": "scenes/1,0-visibility-comp-propagation"
     },
+    {
+      "path": "scenes/0,7-physics-impulse"
+    },
     {
       "path": "scenes/0,6-ui-zindex-and-opacity"
     },

scenes/0,7-physics-impulse/.dclignore

@@ -0,0 +1,20 @@
+.*
+bin/*.map
+package-lock.json
+yarn-lock.json
+build.json
+export
+tsconfig.json
+tslint.json
+node_modules
+*.ts
+*.tsx
+.vscode
+Dockerfile
+dist
+README.md
+*.blend
+*.fbx
+*.zip
+*.rar
+src

scenes/0,7-physics-impulse/.gitignore

@@ -0,0 +1,10 @@
+package-lock.json
+*.js
+node_modules
+bin/
+.DS_Store
+**/.DS_Store
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.editor

scenes/0,7-physics-impulse/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": []
+}

scenes/0,7-physics-impulse/.vscode/launch.json

@@ -0,0 +1,17 @@
+{
+  // Use the Decentraland Editor extension of VSCode to debug the scene
+  // in chrome from VSCode
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "chrome",
+      "request": "launch",
+      "name": "Debug Decentraland in Chrome",
+      "url": "${command:decentraland-sdk7.commands.getDebugURL}",
+      "webRoot": "${workspaceFolder}/bin",
+      "sourceMapPathOverrides": {
+        "dcl:///*": "${workspaceFolder}/*"
+      }
+    }
+  ]
+}

scenes/0,7-physics-impulse/PhysicsForces/.dclignore

@@ -0,0 +1,21 @@
+.*
+bin/*.map
+package-lock.json
+yarn-lock.json
+build.json
+export
+tsconfig.json
+tslint.json
+node_modules
+*.ts
+*.tsx
+.vscode
+Dockerfile
+dist
+README.md
+*.blend
+*.fbx
+*.zip
+*.rar
+*.md
+src

scenes/0,7-physics-impulse/PhysicsForces/.gitignore

@@ -0,0 +1,10 @@
+package-lock.json
+*.js
+node_modules
+bin/
+.DS_Store
+**/.DS_Store
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.editor

scenes/0,7-physics-impulse/PhysicsForces/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": []
+}

scenes/0,7-physics-impulse/PhysicsForces/.vscode/launch.json

@@ -0,0 +1,17 @@
+{
+  // Use the Decentraland Editor extension of VSCode to debug the scene
+  // in chrome from VSCode
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "chrome",
+      "request": "launch",
+      "name": "Debug Decentraland in Chrome",
+      "url": "${command:decentraland-sdk7.commands.getDebugURL}",
+      "webRoot": "${workspaceFolder}/bin",
+      "sourceMapPathOverrides": {
+        "dcl:///*": "${workspaceFolder}/*"
+      }
+    }
+  ]
+}

scenes/0,7-physics-impulse/PhysicsForces/decentraland-sdk-empty-scene-template-2519f16/README.md

@@ -0,0 +1 @@
+# sdk-empty-scene-template

scenes/0,7-physics-impulse/PhysicsForces/decentraland-sdk-empty-scene-template-2519f16/assets/scene/main.composite

@@ -0,0 +1,4 @@
+{
+  "version": 1,
+  "components": []
+}

scenes/0,7-physics-impulse/PhysicsForces/decentraland-sdk-empty-scene-template-2519f16/cursor.config

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://raw.githubusercontent.com/getcursor/cursor-config/main/schema/cursor.schema.json",
+  "context": {
+    "include": [
+      "https://github.com/decentraland/documentation/blob/main/ai-sdk-context/sdk7-complete-reference.md",
+      "https://github.com/decentraland/documentation/blob/main/ai-sdk-context/sdk7-examples.mdc",
+      "https://github.com/decentraland/documentation/tree/main/ai-sdk-context/libraries/*.ts"
+    ],
+    "exclude": [
+      "**/__tests__/**",
+      "**/*.test.*",
+      "**/*.spec.*"
+    ]
+  },
+  "metadata": {
+    "name": "dcl-cursorai-template",
+    "description": "A starter context setup for Cursor AI to use Decentraland SDK7 docs and curated code examples.",
+    "version": "1.0.0",
+    "tags": ["decentraland", "cursor", "sdk7", "ai-context", "examples"],
+    "authors": ["@drkrillo", "@decentraland"]
+  }
+}

scenes/0,7-physics-impulse/PhysicsForces/decentraland-sdk-empty-scene-template-2519f16/cursorignore

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+build/
+context/**/__tests__/
+*.test.*
+*.spec.*

scenes/0,7-physics-impulse/PhysicsForces/decentraland-sdk-empty-scene-template-2519f16/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "dcl-project",
+  "version": "1.0.0",
+  "description": "SDK7 Template scene",
+  "scripts": {
+    "start": "sdk-commands start",
+    "deploy": "sdk-commands deploy",
+    "build": "sdk-commands build",
+    "upgrade-sdk": "npm install --save-dev @dcl/sdk@latest",
+    "upgrade-sdk:next": "npm install --save-dev @dcl/sdk@next"
+  },
+  "devDependencies": {
+    "@dcl/js-runtime": "latest",
+    "@dcl/sdk": "latest"
+  },
+  "engines": {
+    "node": ">=16.0.0",
+    "npm": ">=6.0.0"
+  },
+  "prettier": {
+    "semi": false,
+    "singleQuote": true,
+    "printWidth": 120,
+    "trailingComma": "none"
+  }
+}

scenes/0,7-physics-impulse/PhysicsForces/decentraland-sdk-empty-scene-template-2519f16/scene.json

@@ -0,0 +1,52 @@
+{
+  "ecs7": true,
+  "runtimeVersion": "7",
+  "display": {
+    "title": "Empty Scene Template",
+    "description": "Empty Scene Template",
+    "favicon": "favicon_asset"
+  },
+  "owner": "",
+  "contact": {
+    "name": "SDK",
+    "email": ""
+  },
+  "main": "bin/index.js",
+  "tags": [],
+  "scene": {
+    "parcels": [
+      "0,0"
+    ],
+    "base": "0,0"
+  },
+  "spawnPoints": [
+    {
+      "name": "spawn1",
+      "default": true,
+      "position": {
+        "x": [
+          0,
+          3
+        ],
+        "y": [
+          0,
+          0
+        ],
+        "z": [
+          0,
+          3
+        ]
+      },
+      "cameraTarget": {
+        "x": 8,
+        "y": 1,
+        "z": 8
+      }
+    }
+  ],
+  "requiredPermissions": [
+    "ALLOW_TO_TRIGGER_AVATAR_EMOTE",
+    "ALLOW_TO_MOVE_PLAYER_INSIDE_SCENE"
+  ],
+  "featureToggles": {}
+}

scenes/0,7-physics-impulse/PhysicsForces/decentraland-sdk-empty-scene-template-2519f16/src/index.ts

@@ -0,0 +1,12 @@
+import {} from '@dcl/sdk/math'
+import { engine } from '@dcl/sdk/ecs'
+import { setupUi } from './ui'
+
+
+export function main() {
+    // uncomment the line below to initialize UI from ui.tsx
+    //setupUi()
+
+    // your scene code here
+}
+

scenes/0,7-physics-impulse/PhysicsForces/decentraland-sdk-empty-scene-template-2519f16/src/ui.tsx

@@ -0,0 +1,12 @@
+import ReactEcs, { ReactEcsRenderer, UiEntity } from "@dcl/sdk/react-ecs"
+
+
+export function setupUi() {
+    ReactEcsRenderer.setUiRenderer(uiMenu, { virtualWidth: 1920, virtualHeight: 1080 })
+}
+
+// draw your UI here
+export const uiMenu = () => (
+    <UiEntity>  
+    </UiEntity>
+)

scenes/0,7-physics-impulse/PhysicsForces/decentraland-sdk-empty-scene-template-2519f16/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "allowJs": true,
+    "strict": true,
+    "baseUrl": ".",
+    "paths": {
+      "@dcl/asset-packs/*": ["node_modules/@dcl/inspector/node_modules/@dcl/asset-packs/*"]
+    }
+  },
+  "include": [
+    "src/**/*.ts",
+    "src/**/*.tsx",
+    "assets/**/*.ts",
+    "assets/**/*.tsx"
+  ],
+  "extends": "@dcl/sdk/types/tsconfig.ecs7.json"
+}

scenes/0,7-physics-impulse/README.md

@@ -0,0 +1,88 @@
+# Physics Impulse Test Scene
+
+Прототипная сцена для тестирования `Physics.applyImpulseToPlayer` и `Physics.applyForceToPlayer`
+в разных игровых механиках (кубы, маятники, карусель, настраиваемые зоны).
+
+## Что сейчас в сцене
+
+- Сравнение Force vs Impulse в туннелях.
+- Impulse Cube и Repulsion Cube.
+- Pendulum Bridge с ударными маятниками.
+- Chain Carousel с:
+  - вертикальными колебаниями (можно поставить на паузу),
+  - настраиваемым максимальным углом наклона сидений,
+  - настраиваемой скоростью вращения.
+- Grapple Anchors playground:
+  - подвесные точки зацепа,
+  - pointer interaction для активации,
+  - отрицательный `applyKnockbackToPlayer` для притягивания к якорю.
+
+## Архитектурная заметка (ADR-lite): Reusable Impulse Face Behavior
+
+### Контекст
+
+Сейчас face-триггеры для сидений карусели реализованы рабочим прототипом:
+
+- вынесены немного наружу от граней, чтобы снизить пропуски `onTriggerEnter`;
+- имеют общий кулдаун;
+- агрегируют несколько попаданий за кадр в одно итоговое направление;
+- применяют один импульс фиксированной величины (как от одиночного удара гранью).
+
+Этот подход уже решает проблему многократных срабатываний и нестабильных касаний, но логика пока
+привязана к текущему сценарию.
+
+### Проблема
+
+Нужно переиспользуемое поведение для будущих объектов:
+
+- сегодня это «пульсирующий куб»;
+- завтра это «кресло карусели»;
+- потом это может быть любой другой объект.
+
+### Решение (цель)
+
+Вынести текущую логику в поведенческий модуль, который можно навесить на любую сущность:
+
+`attachImpulseFacesBehavior(entity, config)`
+
+где `config` описывает:
+
+- `boxSize`
+- `getMagnitude()`
+- `cooldownSec`
+- `thickness`
+- `outset`
+- `visuals` (базовые/кулдаун цвета)
+- опционально `groupId` (если нужно объединять несколько сущностей в общий агрегатор/кулдаун)
+
+### Ожидаемое поведение модуля
+
+- Создаёт face-триггеры вокруг target-сущности.
+- Собирает все срабатывания за кадр в агрегатор.
+- Применяет один импульс в конце кадра:
+  - направление = сумма направлений триггеров;
+  - величина = как у одного «обычного» удара (без суммирования силы).
+- Запускает кулдаун на группу/сущность.
+
+### Почему это не полноценный ADR прямо сейчас
+
+Сцена находится в фазе активного прототипирования, параметры и UX часто меняются.
+Поэтому здесь используется формат **ADR-lite** внутри `README`:
+
+- есть явный контекст, решение и последствия;
+- но без формальной фиксации статуса/версий как в строгом ADR-процессе.
+
+Когда поведение стабилизируется и начнёт использоваться в нескольких сценах/проектах, стоит
+вынести это в отдельный формальный ADR.
+
+### Последствия и плюсы
+
+- Переиспользуемость: одно поведение для разных сущностей.
+- Локальность состояния: кулдаун и агрегатор живут рядом с объектом/группой.
+- Простота расширения: можно добавлять пресеты, разные режимы реакции, разные политики группировки.
+
+### TODO (следующий шаг)
+
+1. Вынести текущий код из `src/faceTriggers.ts` в явный reusable behavior API.
+2. Подключить карусель через этот API без изменения внешнего поведения.
+3. Добавить минимальный debug-режим (визуализация направления итогового импульса).

scenes/0,7-physics-impulse/assets/asset-packs/glossy_aetherea_tiles/composite.json

@@ -0,0 +1,15 @@
+{
+  "version": 1,
+  "components": [
+    {
+      "name": "core::GltfContainer",
+      "data": {
+        "0": {
+          "json": {
+            "src": "{assetPath}/CityTile.glb"
+          }
+        }
+      }
+    }
+  ]
+}