Regeneration Skins

RegenCraft comes with 43 Time Lord skins. When a regeneration completes, a different skin is picked at random and everyone on the server sees the change straight away.

Toggling Skin Changes

Skin changing is a per-player toggle:

• Preferences GUI — press [ and click "Change skin on regeneration: ON/OFF". Takes effect immediately.
• Command — /regeneration skinswap on / /regeneration skinswap off
• Check current setting — /regeneration skinswap (no argument)

When disabled, completing a regeneration leaves your current appearance — including your original Minecraft skin — completely untouched.

Arm Styles

The 43 bundled skins cover both slim (Alex-style) and default (Steve-style) arm models. The correct model is applied automatically — you don't need to do anything.

Custom skin support is planned — you'll eventually be able to pick which skins your regenerations cycle through rather than using the built-in pool. More info when it's closer to ready.

Preferences GUI

The Regeneration Preferences screen is opened with [ by default (remappable under Options → Controls → Regeneration). The screen will not open if another screen is already visible. The game does not pause while this screen is open — time continues, so close it promptly if you're in danger.

Layout

A compact settings panel that shows your current regeneration count at the top.

Controls

Keybinds

Both keybinds are remappable under Options → Controls → Regeneration Mod.

Items

All three items appear in the Regeneration creative tab.

Fob Watch

A permanent item that stores up to 12 regenerations. Right-click (CLOSED) to release stored regens into yourself and open the lid. Shift+right-click to deposit one regen back in. Snaps shut when full. Has a durability bar showing stored charges. Renders as a flat icon in inventory and on the ground; full 3D model when held; open-lid variant when the watch is open.

Regeneration Energy

A glowing vial of regeneration energy. Used as a crafting ingredient and can also be drunk. Drink two within a few seconds of each other to gain +1 regeneration cycle. Non-Time Lords get no effect. Always consumed on use.

TimeLord DNA

Rare loot found in TimeLord Refuge structure chests (30% chance). Crafting ingredient for Regeneration Energy. Features a 3D syringe model when held.

Fob Watch — 3D held model

TimeLord DNA — 3D held model

Steel & Raw Materials

A new tier of materials powers most of the mod's advanced crafting.

Raw Steel

Crafted from Raw Iron, Coal and Blaze Powder. Smelt in a blast furnace to get Steel Ingots. Can also be compressed into a Raw Steel Block (9×) or decompressed back.

Steel Ingot

The core material for almost every new recipe. Made by blast-furnace smelting Raw Steel. Can be stored as a Steel Block (9×).

Xylok Cluster

Mined from Xylok Geodes underground with a diamond or netherite pickaxe. Used to craft Mr Smith.

White Point Star

Mined from White Point Ore that generates in the world. Currently a crafting ingredient used in the Chronon Core recipe.

Circuits

Circuits are the building blocks of the mod's advanced items. They're crafted in a chain: Blank Circuit → specialist circuits → advanced items.

Blank Circuit

The base for all specialist circuits. Crafted from Steel Ingots, Green Terracotta, a Comparator and Gold Nuggets.

Interface Circuit

Used in the Fob Watch, Regen Chamber, and Mr Smith. Crafted from a Blank Circuit, Steel Ingots, Redstone, a Book & Quill and a Glass Pane.

Location Circuit

Used in Mr Smith. Crafted from a Blank Circuit, Steel Ingots, Iron Nuggets and Compasses.

Personality Circuit

Used in Mr Smith and the Regeneration Matrix. Crafted from a Blank Circuit, Steel Ingots, Iron Nuggets and Soul Sand.

Regeneration Circuit

Used in the Fob Watch and Regen Chamber. Crafted from a Blank Circuit, Steel Ingots, Blaze Powder and Regeneration Energy.

Advanced Components

Chronon Core

A White Point Star trapped in a steel accelerator. Used in the Fob Watch and Regeneration Matrix. Crafted from Steel Ingots, Blaze Powder and a White Point Star.

Regeneration Matrix

The core component for the Regeneration Chamber. Crafted from Steel Ingots, a Chronon Core and two Personality Circuits.

Drinking Regeneration Energy

Regeneration Energy has a hidden two-vial mechanic for Time Lords:

• First vial — drink animation plays, vial is consumed, nothing happens gameplay-wise. A follow-up window opens (default 5 seconds, configurable via energyVialFollowUpSeconds).
• Second vial within the window — grants +1 regeneration cycle (capped at your max of 12). The action bar confirms: "The second dose stabilises — +1 regeneration."
• Already at max regens — second vial is consumed with no extra effect: "Your regenerations are already at maximum."
• Window expired — treated as a fresh first drink; the window resets.
• Non-Time Lords — vial is consumed, nothing happens.

💡

Alternative to the Fob Watch

Two vials drunk quickly is the only way to restore a regeneration cycle without a Fob Watch charge. Useful mid-game if your watch is empty and you have spare vials from crafting.

Recipes

Regeneration Energy

Shapeless — place all three items anywhere in the crafting grid:

Raw Steel

Shaped — gives 4× Raw Steel:

Steel Ingot

Blast Furnace — smelt Raw Steel to get Steel Ingots (1 per Raw Steel).

Blank Circuit

Interface Circuit

Location Circuit

Personality Circuit

Regeneration Circuit

Chronon Core

Regeneration Matrix

Fob Watch

Shaped — the exact layout matters:

Structures

RegenCraft adds several structures to the world. Some are directly linked to the mod's progression, others are rare finds that reward exploration.

timelord_hut

Time Lord Refuge

A small hut generating rarely across most overworld surface biomes: plains, forests, taiga, desert, savanna, meadow, and more.

type40_mark1

Type 40 Mark 1

A TARDIS-style structure generating in the overworld. Contains a loot chest worth visiting even without DNA.

type40_mark9-10

Type 40 Mark 9-10

A later TARDIS variant. Generates alongside the Mark 1 using its own loot table.

Xylok Geode

A large geode structure that generates underground in the overworld, similar to Amethyst Geodes. The inside is lined with Block of Xylok and contains Xylok Clusters growing from the floor and walls. Mine the clusters with a diamond or netherite pickaxe to collect Xylok Cluster items, which are needed to craft Mr Smith.

Meteor

A rare surface structure consisting of a jagged pile of stone — the remnants of something that fell from above. Two variants exist. Meteors cannot be located by Mr Smith and can only be found through pure exploration.

Loot Tables

Each structure contains one chest. The Time Lord Refuge loot table:

Advancements

RegenCraft adds 22 advancements across two phases — the original regeneration milestones, and a new crafting progression chain.

Getting Started

Time Lord Refuge

"Find TimeLord DNA"

Obtain TimeLord DNA from a structure chest for the first time.

A Watch with a Secret

"Craft a Fob Watch"

Craft your first Fob Watch.

Someone's Not Taking Chances

"Craft a second Fob Watch"

Craft a second watch — likely to store or share regenerations.

Allons-y!

"Become a Time Lord"

Activate Time Lord status for the first time by opening a Fob Watch.

Milestones

New Face, Who Dis?

"Survive 3 regenerations"

Complete 3 full regeneration cycles.

Getting Through Them

"Survive 8 regenerations"

Complete 8 full cycles.

The Final Body

"Survive all 12 regenerations"

Use every last regeneration cycle.

Time Lords Don't Do Rules

"Regenerate more than 12 times"

Somehow exceed the standard 12-regeneration limit.

Crafting Progression

🏭

Age of Machines!

"Smelt Raw Steel using the blast furnace"

Your first Steel Ingot — the start of the new crafting chain.

The Power of The Doctor

"The power of regeneration, in the palm of your hand"

Craft your first Regeneration Circuit.

Interfacing Machinery

"Crafted the Interface Circuit"

Craft your first Interface Circuit.

Personality Loading...

"Crafted the Personality Circuit"

Craft your first Personality Circuit.

Location. Location. Location.

"Crafted the Location Circuit"

Craft your first Location Circuit.

Going Chronon

"Crafted the Chronon Core"

Craft your first Chronon Core.

Advancing Regeneration

"Crafted the Regeneration Matrix"

Craft the Regeneration Matrix.

Mr Smith I Need You!

"Crafted Mr Smith"

Craft Mr Smith for the first time.

The Chamber of Change

"Crafted the Regeneration Chamber"

Craft the Regeneration Chamber — your gateway to the Evolution skill tree.

⭐

the White Point Star

"Now the star is mine. I can increase the signal and use it as a lifeline."

Mine a White Point Star from White Point Ore for the first time.

The Story Continues

"Mined the Xylok Cluster"

Mine a Xylok Cluster from a Xylok Geode for the first time.

Challenges

Not Today

"Use every delay"

Use all 3 countdown extensions in a single Stage 1.

The Grace Period Expired

"Fell before the energy took hold"

Die during Stage 1 — environmental damage can still kill you while pending.

Regeneration Denied

"The new body never got a chance"

Die during Stage 2 while the active sequence is playing.

Commands

Root command: /regeneration  ·  Alias: /regen

Any Player

Admin Commands (Op Level 2)

Senior Admin Commands (Op Level 4)

Configuration

RegenCraft uses a per-world config file stored at <world folder>/regencraft.json. Each world or server save keeps its own settings. The file is created with defaults the first time a world loads. Changes via /regen config apply immediately without a restart and are saved to this file automatically.

Config Keys (regencraft.json)

Per-Player Settings

These are stored server-side per player in RegenerationData and are changed in-game, not via the config file.

Hardcoded Constants

One value is not yet configurable via the config file and requires recompiling to change:

For Developers

RegenCraft is open source under LGPL-3.0.

Architecture Overview

Key Extension Points

• New regen version — add to VERSIONS[] / DURATIONS_TICKS in RegenerationVersions.java, add .ogg, register sound event.
• Post-regen effects / traits — hook into RegenerationHelper.applyPostRegenEffects().
• Adjust Stage 1 timing — PENDING_SEGMENT_TICKS and PENDING_MAX_EXTENSIONS in RegenerationData.
• Custom HUD ring — replace PendingRegenOverlay; getPendingProgress(), getPendingTimer(), and getPendingExtensionsRemaining() are exposed.
• New structures — follow the timelord_hut pattern: structure_set + structure + template_pool + .nbt + loot table.
• Per-version visuals — branch on RegenerationData.getRegenerationVersion() for distinct particle colours, skin pools, or other effects.

Data Flow

Player takes fatal damage
   │
   ▼
ServerLivingEntityEvents.ALLOW_DEATH
   ├─ Not a Time Lord / 0 regens → Allow death (vanilla)
   └─ Time Lord + regens > 0 ──────────────────────────┐
                                                        ▼
                                          STAGE 1: PENDING
                                          data.startPending()
                                          applyImmediateRegenHealing()
                                          Cancel the death (return false)
                                          ┌─ countdown ticks (600 per segment)
                                          ├─ punch block → extend timer
                                          ├─ [=] key / trigger cmd → skip
                                          └─ timer reaches 0
                                                        │
                                                        ▼
                                          STAGE 2: ACTIVE
                                          data.tryRegenerate() → consumes 1 cycle
                                          lockMovement(durationTicks)
                                          playSound(version sound)
                                          camera → THIRD_PERSON_FRONT
                                          ┌─ particles scale with progress
                                          ├─ watchdog runs every tick
                                          └─ timer reaches durationTicks
                                                        │
                                                        ▼
                                          COMPLETE
                                          fullHeal() · unlockMovement()
                                          applyPostRegenEffects()
                                          if skinChangeEnabled → broadcastSkin()
                                          syncToClient()

Regeneration Quality

Every time a regeneration completes, a quality is rolled. Each quality carries lasting effects — on your max health, your flame colour, ongoing status effects, and more — that stay with you until your next regeneration.

Quality Types

⚪

Standard

62% chance

No change to health, no announcement. The regeneration just happens.

💚

Perfect

15% chance

+6 max health (3 extra hearts). Flame colour shifts slightly brighter. You receive a quiet personal message: "This regeneration feels perfect." While active, you carry a permanent Luck effect.

💔

Failed

20% chance

-2 max health (1 heart lost). Flame colour shifts duller. You receive a quiet personal message: "Something went wrong. This regeneration feels... off." While active, you carry a permanent Bad Luck effect.

Master

3% chance

No health change. A server-wide bold purple message broadcasts: "[Name] can hear the never ending drums." A dramatic sound plays for you privately. While this quality is active you carry the Madness effect — a ghostly semi-transparent figure named Koschei appears roughly 25 blocks away, visible only to you. It vanishes if you get too close, move too far, or look directly at its head. Every 5 minutes you are hit with Nausea and Strength simultaneously for 10 seconds.

How it interacts with Evolutions

Quality also affects how long Stage 2 lasts. A Perfect regeneration is 15% faster than normal. A Failed one takes 15% longer. These stack with any Biological evolution bonuses you have active.

Admin Override

Operators can force a specific quality for the next regeneration using /regen quality <standard|perfect|failed|master> (op level 2). The override is consumed on the next regen and does not persist to future ones.

Evolution System

The Evolution System is RegenCraft's progression tree. As a Time Lord you earn Evolution Points (EP) by levelling up in XP, then spend them inside the Regeneration Chamber on permanent upgrades for your next incarnation.

Earning Evolution Points

Every 4 XP levels you reach as a Time Lord grants 1 EP. The system tracks your highest ever XP level — spending XP on enchanting afterwards never takes EP back. You hold up to 150 EP at once (configurable). When you gain EP, you see a message in the action bar: "Your biodata grows more complex — +1 EP."

Opening the Skill Tree

You must be inside a Regeneration Chamber with both doors closed for at least 2 seconds. The GUI opens automatically once you're sealed in. Operators can also use /regen skilltree (op 4) to open it directly.

How Costs Work

Each evolution has a base EP cost. Every 3 evolutions you already own adds +1 EP to the cost of everything you haven't bought yet — so early picks stay cheap but filling out the whole tree is a real investment.

The Six Routes

All routes branch from The Watch Opens (free, no prerequisites — claim it first). Each route's first node requires it.

WIP Evolutions

Some evolutions show as WIP in the skill tree. They're visible so the tree looks complete, but cannot be unlocked normally — they're coming in a future update:

• Stable Regeneration — Resist regeneration going wrong (corruption system not yet built)
• Swift Renewal — Maximum regen speed tier (coming soon)
• Precognition — Sense danger before it strikes (needs special rendering work)
• Matrix Fabrication — Occasionally craft without using materials (needs a crafting hook)
• Trial by Fire — Fully at home in extreme heat (effect not matching name yet)

Removing Evolutions

You can remove evolutions you've already unlocked. In the skill tree GUI, double-click a node you own to remove it. Be aware of two things:

• Cascade removal — removing an evolution also removes anything that depended on it as a prerequisite, so the tree stays valid.
• No EP refund — spent EP is not returned when you remove an evolution.
• One-time reward nodes cannot be removed (to prevent farming the reward repeatedly).
• Removed evolutions still deactivate on your next regeneration, same as unlocking — the change takes effect when you next regenerate.

Admin Commands

Regeneration Chamber

The Regeneration Chamber is a craftable block that Time Lords use to access the Evolution skill tree. It's the only way for non-operator players to open the skill tree GUI.

How to Use It

1. Place the Regeneration Chamber in the world.
2. Right-click one of the doors to open it.
3. Walk inside so you're standing in the chamber.
4. Right-click the door again to close it. Both doors must be closed.
5. After 2 seconds the Skill Tree GUI opens automatically.
6. Shift-click to exit the chamber and close the GUI.

Recipe

Mr Smith

Mr Smith is a placeable block and interactive computer. You can ask him to locate any structure in the Minecraft world — vanilla or RegenCraft — and he will give you the exact coordinates.

Activating Mr Smith

1. Place Mr Smith in the world.
2. Stand within 3 blocks of him.
3. Type in chat: mr smith i need you
4. The chat message is swallowed by the mod — other players won't see it.
5. Mr Smith plays an animation and opens up.
6. Right-click the block to open the structure locator GUI.

Finding a Structure

The GUI shows a text field — type any structure name and press Tab to autocomplete, then click Apply. Mr Smith can locate any vanilla Minecraft or RegenCraft structure, searching within 100 chunks. He'll reply in chat with the exact coordinates.

Closing Mr Smith

Type mr smith close in chat (within 3 blocks) to close him. He also auto-closes if nobody is within range for more than 60 seconds — unless roleplay mode is enabled, in which case only the chat phrase closes him.

Recipe

Centennial Trophy

The Centennial Trophy is a decorative block automatically awarded to a player when they complete their 100th regeneration. It drops directly into their inventory — no admin involvement needed.

The trophy can be placed anywhere in the world. It requires a pickaxe to break and drop properly. It's purely decorative — it grants no gameplay effect when placed.