DBot/better-random
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update readme

Browse Source
This commit is contained in:
DBotThePony 2025-03-12 16:28:16 +07:00
parent 6e88427eef
commit ef717e9f3d
Signed by: DBot
GPG Key ID: DCC23B5715498507
1 changed files with 5 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
README.md
View File

@ -12,16 +12,16 @@ You were warned.
Better Random, or Better PRNG if you prefer, is a mod which replace Minecraft's default Better Random, or Better PRNG if you prefer, is a mod which replace Minecraft's default
[Linear congruential generator](https://en.wikipedia.org/wiki/Linear_congruential_generator) [Linear congruential generator](https://en.wikipedia.org/wiki/Linear_congruential_generator)
(LCG for short, used for generating most of random game events, as well as generator used when generating world features) (LCG for short, used for generating most of random game events, as well as generator used when generating some world features)
and Xoshiro128PlusPlus (used to generate "sequences" aka random generator used for `LootPool`s) and Xoroshiro128PlusPlus (used to generate "sequences" aka random generator used for `LootPool`s, as well as generator used when generating most of world features)
with a better random number generator, [gjrand](https://gjrand.sourceforge.net). with a random number generator which have better statistical properties, [gjrand](https://gjrand.sourceforge.net).
This mod is virtually incompatible with other mods which mess with vanilla codebase random, This mod is virtually incompatible with other mods which mess with vanilla codebase random,
such as Faster Random. If you have such mod installed already, decide which mod you will use. such as Faster Random. If you have such mod installed already, decide which mod you will use.
### Features: ### Features:
* Replaces `RandomSupport#create`, and subsequently, `Entity#random`, `Level#random`, worldgen (but not noise map, which means world will have same elevation, but different feature placement), countless other places including mods; * Replaces `RandomSupport#create`, and subsequently, `Entity#random`, `Level#random`, worldgen (but not noise map, which means world will have same elevation, but different feature placement), countless other places including mods;
* Patches `WorldgenRandom` to convert `LegacyRandomSource` and `XoroshiroRandomSource` to random provided by Better Random, albeit patch is lazy and it may interfere with other mods which deliberately want these random generators to be underlying generators; * Patches `WorldgenRandom` to convert `LegacyRandomSource` and `XoroshiroRandomSource` to random provided by Better Random, albeit it may interfere with other mods which *deliberately* want these random generators to be underlying generators;
* Replaces `RandomSequence` and `RandomSequences` with versions which use gjrand; * Replaces `RandomSequence` and `RandomSequences` with versions which use gjrand;
* Replaces `Level#getBlockRandomPos` to use `Level#random`. Previously, `getBlockRandomPos` utilized LCG with even worse properties than one of `Level#random`. * Replaces `Level#getBlockRandomPos` to use `Level#random`. Previously, `getBlockRandomPos` utilized LCG with even worse properties than one of `Level#random`.
@ -34,6 +34,5 @@ such as Faster Random. If you have such mod installed already, decide which mod
Should be compatible with everything that doesn't go around public interfaces vanilla code provide. Should be compatible with everything that doesn't go around public interfaces vanilla code provide.
Existing `RandomSequence` saved data is left untouched (in meaning that nothing is done to it through code, Existing `RandomSequence` saved data is left untouched (in meaning that nothing is done to it through code,
but Minecraft continue to load/create it upon server start), and removing Better Random mid-game won't have any but Minecraft continue to load/create it upon server start), and removing Better Random mid-game won't have any
noticeable side effects (but world generation *may* look weird after installing/removing the mod, because noticeable side effects (but world generation *may* look weird after installing/removing the mod).
`RandomSupport#create` is used to determine how to place world features, such as ores and trees).