Data packs¶

Most of what Why Can't I Sleep? decides is data. A data pack can change which mobs keep you awake, what counts as soothing or unsettling by the bed, which music helps or hurts a night, how nights are scored, what you wake up with, and where players can hide. No code is needed, and nothing has to be installed on the players' side: everything here is read by the server (or by the world, in single player).

How the features themselves play is on the Why can't I sleep?, Hiding and Nights pages; the server settings that turn them on and off are on Configuration. For changes that need code, see For mod developers.

Where files go¶

A data pack is a folder (or a zip) in the world's datapacks folder, with a pack.mcmeta and a data folder. The mod's own files live in the whycantisleep namespace; yours can use any namespace you like, except where you mean to replace one of the mod's own files, which must keep its namespace and path.

my_pack/
├── pack.mcmeta
└── data/
    ├── whycantisleep/
    │   └── tags/
    │       ├── entity_type/
    │       │   ├── blocks_sleep.json
    │       │   ├── does_not_block_sleep.json
    │       │   └── ignores_hiding.json
    │       ├── item/
    │       │   ├── soothing.json
    │       │   └── unsettling.json
    │       └── jukebox_song/
    │           ├── calm.json
    │           ├── creepy.json
    │           └── loud.json
    └── mypack/
        └── whycantisleep/
            ├── sleep_modifier/
            │   └── rainy_night.json
            ├── sleep_effect/
            │   └── starry_dream.json
            └── hiding_spot/
                └── wardrobe.json

my_pack/
├── pack.mcmeta
└── data/
    ├── whycantisleep/
    │   └── tags/
    │       ├── entity_types/
    │       │   ├── blocks_sleep.json
    │       │   ├── does_not_block_sleep.json
    │       │   └── ignores_hiding.json
    │       └── items/
    │           ├── soothing.json
    │           ├── unsettling.json
    │           ├── calm.json
    │           ├── creepy.json
    │           └── loud.json
    └── mypack/
        └── whycantisleep/
            ├── sleep_modifier/
            │   └── rainy_night.json
            ├── sleep_effect/
            │   └── starry_dream.json
            └── hiding_spot/
                └── wardrobe.json

The whycantisleep/sleep_modifier, whycantisleep/sleep_effect and whycantisleep/hiding_spot folders are the same on every version. A file's id is its namespace and its path under that folder: data/mypack/whycantisleep/sleep_effect/starry_dream.json is mypack:starry_dream.

Set pack_format in pack.mcmeta to the one for your Minecraft version, as for any data pack.

Tags¶

Every tag the mod reads is in the whycantisleep namespace. The mod's own files are complete tags: add to them with "replace": false (the default), or start from nothing with "replace": true.

Entity type tags¶

The sleep rules change the game's own check, so they decide whether a sleep really goes ahead, not only what the mod highlights. The game looks for monsters within 8 blocks of the bed's head to each side and 5 up and down; a mob in does_not_block_sleep is taken out of what it found, and any living mob in blocks_sleep inside the same box is added. A mob in both tags still blocks: blocks_sleep is applied after. These tags don't change which monsters count against a night's sleep quality (that counts every monster within 24 blocks).

{
  "values": [
    "minecraft:spider",
    { "id": "mymod:friendly_ghost", "required": false }
  ]
}

{
  "values": [
    "minecraft:goat"
  ]
}

{
  "values": [
    { "id": "mymod:shadow_stalker", "required": false }
  ]
}

On 1.20.1 these files go in tags/entity_types/ instead.

Item tags: things by the bed¶

Every block within 6 blocks of the bed to each side, and 3 up and down, is looked at through its item. A flower pot counts as the plant in it, so a potted poppy is soothing. A block whose item is in both tags counts as unsettling. With the mod's own modifiers, each soothing thing is worth +2 (up to +10) and each unsettling one -3 (down to -15); those numbers live in the soothing and unsettling modifier files, so a data pack can change them. The items' tooltips say which tag they are in.

{
  "values": [
    "minecraft:lantern",
    "#minecraft:banners",
    { "id": "mymod:dreamcatcher", "required": false }
  ]
}

On 1.20.1 these files go in tags/items/ instead.

Music tags¶

A jukebox playing within 16 blocks of the bed while you sleep counts. When several play, the worst of them is what is heard: creepy, then loud, then calm. A song in none of the tags counts as no music at all for the score.

{
  "values": [
    "minecraft:relic",
    { "id": "mymod:lullaby", "required": false }
  ]
}

{
  "values": [
    { "id": "mymod:music_disc_lullaby", "required": false }
  ]
}

The points are those of the mod's calm_music, creepy_music and loud_music modifiers. Creepy and loud both count when both played; calm counts only when neither did.

Block tags¶

The mod has no block tags of its own. Block ids and #tags are used inside sleep modifiers (near_blocks) and hiding spots (blocks), where any block tag works, the game's or your own.