Wiki
Fabric 1.20.1  ·  v1.0.0

Time Lord
Regeneration
for Minecraft

A Doctor Who-inspired regeneration system. Gain 12 regeneration cycles instead of dying permanently — with a tense countdown, spectacular particle effects, custom sounds, and an optional new appearance every time.

⚡ Fabric Mod ✦ MC 1.20.1 4 Public Regen Styles 43 Time Lord Skins LGPL-3.0
Mod at a Glance
Regen Regenerations 12 per watch
Styles Public styles 4
Skins Bundled skins 43
Stage 1 Stage 1 delay Up to 2 min
Structures Structures 3 types
Advancements Advancements 11
⚖️ License LGPL-3.0

What is RegenCraft?

RegenCraft adds a fully-featured Time Lord regeneration system to Minecraft. Instead of dying permanently, eligible players enter a two-stage regeneration sequence — first a tense countdown where you can still act and choose to delay, then a spectacular particle-and-sound sequence that heals you completely and optionally transforms your appearance.

Fob Watch

Fob Watch

Craft the Fob Watch to awaken your Time Lord nature and gain 12 regeneration cycles.

🔄

Two-Stage Regen

A 30-second countdown lets you move freely and delay up to 3 times (2-minute max) before the active sequence locks in.

Regen Versions

4 Regeneration Styles

Pick from 4 different regeneration styles, each with its own sound and length. More styles are coming.

World Structures

World Structures

Discover Time Lord Refuges and TARDIS structures scattered across most overworld biomes.

Requirements

DependencyVersionPurpose
Minecraft1.20.1Target version
Fabric Loader≥ 0.14.22Mod loader
Fabric API0.92.6+1.20.1Events, networking, registries
GeckoLib4.8.33D item model animations
Java≥ 17Required language version

Where to download

RegenCraft can be found on Modrinth and CurseForge.

Installation

RegenCraft is a Fabric mod for Minecraft 1.20.1. Follow these steps to get it running.

1 — Install Fabric

Download the Fabric Installer from fabricmc.net. Run it and select Minecraft 1.20.1 with Fabric Loader 0.14.22 or higher. Then launch the game once to generate the mods folder.

2 — Install required libraries

Place both files in your .minecraft/mods folder:

3 — Install RegenCraft

Download regeneration-1.0.0.jar from the mod page and place it in your .minecraft/mods folder alongside the libraries above.

4 — Launch

Open the Minecraft Launcher, select the Fabric 1.20.1 profile, and click Play. RegenCraft will load automatically.

💡
Multiplayer servers

GeckoLib, Fabric API, and RegenCraft are required on both the server and every client.

Becoming a Time Lord

To use the regeneration system, you must awaken your Time Lord nature using a Fob Watch. The watch is crafted from rare ingredients found in world structures — see Recipes.

The Fob Watch

The Fob Watch is a permanent item — it is never consumed or destroyed. It has two visual states (CLOSED and OPEN) and a durability bar that shows how many regenerations are currently stored inside (0–12). The bar colour shifts from dark red → orange → gold as it fills.

Fob Watch Closed

Closed

Regenerations are sealed inside. Right-click to release them into yourself and flip the watch open.

Fob Watch Open

Open

Regens have been released. Shift+right-click to deposit regens back in. The watch snaps closed automatically when all 12 are stored again.

Right-click — Releasing Regenerations

Hold the Fob Watch and right-click:

  • Watch is CLOSED with charges stored — the watch opens, releasing all stored regens into you. If you are not yet a Time Lord, you are awakened as one. If already a Time Lord, your count is topped up (capped at your max). Watch flips to the open-lid model.
  • Watch is OPEN with charges stored — releases those charges back to you (useful if you deposited regens during a grace period and want them back).
  • Watch is OPEN and empty — nothing to release; you get a reminder to shift+right-click to deposit.
  • Already at max regens — nothing to top up; the watch stays closed and shows a "cycle already full" message.
💡
The watch stays in your inventory

A freshly crafted Fob Watch starts CLOSED with 12 charges. Opening it releases those regens into you and flips the lid open. You keep the watch — fill it back up by depositing regens, then pass it to another player or open it yourself later.

Shift + Right-click — Depositing a Regeneration

Shift + right-click while holding a Fob Watch to move one regeneration from yourself into the watch:

  • You must be a Time Lord with at least 1 regeneration remaining.
  • During the grace period, you must have more than 1 regen — you cannot deposit your last one while the timer is active.
  • Each deposit increments the watch's stored count by 1 and is shown in the tooltip and durability bar.
  • When stored charges reach 12, the watch snaps shut automatically.
  • You remain a Time Lord even with 0 regens in your body, as long as the watch is holding them.
  • The watch can be given to any player — they can right-click it to receive the stored regenerations.

Checking Your Status

Run /regeneration info for a full state dump: Time Lord status, regen count, current sequence stage, flame colour, current skin, skin-change setting, and regeneration version.

Regeneration Stages

When you take fatal damage as a Time Lord, death is intercepted and you enter a two-stage sequence. You can also trigger it voluntarily at any time.

Stage 1
Pending Regeneration
  • Free to move, fight, build
  • Player damage reduced by 20%
  • Environmental damage still applies
  • 30s countdown HUD ring (no action bar)
  • Empty-hand punch a new block → +30s (up to 3×)
  • Max total delay: 2 minutes
  • No cycle consumed yet
timer ends
or triggered
Stage 2
Active Regeneration
  • 1 cycle consumed
  • Fully invulnerable & frozen
  • Particles scale with progress
  • Chosen sound plays in full
  • Camera auto-switches to front
  • Full heal on completion

Stage 1 — Pending Regeneration

You enter Stage 1 the moment fatal damage is intercepted, or immediately when you press =. You are free to move, fight, and build during this stage — movement is only locked once Stage 2 begins.

  • A countdown ring (radius 14 px, drawn near the top-centre of the screen at y=28) appears via PendingRegenOverlay. The ring colour changes based on how much of the current segment has elapsed: green (0–50% elapsed) → yellow (50–80%) → red (80–100%). The remaining whole seconds are shown in the centre in gold, turning red when 5 or fewer seconds remain.
  • Below the ring, a hint text reads "Punch the ground to delay (N left)" while extensions remain, or "Regeneration is inevitable..." when all extensions are used up. There is no action bar message — the HUD ring is the sole indicator.
  • A hand glow sound plays once at the start of the pending stage.
  • A critical stage warning sound plays when there are 5 seconds or fewer left on the current countdown segment, giving you a heads-up before Stage 2 locks in. It resets and can play again each time you extend the timer.
  • Subtle particles trickle around you every few ticks (only for the default regeneration version).
  • Punching the ground — left-clicking a block with an empty hand on a block you haven't punched before — adds 30 seconds to the countdown. You can do this up to 3 times (configurable), for a maximum of 2 minutes total (30s base + 3 × 30s). Clicking the same block again counts as normal mining, not a delay punch. Holding any item makes left-click behave as normal mining with no delay granted.
  • Press = again while pending to skip the rest of the countdown and begin Stage 2 immediately.
  • An operator can run /regeneration trigger <player> to force Stage 2 to begin.
⚠️
You are not fully invulnerable in Stage 1

Damage from other players is reduced by 20% (you take 80% of incoming player damage). However, all environmental damage — mobs, fall damage, fire, explosions — passes through completely unmodified. If you die during Stage 1, the sequence is cancelled, no regeneration cycle is consumed, and the normal death proceeds.

📌
No cycle consumed in Stage 1

A regeneration cycle is only consumed when Stage 2 begins. If you die during Stage 1 (from mobs, fall damage, etc.) your regen count is untouched.

Stage 2 — Active Regeneration

One cycle is consumed and the full sequence begins:

  • Duration matches the exact length of your chosen regeneration sound (11–54 seconds depending on version).
  • Camera auto-switches to third-person front view.
  • You are frozen in place and fully invulnerable for the entire sequence.
  • Glowing particles in your chosen flame colour swirl around you, intensifying toward the end with a final burst.
  • Action bar shows: "Regenerating… X regenerations remaining", refreshed every second.

On completion

  • You are fully healed, fed, and re-oxygenated. Any fire is extinguished.
  • Movement and normal camera perspective are restored.
  • You receive Regeneration II and Fire Resistance for a short time.
  • Action bar: "Regeneration complete. X remaining" — or "This is your final body." if you're out.
  • A 3-minute grace period begins (configurable via gracePeriodSeconds). During this window you cannot voluntarily trigger Stage 1 with =, and if you take fatal damage you die normally — Stage 1 does not activate.
📌
Skin change happens mid-sequence, not at the end

If skin changing is enabled, the new skin is applied at the halfway point of Stage 2 (when particles are ramping up), not when the sequence finishes. For the watcher version specifically, the change is delayed to tick 260 (≈13 s) to coincide with the Watcher entity merging with the player.

🛡️
Safety watchdog

A tick-based watchdog monitors Stage 2. If the sequence timer ever exceeds its target duration without completing, it is force-completed — you can never get permanently stuck.

Running Out of Regenerations

Once all 12 regenerations are used, the next fatal hit kills you normally. Neither stage triggers. After your last regen the action bar will read "This is your final body."

Regeneration Versions

RegenCraft has 4 public regeneration styles available to all players. Each has its own sound effect and the Stage 2 duration is automatically tied to the audio length — the sequence ends exactly when the track finishes.

📌
WIP versions are dev-only

Seven more styles (regen_1 through regen_7) are in the works but not yet public — they won't show up in your GUI or commands.

Public Versions

Each version has a distinct sound and visual energy. Here are screenshots of each public style in action:

default — ~54s

default regeneration version

watcher — ~17s

watcher regeneration version

regen_0 — ~16s

regen_0 regeneration version

troughton — ~12s

troughton regeneration version
default~54.1 s
regen_0~16.1 s
troughton~12.2 s
watcher~17.2 s
📌
Names are temporary

Version IDs are based on sound file names for now. Proper Doctor Who-style names are planned for a future update.

Changing Your Version

  • Preferences GUI — press [ and use the < / > arrows next to the version name.
  • Command/regeneration version <name>

New Time Lords start on default (~54 seconds). The GUI and command only show versions you have access to.

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:

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.

Regeneration Preferences GUI screenshot

Controls

ControlWhat it does
R / G / B slidersSet your regeneration flame colour (0–255 each). Labels read "R: X", "G: X", "B: X". A live colour preview swatch (40×40 px) and its hex code update in real time to the right of the sliders.
Preset colour buttonsFive one-click presets: Orange, Blue, Green, Red, Gold. Click one to instantly set all three sliders.
Skin Change toggle"Skin Change: ON" / "Skin Change: OFF" — click to flip. Sends a packet to the server immediately; no need to press Apply.
< / > arrowsCycle through available regeneration versions. The current version's display name is shown between the arrows. WIP versions are automatically skipped for public players. Sends a packet to the server immediately on each click.
ApplySaves your current R/G/B slider values as your flame colour (sends a C2S packet) and closes the screen. The skin-change toggle and version are already saved live, so Apply only affects the colour.
📌
Custom colours coming soon

Currently 5 preset colours are available: Orange, Blue, Green, Red, and Gold. Full custom hex code support is planned for a future update — for now, use the R/G/B sliders to dial in any colour you want.

⚠️
Singleplayer vs Multiplayer

In singleplayer, the game pauses while this screen is open — animation, sound, and effects all stop. In multiplayer, the game does not pause and the world continues running.

Keybinds

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

Default keyAction
[ Open the Regeneration Preferences GUI.
= Voluntarily start Stage 1. Press again while pending to skip straight to Stage 2.

Items

All three items appear in the Regeneration creative tab.

Fob Watch

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

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

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

Fob Watch 3D model

TimeLord DNA — 3D held model

TimeLord DNA syringe 3D model

Drinking Regeneration Energy

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

💡
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:

Ghast Tear
TimeLord DNA
Glass Bottle
  • 🧬 1× TimeLord DNA
  • 💧 1× Ghast Tear
  • 🫙 1× Glass Bottle
  • → 1× Regeneration Energy
Regeneration Energy crafting recipe

Fob Watch

Shaped recipe — the exact layout matters:

Iron Ingot
Dragon Breath
Iron Ingot
Regen Energy
Clock
Regen Energy
Iron Ingot
Dragon Breath
Iron Ingot
  • ⚙️ 4× Iron Ingot
  • 🌬️ 2× Dragon Breath
  • 2× Regeneration Energy
  • 🕐 1× Clock
  • → 1× Fob Watch
Fob Watch crafting recipe
⚠️
Intentionally difficult to craft

Two Regeneration Energy vials (each needing TimeLord DNA — 30% loot from structures) plus Dragon Breath make this a late-game recipe. The watch itself is permanent and never consumed, so one crafted watch serves you indefinitely.

Structures

Three structures generate in the overworld. Explore them to find the materials needed to become a Time Lord.

Time Lord Refuge exterior
timelord_hut
Time Lord Refuge
A small hut generating rarely across most overworld surface biomes: plains, forests, taiga, desert, savanna, meadow, and more.
Type 40 Mark 1
type40_mark1
Type 40 Mark 1
A TARDIS-style structure generating in the overworld. Contains a loot chest worth visiting even without DNA.
Type 40 Mark 9-10
type40_mark9-10
Type 40 Mark 9-10
A later TARDIS variant. Generates alongside the Mark 1 using its own loot table.
📌
More structures coming

Additional structures are planned for future updates. Check back here as the mod grows.

Loot Tables

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

PoolDropChance / Quantity
PrimaryTimeLord DNA30% (configurable via dnaLootChancePercent)
PrimaryGold Ingots75%, 1–4 ingots
Bonus (2–4 rolls)Clock, Glass Bottle, Ghast TearVaries
Bonus (2–4 rolls)Emerald, Iron Ingot, Redstone, BreadVaries
Bonus (2–4 rolls)Enchanted BookVaries
💡
Always worth visiting

Even if you don't get DNA (70% of the time you won't), the bonus loot pool ensures every hut yields useful vanilla items. Keep exploring — most players need 3–5 huts before crafting a watch.

Advancements

RegenCraft adds 11 advancements, all visible in the Advancements screen under the Regeneration tab.

Getting Started
TimeLord DNA
Time Lord Refuge
"Find TimeLord DNA"
Obtain TimeLord DNA from a structure chest for the first time.
Fob Watch
A Watch with a Secret
"Craft a Fob Watch"
Craft your first Fob Watch.
Fob Watch
Someone's Not Taking Chances
"Craft a second Fob Watch"
Craft a second watch — likely to store or share regenerations.
Fob Watch Open
Allons-y!
"Become a Time Lord"
Activate Time Lord status for the first time by opening a Fob Watch.
Milestones
Regen Version
New Face, Who Dis?
"Survive 3 regenerations"
Complete 3 full regeneration cycles.
Regen Version
Getting Through Them
"Survive 8 regenerations"
Complete 8 full cycles.
Regen Version
The Final Body
"Survive all 12 regenerations"
Use every last regeneration cycle.
Regen Energy
Time Lords Don't Do Rules
"Regenerate more than 12 times"
Somehow exceed the standard 12-regeneration limit.
Challenges
Delay
Not Today
"Use every delay"
Use all 3 countdown extensions in a single Stage 1.
Regen Version
The Grace Period Expired
"Fell before the energy took hold"
Die during Stage 1 — environmental damage can still kill you while pending.
Regen Version
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

No permission required
/regeneration info [player]Full status dump: Time Lord status, regen count, current stage, flame colour, skin index, skin-swap setting, version.
/regeneration versionShows your current regeneration version ID.
/regeneration version <name>Sets your regeneration version. Only versions accessible to your account are accepted (public players can only set public versions).
/regeneration skinswapShows whether skin-swap is ON or OFF for you.
/regeneration skinswap on|offEnable or disable skin changing on regeneration.
/regeneration skinresetResets your appearance back to your original Minecraft skin, clearing any Time Lord skin currently applied.
/regeneration flamecolor <r> <g> <b>Set your particle colour by RGB (0–255 each).
/regeneration flamecolor <preset>Named presets: orange, blue, green, purple, white, red, gold, reset.

Admin Commands (Op Level 2)

Op Level 2
/regeneration add <player> <n>If not a Time Lord: activates them with <n> regenerations. If already a Time Lord: adds <n> to their current count (capped at max).
/regeneration set <player> <n>Sets regeneration count directly to <n> (0–12). Also sets timelord=true if n > 0.
/regeneration reset <player>Strips Time Lord status entirely, sets regen count to 0, and restores the player's original skin.

Senior Admin Commands (Op Level 4)

Op Level 4
/regeneration trigger <player>If the player is pending (Stage 1): cancels the countdown and begins Stage 2 immediately. Otherwise starts an active regeneration sequence directly, consuming one cycle.
/regeneration skipInstantly ends your current regeneration or pending countdown. The cycle is still consumed, skin still changes, but animation and audio are cut immediately.
/regeneration bypass <on|off>Enables or disables the grace period for yourself. on clears the current timer and lets you voluntarily regenerate again immediately. off re-enables the grace period.
/regeneration configDisplays all current config values for this world (grace period, max regens, extensions, particle density, etc.).
/regeneration config <key> <value>Sets a config value and saves it immediately — no server restart needed. See the Configuration page for all valid keys.

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.

💡
Live config changes

Use /regen config <key> <value> (op level 4) to change any value while the server is running. No restart needed. Run /regen config with no arguments to see all current values.

Config Keys (regencraft.json)

KeyDefaultEffect
gracePeriodSeconds180 (3 min)Seconds a player must wait after completing a regeneration before they can voluntarily trigger another with =. Death-triggered regens are unaffected.
maxRegenerations12Maximum regenerations a Time Lord can hold. The Fob Watch tops up to this value.
maxPendingExtensions3How many times a player can empty-hand punch a block to extend the Stage 1 countdown by 30s.
particleDensity1.0Multiplier applied to all regeneration particle counts. Set lower to reduce visual intensity on busy servers.
fobWatchRecipeEnabledtrueIf set to false, the Fob Watch crafting recipe is disabled. Useful if you want to gate Time Lord status through admin commands only.
soundVolumeMultiplier1.0Multiplier applied to all regeneration sound volumes.
dnaLootChancePercent30Percent chance (0–100) for TimeLord DNA to appear in a Time Lord Refuge chest.
energyVialFollowUpSeconds5.0Seconds allowed between drinking two Regeneration Energy vials to trigger a bonus effect.

Per-Player Settings

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

SettingChange viaDefault
Flame colour (R/G/B)Preferences GUI or /regeneration flamecolorOrange (#FF8000)
Skin change on regenPreferences GUI or /regeneration skinswapON
Regeneration versionPreferences GUI or /regeneration versiondefault (~54s)

Hardcoded Constants

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

ConstantValueLocation
PENDING_SEGMENT_TICKS600 ticks (30 s)RegenerationData.java — length of each Stage 1 countdown segment including extensions.

For Developers

RegenCraft is open source under LGPL-3.0.

Architecture Overview

PackageResponsibility
component/Core data model (RegenerationData) and in-memory per-player store.
event/Death interception → Stage 1 countdown → Stage 2 sequence, particles, skin change.
network/S2C state sync, S2C skin broadcast, C2S flame colour / skin-swap / version packets.
regen/Ordered list of 11 version IDs, tick durations, display names, next/previous helpers.
item/Fob Watch, Regeneration Energy, TimeLord DNA, item registry, creative tab.
command/Full /regeneration command tree.
client/Keybinds, packet handlers, HUD overlay, animation controller, renderers.
skin/Pool of 43 Time Lord skins, random-index picker (always picks a different one).
world/Anchor for datapack-driven worldgen (3 structures).
mixin/Death hook, player render hooks, skin override, title-screen logo.

Key Extension Points

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()
On this page