Create Progressive Assembly (Sable)

BETA. This mod is still being tested. It has been tested on one server so far. Earlier versions lost one attached block (a redstone link) per assembly; 0.15.3 fixes the cause we found, but that fix has only been tested once. Extremely large ships (around 190,000 blocks) failed to assemble before 0.15 and have not been retested. Back up your world before using it on a server that matters.

What it does

Assembling a big ship with Sable / Create Aeronautics moves every block in a single server tick, which freezes the server for everyone. Assemblage Progressif ("progressive assembly") spreads that work over several ticks so the server keeps running while the ship is being built.

• Ships above a block threshold (500 by default) are assembled in batches (200 blocks per tick by default). Smaller ships are assembled the normal way.
• The glued-block search that runs when the Physics Assembler is activated is faster.
• The ship is built far up in the sky and brought back to its place at the end, so it does not collide with the terrain while it is incomplete.
• Players standing in the ship area are held in place during the assembly.
• Progress is shown to nearby players (boss bar and action bar).
• Disassembly is lighter too: the bounds of each ship part are recomputed once instead of once per block.
• Only one ship is assembled at a time; the others wait their turn.
• Ships larger than the loaded area are assembled whole: the mod loads the chunks around the ship, then re-triggers the Physics Assembler by itself (glue is an entity and is not loaded outside the view distance, so the search used to stop there silently).
• Extended range: a ship stays loaded as long as any part of it is within simulation distance of a player, instead of vanishing as soon as one of its chunks leaves it. Idea from "Sable: Far and Wide" by BlockCrafterJ (MIT), rewritten for Sable 2.0. The chunks under such a ship stay loaded, which costs some server load.

On our test server, ships of 34,000 to 36,000 blocks were assembled with a worst tick of about 25 ms. The first batch can still be longer (158 ms measured once).

Requirements

• Minecraft 1.21.1, NeoForge
• Sable 2.0 or newer (tested with 2.0.5)
• Create Aeronautics / Simulated is optional (tested with Simulated 1.3.2)
• Server-side only: players do not need to install it.

Commands (operators, permission level 2)

• /assemblage info: current settings and state
• /assemblage blocs <number>: blocks moved per tick
• /assemblage intervalle <ticks>: ticks between two batches
• /assemblage ecart <true|false>: build the ship away in the sky
• /assemblage figer <true|false>: hold players in place during assembly
• /assemblage portee <true|false>: extended range for ships
• /assemblage zone <true|false>: load the area around the ship before assembling
• /assemblage nettoyer: remove empty leftover sub-levels

Configuration

config/assemblage_progressif.properties, created on first start. Every option is explained in the file. The option names, the comments and the in-game messages are in French for now.

This is an unofficial add-on. It is not affiliated with the authors of Sable or Create Aeronautics.

En français

BÊTA. Le mod est encore en test. Il n'a tourné que sur un seul serveur. Les versions précédentes perdaient un bloc accroché (un redstone link) à chaque assemblage ; la 0.15.3 corrige la cause trouvée, mais ce correctif n'a été testé qu'une fois. Les vaisseaux vraiment énormes (environ 190 000 blocs) ne s'assemblaient pas avant la 0.15 et n'ont pas été retestés. Faites une sauvegarde de votre monde avant de l'utiliser sur un serveur important.

Assembler un gros vaisseau avec Sable / Create Aeronautics déplace tous les blocs en un seul tick, ce qui fige le serveur pour tout le monde. Assemblage Progressif étale ce travail sur plusieurs ticks : le serveur continue de tourner pendant que le vaisseau se construit.

• Au-dessus d'un seuil (500 blocs par défaut), l'assemblage se fait par lots (200 blocs par tick par défaut). Les petits vaisseaux s'assemblent normalement.
• La recherche des blocs collés à l'actionnement du Physics Assembler est plus rapide.
• Le vaisseau se construit très haut dans le ciel puis revient à sa place à la fin, pour éviter les collisions avec le décor.
• Les joueurs dans la zone du vaisseau sont immobilisés pendant l'assemblage.
• La progression est affichée aux joueurs proches (barre de boss et barre d'action).
• Le désassemblage est allégé lui aussi.
• Un seul vaisseau s'assemble à la fois, les autres attendent.
• Les vaisseaux plus grands que la zone chargée s'assemblent en entier : le mod charge les chunks autour du vaisseau puis relance l'assembleur tout seul.
• Portée étendue : un vaisseau reste chargé tant qu'une partie de lui est à distance de simulation d'un joueur. Idée reprise de « Sable: Far and Wide » de BlockCrafterJ (MIT), refaite pour Sable 2.0.

Côté serveur uniquement : les joueurs n'ont rien à installer. Il faut Minecraft 1.21.1, NeoForge et Sable 2.0 ou plus récent. Les réglages sont dans config/assemblage_progressif.properties et se changent aussi en jeu avec /assemblage (opérateurs).

Mod non officiel, sans lien avec les auteurs de Sable ou de Create Aeronautics.