Aleatório
Um gerador determinístico: a mesma semente dá sempre a mesma sequência, em todas as plataformas.
Namespace: caffeine.random · Dryad prefix: caffeine_random_
setSeed#
Lua: caffeine.random.setSeed · Dryad: caffeine_random_set_seed
setSeed(seed)
Reinicia a sequência.
| Parâmetros | Tipo | Descrição |
|---|---|---|
seed | number | Qualquer inteiro; 0 é substituído por um valor fixo. |
Devolve: nada
Exemplo
caffeine.random.setSeed(1234)
value#
Lua: caffeine.random.value · Dryad: caffeine_random_value
value() -> number
Próximo número aleatório.
Devolve: number. Um número em [0, 1).
Exemplo
local r = caffeine.random.value()
range#
Lua: caffeine.random.range · Dryad: caffeine_random_range
range(min, max) -> number
Um número aleatório num intervalo.
| Parâmetros | Tipo | Descrição |
|---|---|---|
min | number | Limite inferior (inclusivo). |
max | number | Limite superior (exclusivo). |
Devolve: number. Um número em [min, max).
Exemplo
local x = caffeine.random.range(-5, 5)
int#
Lua: caffeine.random.int · Dryad: caffeine_random_int
int(min, max) -> number
Um inteiro aleatório, com os dois extremos incluídos.
| Parâmetros | Tipo | Descrição |
|---|---|---|
min | number | Limite inferior (inclusivo). |
max | number | Limite superior (inclusivo); limites invertidos são trocados. |
Devolve: number. Um inteiro em [min, max].
Exemplo
local roll = caffeine.random.int(1, 6)
chance#
Lua: caffeine.random.chance · Dryad: caffeine_random_chance
chance(p) -> boolean
Um cara ou coroa com pesos.
| Parâmetros | Tipo | Descrição |
|---|---|---|
p | number | Probabilidade de 0 a 1. |
Devolve: boolean. true com probabilidade p.
Exemplo
if caffeine.random.chance(0.25) then end