redscript-mc 3.0.1 → 3.0.2

package/redscript-docs/docs/zh/stdlib/effects.md

@@ -0,0 +1,324 @@
+# Effects
+
+> 本文档由 `src/stdlib/effects.mcrs` 自动生成，请勿手动编辑。
+
+## API 列表
+
+- [speed](#speed)
+- [jump](#jump)
+- [regen](#regen)
+- [resistance](#resistance)
+- [strength](#strength)
+- [invisible](#invisible)
+- [night_vision](#night-vision)
+- [slow_fall](#slow-fall)
+- [glow](#glow)
+- [clear_effects](#clear-effects)
+- [clear_effect](#clear-effect)
+- [buff_all](#buff-all)
+
+---
+
+## `speed` <Badge type="info" text="v1.0.0" />
+
+给目标实体施加速度提升效果
+
+```redscript
+fn speed(target: selector, duration: int, level: int)
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `target` | 实体选择器（如 @p, @a, @e[...]） |
+| `duration` | 效果持续时间（刻，20 刻 = 1 秒） |
+| `level` | 效果等级（0 = 速度 I，1 = 速度 II，...） |
+
+**返回：** void — 应用 minecraft:speed 效果
+
+**示例**
+
+```redscript
+speed(@p, 200, 1)  // Speed II for 10 seconds
+```
+
+---
+
+## `jump` <Badge type="info" text="v1.0.0" />
+
+给目标实体施加跳跃提升效果
+
+```redscript
+fn jump(target: selector, duration: int, level: int)
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `target` | 实体选择器 |
+| `duration` | 效果持续时间（刻） |
+| `level` | 效果等级（0 = 跳跃 I，...） |
+
+**返回：** void — 应用 minecraft:jump_boost 效果
+
+**示例**
+
+```redscript
+jump(@p, 100, 0)  // Jump Boost I for 5 seconds
+```
+
+---
+
+## `regen` <Badge type="info" text="v1.0.0" />
+
+给目标实体施加生命恢复效果
+
+```redscript
+fn regen(target: selector, duration: int, level: int)
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `target` | 实体选择器 |
+| `duration` | 效果持续时间（刻） |
+| `level` | 效果等级 |
+
+**返回：** void — 应用 minecraft:regeneration 效果
+
+**示例**
+
+```redscript
+regen(@p, 60, 0)  // Regeneration I for 3 seconds
+```
+
+---
+
+## `resistance` <Badge type="info" text="v1.0.0" />
+
+给目标实体施加伤害抵抗效果
+
+```redscript
+fn resistance(target: selector, duration: int, level: int)
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `target` | 实体选择器 |
+| `duration` | 效果持续时间（刻） |
+| `level` | 效果等级 |
+
+**返回：** void — 应用 minecraft:resistance 效果
+
+**示例**
+
+```redscript
+resistance(@p, 400, 0)  // Resistance I for 20 seconds
+```
+
+---
+
+## `strength` <Badge type="info" text="v1.0.0" />
+
+给目标实体施加力量提升效果
+
+```redscript
+fn strength(target: selector, duration: int, level: int)
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `target` | 实体选择器 |
+| `duration` | 效果持续时间（刻） |
+| `level` | 效果等级（0 = 力量 I，1 = 力量 II，...） |
+
+**返回：** void — 应用 minecraft:strength 效果
+
+**示例**
+
+```redscript
+strength(@p, 200, 1)  // Strength II for 10 seconds
+```
+
+---
+
+## `invisible` <Badge type="info" text="v1.0.0" />
+
+使目标实体隐身
+
+```redscript
+fn invisible(target: selector, duration: int)
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `target` | 实体选择器 |
+| `duration` | 效果持续时间（刻） |
+
+**返回：** void — 应用 minecraft:invisibility（等级 0）
+
+**示例**
+
+```redscript
+invisible(@p, 300)  // invisibility for 15 seconds
+```
+
+---
+
+## `night_vision` <Badge type="info" text="v1.0.0" />
+
+给目标实体施加夜视效果
+
+```redscript
+fn night_vision(target: selector, duration: int)
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `target` | 实体选择器 |
+| `duration` | 效果持续时间（刻） |
+
+**返回：** void — 应用 minecraft:night_vision
+
+**示例**
+
+```redscript
+night_vision(@p, 6000)  // night vision for 5 minutes
+```
+
+---
+
+## `slow_fall` <Badge type="info" text="v1.0.0" />
+
+给目标实体施加缓降效果
+
+```redscript
+fn slow_fall(target: selector, duration: int)
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `target` | 实体选择器 |
+| `duration` | 效果持续时间（刻） |
+
+**返回：** void — 应用 minecraft:slow_falling
+
+**示例**
+
+```redscript
+slow_fall(@p, 200)  // slow falling for 10 seconds
+```
+
+---
+
+## `glow` <Badge type="info" text="v1.0.0" />
+
+使目标实体发光轮廓
+
+```redscript
+fn glow(target: selector, duration: int)
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `target` | 实体选择器 |
+| `duration` | 效果持续时间（刻） |
+
+**返回：** void — 应用 minecraft:glowing
+
+**示例**
+
+```redscript
+glow(@e[type=zombie], 100)  // make all zombies glow for 5 seconds
+```
+
+---
+
+## `clear_effects` <Badge type="info" text="v1.0.0" />
+
+清除目标实体的所有药水效果
+
+```redscript
+fn clear_effects(target: selector)
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `target` | 实体选择器 |
+
+**返回：** void
+
+**示例**
+
+```redscript
+clear_effects(@p)  // remove all effects from nearest player
+```
+
+---
+
+## `clear_effect` <Badge type="info" text="v1.0.0" />
+
+清除目标实体的特定效果
+
+```redscript
+fn clear_effect(target: selector, eff: string)
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `target` | 实体选择器 |
+| `eff` | 效果资源位置字符串（如 "minecraft:speed"） |
+
+**返回：** void
+
+**示例**
+
+```redscript
+clear_effect(@p, "minecraft:poison")  // cure poison
+```
+
+---
+
+## `buff_all` <Badge type="info" text="v1.0.0" />
+
+给目标施加完整增益套餐（速度 I、力量 I、生命恢复 I、抵抗 I）
+
+```redscript
+fn buff_all(target: selector, duration: int)
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `target` | 实体选择器 |
+| `duration` | 所有效果的持续时间（刻） |
+
+**返回：** void
+
+**示例**
+
+```redscript
+buff_all(@p, 600)  // full buff for 30 seconds
+```
+
+---

package/redscript-docs/docs/zh/stdlib/events.md

@@ -0,0 +1,3 @@
+# Events
+
+> 本文档由 `src/stdlib/events.mcrs` 自动生成，请勿手动编辑。

package/redscript-docs/docs/zh/stdlib/expr.md

@@ -0,0 +1,37 @@
+# Expr
+
+> 本文档由 `src/stdlib/expr.mcrs` 自动生成，请勿手动编辑。
+
+## API 列表
+
+- [expr_eval](#expr-eval)
+
+---
+
+## `expr_eval` <Badge type="info" text="v1.2.0" />
+
+求值 RPN（逆波兰表达式）令牌流，支持单变量替换。正整数为字面量，-10000 为变量 x，-1~-8 为运算符。栈深度 16。
+
+```redscript
+fn expr_eval(tokens: int[], n: int, x: int): int
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `tokens` | 长度为 n 的 RPN 令牌数组 |
+| `n` | 令牌数量 |
+| `x` | 替换令牌 -10000 的变量值 ×10000 |
+
+**返回：** 求值后栈顶值 ×10000
+
+**示例**
+
+```redscript
+// 2*x + 1  →  RPN: [20000, -10000, -3, 10000, -1]
+let prog: int[] = [20000, -10000, -3, 10000, -1];
+expr_eval(prog, 5, 15000); // 40000  (2×1.5 + 1 = 4.0)
+```
+
+---

package/redscript-docs/docs/zh/stdlib/fft.md

@@ -0,0 +1,128 @@
+# Fft
+
+> 本文档由 `src/stdlib/fft.mcrs` 自动生成，请勿手动编辑。
+
+## API 列表
+
+- [dft_noop](#dft-noop)
+- [dft_real](#dft-real)
+- [dft_magnitude](#dft-magnitude)
+- [dft_power](#dft-power)
+- [dft_freq_bin](#dft-freq-bin)
+
+---
+
+## `dft_noop` <Badge type="info" text="v2.0.0" />
+
+dft_coro 的默认空回调，不执行任何操作
+
+```redscript
+fn dft_noop(): void
+```
+
+---
+
+## `dft_real` <Badge type="info" text="v2.0.0" />
+
+计算 input[0..n-1] 的离散傅里叶变换，输出实部到 out_re
+
+```redscript
+fn dft_real(input: int[], n: int, out_re: int[], out_im: int[])
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `input` | 信号采样值数组，×10000 定点数 |
+| `n` | 采样数量（建议 ≤ 16） |
+| `out_re` | 预分配输出数组，存放实部（×10000） |
+| `out_im` | 预分配输出数组，存放虚部（×10000） |
+
+**示例**
+
+```redscript
+let re: int[] = [0, 0, 0, 0]
+let im: int[] = [0, 0, 0, 0]
+dft_real(sig, 4, re, im)
+```
+
+---
+
+## `dft_magnitude` <Badge type="info" text="v2.0.0" />
+
+返回 DFT 第 k 个频段的幅度（sqrt(re²+im²)），×10000
+
+```redscript
+fn dft_magnitude(re: int[], im: int[], k: int): int
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `re` | dft_real 输出的实部数组 |
+| `im` | dft_real 输出的虚部数组 |
+| `k` | 频段索引 |
+
+**返回：** 第 k 频段幅度，×10000
+
+**示例**
+
+```redscript
+let mag: int = dft_magnitude(re, im, 1)
+```
+
+---
+
+## `dft_power` <Badge type="info" text="v2.0.0" />
+
+返回 DFT 第 k 个频段的功率（re²/10000 + im²/10000），×10000
+
+```redscript
+fn dft_power(re: int[], im: int[], k: int): int
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `re` | dft_real 输出的实部数组 |
+| `im` | dft_real 输出的虚部数组 |
+| `k` | 频段索引 |
+
+**返回：** 第 k 频段功率，×10000
+
+**示例**
+
+```redscript
+let power: int = dft_power(re, im, 2)
+```
+
+---
+
+## `dft_freq_bin` <Badge type="info" text="v2.0.0" />
+
+返回 DFT 第 k 个频段对应的频率（Hz）
+
+```redscript
+fn dft_freq_bin(sample_rate_hz: int, n: int, k: int): int
+```
+
+**参数**
+
+| 参数 | 说明 |
+|------|------|
+| `sample_rate_hz` | 采样率（Hz，如 20 = Minecraft tick 速率） |
+| `n` | 变换大小 |
+| `k` | 频段索引 |
+
+**返回：** 第 k 频段对应的频率（Hz）
+
+**示例**
+
+```redscript
+let freq: int = dft_freq_bin(20, 8, 3)
+```
+
+---