prismarine-rng

Collection of utilities to work with minecraft RNG.

API

LCG

Linear Congruential Generator https://en.wikipedia.org/wiki/Linear_congruential_generator The type of random number generator used by Java. ?tbd //TODO: need to document the classes

Random

An implementation of Java's Random https://docs.oracle.com/javase/8/docs/api/java/util/Random.html ?tbd //TODO: need to document the classes

crackPlayerSeed

crackPlayerSeed.crack(bits)

Returns the decrypted player seed example

• Returns - Seed number
• bits - Encrypted seed string?

❗ this is highly experimental, and for helping to build a seed cracking tool

enchantments

enchantments.findEnchantment(playerSeed, item, power, matching)

• Returns - Object or null ?tbd
• playerSeed - BigInt
• item - Item object to enchant
• power - Number of bookshelves around the table
• matching - Matching function that returns a bool ?tbd

enchantments.getEnchantmentList(xpseed, item, slot, level)

• Returns - Array ?tbd
• xpseed - Number of the seed of the rng for the next enchant
• item - Item object to enchant
• slot - ?tbd
• level - Number ?tbd

enchantments.getEnchantmentCost(rand, slot, power, item)

• Returns - Numeber ?tbd
• rand - ?tbd
• slot - ?tbd
• power - Number of bookshelves around the table
• item - Item object to enchant

enchantments.getEnchantmentPower(pos, world)

• Returns - Power number ?tbd
• pos - Vec3 ?tbd
• world - ?tbd

createWorldGenerator

createWorldGenerator(mcData, worldSeed, dimension)

Returns a promise

• Returns - Promise that resolves to ?tbd
• mcData - mcData
• worldSeed - World seed number
• dimension - Dimension string (defaults to "overworld")