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
- Install Fabric Loader on your server
- Install Fabric API
- Drop the correct JAR for your Minecraft version into
mods/ - Start the server — config is created automatically
- No client mod needed — vanilla clients connect normally
