
Synchronised Blockstates
A mod to synchronise the list of blockstates from server to client to prevent mismatches
- Загрузки
- 259
- Подписчики
- 2
- Обновлён
- 10 октября 2025 г.
- Лицензия
- GPL-2.0-or-later
Опубликован 1 июля 2025 г.
Synchronised Blockstates
Modded multiserver setups can be... complicated.
When you have multiple connected servers that all have different modlists, it's not uncommon for different servers to have mismatched blocks, leaving you with sights like this:

Obviously this isn't ideal, so this mod takes the approach of synchronising all of the blockstates from the server to the client side when the player joins, allowing the client to compensate.
For example, that same image with synchronised blockstates enabled:

Note: if the client doesn't receive blockstate info from the server, it'll fall back to using vanilla states.
This mod is still a W.I.P. and there are plenty of improvements yet to be made, but it should function for the time being.
Configuration
In lieu of a proper config at this point in time, Synchronised Blockstates has several behaviours that can be enabled or customised using JVM arguments or environment variables:
-Dmod.synchronisedblockstates.dumpAllStates- Client-only.
- Accepted values:
true,1,yes,on. - On startup, encodes all blockstates (using the same format as if it were sending a single, unchunked, state registry packet) and writes it to
<minecraft run directory>/synchronized_blockstates/vanillablockstates.dat(note: not necessarily only vanilla blockstates, will also include modded blockstates if there are any modded blocks).
-Dmod.synchronisedblockstates.ouputMissingStates- Client-only.
- Accepted values:
true,1,yes,on. - When the client recieves a packet and remaps its local registry, outputs any mismatches between the client and server registries to
<minecraft run directory>/synchronized_blockstates/missing-states-<current time>.dat
-Dmod.synchronisedblockstates.propertyChunkingThreshold- Logical Server only.
- Accepted values: any integer, default
1024. - Max limit on properties before the server starts chunking data before sending it to the client. Additionally, the maximum number of properties that can be sent in a single property chunk.
-Dmod.synchronisedblockstates.blockChunkingThreshold- Logical Server only.
- Accepted values: any integer, default
4096. - Max limit on blocks before the server starts chunking data before sending it to the client. Additionally, the maximum number of blocks there can be sent in a single blockstate chunk.
-Dmod.synchronisedblockstates.stateChunkingThreshold- Logical Server only.
- Accepted values: any integer, default
32768. - Max limit on blockstates before the server starts chunking data before sending it to the client.
Ченджлог
2.0.0+1.20.1Релиз1.20.1 · 10 октября 2025 г.
The 1.21.1 version's source code & project setup was a total mess, so I did an entire rewrite for 1.20.1 - this time doing it right.
Improvements:
- Massively reduced the encoded size of blockstates:
- Approximately an 8x reduction in size over the original 1.3.0 release for just vanilla states
- Approximately a 37x reduction over 1.3.0 in certain large modpacks (hard to test due to
1.20.1/1.21.1)
- Massively improved parsing and remapping times
- Measured 70x improvement over 1.3.0 on even very lightly modded modpacks
- Now properly handles:
- Properties that only exist on the client
- Properties that only exist on the server
- Property values that only exist on the client
- Property values that only exist on the server
I wrote version 2.0.0 in a way that should be easy to port to 1.21.1 again, and I already have ideas for further improvements and optimizations for a hypothetical 2.1.0 release.
Additionally, there are plans for a Forge/NeoForge release sometime in future if I ever get the time.
1.4.0-b1Бета1.21.1 · 13 августа 2025 г.
Changes (1.3.0 -> 1.4.0-b1):
- Massively reduced packet and file size by well ordering states
- Optimized encoding for chunked packets (approx 15x faster on large modpacks)
- Unchunked packets are still a W.I.P. and will be part of the 1.4.0 release
1.3.0Релиз1.21.1 · 1 июля 2025 г.
Initial Release
Комментарии
Загружаем…