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

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

版本：0\.5\.11
npm 元数据更新时间：2026-11-07T17:26:31.436Z
中文译文更新时间：2026-11-06T23:39:28.047Z
软件包许可：MIT

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

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

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

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

## 中文简介

@adatechnology/game-weather的渲染器:游戏的雨幕(14 000个GPU点),游戏-vfx游泳池上相近的雨雾和灰尘,带区雾的线性和指数性雾,雨中暗淡的天空,闪电,雨中前灯等

## 安装

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

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

## README

# @adatech/game-weather- 三号

三个J的照片 [`@adatechnology/game-weather`](https://npmcn.com/package/%40adatechnology/game-weather):雨、雾、天空、闪电、灯光和天气的热量 `createWeather` 世界样本。 写着 `weather.sample()` 一次一个相框,然后画出它;它永远不会推进天气.

| 编 | 它画的是什么 | 从何而来 |
| --- | --- | --- |
| **雨帘风** (单位:千美元)`createRainCurtain`(中文(简体) ) | 14 000个GPU在相机后面的70米x25米的盒子中点出,跌出13米/秒; 字符的阴影文本字符; 由天气大小 `drops` (全幕为4000分,暴风雨)和由简介(`low` 0.35 (中文(简体) ), `medium` 0.7, (韩语), `high` 第1条 | 游戏 `jogo.js`, (中文(简体) ), `const RAIN = 14000` |
| **接近雨点** (单位:千美元)`createNearRain`(中文(简体) ) | 研讨会的历程`engine.rain`高达4000,被风所倾斜, 喷出在 `normal` 宝石池和指环(仅在 `puddleAt` 说里面有个水坑 `12 / (1 + quality)` (单位:千美元); `game-vfx-three` 画出来 | 讲习班W313-331 |
| **雾和灰** (单位:千美元)`emitAirborne`(中文(简体) ) | `mistPerSecond` 低沉的烟雾和 `ashPerSecond` 在相机周围掉下一秒钟的灰 就掉进同一个池子里 | 讲习班 `neblina`,W1085-1086号 |
| **雾** (单位:千美元)`createFog`, (中文(简体) ), `fogOf`(中文(简体) ) | 线性雾(靠近25米,与天气相去甚远:220个晴天,140个雨地)或指向平方雾,天气有密度(`fog` 0.075),和区雾(颜色,远,重;全重接近4米) | 游戏 `skyUpdate` 财务报告和审定财务报表 `ZONA_NEBLINA` |
| **天空** (单位:千美元)`createSky`(中文(简体) ) | 夜间颜色 `0x0b0f18` 到今天为止 `0x8796a6` 以 `sample.sun`时间 `sample.skyScale` (一页是0.8 在雨中),拉到区色;它也给雾它的颜色 | 游戏 `skyUpdate` |
| **闪电** (单位:千美元)`createLightning`(中文(简体) ) | 双闪出 `sample.flash`:半球光 `+ 3.2 I`页:1 `+ I * (.25, .27, .32)`屏幕白色 `I * .12` | 讲习班 `chuva`, W1068-1072 (英语) |
| **头灯** (单位:千美元)`createHeadlights`(中文(简体) ) | 两个点灯和两个添加剂的光束锥 `Object3D`在夜间,在雨中或雾中被点燃,真实光线只在相机40米以内,而光线在光束内被点燃的雨(每秒可达600克) | 讲习班 `farol`,W101-103和W1161-1170 |
| **热雾** (单位:千美元)`createHeatHaze`(中文(简体) ) | 温暖的波段,从下半部上升 `sample.haze` | SDK制作:没有团队交付 |

`createWeatherRenderer(THREE, { scene, camera, weather, vfx, profile, zone, puddles, puddleAt, headlights, layers })` 把它们放在一起: `update(dt)` 每个相框, `setLayer(id, on)` 页:1 `far_rain`, (中文(简体) ), `near_rain`, (中文(简体) ), `mist`, (中文(简体) ), `fog`, (中文(简体) ), `sky`, (中文(简体) ), `lightning`, (中文(简体) ), `headlights` 财务报告和审定财务报表 `haze`, (中文(简体) ), `setZoneFog`, (中文(简体) ), `setProfile`, (中文(简体) ), `headlights.attach(car, lensMaterial)`没有 `vfx` 只有窗帘,雾,天空,闪电光,前灯和雾霾被画出.

```ts
import * as THREE from 'three'
import { createWeather } from '@adatechnology/game-weather'
import { createWeatherRenderer } from '@adatechnology/game-weather-three'

const weather = createWeather({ seed: 1, start: 'storm' })
const picture = createWeatherRenderer(THREE, { scene, camera, weather, vfx })
// every frame
weather.advance(dt)
picture.update(dt)
```

## 座椅

`createWeatherTestModule({ visual: createWeatherVisual({ vfx: room.vfx }) })` 模块 `game-weather`)将图片添加到气象台:七层 (雨帘,相近地有雨和花溅出,有雾和灰,有天空,有闪电,有前灯,有热雾;名字用pt-BR和en),相机前有灯具来显示前灯. 钻机的车不在这里:通过 `vehicles: (THREE) => createVehiclesThree(THREE, { kit })` (游戏-车辆-三,并安装了车队),它建造了一款车队汽车(英语:`rigVehicle`默认值 `midsize_sedan`在灯下,它沿着车辆SDK走;没有它,钻机只有灯和它们的梁. `layers: { sky: false }` 保持一个房间的天空 `fog` 层到达 制造器也一样。 雾层还原了主机关闭时的雾.

## 证据

-   `tools/golden/bin/record-weather-visual.mjs` 减少雨区 `jogo.js` (单位:千美元)`const RAIN = 14000` 改为 `skyUpdate`并运行在一个vm与 三.js 的根下 种子 `Math.random`; 固定线 `tools/golden/fixtures/weather/game-rain-curtain.json` 保留42 000个浮标中的SHA-256、阴影文本以及天空、区域以及 页面上的雾行. `tests/rain-curtain-golden.test.ts` 比较比特的分数,字符的阴影字符 和天空,雾,闪电的数字, 头灯,雾和灰与页面文本相对.
-   讲习班 `chuva` (三关), `neblina` 财务报告和审定财务报表 `farol` 运行在 `game-vfx` 作为效果(`rain_and_puddles`, (中文(简体) ), `fog_and_ash`, (中文(简体) ), `headlights_in_rain`),与他们自己的 事件和游泳池的金色花朵`vfx-workshop-weather.json`) (中文(简体) ).

这里没有游戏内容: 没有城市或派别的名称. 同伴依赖 : `three` ^0.160 (英语).

## 常见问题

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

@adatechnology/game-weather的渲染器:游戏的雨幕\(14 000个GPU点\),游戏-vfx游泳池上相近的雨雾和灰尘,带区雾的线性和指数性雾,雨中暗淡的天空,闪电,雨中前灯等

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

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

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

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

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

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

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

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

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

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

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

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