NeoSync

!(https://raw.githubusercontent.com/breakinblocks/NeoSync/main/media/logo.png)

> 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.

## How it works

1. Craft a Shell Constructor and place it down. 2. 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. 3. 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. 4. Craft a Shell Storage, place it, and feed it redstone or FE. 5. Walk into an open Shell Storage and a radial shell menu appears — pick your destination body and sync.

!(https://raw.githubusercontent.com/breakinblocks/NeoSync/main/media/shell_constructor-showcase.png)

!(https://raw.githubusercontent.com/breakinblocks/NeoSync/main/media/menu-showcase.png)

## Features

• Cross-dimensional syncing. Park shells in the Overworld, Nether, End, or any modded dimension and sync between them instantly.
• - Per-shell inventory, XP, and gamemode. Each shell is a fully independent body with its own loadout and progression.
• - Death handoff. If a shell dies, you auto-sync back to your original body or to a random remaining shell if the original is gone. Shell deaths don't count toward your
• death counter.
• - Automation support. Pipe armor and tools into a Shell Storage to equip the parked shell, or pull gear back out.
• - Dye your storages. Right-click a Shell Storage with dye to color-code it makes spotting "the mining shell" across a dozen containers easier.
• - Configurable sync priority. On death, auto-sync to the `NATURAL`, `NEAREST`, or dye-color-matched shell of your choice.
• - Flexible power. Shell Storages accept raw redstone signal and/or FE. Treadmills output FE to any energy-accepting block.
• - Comparator output. Containers emit signal based on either build progress or inventory fullness — right-click with a wrench (stick by default) to toggle.

## Blocks & Items

| 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. |

## Mod Integration

• *(https://www.curseforge.com/minecraft/mc-mods/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.
• - (https://www.curseforge.com/minecraft/mc-mods/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.

## Configuration

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. |

## Credits & License

- Original concept:* (https://github.com/iChun) — the original (https://github.com/iChun/Sync) mo