Skip to main content

Well Rested

info

Well Rested provides bonuses to speed, strength, and block mining speed, increases the player's HP, and also adds gradual health regeneration. The effect of the additional health and regeneration doesn't diminish over time, unlike other buffs.

The Well Rested level depends on the comfort of the sleeping area.

After waking up, the player receives the Rested effect. The effect has up to 5 levels — higher levels increase strength and duration.

Each level progresses through three phases, gradually weakening over time:

PhaseStrength
Phase 1Strongest
Phase 2Medium
Phase 3Weakest
tip

Higher Rested levels are always stronger overall. For example, Phase 3 of Level 5 is still stronger than Phase 1 of Level 1.

If a player goes to bed with the Well Rested buff, they will only receive a new buff upon waking if it is stronger than the buff they already have. For example, if a player currently has Well Rested at level 4, sleeping in a location that only provides Well Rested at level 1 will keep their level 4 buff. However, if the current buff is stronger but is about to expire, the player will receive a new one, even if it is weaker.

HUD​

While the effect is active, a small bar shows the remaining time, and a numeral shows the level. The whole HUD fades in and out during the last ten seconds, so you can tell the effect is about to run out without watching the bar.

You can hide it completely:

"ui": {
  "hideWellRestedHud": true
}

The HUD has three positions, chosen with wellRestedHudPosition inside ui:

Bottom left corner. This is the default.

"wellRestedHudPosition": "left"

Well Rested in the bottom left corner

note

An unknown value falls back to left, and the corrected value is written back to the config file.

Config​

The whole system can be switched off with a single flag:

"wellRested": {
  "enabled": true
}

With enabled: false no effect is ever granted — sleeping still shows the overlay and the summary, players just wake up without buffs.

In the config, the following fields are responsible for the strength of the effects:

"level5": {
"durationMinutes": 15,
"speedPhase1": 0.25,
"speedPhase2": 0.15,
"speedPhase3": 0.08,
"strengthPhase1": 1.5,
"strengthPhase2": 1.0,
"strengthPhase3": 0.5,
"hastePhase1": 0.25,
"hastePhase2": 0.14,
"hastePhase3": 0.07,
"attackSpeedPhase1": 0.07,
"attackSpeedPhase2": 0.04,
"attackSpeedPhase3": 0.02,
"healthBonus": 10.0,
"regenBonus": 0.05
}
warning

The haste parameter does not exist in version 1.20.1. Minecraft itself does not provide this parameter prior to version 1.21

The strength of each buff can be adjusted for any effect level and any phase. durationMinutes indicates the total duration of the effect for the specified level.

speed, haste and attackSpeed are multipliers added to the player's base stat. For example, base movement speed is 1 — receiving speedPhase1: 0.25 makes it 1.25.

strength works differently: it is flat attack damage, exactly like the Strength potion. strengthPhase1: 1.5 adds 1.5 damage to every hit, no matter which weapon is held.

All of these stack with potions.

Regeneration​

regenBonus restores the player's health every 5 seconds. The amount of healing is calculated as a percentage of the player's maximum health:

heal = maxHealth × regenBonus × 0.5

For example, with 20 HP (10 hearts) and regenBonus = 0.05 — restores 0.5 HP every 5 seconds.

note

Regeneration and health increase remain the same regardless of the current phase of the effect.

Granting it manually​

Operators can hand out or remove the effect without anyone sleeping:

/midnightthoughts wellrested grant @a 5
/midnightthoughts wellrested clear @a

Useful for event servers, testing a config change, or rewarding players after a boss fight. Full syntax on the commands page.

warning

grant refuses to run while "enabled": false and says so, rather than pretending to work.

Mod and modpack developers can do the same from code — see KubeJS and the Java API.