![Logo](https://github.com/user-attachments/assets/82b47de8-13a9-40dd-86d7-ef1e6a24d392) ![Header](https://github.com/user-attachments/assets/f0e6fa15-af81-4951-970f-061f08674c1e) ![Summary](https://github.com/user-attachments/assets/5b2ca71b-0574-46b0-bcd6-6d6508000948) ![Well Rested](https://github.com/user-attachments/assets/3e8f9a96-ac4d-4099-b792-050b23ec1b9c) ![Footer](https://github.com/user-attachments/assets/8bb8b517-7224-4525-a471-12651b268a25)

Description

## Midnight Thoughts **Midnight Thoughts** enhances the Minecraft sleep mechanic, making nights more rewarding and memorable. While resting, players may see **thoughts, random facts, or nightmares**. Players who sleep through the night receive the **Rested effect** and a **summary of their activity since the last sleep**. --- ### Random Facts The mod uses the **Useless Facts API**, providing a large and constantly updated database of random facts. **Supported languages** - English - German --- ### Player Statistics Each player has their own statistics, and everyone on the server can view each other's results. At the end of the night, a **summary screen** highlights: - The **MVP** — the most active player - **Personal bests** - Small **achievements** --- ### Themes The server can define a **default interface theme** in the mod configuration. Players can also choose their own theme: - **Vanilla** - **Classic** - **Tech** - **Magic** --- ### Comfort System The mod introduces a **comfort system** that affects sleep quality. When a player goes to bed, their **rest level** after waking depends on the **comfort level around the bed**. Comfort is influenced by nearby elements such as: - furniture - plants - decorative blocks - other environmental elements Some blocks **increase comfort**, while others **decrease it**. --- ### Rested Effect _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_ 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: 1. **Phase 1** — strongest 2. **Phase 2** — medium 3. **Phase 3** — weakest However, **higher Rested levels are always stronger overall**. For example, **Phase 3 of Level 5** is still stronger than **Phase 1 of Level 1**. --- ### MVP Bonus When playing with others, the **MVP always receives the most powerful buff**, regardless of the conditions in which they slept. Additionally: - The MVP buff **lasts longer** than the standard **Level 5 Rested effect**. --- ### Nightmares Sleep quality also affects the player's experience: - **Bad conditions** → the player may experience **nightmares** - **Terrible conditions** → the player **cannot fall asleep at all**

Config

In the config, you can customize the **HUD interface settings**, enable or disable the moon image, adjust the animation speed, or disable the HUD entirely. You can also configure the **Well Rested effect bonuses**, the interior scan radius, MVP status **and more**. The theme set in the config is the default for the entire server. However, if a player changes their theme, their personal selection will override the server default and be displayed in their interface ``` { "sleepOverlay": { "minSlideDisplayTimeMs": 2500, "maxSlideDisplayTimeMs": 4000, "fadeInDurationMs": 300, "fadeOutDurationMs": 300, "overlayOpacity": 0.4, "textOpacity": 1.0, "imageOpacity": 0.6, "specialSlideChance": 0.05, "enableOverlay": true, "enableImage": true, "enableDailySummaryScreen": true, "useFactsApi": true, "userContentReplaces": false, "hideChatWhenSleeping": true }, "wellRested": { "levels": { "level5": { "durationMinutes": 15, "speedPhase1": 0.5, "speedPhase2": 0.3, "speedPhase3": 0.16, "strengthPhase1": 0.24, "strengthPhase2": 0.16, "strengthPhase3": 0.08, "hastePhase1": 0.35, "hastePhase2": 0.2, "hastePhase3": 0.1, "attackSpeedPhase1": 0.12, "attackSpeedPhase2": 0.06, "attackSpeedPhase3": 0.03, "healthBonus": 10.0, "regenBonus": 0.1 }, "level4": { "durationMinutes": 10, "speedPhase1": 0.4, "speedPhase2": 0.24, "speedPhase3": 0.12, "strengthPhase1": 0.2, "strengthPhase2": 0.12, "strengthPhase3": 0.06, "hastePhase1": 0.28, "hastePhase2": 0.16, "hastePhase3": 0.08, "attackSpeedPhase1": 0.1, "attackSpeedPhase2": 0.05, "attackSpeedPhase3": 0.02, "healthBonus": 8.0, "regenBonus": 0.08 }, "level1": { "durationMinutes": 3, "speedPhase1": 0.16, "speedPhase2": 0.08, "speedPhase3": 0.04, "strengthPhase1": 0.08, "strengthPhase2": 0.04, "strengthPhase3": 0.02, "hastePhase1": 0.1, "hastePhase2": 0.05, "hastePhase3": 0.02, "attackSpeedPhase1": 0.04, "attackSpeedPhase2": 0.02, "attackSpeedPhase3": 0.01, "healthBonus": 2.0, "regenBonus": 0.02 }, "level3": { "durationMinutes": 7, "speedPhase1": 0.32, "speedPhase2": 0.18, "speedPhase3": 0.08, "strengthPhase1": 0.16, "strengthPhase2": 0.08, "strengthPhase3": 0.04, "hastePhase1": 0.22, "hastePhase2": 0.12, "hastePhase3": 0.06, "attackSpeedPhase1": 0.08, "attackSpeedPhase2": 0.04, "attackSpeedPhase3": 0.02, "healthBonus": 6.0, "regenBonus": 0.06 }, "level2": { "durationMinutes": 5, "speedPhase1": 0.24, "speedPhase2": 0.12, "speedPhase3": 0.06, "strengthPhase1": 0.12, "strengthPhase2": 0.06, "strengthPhase3": 0.03, "hastePhase1": 0.16, "hastePhase2": 0.08, "hastePhase3": 0.04, "attackSpeedPhase1": 0.06, "attackSpeedPhase2": 0.03, "attackSpeedPhase3": 0.01, "healthBonus": 4.0, "regenBonus": 0.04 } } }, "mvp": { "enabled": true, "minScoreRequired": 10, "pointsPerDistance100": 2, "pointsPerBlock": 3, "pointsPerMob": 15, "pointsPerJump10": 1, "penaltyPerDeath": 30, "mvpWellRestedDurationMinutes": 21 }, "comfort": { "enabled": true, "scanRadius": 5 }, "server": { "resetPhantomTimerForNonSleepers": true }, "ui": { "theme": "classic", "hideWellRestedHud": false, "hideThemeSwitchButton": false } } ``` **UI themes: "classic", "tech", "magic", "vanilla".** The NeoForge version has an additional parameter: ``` "wellRestedHudPosition": "primary" ``` This changes the position of the well-rested hud. "primary" is above the hunger bar, "alternative" is in the lower left corner (as in all other versions) Well Rested effect modifiers are added directly to the player's generic stats

Custom facts configuration

### Two configuration flags are available: ```json "useFactsApi": true, "userContentReplaces": false ``` `useFactsApi` - enables or disables the external API. `userContentReplaces` - determines whether user-defined facts completely replace the facts from the local database. ### Behavior Overview During mod initialization, configuration directories are automatically created in the config folder. ![Folders](https://cdn.modrinth.com/data/cached_images/489c272e3609f56bbdad7903776e4810248ebe55.png) Custom facts can be added to these directories. By default, they are **appended** to the existing local database. If `userContentReplaces` is set to `true`, all local database facts are **fully replaced** with user-defined content. ### Important note If replacement is enabled (`userContentReplaces: true`), but no custom facts are provided in at least one category, that category will be automatically populated with entries from the local database. ### File format example ```json { "entries": [ { "text": "Text example", "rarity": 1.0 } ] } ``` - `text` - the fact content - `rarity` - defines how frequently the entry appears (rarity weight) ![Slide example](https://cdn.modrinth.com/data/cached_images/2527d38e144545a5d098dd697a848e0a06663d6a_0.webp)

Custom achievements

You can define your own custom achievements in the mod's config. Achievements with specified requirements for obtaining, a description, and an achievement name are added to the achievements.json file. For example: ```json { "achievements": [ { "id": "test_achievment", "name": "First Night", "tooltip": "You survived the first night!", "conditions": { "deathsMax": 999 } } ] } ``` The id determines whether an achievement has already been earned. Multiple achievements can share the same id, but they will be counted as one. This means that if a player has already earned an achievement with the same id, all other achievements will also be counted as earned The achievement constructor provides the following parameters (conditions): ``` deathsEq; deathsMin; deathsMax; mobsKilledEq; mobsKilledMin; mobsKilledMax; blocksDestroyedEq; blocksDestroyedMin; blocksDestroyedMax; distanceWalkedEq; distanceWalkedMin; distanceWalkedMax; jumpsEq; jumpsMin; jumpsMax; damageDealtEq; damageDealtMin; damageDealtMax; ``` - Eq is exactly how much is needed - Min is the minimum - Max is the maximum Example: ``` { "achievements": [ { "id": "test_achievment", "name": "First Night", "tooltip": "You survived the first night!", "conditions": { "deathsMax": 999 - The maximum number of deaths possible to get the achievement "mobsKilledMin": 10 - Minimum number of mobs to kill to get the achievement "jumpsEq": 1 - The exact number of jumps required to get the achievement } } ] } ```

For servers

### Server behavior The mod respects the vanilla **`playerSleepingPercentage`** gamerule. If this value is set **below 100%**, only players who actually slept during the night will receive: - the **Rested effect** - the **night summary** Players who did not sleep will not receive these rewards. --- ### Rest counter handling The config includes the following option: ```json "server": { "resetPhantomTimerForNonSleepers": true } ``` This setting controls how the **phantom rest timer** (`timeSinceLastRest`) is reset when the night is skipped. **When enabled (`true`):** - the rest timer is reset for **all players** - even players who **did not sleep** will have their counter reset This prevents situations where players who didn’t participate in skipping the night are still targeted by **phantoms** later. **When disabled (`false`):** - the rest timer is reset **only for players who actually slept** - players who didn’t sleep keep their **`timeSinceLastRest`** value and may still be targeted by phantoms on future nights

Items that boost or decrease Well Rested

### Comfort Tags You can extend the comfort system using **data packs** by adding blocks to special tags. Place your tag files in: ``` data/midnightthoughts/tags/block/ ``` Each file must contain a JSON list of blocks: ```json { "replace": false, "values": [ "minecraft:example_block" ] } ``` Setting `"replace": false` ensures that new blocks are **added without overriding the default ones**. Tags in Minecraft are used to group blocks together through datapacks and mods. --- ### Positive Comfort Tags These tags **increase comfort** and contribute to the **Well Rested** level: - `comfort_lighting` - `comfort_carpet` - `comfort_furniture` - `comfort_decoration` - `comfort_structure` Each category contributes **+1 level** to the effect (up to 5 levels). --- ### Negative Comfort Tags These tags **reduce comfort** around the bed: - `comfort_negative_dark` - `comfort_negative_hostile` - `comfort_negative_macabre` Too many negative blocks may **lower the final Rested level or cause nightmares**. --- ### Full block list The complete list of blocks used by the comfort system can be found here: **Full list:** [Github](https://github.com/Iliiasik/MThoughts/tree/neoforge-1.21.11/src/main/resources/data/midnightthoughts/tags/block)

Midnight Thoughts

Tech

Nightmares

Well Rested Hud

Magic

Well Rested MVP Hud

Classic

Terrible conditions

Vanilla

External resources

Project members

Technical information