promotional bannermobile promotional banner
premium banner
Complete time management: time, moon phases, day/night alerts, customizable messages, and more

Description

# ⏰ SleepTimer

 

## 🌟 Main features

 

### 📊 Instant information (H key)

Press **H** at any time to see:

- ⏰ **Current time** in 24-hour format (e.g., 2:30 p.m.)

- 📅 **Day of the world** (e.g., Day 5)

- 🌅 **Time until sunset/sunrise** (e.g., Sunset in 3:42)

- 🌙 **Current moon phase** (Full Moon, First Quarter, New Moon, etc.)

- 💧 **Rain/storm duration** (e.g., Raining for 2:15)

 

### 🛏️ Smart bed timer

When you click on a bed during the day, a message appears indicating

**exactly how long it will be** before you can sleep (e.g., “⏰ You can sleep in 4:23”)

 

### ⚠️ Automatic alerts

- **Nightfall**: Alert 1 minute before nightfall

- **Sunrise**: Notification when it is safe to go out

- **Optional sounds**: Bells accompanying alerts

 

### ✏️ 100% customizable messages

Don't like the default messages? Change them!

- Write your own texts for each alert

- Use color codes (§e=yellow, §a=green, §c=red, §b=blue, §6=orange)

- Use %s to insert the time wherever you want

 

**Examples:**

- `§e⏰ You can sleep in %s` → “⏰ You can sleep in 3:42”

- `§cGo to bed in %s!` → “Go to bed in 3:42!”

- `§b%s left to dream` → “3:42 left to dream”

---

## ⚙️ Fully configurable

Open the configuration menu from:
- **Command**: `/sleeptimer config`
- **Mods menu**: Mods → SleepTimer → ⚙️ Config

### Category: Alerts

 

Option    Description
Sunset alert Notification 1 minute before sunset
Sunrise alert Notification at sunrise
Sounds in alerts Play sound with alerts

### Category: Display

Option Description
Show moon phase View moon phase when pressing H
Show rain info View rain time when pressing H
Message when using bed Show sleep time when clicking on bed

### Category: Custom messages

Option Description
Bedtime message text Customize the message when using bed (use %s for the time)
Sunset alert text Customize the sunset alert
Sunrise alert text Customize the sunrise alert

---

## ⌨️ Customizable key

Don't like the **H** key? Change it easily:
1. Go to **Options** → **Controls**
2. Find the **“SleepTimer”** category
3. Click on the current key
4. Press the new key you prefer

---

## 🌍 Multilingual

Fully translated into **13 languages**:

| Language | Code |
|----------|------|
| 🇪🇸 Spanish | es_es |
| 🇬🇧 English | en_us |
| 🇫🇷 French | fr_fr |
| 🇩🇪 German | de_de |
| 🇵🇹 Portuguese (Brazil) | pt_br |
| 🇮🇹 Italian | it_it |
| 🇯🇵 Japanese | ja_jp |
| 🇷🇺 Russian | ru_ru  |
| 🇨🇳 Chinese (Simplified) | zh_cn |
| 🇰🇷 Korean | ko_kr |
| 🇵🇱 Polish | pl_pl |
| 🇹🇷 Turkish | tr_tr |
| 🇳🇱 Dutch | nl_nl |

The mod automatically detects your Minecraft language.

---

## 📦 Installation

1. Install [Fabric Loader](https://fabricmc.net/use/)
2. Download [Fabric API](https://modrinth.com/mod/fabric-api)
3. Download SleepTimer
4. Place both mods in the `.minecraft/mods` folder
5. Enjoy!

> ℹ️ **Note**: Cloth Config API is included in the mod, you don't need to download it separately.

---

## 🎮 Requirements

Requirement Version
Minecraft 1.20.1
Fabric Loader 0.18.4+
Fabric API Lastest version

---

## 🎨 Available color codes

For use in your custom messages:

Code Color
§0 Black
§1 Dark blue
§2 Dark green
§3 Cyan
§4 Dark red
§5 Purple
§6 Orange
§7 Gray
§8 Dark gray
§9 Blue
§a Green
§b Light blue
§c Red
§d Pink
§e Yellow
§f White

**Formats:**

Code Effect
§l Bold
§o Italics
§n Underlined
§m Strikethrough
§r Reset formatting

---

## 📸 Screenshots

1. Information when pressing H

2. Bedtime message

3. Command

4. Settings menu

---

## 🐛 Report bugs

Found a problem? 
- Write to me on Discord: Tracats787
- Describe the problem and how to reproduce it.

---

## 📜 License

This mod is open source under the **CC0-1.0** license.

---

## 🙏 Credits

- **Developer**: Tracats787
- **Configuration API**: [Cloth Config](https://modrinth.com/mod/cloth-config) by shedaniel

---

## ❤️ Do you like the mod?

- 💚 Like it on Modrinth/CurseForge
- 📢 Share it with your friends!