Memory Bank Settings - JackFred2/ChestTracker GitHub Wiki

Memory Banks are stored under <minecraft dir>/chesttracker, and are composed of two files: the data file (e.g. New World.nbt), and a JSON metadata file (New World.nbt.meta).

Settings GUI

image

Legend

1. Memory Bank ID

The ID (filename) of the memory bank. The default formats are:

  • Singleplayer: singleplayer/<world folder name>
  • Multiplayer: multiplayer/<server ip>
  • Realms: realms/<encoded realms ID>
  • LAN: lan/<motd> - the MOTD is usually the world folder name

The ID is obfuscated by default, so as not to leak the IP or realm ID in the case of screenshots / streaming. You can change this in the global Chest Tracker settings.

2. Memory Bank Name

The user-facing name of this memory bank. The default formats are:

  • Singleplayer: World name as it displays in the server list
  • Multiplayer: Name of the server entry, or 'A Minecraft Server' for direct connections
  • Realms: Name of the realm
  • LAN: MOTD of the LAN server

3. Close

Closes the settings menu without saving, and returns to the previous screen if applicable.

4. Settings Categories

Allows you to select a settings category. For more information on each category, see Settings below.

5. Settings Page

Allows you to modify the settings within the selected category. For more information on each category, see Settings below.

6. Load

If the memory bank you are editing isn't the one currently loaded, and you are in game, this button will load the memory bank.

7. Save

Saves the changed settings of the given memory bank and returns to the previous screen.

8. Make Default

Allows you to specify this memory bank to be loaded on the current connection (world, IP, realm) instead of the automatic one.

9. Delete

Deletes the given memory bank, and returns to the previous screen. This is irreversible.

10. Edit Memory Keys

Allows you to delete, reorder, and change the icon of this memory bank's memory keys.

image

1. Reorder Handle

Click and drag to reorder the keys shown on the left of the main GUI. Disables automatic ordering.

2. Icon Change

Allows you to select a different icon to be shown for this key. Useful for keys from custom dimensions.

3. Memory Key

Displays the given memory key. As of 2.2.2 this is not editable.

4. Delete

Deletes the given memory key. This is irreversible.

5. Default Ordering Toggle

By default, Chest Tracker uses a 'Canonical' ordering of memory keys (Ender Chest > Overworld > The Nether > The End). This can be disabled by manually reordering, or enabled again with this button.

6. Return

Returns to the Memory Bank Settings screen. Changes to memory keys are saved with the memory bank settings.

Settings

This section goes over each category's settings, first going left-to-right then top-down order.

Compatibility

Settings to help make Chest Tracker more compatible with certain servers, for example with resource packs.

Name Filtering Mode

Some servers provide a custom resource pack that modifies the default font file, resulting in Chest Tracker rendering unwanted textures for container names:

A cluttered screen of UI displayed in-world.

This setting allows you to filter certain groups of characters out of names.

Options:

  • None (No filtering)
  • ASCII only (Only allow ASCII characters in container names)
  • Basic Unicode (Only allow characters up to \u33FF, which supports most scripts except for Chinese, Korean and Japanese).

Display Container Names

Whether Chest Tracker should display container names at all.

Filtering

Settings related to filtering what containers get saved.

Only Named

Whether Chest Tracker should only remember containers with a custom name. Custom name detection is done by checking whether the title component is translatable.

Default: Off

Container Filter

Which containers Chest Tracker should remember items from.

Options:

  • All Containers
  • Common Containers (Chests, Barrels & Shulker Boxes)

Default: All Containers

Auto-add Placed Blocks

Whether items with an inventory, such as Shulker Boxes or [Ctrl]-clicked chests in creative, should automatically be added as a memory.

Options:

  • Yes (everything with an inventory)
  • Shulker Boxes (only auto-add Shulker Boxes)
  • No (don't add memories from placed blocks

Default: Shulker Boxes

Ender Chest Support

Whether to track items from a player's Ender Chest.

Default: On

Integrity

Settings related to keeping inventory data as up-to-date as possible.

Preserve Named

Whether to exempt containers with a custom name from being pruned by the lifetime check below.

Default: On

Lifetime Counting Method

How to count time passed, for the purposes of the maximum lifetime check.

Options:

  • Bank Loaded Time: How long this specific memory bank has been loaded in-game.
  • Real Time: How much time has passed in the real world.
  • World Loaded Time: How long the given world has been loaded, as tracked by the server.

Default: Bank Loaded Time

Maximum Memory Lifetime

How old a memory has to be before it's considered 'out of date' and forgotten by Chest Tracker. Uses the above time counting method.

Options: [10 seconds, 1 week] or never expires

Default: 12 hours

Block Break Removing

Whether to remove memories at a given position when a block there is broken by the player.

Default: On

Periodic Check

Chest Tracker periodically checks memories that are nearby to see if they are still present in the world. This can catch cases where containers were broken while you were offline, or not by you.

Default: On

Manage

Only available if the edited memory bank is loaded. Allows you to manage some memories yourself.

Range

The working range, in blocks, for the two buttons below.

Deletion within range

Allows you to delete all memories in the current key within X blocks of your player's current position. The bracketed number at the end is the number of memories that will be affected by this action.

Deletion outside range

Allows you to delete all memories in the current key outside of X blocks of your player's current position. The bracketed number at the end is the number of memories that will be affected by this action.

Highlight All

Closes the settings GUI and displays the location all memories in the current memory key. This does not save changes to your settings.

Search

Handles the item list and it's displayed items.

Item List Range

The maximum distance of memories in the currently memory key that will be displayed in the item list. Does not affect the searching range.

Options: [4, ∞) blocks

Default: 256 blocks

Search Range

The maximum distance of memories that will be searched for when looking for an item. Does not affect the item list range.

Options: [4, ∞) blocks

Default: 256 blocks

Stack Merge Mode

By default, the item list merges all identical stacks into one with an oversized count. This helps improve readability of the menu, but this setting can be used to change it.

Options:

  • Merge All: Merge all matching stacks into one with a large count.
  • Within Container: Merge all matching stacks within each container, but keep stacks from different containers separated.
  • Never Merge: Don't merge stacks.

Default: Merge All

⚠️ **GitHub.com Fallback** ⚠️