Cupboard mod guide for All the Mods 10 2.12

Cupboard is included in this pack at version 2.8, shipped as the file cupboard-1.21-2.8.jar. It has been in the pack since version 0.51 or earlier, so it's a long-standing part of the mod list.^[1]

Unverified The sources I have don't describe what Cupboard does, who it's meant for, or any pack-specific changes to its configs or recipes. I haven't guessed at those. Cupboard also isn't on the ATM Star quest path, and no quests in this pack involve it, so there's no progression step tied to it.

Cupboard is a utility mod, so there is nothing for you to craft first. The only thing this pack's sources show for it is its config file, so that is where getting started happens, and there are no recipe blocks in this section.^[2]

Every setting lives in config/cupboard.json, and each one is a crash or debugging helper. The values this pack sets match the defaults named in the file's own descriptions, so nothing has been changed from stock.^[2]

What you can tweak

• logOffthreadEntityAdd.logOffthreadEntityAdd is true. Entities should only be added on the server thread. The description says Cupboard fixes the crashes caused by mods that break this rule, and this option logs those cases.^[2]
• showCommandExecutionErrors.showCommandExecutionErrors is true. It controls whether errors during command execution are displayed.^[2]
• skipErrorOnEntityLoad.skipErrorOnEntityLoad is false. Turning it on prevents crashes on entity loading.^[2]
• forceHeapDumpOnOOM.forceHeapDumpOnOOM is false. If enabled, a heap dump is created automatically when the game crashes with an out of memory issue. The description warns that heap dumps take a lot of space, so use it with care.^[2]
• debugChunkloadAttempts.debugChunkloadAttempts is false. It enables debug logging of chunks being forceloaded on the server thread by directly accessing an unloaded chunk, which stalls the server until the chunk finishes loading. The description says it is incompatible with lithium and its forks.^[2]

Here's the honest picture for Cupboard mod: the only thing the sources show for it in this pack is its config file. This section walks through the settings and what each one does.^[2]

Server-thread safety options

These options deal with entities and chunks being handled on the server thread.^[2]

• logOffthreadEntityAdd.logOffthreadEntityAdd is true in this pack. Entities should only be added on the server thread, and Cupboard fixes the crashes caused by mods that break that rule. This option enables the logging of those cases.^[2]
• debugChunkloadAttempts.debugChunkloadAttempts is false in this pack. When enabled, it logs chunks being forceloaded on the server thread by directly accessing an unloaded chunk, which stalls the server until the chunk finishes loading. Its description says it is incompatible with lithium and its forks.^[2]

Crash and error handling options

• skipErrorOnEntityLoad.skipErrorOnEntityLoad is false in this pack. If you turn it on, it prevents crashes on entity loading.^[2]
• forceHeapDumpOnOOM.forceHeapDumpOnOOM is false in this pack. Enabled, it automatically creates a heap dump when the game crashes with an out of memory issue. The description warns to use it with care because heap dumps take a lot of space.^[2]
• showCommandExecutionErrors.showCommandExecutionErrors is true in this pack. It controls whether errors during command execution are displayed.^[2]

Cupboard is a small library-style mod, and its config is short. There are only five options in the pack's config file, and all of them are on-or-off switches. Each one is set to the same value as the default listed in its own description, so the pack doesn't change anything here.^[2]

Options and the pack's values

• skipErrorOnEntityLoad.skipErrorOnEntityLoad is false in the pack. When turned on, it prevents crashes on entity loading. It's off, so an entity loading error will still crash the game.^[2]
• logOffthreadEntityAdd.logOffthreadEntityAdd is true in the pack. Entities should only be added on the server thread. Cupboard fixes the crashes caused by mods that break that rule, and this option logs when it happens. It's a handy clue if you're hunting down a misbehaving mod.^[2]
• showCommandExecutionErrors.showCommandExecutionErrors is true in the pack. It controls whether errors during command execution are displayed.^[2]
• forceHeapDumpOnOOM.forceHeapDumpOnOOM is false in the pack. When enabled, the game automatically creates a heap dump if it crashes with an out-of-memory issue. The description warns that heap dumps take a lot of space, so use it with care.^[2]
• debugChunkloadAttempts.debugChunkloadAttempts is false in the pack. It enables debug logging of chunks being force-loaded on the server thread by directly accessing an unloaded chunk, which stalls the server until the chunk finishes loading. The description says it is incompatible with lithium and its forks.^[2]