# @adatechnology/game-interactables 中文文档
规范地址：https://npmcn.com/package/%40adatechnology/game-interactables/
版本：0\.2\.17
npm 元数据更新时间：2026-11-06T05:13:55.364Z
中文译文更新时间：2026-11-06T07:56:16.136Z
软件包许可：MIT
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40adatechnology/game-interactables
原文对照：https://npmcn.com/package/%40adatechnology/game-interactables/?lang=original
项目主页：https://github.com/Andersonfrfilho/adatechnology-game-kit#readme
源码仓库：https://github.com/Andersonfrfilho/adatechnology-game-kit
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：455 kB，8 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-10-23T15:06:50.572Z
- 最新版本发布：2026-11-06T05:13:54.911Z
- 近 30 天下载量：4044（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 20 个）
## 中文简介
交互式世界物体的可移动部件、带有可取物品的容器、电网、燃料、逻辑管道、座位、软音量、效果、镜像和损坏.
## 安装
```sh
npm install @adatechnology/game-interactables
```
也可以使用：`pnpm add @adatechnology/game-interactables`、`yarn add @adatechnology/game-interactables`、`bun add @adatechnology/game-interactables`
## README
# @ adatech/ game- 交互
交互式世界物体的可移动部件(门、抽屉、盖子、接头等)、可取物品的容器和 确定性掠夺,逻辑电网(仪表、电路、插座、开关、装置)、燃料(气瓶、木炭)、逻辑水网, 座椅和床位,柔软的体积会摇动而不会被挡住,效果会释放出出弹器,镜像,相撞和损坏.
包裹什么也不画. 内容包描述对象为 `ObjectSpec` 数据(参见 `src/types.ts`),主持人将其添加到一个 `World`,电话 `update(dt)` 每个框架和绘制世界报告(部分形式、活性发射器、镜子、相撞器、摇摆等). `three` 无需.
## 安装
```sh
pnpm add @adatechnology/game-interactables
```
没有捆绑的浏览器( 全局为 `GameInteractables`:
```html
```
## 使用量
```ts
import { createWorld, poseOf, type ObjectSpec } from '@adatechnology/game-interactables'
const world = createWorld({
locale: 'en',
seed: 'level-1',
items: { can: { id: 'can', category: 'food', size: [0.07, 0.11, 0.07], weight: 0.4, stack: 6 } },
loot: { pantry: { fill: 0.7, entries: [{ type: 'can', weight: 1, qty: [1, 3] }] } },
strings: { en: { 'prompt.door.closed': 'Open {name}', 'prompt.door.open': 'Close {name}', 'type.cupboard': 'cupboard' } },
onEvent: (e) => console.log(e),
})
const cupboard: ObjectSpec = {
type: 'cupboard',
parts: [{ id: 'door', pivot: [-0.4, 0, 0.3], motion: { kind: 'hinge', angle: -Math.PI / 2 }, sweep: [-0.4, 0.3, 0.4, 1.1], label: 'prompt.door' }],
containers: [{ id: 'main', access: 'door', volume: { center: [0, 0.5, 0], half: [0.4, 0.4, 0.25] }, slots: [{ pos: [0, 0.1, 0], max: [0.3, 0.3, 0.3] }], loot: 'pantry' }],
}
world.add('kitchen_cupboard', cupboard, { x: 2, y: 0, z: -1, ry: Math.PI })
// once, after placing objects next to walls: the door never opens through them
world.fitSweep('kitchen_cupboard', 'door', (x, z) => isWall(x, z))
// every frame
world.update(dt)
const look = world.target({ x: cam.x, y: cam.y, z: cam.z, yaw, pitch }) // best interaction or null
if (look) hud.show(look.label) // "Open cupboard"
if (pressedUse && look) look.act()
// drawing a part: pose is relative to the part's pivot
for (const o of world.objects()) {
for (const p of o.spec.parts ?? []) {
const pose = poseOf(p.motion, world.partT(o.id, p.id)) // { position, rotation: { axis, angle }, scale }
}
}
```
坐标在某一个 spec中是局部到对象: 前为 `+z`,起源于地上脚印的中心,米. `Transform.ry` 旋转 周围 `+y` 喜欢 `three.js` (单位:千美元)`+z` 转向 `+x` 以正角度表示). 视图 `yaw` 照相机惯例: `-z`。 。 。 .
## 行为
- **部件** 向目标前进 `motion.speed` (默认为2.5 t/s). `requires` 在另一部分未打开时, 不要打开并关闭 拿着那个(门后一个抽屉关上门). `fitSweep(object, part, blocked)` 扫描样本 `sweep` 矩形(将叶子旋转为轴,将叶子翻译为幻灯片), 返回最大保险箱 `t` (当一部分宣布) `bounds`,整个闭塞-pose slab都是通过运动移动的,所以叶子厚度,轴向偏移和水平轴向计数),并永远将部分夹住. 部分算作打开 `t >= 0.5` (或被夹住的限度的90%). 共享的部件 a `group` 一起移动 : `setPart` 或切换到任何成员都会设定所有成员的目标(盲窗、幕板).
- **默认互动**: 当一个 spec 不存在时 `interactions`,世界产生它们。 标签部件给 `toggle_part`; 容器无 访问部分给定 `open_container`; 设备、开关、固定装置、燃烧器(和 `ignite` 页:1 `needsIgnition`),气阀和座椅得到 匹配动作。 明确 `interactions` 替换衍生的。 药是 `part.`, (中文(简体) ), `open.`, (中文(简体) ), `device.`, (中文(简体) ), `channel.`, (中文(简体) ), `switch.`, (中文(简体) ), `fixture.`, (中文(简体) ), `burner.`, (中文(简体) ), `ignite.`, (中文(简体) ), `fuel.`, (中文(简体) ), `seat.`; 全世界 `object:interactionId`。 。 。 .
- **标签**:世界抬头看 `