FeatureRandom 5.46.0

final class · pocketmine\world\generator\vanilla\feature\FeatureRandom · source

Vanilla's WorldgenRandom over a Xoroshiro128++ source, as used for biome decoration (ChunkGenerator .applyBiomeDecoration): every value comes from next(bits) = (int) (xoroshiro.nextLong() >>> (64 - bits)), and the int/float/double/long/gaussian helpers are the java.util.Random style ones of BitRandomSource / LegacyRandomSource.

Note: the gaussian cache is NOT reset by setSeed() (WorldgenRandom overrides setSeed and only reseeds the source), so it carries over between features of the same chunk, like in vanilla.

Methods

__construct()

public function __construct(int $seed = 0)

consumeCount()

public function consumeCount(int $count) : void

fork()

public function fork() : \pocketmine\world\generator\vanilla\random\XoroshiroRandom

WorldgenRandom.fork(): a plain Xoroshiro source (with its own nextInt(bound) semantics).

getGaussianState()

public function getGaussianState() : array

Pending second value of nextGaussian() (the native decoration continues the same sequence).

mthNextInt()

public function mthNextInt(int $min, int $max) : int

Mth.nextInt(random, min, max): min if min >= max

next()

public function next(int $bits) : int

(int) (nextLong() >>> (64 - bits)), for 1 <= bits <= 32.

nextBoolean()

public function nextBoolean() : bool

nextBoundedInt()

public function nextBoundedInt(int $bound) : int

Uniform int in [0, bound) (java.util.Random algorithm).

nextDouble()

public function nextDouble() : float

nextFloat()

public function nextFloat() : float

float32 in [0, 1)

nextGaussian()

public function nextGaussian() : float

nextInt()

public function nextInt() : int

nextIntBetweenInclusive()

public function nextIntBetweenInclusive(int $min, int $max) : int

RandomSource.nextIntBetweenInclusive / Mth.randomBetweenInclusive

nextIntRange()

public function nextIntRange(int $origin, int $bound) : int

RandomSource.nextInt(origin, bound)

nextLong()

public function nextLong() : int

rawLong()

public function rawLong() : int

Raw Xoroshiro128++ output.

setDecorationSeed()

public function setDecorationSeed(int $levelSeed, int $x, int $z) : int

WorldgenRandom.setDecorationSeed(levelSeed, minBlockX, minBlockZ): returns the decoration seed.

setFeatureSeed()

public function setFeatureSeed(int $decorationSeed, int $index, int $step) : void

WorldgenRandom.setFeatureSeed(decorationSeed, index, step).

setGaussianState()

public function setGaussianState(bool $have, float $value) : void

setSeed()

public function setSeed(int $seed) : void

triangle()

public function triangle(float $mean, float $spread) : float

RandomSource.triangle(mean, spread) for doubles