@bepack/cli 0.1.0-beta.6 → 0.1.0-beta.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +89 -224
- package/README.zh-CN.md +95 -223
- package/dist/cli.js +11 -11
- package/dist/index.d.ts +30 -78
- package/dist/index.js +2 -2
- package/package.json +3 -3
- package/reference.md +4 -1
package/README.zh-CN.md
CHANGED
|
@@ -18,88 +18,48 @@
|
|
|
18
18
|
|
|
19
19
|
[English](./README.md) | 中文
|
|
20
20
|
|
|
21
|
-
BePack
|
|
21
|
+
BePack 用一套工作流管理附加包项目：manifest、Script API 依赖、TypeScript 构建、复制到 Minecraft，以及 `.mcpack` / `.mcaddon` 打包发布。
|
|
22
22
|
|
|
23
|
-
##
|
|
23
|
+
## 功能
|
|
24
24
|
|
|
25
|
-
-
|
|
26
|
-
- 同步 `manifest.json
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
- 通过 `compile.define
|
|
30
|
-
-
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
- 将包复制到 Minecraft 开发目录，并生成发布压缩包。
|
|
34
|
-
- 分析 Bedrock `.cpuprofile`，避免把 tick 之间的空闲 gap 当成 CPU 工作。
|
|
25
|
+
- 支持从零创建配置，也可从现有 BP/RP manifest 导入。
|
|
26
|
+
- 同步 `manifest.json` 时保留 BePack 不管理的字段。
|
|
27
|
+
- 提供 `preserve`（增量）与 `clean`（按配置重建）两种合并策略。
|
|
28
|
+
- 类型检查通过后，将 Script API 源码构建到 `scripts/` 目录。
|
|
29
|
+
- 通过 `compile.define` 或 `replace` 注入编译期开关。
|
|
30
|
+
- 解析 `@minecraft/*` 依赖并写入具体版本。
|
|
31
|
+
- 可将包复制到游戏开发目录，或直接生成发布压缩包。
|
|
32
|
+
- 分析 `.cpuprofile` 时排除空闲 tick，只统计真实 CPU 时间。
|
|
35
33
|
|
|
36
34
|
## 环境要求
|
|
37
35
|
|
|
38
36
|
- Node.js 20 或更高版本。
|
|
39
|
-
-
|
|
40
|
-
-
|
|
37
|
+
- 行为包、资源包，或两者兼有。
|
|
38
|
+
- 使用 Script API 依赖时需要 `package.json`。
|
|
41
39
|
|
|
42
|
-
##
|
|
40
|
+
## 创建项目
|
|
43
41
|
|
|
44
|
-
|
|
42
|
+
新项目建议使用 [create-mcbe](https://www.npmjs.com/package/create-mcbe) 生成，交互选项见该项目文档：
|
|
45
43
|
|
|
46
44
|
```bash
|
|
47
45
|
npm create mcbe
|
|
48
46
|
```
|
|
49
47
|
|
|
50
|
-
|
|
48
|
+
也可以自行安装 BePack 后初始化：
|
|
51
49
|
|
|
52
50
|
```bash
|
|
53
|
-
npm install -
|
|
51
|
+
npm install -D @bepack/cli
|
|
52
|
+
npx bepack init # 全新配置
|
|
53
|
+
npx bepack init --from-bp bp/manifest.json # 从现有 BP 导入
|
|
54
|
+
npx bepack init --from-bp bp/manifest.json --from-rp rp/manifest.json
|
|
55
|
+
npx bepack build --install # 首次构建
|
|
54
56
|
```
|
|
55
57
|
|
|
56
|
-
|
|
58
|
+
`--from-bp` / `--from-rp` 会读取 manifest 中的名称、UUID、版本、格式和 Script API 依赖，无需手动填写；仅在找到对应源文件时启用编译。`--dry-run` 只预览结果、不写入文件，`--format js|mjs` 生成 JavaScript 配置。使用 `npm i -g @bepack/cli` 全局安装后，可省略 `npx`。
|
|
57
59
|
|
|
58
|
-
|
|
60
|
+
## 配置
|
|
59
61
|
|
|
60
|
-
|
|
61
|
-
bepack init
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
初始配置会包含一个 BP、位于 `src/main.ts` 的 TypeScript 入口和自动生成的 UUID。首次构建时安装依赖：
|
|
65
|
-
|
|
66
|
-
```bash
|
|
67
|
-
bepack build --install
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
## 接入已有项目
|
|
71
|
-
|
|
72
|
-
已有包的 manifest 时，不必手动重新填写 UUID 和版本号；直接从 manifest 导入配置最快：
|
|
73
|
-
|
|
74
|
-
```bash
|
|
75
|
-
# 仅行为包
|
|
76
|
-
bepack init --from-bp bp/manifest.json
|
|
77
|
-
|
|
78
|
-
# 同时有行为包和资源包
|
|
79
|
-
bepack init --from-bp bp/manifest.json --from-rp rp/manifest.json
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
该命令会根据读取到的包根目录、名称、UUID、版本、manifest 格式和受支持的 Script API 依赖创建 `bepack.config.ts`。只有当确实存在匹配的源文件（`src/<入口>.ts`、`.mts`、`.js` 或 `.mjs`）时，脚本模块才会生成 TypeScript 构建配置——脚本已经在包里的项目会保持编译关闭，而不是生成一个首次构建就会失败的入口。存在 TypeScript 源码但缺少 `tsconfig.json` 时会给出提示，并在生成的配置里关闭类型检查。
|
|
83
|
-
|
|
84
|
-
`--dry-run` 只打印将要创建的文件，不写盘。
|
|
85
|
-
|
|
86
|
-
常用变体：
|
|
87
|
-
|
|
88
|
-
```bash
|
|
89
|
-
# 生成 JavaScript 或 ESM JavaScript 配置，而非 TypeScript
|
|
90
|
-
bepack init --format js
|
|
91
|
-
bepack init --format mjs
|
|
92
|
-
|
|
93
|
-
# 在项目目录外执行
|
|
94
|
-
bepack init --cwd path/to/project --from-bp bp/manifest.json
|
|
95
|
-
|
|
96
|
-
# 明确覆盖已有的生成配置
|
|
97
|
-
bepack init --from-bp bp/manifest.json --force
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
## 最小配置
|
|
101
|
-
|
|
102
|
-
BePack 会从项目目录加载 `bepack.config.ts`、`bepack.config.mjs` 或 `bepack.config.js`。以下是常见的 Script API 行为包配置：
|
|
62
|
+
配置文件位于项目根目录，支持 `bepack.config.ts`、`bepack.config.mjs` 或 `bepack.config.js`：
|
|
103
63
|
|
|
104
64
|
```ts
|
|
105
65
|
import { defineConfig } from "@bepack/cli";
|
|
@@ -130,11 +90,9 @@ export default defineConfig({
|
|
|
130
90
|
});
|
|
131
91
|
```
|
|
132
92
|
|
|
133
|
-
新包请生成新的 UUID
|
|
93
|
+
新包请生成新的 UUID，不要与其他附加包重复。纯数据行为包无需 `moduleUuid` 和 `compile`；仅资源包项目配置 `packs.rp`，填写其 `root`、头部 `uuid` 和资源模块 `moduleUuid`。
|
|
134
94
|
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
目录名称都可通过配置调整；以下结构对应上面的示例：
|
|
95
|
+
目录名均可配置，上述配置对应以下结构：
|
|
138
96
|
|
|
139
97
|
```text
|
|
140
98
|
my-addon/
|
|
@@ -149,196 +107,119 @@ my-addon/
|
|
|
149
107
|
└── dist/ # .mcpack / .mcaddon 输出
|
|
150
108
|
```
|
|
151
109
|
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
## 日常工作流
|
|
110
|
+
## 常用命令
|
|
155
111
|
|
|
156
112
|
```bash
|
|
157
|
-
|
|
158
|
-
bepack build
|
|
159
|
-
|
|
160
|
-
#
|
|
161
|
-
bepack build
|
|
162
|
-
|
|
163
|
-
# 开发时监听文件并自动重建
|
|
164
|
-
bepack dev
|
|
165
|
-
|
|
166
|
-
# 生成发布压缩包（会先构建）
|
|
167
|
-
bepack pack
|
|
168
|
-
|
|
169
|
-
# 一次完成构建和打包
|
|
170
|
-
bepack build --pack
|
|
113
|
+
bepack build --install # 解析依赖、更新 manifest、构建
|
|
114
|
+
bepack build # 依赖已就绪，仅构建
|
|
115
|
+
bepack dev # 监听文件变化并重建
|
|
116
|
+
bepack pack # 先构建，再打包
|
|
117
|
+
bepack build --pack # 构建与打包一次完成
|
|
171
118
|
```
|
|
172
119
|
|
|
173
|
-
`bepack pack`
|
|
174
|
-
|
|
175
|
-
如果只想更新受管理的依赖和 manifest，可单独执行 `bepack install`。可以在配置中设置 `target`，也可以在安装并构建时临时指定目标 Minecraft 版本：
|
|
120
|
+
`bepack pack` 默认先构建，避免将过期的 `scripts/*.js` 打进包内；如需直接压缩磁盘上的目录，使用 `--no-build`。仅刷新依赖和 manifest 时，可单独运行 `bepack install`。需要临时切换 Minecraft 版本时，使用 `--target`：
|
|
176
121
|
|
|
177
122
|
```bash
|
|
178
123
|
bepack install --target 1.21.120
|
|
179
|
-
bepack build --install --target 1.21.120
|
|
180
124
|
```
|
|
181
125
|
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
### 自定义类型检查器
|
|
126
|
+
## 类型检查
|
|
185
127
|
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
```ts
|
|
189
|
-
export default defineConfig({
|
|
190
|
-
packs: {
|
|
191
|
-
bp: {
|
|
192
|
-
compile: {
|
|
193
|
-
entry: "src/main.ts",
|
|
194
|
-
// 终端里能敲的命令都行。默认是 "tsc --noEmit"。
|
|
195
|
-
typecheckCommand: "bun check",
|
|
196
|
-
// typecheckCommand: "tsc-rs --noEmit",
|
|
197
|
-
// typecheckCommand: "npx tsc --noEmit",
|
|
198
|
-
// 按引号分词；反斜杠只转义引号，所以 Windows 路径可以原样书写：
|
|
199
|
-
// typecheckCommand: 'node "C:\\tools\\my checker.mjs"',
|
|
200
|
-
},
|
|
201
|
-
},
|
|
202
|
-
},
|
|
203
|
-
});
|
|
204
|
-
```
|
|
128
|
+
`bepack build` 和 `bepack dev` 默认先运行 `tsc --noEmit`，通过后再交给 Rolldown；失败会以 `TYPECHECK_FAILED` 终止，不会产出不完整的包。如需跳过，使用 `--skip-typecheck` 或设置 `compile.typecheck: false`。添加自定义 Rolldown 选项不会关闭类型检查。
|
|
205
129
|
|
|
206
|
-
|
|
130
|
+
检查器可以是任意命令行工具：
|
|
207
131
|
|
|
208
132
|
```ts
|
|
209
133
|
compile: {
|
|
210
|
-
|
|
211
|
-
|
|
134
|
+
entry: "src/main.ts",
|
|
135
|
+
typecheckCommand: "bun check", // 默认："tsc --noEmit"
|
|
212
136
|
}
|
|
213
137
|
```
|
|
214
138
|
|
|
215
139
|
```bash
|
|
216
|
-
bepack build --typecheck-command "
|
|
217
|
-
bepack dev --typecheck-command "tsc-rs --noEmit"
|
|
218
|
-
bepack pack --typecheck-command "npx tsc --noEmit"
|
|
140
|
+
bepack build --typecheck-command "tsc-rs --noEmit"
|
|
219
141
|
```
|
|
220
142
|
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
| 想用什么 | `typecheckCommand` |
|
|
224
|
-
| --- | --- |
|
|
225
|
-
| 默认 | *不配* → `tsc --noEmit --project <tsconfig>` |
|
|
226
|
-
| 项目本地的 TypeScript | `"npx tsc --noEmit"` |
|
|
227
|
-
| Bun 的快速检查 | `"bun check"`（用的是 Bun 自带的 TypeScript，不是项目里锁定的版本） |
|
|
228
|
-
| 原生 TS 移植（Rust） | `"tsc-rs --noEmit"` |
|
|
229
|
-
| Vue / Svelte | `"vue-tsc --noEmit"` / `"svelte-check"` |
|
|
230
|
-
|
|
231
|
-
**只有"不配 command"的默认情况和旧 `useNpx` 兼容配置会被 BePack 附加参数**（`--project <tsconfig>`，以及 `--cache` 时的 `--incremental` / `--tsBuildInfoFile`）。你一旦写了 `command`，BePack 一个参数都不加——工具需要 tsconfig 就自己写进命令里。`typecheck.args` 追加在命令之后。
|
|
143
|
+
BePack 只为自带的 `tsc` 默认命令追加 `--project` 和缓存参数；自定义命令按原样执行。对象写法（`typecheck: { command, args }`）、优先级以及已废弃的 `useNpx` 参见[参考文档](./reference.md)。
|
|
232
144
|
|
|
233
|
-
|
|
145
|
+
## Script API 依赖
|
|
234
146
|
|
|
235
|
-
|
|
147
|
+
`@minecraft/*` 依赖支持 `stable`、`beta`、`preview` 和精确版本。`install`、`build --install` 会联网将选择器解析为具体版本，写入 `package.json` 和 BP manifest；`build`、`dev` 等离线命令沿用 manifest 中的值。配置中指定精确版本时，以配置为准。
|
|
236
148
|
|
|
237
|
-
|
|
149
|
+
## 自定义构建
|
|
238
150
|
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
`packs.bp.compile` 覆盖了常见场景。需要 Rolldown 的其它能力时（额外插件、`resolve.alias`、`treeshake`、`sourcemap` 等），可以用内联选项、函数或配置文件传入：
|
|
151
|
+
需要插件、alias、sourcemap 等 Rolldown 能力时，可以内联选项、写成函数，或使用独立配置文件：
|
|
242
152
|
|
|
243
153
|
```ts
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
entry: "src/main.ts",
|
|
250
|
-
// 对象形式，或函数形式 (options, context) => options
|
|
251
|
-
rolldown: {
|
|
252
|
-
resolve: { alias: { "@lib": "./src/lib" } },
|
|
253
|
-
output: { sourcemap: true },
|
|
254
|
-
},
|
|
255
|
-
// 或使用配置文件（相对项目根）：
|
|
256
|
-
// rolldownConfig: "rolldown.bp.config.ts",
|
|
257
|
-
},
|
|
258
|
-
},
|
|
154
|
+
compile: {
|
|
155
|
+
entry: "src/main.ts",
|
|
156
|
+
rolldown: {
|
|
157
|
+
resolve: { alias: { "@lib": "./src/lib" } },
|
|
158
|
+
output: { sourcemap: true },
|
|
259
159
|
},
|
|
260
|
-
|
|
160
|
+
// rolldownConfig: "rolldown.bp.config.ts",
|
|
161
|
+
}
|
|
261
162
|
```
|
|
262
163
|
|
|
263
164
|
```bash
|
|
264
|
-
# 临时替换配置里指定的文件
|
|
265
165
|
bepack build --rolldown-config rolldown.staging.mjs
|
|
266
|
-
bepack dev --rolldown-config rolldown.staging.mjs
|
|
267
166
|
```
|
|
268
167
|
|
|
269
|
-
|
|
168
|
+
自定义选项会合并到 BePack 生成的配置上：`plugins` 追加，`external` 取并集，`resolve` / `output` / `transform` 做一层深合并。`input` 和输出位置不允许改动。完整规则见参考文档。
|
|
270
169
|
|
|
271
|
-
##
|
|
170
|
+
## 复制到 Minecraft
|
|
272
171
|
|
|
273
|
-
|
|
172
|
+
配置复制目标后，为 `dev` 或 `build` 添加 `--copy`：
|
|
274
173
|
|
|
275
174
|
```ts
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
type: "gameRoot",
|
|
283
|
-
path: "C:/Users/you/AppData/Local/Packages/Microsoft.MinecraftUWP_8wekyb3d8bbwe/LocalState/games/com.mojang",
|
|
284
|
-
},
|
|
175
|
+
copy: {
|
|
176
|
+
defaultTarget: "minecraft",
|
|
177
|
+
targets: {
|
|
178
|
+
minecraft: {
|
|
179
|
+
type: "gameRoot",
|
|
180
|
+
path: "C:/Users/you/AppData/Local/Packages/Microsoft.MinecraftUWP_8wekyb3d8bbwe/LocalState/games/com.mojang",
|
|
285
181
|
},
|
|
286
182
|
},
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
},
|
|
290
|
-
});
|
|
183
|
+
},
|
|
184
|
+
dev: { copy: true },
|
|
291
185
|
```
|
|
292
186
|
|
|
293
187
|
```bash
|
|
294
|
-
#
|
|
295
|
-
bepack
|
|
296
|
-
|
|
297
|
-
# 或仅复制一次已完成的构建
|
|
298
|
-
bepack build --copy
|
|
188
|
+
bepack dev # 构建，之后每次文件变化都重建并复制
|
|
189
|
+
bepack build --copy # 仅复制一次已完成的构建
|
|
299
190
|
bepack copy --target minecraft
|
|
300
191
|
```
|
|
301
192
|
|
|
302
|
-
`gameRoot`
|
|
193
|
+
`gameRoot` 会将行为包放入 `development_behavior_packs`，资源包放入 `development_resource_packs`。如需为 BP 和 RP 分别指定路径，可使用自定义目标，写法见参考文档。
|
|
303
194
|
|
|
304
|
-
## 分析
|
|
195
|
+
## 分析 CPU profile
|
|
305
196
|
|
|
306
|
-
|
|
197
|
+
Bedrock 不采样空闲时间，tick 间隔会作为一条很大的 `timeDeltas` 记录在下一个采样点上。`bepack profile` 会忽略超过 `--gap`（默认 `5` ms）的 delta，并按真实累计时间对函数排序：
|
|
307
198
|
|
|
308
199
|
```bash
|
|
309
|
-
# 概览；burst 按 busy 时间倒序
|
|
310
200
|
bepack profile summary bedrock.cpuprofile
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
bepack profile
|
|
314
|
-
|
|
315
|
-
# 查看时间窗口内的 self 或 inclusive 函数
|
|
316
|
-
bepack profile top bedrock.cpuprofile --from 2900 --to 2950 --by total
|
|
317
|
-
|
|
318
|
-
# 对比两次抓取；一侧没有 burst 时回退到整体 active 统计
|
|
319
|
-
bepack profile diff before.cpuprofile after.cpuprofile
|
|
201
|
+
bepack profile bursts bedrock.cpuprofile
|
|
202
|
+
bepack profile top bedrock.cpuprofile --from 2900 --to 2950 --by total
|
|
203
|
+
bepack profile diff before.cpuprofile after.cpuprofile
|
|
320
204
|
```
|
|
321
205
|
|
|
322
|
-
|
|
206
|
+
`--json` 输出机器可读结果，`--root <目录>` 用于缩短路径。该命令不需要 `bepack.config`。
|
|
323
207
|
|
|
324
208
|
## 打包发布
|
|
325
209
|
|
|
326
|
-
|
|
210
|
+
在 `pack` 中设置产物名称和目录，`{name}`、`{version}` 会替换为顶层配置中的值：
|
|
327
211
|
|
|
328
212
|
```ts
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
outDir: "releases",
|
|
334
|
-
},
|
|
335
|
-
});
|
|
213
|
+
pack: {
|
|
214
|
+
name: "{name}-{version}",
|
|
215
|
+
outDir: "releases",
|
|
216
|
+
}
|
|
336
217
|
```
|
|
337
218
|
|
|
338
219
|
```bash
|
|
339
220
|
bepack pack
|
|
340
221
|
bepack pack --name my-addon-preview
|
|
341
|
-
bepack pack --no-build
|
|
222
|
+
bepack pack --no-build
|
|
342
223
|
```
|
|
343
224
|
|
|
344
225
|
| 已配置的包 | 输出 |
|
|
@@ -347,52 +228,43 @@ bepack pack --no-build # 不构建，直接压缩磁盘上的包目录
|
|
|
347
228
|
| 仅 RP | `.mcpack` |
|
|
348
229
|
| BP 和 RP | `.mcaddon` |
|
|
349
230
|
|
|
350
|
-
|
|
231
|
+
当 include 列表遗漏文件时，BePack 会列出被遗漏的顶层条目，并提示添加到 `packs.bp.include` / `packs.rp.include`，不会静默丢弃。
|
|
351
232
|
|
|
352
233
|
### Pack 优化（`__brarchive`）
|
|
353
234
|
|
|
354
|
-
1.26.40
|
|
235
|
+
从 1.26.40 起，官方支持将包内的散文件收进 `__brarchive/` 归档。BePack 打包时也可生成相同结构：
|
|
355
236
|
|
|
356
237
|
```ts
|
|
357
238
|
pack: { outDir: "dist", optimize: true }
|
|
358
239
|
```
|
|
359
240
|
|
|
360
241
|
```bash
|
|
361
|
-
bepack pack --optimize # --no-optimize
|
|
362
|
-
bepack build --pack --optimize
|
|
242
|
+
bepack pack --optimize # --no-optimize 可关闭
|
|
363
243
|
```
|
|
364
244
|
|
|
365
|
-
BePack
|
|
366
|
-
|
|
367
|
-
磁盘上的包目录不会被修改，`bepack copy` 也只在显式开启时才优化。
|
|
245
|
+
BePack 会写入 `header.pack_optimization_version: "0.1.0"` —— 该字段才是引擎读取归档的开关。`entities/`、`items/` 等注册表目录整体进归档，并删除散文件；`functions/`、`textures/` 等按路径引用的目录保留散文件，归档中仅登记一个同名存根。磁盘上的包目录不会被修改。
|
|
368
246
|
|
|
369
|
-
>
|
|
370
|
-
|
|
371
|
-
复制到开发目录默认仍是散文件形态。开启 `copy.optimize`（或给 `copy` / `dev` / `build --copy` 传 `--optimize`）可以把**优化后的形态**放进开发目录，这样打包后才可能出现的问题能在实机里提前发现：
|
|
372
|
-
|
|
373
|
-
```ts
|
|
374
|
-
copy: { defaultTarget: "minecraft", optimize: true }
|
|
375
|
-
```
|
|
247
|
+
> 只有 1.26.40+ 的客户端能读取归档内容，旧客户端只能看到保留的散文件。如需让开发目录也保持相同形态，启用 `copy.optimize` 即可。
|
|
376
248
|
|
|
377
249
|
## 命令速查
|
|
378
250
|
|
|
379
|
-
| 命令 | 用途
|
|
380
|
-
| ------------------------- |
|
|
381
|
-
| `bepack init` |
|
|
382
|
-
| `bepack install` |
|
|
383
|
-
| `bepack manifest` |
|
|
384
|
-
| `bepack build` | 修补 manifest
|
|
385
|
-
| `bepack dev` |
|
|
386
|
-
| `bepack copy` |
|
|
387
|
-
| `bepack pack` |
|
|
388
|
-
| `bepack profile summary` | 分析
|
|
389
|
-
| `bepack config --summary` | 查看解析后的配置摘要。
|
|
251
|
+
| 命令 | 用途 |
|
|
252
|
+
| ------------------------- | ----------------------------------------------------------------- |
|
|
253
|
+
| `bepack init` | 创建配置，或通过 `--from-bp` / `--from-rp` 导入。 |
|
|
254
|
+
| `bepack install` | 解析托管依赖，更新 `package.json` 和 manifest。 |
|
|
255
|
+
| `bepack manifest` | 仅更新 manifest，不安装依赖。 |
|
|
256
|
+
| `bepack build` | 修补 manifest、类型检查、编译 BP 源码。 |
|
|
257
|
+
| `bepack dev` | 构建一次后进入监听，文件变化时重建。 |
|
|
258
|
+
| `bepack copy` | 将配置的包复制到开发目标。 |
|
|
259
|
+
| `bepack pack` | 构建后生成 `.mcpack` / `.mcaddon`（`--no-build` 跳过构建）。 |
|
|
260
|
+
| `bepack profile summary` | 分析 `.cpuprofile`，定位慢 tick。 |
|
|
261
|
+
| `bepack config --summary` | 查看解析后的配置摘要。 |
|
|
390
262
|
|
|
391
|
-
|
|
263
|
+
所有项目命令均支持 `--cwd <目录>`、`--config <路径>`、`--dry-run` 和 `--json`；完整参数见 `bepack <命令> --help`。
|
|
392
264
|
|
|
393
|
-
##
|
|
265
|
+
## 文档
|
|
394
266
|
|
|
395
|
-
|
|
267
|
+
完整配置字段、自定义复制目标、include 规则、依赖解析器、插件、Hook 和替换标记，详见[参考文档](./reference.md)。
|
|
396
268
|
|
|
397
269
|
## 许可证
|
|
398
270
|
|