NeoSync

 # NeoSync > **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**.   --- ## 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 - **[JEI](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. - **[Jade](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:** [iChun](https://github.com/iChun) — the original [Sync](https://github.com/iChun/Sync) mod. - **Fabric reimplementation:** [Kir_Antipov](https://github.com/Kir-Antipov/sync-fabric). - **NeoForge 1.21.1 port:** BreakinBlocks. Licensed under MIT. See the [LICENSE](https://github.com/breakinblocks/NeoSync/blob/main/LICENSE) file for details.