One mind. Many bodies.
NeoSync brings the legendary Sync experience to NeoForge 1.21.1.
Grow extra bodies, or shells, each with its own inventory, experience level, and gamemode. Swap your consciousness between them at will. Die in a shell? You wake up in another. Leave one parked in the Nether while you mine the Overworld. Keep a spare set of enchanted gear loaded in a shell halfway across the server. The possibilities are yours.
Craft a Shell Constructor and place it down.
Provide a genetic sample — right-click with an empty hand.
> ⚠️ With default config this costs 20 HP (40 in hardcore). Hold a totem, eat a golden apple, or flip warnPlayerInsteadOfKilling in the config if you'd rather not die
for science.
Power the Constructor. Place a Treadmill next to it, lure a pig or wolf onto the front block, and piggawatts flow. Or hook it up to any Forge Energy source from your favourite tech mod.
Craft a Shell Storage, place it, and feed it redstone or FE.
Walk into an open Shell Storage and a radial shell menu appears — pick your destination body and sync.
NATURAL, NEAREST, or dye-color-matched shell of your choice.| Block / Item | Purpose |
|---|---|
| Shell Constructor | Consumes FE to grow a new shell from your genetic sample. |
| Shell Storage | Houses a shell; walking in opens the radial selector. Needs power to keep the shell alive. |
| Treadmill | Two-block structure. Lure an animal on; it walks; FE flows. |
| Sync Core | Key crafting ingredient — combine with gray concrete to make either shell container. |
JEI — in-depth info panels on every sync block explaining the workflow, plus a Treadmill Energy Sources category listing every supported entity and its FE/tick output.
Jade — crosshair tooltips for Shell Constructors, Storages, and Treadmills showing owner, build progress, color, powered state, and energy.
Both are optional. NeoSync runs fine without them.
Everything is tunable in config/neosync-common.toml. A taste of the knobs:
| Key | Default | Effect |
|---|---|---|
enableInstantShellConstruction |
false |
Instant shell builds in creative. |
warnPlayerInsteadOfKilling |
false |
Don't kill low-HP players on fingerstick. |
fingerstickDamage / hardcoreFingerstickDamage |
20 / 40 |
HP consumed per shell sample. |
shellConstructorCapacity |
256000 |
FE needed to finish a shell. |
shellStorageCapacity / shellStorageConsumption |
320 / 16 |
FE buffer + per-tick drain to keep a shell alive. |
shellStorageAcceptsRedstone |
true |
Accept raw redstone signal as power. |
shellStorageMaxUnpoweredLifespan |
20 |
Ticks a storage holds a shell without power. |
energyMap |
chicken=2, pig=16, player=20, wolf=22, villager=25, creeper=80, enderman=160 | FE/tick each entity generates on a treadmill. |
syncPriority |
NATURAL |
On-death auto-sync target: NATURAL, NEAREST, or any dye color. |
wrench |
minecraft:stick |
Item that toggles a container's comparator output. |
Original concept: iChun — the original Sync mod.
Fabric reimplementation: Kir_Antipov.
NeoForge 1.21.1 port: BreakinBlocks.
Licensed under MIT. See the LICENSE file for details.
