# @adatechnology/game-urban-three 中文文档

规范地址：https://npmcn.com/package/%40adatechnology/game-urban-three/

版本：0\.3\.10
npm 元数据更新时间：2026-11-07T17:26:03.767Z
中文译文更新时间：2026-11-07T01:42:05.081Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adatechnology/game-urban-three
原文对照：https://npmcn.com/package/%40adatechnology/game-urban-three/?lang=original
项目主页：https://github.com/Andersonfrfilho/adatechnology-game-kit#readme
源码仓库：https://github.com/Andersonfrfilho/adatechnology-game-kit

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：5.5 MB，14 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：6 个
- peer 依赖：three ^0\.160\.0
- 首次发布：2026-10-24T19:11:09.744Z
- 最新版本发布：2026-11-07T17:26:03.385Z
- 近 30 天下载量：2103（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：23（近 12 个月 23 个）

## 中文简介

用三个.j来绘制城市的游戏模式:部分与球队的圆形盒子相接相接,例举出道路破折和窗子(光和暗),帆布标志和标签,从光预算中取出点和点灯,以及动画(闪光灯)

## 安装

```sh
npm install @adatechnology/game-urban-three
```

也可以使用：`pnpm add @adatechnology/game-urban-three`、`yarn add @adatechnology/game-urban-three`、`bun add @adatechnology/game-urban-three`

## README

# @adatechnology/game-urban-3 请检查access-date=中的日期值 (帮助)

绘制场景 `@adatechnology/game-urban` 和三.j, 球队的Galeria do Vale Cinzento的方式.

```ts
import * as THREE from 'three'
import { createUrban } from '@adatechnology/game-urban'
import { createUrbanThree } from '@adatechnology/game-urban-three'

const urban = createUrban()
const b = urban.builder({ seed: 7 })
urban.streets.grid(b, { block: 36, count: 2, width: 10 })
urban.poles.get('led_double').build(b, { x: 18, z: 5 })

const three = createUrbanThree(THREE, { document })   // `document` only for signs and labels
const drawn = three.draw(b.scene())
scene.add(drawn.root)
// each frame: drawn.animate(elapsedSeconds)            // flickering lamps, sweeping searchlights
// when done:  drawn.dispose()
```

-   每个部分按所加入的顺序成为网格:有球队圆边的盒子(每面有4×4x4格子,边缘顶点在弧上),有带状圆筒,平面被遮蔽的圆锥和棱镜,只接收阴影的飞机,只有铸作的花冠,画布标志和标签.
-   细小的盒子(道破片,沙袋)为一例网格,而窗户为二(一升发光,一出暗相是一出暗相. 实例矩阵是页面的.
-   灯是真实的 `PointLight` 财务报告和审定财务报表 `SpotLight` 对象; `drawn.lights` 列出他们. `animate(t)` 闪烁灯光`I * (sin(23t + x) > 0.3 || sin(3.1t) > 0.85 ? 0.15 : 1)`并且把每个探照灯目标移动到塔周围.
-   A 类 `terrain` 部分成为有顶点颜色的平面网格(平面阴影、粗糙度1、铸出并接收阴影);水为平面后所绘制的部分.
-   A 类 `placement` 部分(舰队的一辆车,一包的物种)在现场变成一组,转过身来并缩放,把物体握住一个解析器: `createUrbanThree(THREE, { resolvers: { vehicle: createVehicleResolver(vehiclesThree), plant: createPlantResolver(THREE) } })`。车辆解析器使用 `lite` 建造 `game-vehicles-three` (6个结膜)和植物溶剂 `generate` 财务报告和审定财务报表 `createPlantObject` 联 合 国 `game-vegetation`;每个被建造一次,用于一个标识和涂料(或种子),并被复制每个斑点,共享几何和材料. 包件的ID不知道空出位置. `resolver.dispose()` 释放他们.
-   `draw(scene, { root })` 引入你们一群人 工作在3个r160以及后来.

对34个病例的场景散列,实例清单以及每件材料的表面(阴影,粗糙,金属,平面阴影)进行对照页面测试.

## 几何

平面、圆筒、圆锥、盒子(以及一个上建的圆形盒子),棱镜的外延和试验区的光能球被制成 结束 `shapeGeometries(THREE)` 联 合 国 `@adatechnology/game-shapes-three`: 与三个构造器相同的字节 (单位:千美元)`tests/exact-golden.test.ts`),被参数缓存. 十二面体岩还自相出.

## 测试区域

`createUrbanTestModule(options)` 财务报告和审定财务报表 `loadUrbanTestModule(room, options)` 将城市置于共用测试室(`?area=urban` 内 `examples/urban-test-area`;模块也装入 `examples/interactables-test-area`) (中文(简体) ).

-   项目(17):包子相接的五根柱子,有填满块的街道网格,地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地; `terrain` 取而代之)和加勒里亚细胞中样本表的10个街区. 所有东西都是用工具箱和这个包裹画的, 所以一个游戏通过 `urban: { packs, patch, remove }` 可以看到该地区自己的目录。 每件物品都是风景:一个与样品一样大的嵌入式混凝土板.
-   座椅:邻居、种子、灯具份额(图案自有、全部、一半、零)、真灯的预算,以及当被问及区域物种和车队车辆时(游戏给出) `vehicles: (THREE) => createVehiclesThree(...)`没有它 长椅公园没有汽车。 动作在玩家面前绘制并取出邻里; 更改一个设置再次绘制.
-   图层:每个真实光线的能及度和每个样本的盒子. 度量衡:取出样品,取出电话,三角形,真光,例数,长椅对象和光预算左出.
-   八种场景,没有房间目标:柱高,平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平.
-   房间相机视相机为140米,取样板为240米宽,因此模块在装入相机时出借相机600米的视野,并让旧相机脱出后还原.

## 常见问题

### @adatechnology/game-urban-three 是什么？

用三个\.j来绘制城市的游戏模式:部分与球队的圆形盒子相接相接,例举出道路破折和窗子\(光和暗\),帆布标志和标签,从光预算中取出点和点灯,以及动画\(闪光灯\)

### 如何安装 @adatechnology/game-urban-three？

在项目目录运行 npm install @adatechnology/game-urban-three，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：three（^0\.160\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @adatechnology/game-urban-three 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @adatechnology/game-urban-three 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @adatechnology/game-urban-three 可以商用吗？

@adatechnology/game-urban-three 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @adatechnology/game-urban-three 的下载量有多少？

根据 npm 官方下载统计，@adatechnology/game-urban-three 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,103 次，日均约 70 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adatechnology/game-urban-three 还在维护吗？

最新版本 0\.3\.10 发布于 2026/11/08（今天）；至今共发布 23 个版本，其中过去 12 个月发布了 23 个；首次发布于 2026/10/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。