Chest Troubleshooting
Diagnostic Flow — "Chest not working"
- Ask what chest type — Gift, Dated, or Timed?
- Ask what message they see — "not ready", "already opened", "illegal break"?
- For Dated: check current date vs sign dates and
Default_Year
Common Mistakes
- Dated chest: 2 opens with preview, 1 without — first open shows read-only preview, second open gives loot. Users report "can't take items" on first open — this is by design
Default_Yearneeded for year-spanning ranges — e.g. Dec 25→Jan 3 needsDefault_Yearset to the start year (2026 for 25.12-03.01)- Sneaking blocks chest interaction — players holding Shift can't open Winter chests. This prevents accidental block placement
InvalidChestDateExceptionfrom corrupted sign dates — break the sign and recreate with validDD.MMformat- Items can't be taken from preview inventory — all clicks are cancelled in preview mode. Open the chest a second time to loot