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.