Skip to content
酷学小栈

luanti API-Classes 随机数(Random)

随机数(Random) Luanti 提供 四种随机数生成器 ,各有优缺点,模组开发者需要根据场景选择。 Lua 内置随机(全局) 不受模组安全限制,服务端和客户端模组都能用。 math.randomseed(seed) 设置全局随机种子。 引擎 已经用系统时间自动帮你设置过 。 重要提醒 不要自己手动设置种子…

On this page
  1. Lua 内置随机(全局)
  2. math.randomseed(seed)
  3. 重要提醒
  4. math.random()
  5. 缺点
  6. 适用场景
  7. 四种随机生成器详解
  8. 1. PcgRandom(推荐!)
  9. :rand_normal_dist(min, max, [num_trials])
  10. 2. PseudoRandom(老古董,不推荐)
  11. 3. SecureRandom(密码级安全随机)
  12. 性能对比(越快越好)
  13. 总结对比表(精简版)
  14. 官方最终结论

随机数(Random)

Luanti 提供四种随机数生成器,各有优缺点,模组开发者需要根据场景选择。

Lua 内置随机(全局)

不受模组安全限制,服务端和客户端模组都能用。

math.randomseed(seed)

设置全局随机种子。 引擎已经用系统时间自动帮你设置过。

重要提醒

  • 不要自己手动设置种子,会破坏其他模组的随机性
  • 全局只有一个种子,一旦修改会影响所有代码
  • 如果你必须临时用固定种子,用完要立刻还原
-- 安全用法示例
local reseed = math.random(2147483647) -- 先存一个随机种子
math.randomseed(我的固定种子) -- 临时 deterministic
-- 做你的事...
math.randomseed(reseed) -- 恢复全局随机性

math.random()

获取随机数:

  • 无参:0~1 浮点数
  • 1 个参:1~n
  • 2 个参:min~max

缺点

  • 不同平台、不同 Lua 版本结果不一样
  • 不能用于地图生成(会出现不同步)
  • 精度约 32 位,不是完整 52 位

适用场景

快速、非确定性、不需要跨平台一致的随机。


四种随机生成器详解

1. PcgRandom(推荐!)

可设置种子、32 位、高质量、跨平台一致 适合地图生成、结构、树、矿石等。

local r = PcgRandom(seed)
r:next([min, max])
  • 默认范围:-2³¹ ~ 2³¹-1
  • 质量高、速度不错
  • 全平台结果完全一致

:rand_normal_dist(min, max, [num_trials])

近似正态分布(高斯) 均值在中间, trials 越大越接近正态。 官方不推荐使用。


2. PseudoRandom(老古董,不推荐)

16 位 LCG 随机算法,质量最差。

local r = PseudoRandom(seed)
r:next()
  • 范围:0~65535
  • 分布差、功能弱
  • 官方结论:永远不要用

3. SecureRandom(密码级安全随机)

系统级加密安全随机数,不可预测、不可设置种子。

用于:

  • 生成令牌
  • 密钥
  • 抽奖、防作弊
local r = SecureRandom()
local bytes = r:next_bytes([count])
  • 最多一次取 2048 字节
  • Windows 使用 CryptoAPI
  • Linux/Android 使用 /dev/urandom

性能对比(越快越好)

  • math.random:最快(1x)
  • PcgRandom:约 14x
  • PseudoRandom:约 15x
  • SecureRandom:约 30x

总结对比表(精简版)

类型 可设种子 跨平台一致 质量 用途
math.random 全局 ❌ 不保证 一般 快速普通随机
PcgRandom ✅ 实例独立 ✅ 完全一致 高 地图生成、模组逻辑
PseudoRandom ✅ ✅ 差 不用
SecureRandom ❌ — 最高 密码、防作弊

官方最终结论

  • 永远不要用 PseudoRandom,被 PcgRandom 全面吊打
  • 要快、简单 → math.random
  • 要确定性、地图生成、全平台一致 → PcgRandom
  • 要加密安全 → SecureRandom