Forge

Common Configuration

Please note that structure blacklists are not functional outside of 1.16.5 due to tagging and holder changes.

Values specified in variable definition are defaults.

skip_unloaded = true - Skip unloaded block entities that are eligible for conversion, set to false to potentially resolve issues with containers that aren't being converted [default: true]

convert_wooden_chests = true - Whether or not the entire forge:chests/wooden tag should be added to the conversion list for structures (if they are backed by RandomizableContainerBlockEntity) [default: true]

decay_loot_tables = [] - List of loot tables which will decay (default blank, meaning no chests decay, in the format of ["modid:loot_table", "othermodid:other_loot_table"])

additional_chests = [] - A list of additional chests that should be converted (in the format of ["modid:name", "modid:other_name"], must be a tile entity instance of RandomizableContainerBlockEntity)

decay_modids = [] - List of mod IDs whose loot tables will decay (default blank, meaning no chests decay, in the format ["modid", "othermodid"])

loot_modid_blacklist = [] - List of modids whose loot tables shouldn't be converted (in the format of ["modid", "other_modid"])

additional_trapped_chests = [] - A list of additional trapped chests that should be converted (in the format of ["modid:name", "modid:other_name"], must be a tile entity instance of RandomizableContainerBlockEntity)

dimension_whitelist = [] - List of dimensions (to the exclusion of all others) that loot chest should be replaced in (default: blank, allowing all dimensions, e.g., ["minecraft:overworld", "minecraft:the_end"])

decay_dimensions = [] - List of dimensions where loot chests should automatically decay (default: blank, e.g., ["minecraft:the_nether", "minecraft:the_end"])

convert_trapped_chests = true - Whether or not the entire forge:chests/trapped tag should be added to the conversion list for structures (if they are backed by RandomizableContainerBlockEntity

report_unresolved_tables = false - Lootr will automatically log all unresolved tables (i.e., for containers that have a loot table associated with them but, for whatever reason, the lookup for this table returns empty). setting this option to true additionally informs players when they open containers.

loot_table_blacklist = [] - List of loot tables which shouldn't be converted (in the format of ["modid:loot_table", "othermodid:other_loot_table"])

refresh_dimensions = [] List of dimensions where loot chests should automatically refresh (default: blank, e.g., ["minecraft:overworld", "othermod:otherdimension"])

refresh_modids = [] - List of mod IDs whose loot tables will refresh (default blank, meaning no chests refresh, in the format of ["modid", "othermodid"])

randomise_seed = true - Determine whether or not loot generated is the same for all players using the provided seed, or randomised per player [default:true]

maximum_age = 3600 - the maximum age for containers; entries above this age will be discarded [default: 180 * 20, 3 minutes] #Range: > 0

convert_quark = true - Whether or not quark chests used in world generation for loot purposes should be replaced with Lootr chests

decay_value = 6000 - How long (in ticks) a decaying loot containers should take to decay (default 5 minutes = 5 * 60 * 20): Range: > 0

refresh_loot_tables = [] - List of loot tables which will refresh (default blank, meaning no chests refresh, in the format of ["modid:loot_table", "othermodid:loot_table"])

refresh_all = false - Overriding refresh_loot_tables, refresh_modids and refresh_dimensions: all chests will refresh after being opened for the first time

decay_all = false - Overriding decay_loot_tables, decay_modids and decay_dimensions: all chests will decay after being opened for the first time

blast_resistant = false - Lootr chests cannot be destroyed by explosions

dimension_blacklist = [] - List of dimensions that loot chests should not be replaced in (default: blank, allowing all dimensions, format e.g., ["minecraft:overworld", "minecraft:the_end"])

disable_break = false - Prevent the destruction of Lootr chests except while sneaking in creative mode (this prevents players from breaking chests outside of creative)

convert_mineshafts = true - Whether or not mineshaft chest minecarts should be converted to standard loot chests

power_comparators = true - When true, comparators on Lootr containers will give an output of 1; when false, they will give an output of 0. This is important for trap-based structures.

refresh_value = 24000 - How long (in ticks) a refreshing loot containers should take to refresh their contents (default 20 minutes = 20 * 60 * 20) Range: > 0

Client Configuration

vanilla_textures = false - Set to true to use vanilla textures instead of Lootr special textures. Note: this will prevent previously opened chests from rendering differently

Fabric

Additional containers are supported using data packs and tags. Indeed, this is how Vanilla containers are originally listed. Please see the source code data pack for more information.

Debug options

"debugMode": false, - Currently debug mode does nothing.

"report_unresolved_tables": false - Reports loot tables in containers that resolve to an empty or null value.

Seed options

"randomize_seed": true - Randomizes the seed of each container. Setting this to true will cause all containers to have identical loot.

Conversion options

"skip_unloaded": true, - Containers that are in unloaded chunks are skipped. When the chunk is next loaded, the container will be added back into the queue.

"maximum_age": 3600, - The maximum amount of time a container should spend in the queue.

"convert_mineshafts": true - Whether or not Mineshafts should be converted to use Lootr Minecarts.

Breaking options

"disable_break": false, - Prevents containers from being broken unless done so while sneaking in creative mode.

"power_comparators": true, - When true, causes comparator output from containers to be 1, when false, 0. Default behaviour for a comparator on a chest is to output based on the number of items; some structures have traps based on this, but a default output of 0 results in the trap triggering as soon as the structure is loaded.

"blast_resistant": false - When true, prevents containers from being destroyed by explosions.

Lists

"dimension_whitelist": [], - Dimensions where loot containers should explicitly be converted

"dimension_blacklist": [], - Dimensions where loot containers explicitly should NOT be converted

"loot_table_blacklist": [], - List of loot tables which, if used in a container, should not be converted

"loot_modid_blacklist": [], - List of modids which, if used in a container's loot table, should not be converted.

"loot_structure_blacklist": [] - Currently non-functional.

Decay

"decay_value": 6000, - The amount of time in ticks it takes for a container to decay.

"decay_all": false, - Whether or not all containers should be marked to decay after being opened for the first time.

"decay_modids": [], - A list of specific modids which, if used in the container's loot table, will cause it to be marked for decay the first time it is opened.

"decay_loot_tables": [], - A list of loot tables which, if used in a container, will cause it to be marked for decay the first time it is opened.

"decay_dimensions": [], ` A list of dimensions where containers should be marked for decay the first time they are opened.

"decay_structures": [] - Currently non-functional.

Refresh

All values are identical in function to decay.

Vanilla

"vanilla_textures": false - Client-side option that forces containers to be displayed using vanilla visuals.