Skip to content

Troubleshooting

Jump to bottom
Divesh Gupta edited this page Jul 31, 2026 · 3 revisions

Troubleshooting

"My shulker box did not come back"

Check containerAwareMatching in the config. With it on (the default) the box comes back holding whatever it held both in the dream and at death. With it off, changing the contents at all forfeits the whole box, it drops at your death site rather than returning.

"I got an empty shulker back"

Working as intended. You took the contents out after sleeping, so they are wherever you put them. Returning the box still full would duplicate them.

"My enchanted tool dropped instead of coming back"

If you enchanted or renamed it after sleeping, it is no longer the item you slept with, so it counts as new. Durability is the only change that is ignored, a worn tool still matches.

"Only one of us got a checkpoint"

If you are on 1.1.1 or older, that is a known bug, update to 1.2.0. See Multiplayer.

"Nothing is being saved at all"

Check in order:

  1. /dreambound status, does it say you have a snapshot?
  2. Is enableBedSleepSnapshots still true in the config?
  3. Did the sleep actually succeed? Being woken by a mob, or leaving the bed early, is not a completed sleep.
  4. Is your bed still there? With clearSnapshotOnSpawnpointDestroyed on, breaking your bed clears the dream.
  5. Check the server log for Dreambound initialized. at startup.

"Items are going into the grave that should have stayed with me"

Set debugUniversalGravesCompat=true and reproduce it. The log will show every decision about every item, which were kept, which were trimmed, and what the budget was. Include that in a bug report.

"Ohmega accessories are not being saved"

Check the startup log. You should see:

Dreambound: Ohmega detected - accessory slot protection active (1.5.x API).

If instead there is a warning that the API could not be recognised, Dreambound has deliberately stood down rather than half-handle your accessories. Report it with your Ohmega version.

Also confirm enableOhmegaCompat is true.

"My config edits do nothing"

Run /dreambound reload, or restart. If a setting still does not apply, check the log at startup, if the file failed to parse, Dreambound runs on defaults for that session and leaves your file untouched, and says so in the log.

Reporting a bug

Please include:

  • Dreambound version, Minecraft version, and whether you are on a server or singleplayer
  • Which of Universal Graves, Trinkets Updated and Ohmega are installed, and their versions
  • The relevant part of the server log, including the Dreambound startup lines
  • Exact steps: what you slept with, what you did, how you died, what you got back

Item-tracking bugs are very hard to diagnose without the before-and-after, so /dreambound preview output taken before the death is genuinely useful.

Issues: https://github.com/Overshock-Studios/Dreambound/issues

Dreambound

Clone this wiki locally