BackToBed!

Features

Recipe

• 1 Ender Pearl + 1 Bed (any color) + 1 Paper
• Shapeless recipe — any arrangement works

Use it to get home

• Right-click to teleport back to your bed
• Consumed on use, non-stackable
• Works across dimensions (Nether/End → Overworld)

Balance-it-yourself (BIY) Health-based delay system

• Full health = instant teleport
• Injured = countdown timer based on missing HP
• Half health = ~5 second delay with rising bell chime
• Nearby players can hear the countdown
• Heal to full during countdown to skip the wait
• Move more than 1 block to cancel (scroll is preserved)

Server-side only

• Players don't need to install anything
• Vanilla clients see the scroll as enchanted paper
• Powered by Polymer

Fully configurable

• Health delay mode: linear, exponential, or disabled
• Optional fixed delay on top of health delay
• "Full health only" mode for hardcore servers
• Customizable countdown sound and volume
• Config file: config/bed-recall-scroll.json

---

Configuration

A config file is created automatically at config/bed-recall-scroll.json:

Setting	Default	Description
healthMode	"linear"	"none", "linear", "exponential"
maxDelaySeconds	10.0	Maximum delay at 1 HP
fixedDelaySeconds	0.0	Extra flat delay added to every teleport
requireFullHealth	false	If true, scroll only works at full HP
countdownSound	"block.note_block.bell"	Sound during countdown
countdownVolume	0.6	Volume (0.0–1.0)
cancelFallDamage	true	Cancel fall damage on arrival

Suggested Configurations

Style	Settings	Effect
Casual	healthMode: "none"	Instant teleport always
Balanced	healthMode: "linear" (default)	Delay scales with missing HP
Challenging	healthMode: "exponential", fixedDelaySeconds: 2	Steep curve + 2s base
Hardcore	requireFullHealth: true	Only works at 20 HP

---

How the Delay Works

Linear: delay = (missingHP / 20) × maxDelay Exponential: delay = (missingHP / 20)² × maxDelay

During the countdown:

• A rising-pitch bell sounds at halving intervals
• Action bar shows remaining time
• Move >1 block → cancelled, scroll preserved
• Heal to full → instant teleport

---

Compatibility

Minecraft	JAR	Polymer
1.20.1 – 1.20.4	mc1.20.1	0.5.19
1.21 – 1.21.x	mc1.21	0.9.19
26.1 – 26.1.1	mc26.1	0.16.0

Requires: Fabric Loader and Fabric API

---

Installation

1. Install Fabric Loader on your server
2. Install Fabric API
3. Drop the correct JAR for your Minecraft version into mods/
4. Start the server — config is created automatically
5. No client mod needed — vanilla clients connect normally

---

Credits

Built with Fabric and Polymer.