The configuration file makes use of the Java properties format. If the configuration file does not exist during game start-up, a blank file with a comment will be created.
The configuration file defines overrides for the available options, and as such, a blank file is perfectly normal! It simply means that you'd like to use all the default values.
Each category below includes a list of options which can be changed by the user. Due to the nature of the mod, configuration options require a game restart to take effect.
Before editing the configuration file, take a backup of your minecraft worlds! All configuration options are simple key-value pairs. In other words, you first specify the option's name, followed by the desired value, like so:
mixin.ai.pathing=false
mixin.gen.biome_noise_cache=false
(default: true
)
Mob AI optimizations
(default: true
)
A faster code path is used for determining what kind of path-finding node type is associated with a
given block. Additionally, a faster chunk cache will be used for accessing blocks while evaluating
paths.
Requirements:
mixin.util.chunk_access=true
(default: true
)
Implements a faster POI search
(default: true
)
Portal search uses the faster POI search and optimized loaded state caching
(default: true
)
Mob Tasks which search for POIs use the optimized POI search
(default: true
)
Avoids unnecessary raid bar updates and optimizes expensive leader banner operations
Requirements:
mixin.util.data_storage=true
(default: true
)
Brain sensor optimizations
(default: true
)
Avoid unnecessary secondary POI searches of non-farmer villagers
(default: true
)
Various AI task optimizations
(default: true
)
Keep track of running and runnable tasks to speed up task launching checks
(default: true
)
Keep track of AI memory changes to skip checking AI task memory prerequisites
(default: true
)
Replace Stream code of AI tasks with more traditional iteration.
(default: true
)
Various optimizations inside AI tasks
(default: true
)
Speed up the weighted random choice of long jump target positions.
(default: true
)
Disabling useless brain sensors to avoid useless sensing calculations.
(default: true
)
Disable the goat item sensor whose memories are never used.
(default: true
)
Disable the parent animal sensor when an animal is not a baby. Would differ from vanilla in the case where an adult animal turns back into a baby animal, as the sensor information is refreshed, leading to a less-outdated value in the first second of turning back into a baby animal. However, there is no way to turn an animal back into a baby without reinitializing the brain, creating entirely new sensors.
(default: true
)
Patches that reduce memory allocations
(default: true
)
Improve the BlockState withTable lookup by using a custom table implementation.
(default: true
)
Random block ticking uses fewer block position allocations, thereby reducing the object allocation rate.
(default: true
)
Reuse large chunk lists
(default: true
)
Composters will reuse the available slot arrays that are requested by hoppers
(default: true
)
Reduce stream code usage when getting the passengers of an entity
(default: true
)
Entity trackers use a fastutil set for storing players instead of an IdentityHashSet
(default: true
)
Avoid Enum#values()
array copy in frequently called code
(default: true
)
Avoid Enum#values()
array copy in frequently called code
(default: true
)
Avoid Enum#values()
array copy in frequently called code
(default: true
)
Avoid Enum#values()
array copy in frequently called code
(default: true
)
Avoid Enum#values()
array copy in frequently called code
(default: true
)
Remove lambda allocation in frequently called block blast resistance calculation in explosion code
(default: true
)
NBT tags use a fastutil hashmap instead of a standard HashMap
(default: true
)
Optimizations related to blocks
(default: true
)
FluidStates store directly whether they are empty
(default: true
)
Fluid optimizations
(default: true
)
Fluid flow optimization
(default: true
)
Reduces hopper lag using caching, notification systems and BlockEntity sleeping
Requirements:
mixin.util.entity_movement_tracking=true
mixin.util.block_entity_retrieval=true
mixin.util.inventory_change_listening=true
mixin.util.item_component_and_count_tracking=true
(default: false
)
Send updates to hoppers when adding inventory block entities to chunks when world edit is loaded. Fixes the issue of hoppers not noticing when inventories are placed using worldedit without any block updates.
Requirements:
mixin.util.block_entity_retrieval=true
(default: true
)
Moving blocks and retracting pistons avoid calculating their VoxelShapes by reusing previously created VoxelShapes.
(default: true
)
Redstone wire power calculations avoid duplicate block accesses
(default: true
)
BlockNeighborGroups used in fluid code cache their hashcode
(default: true
)
Various world chunk optimizations
(default: true
)
Allow grouping entity classes for faster entity access, e.g. boats and shulkers
Requirements:
mixin.util.accessors=true
(default: true
)
Remove debug checks in block access code
(default: true
)
Skip bounds validation when accessing blocks
(default: true
)
Replaces the vanilla hash palette with an optimized variant
(default: true
)
Optimizes chunk palette compaction when serializing chunks
(default: true
)
Various collection optimizations
(default: true
)
Uses fastutil hashmaps for entity attributes
(default: true
)
Uses fastutil hashmaps for BlockEntity tickers
(default: true
)
Uses fastutil hashmaps for AI memories and sensors
(default: true
)
Improves the chunk ticket sets by speeding up the removal of chunk tickets
(default: true
)
Uses fastutil hashmaps for type specific entity lists
(default: true
)
The expensive check to see if a TypeFilterableList can be filtered by a specific class is only made when a new list for that type needs to be created
(default: true
)
Copy entity hashmap instead of duplicating the list using iteration
(default: true
)
Use ReferenceArraySet instead of HashSet to store the fluids the entity is currently submerged in.
(default: true
)
Uses fastutil hashmaps for gamerules
(default: true
)
Uses fastutil hashsets for goals in the AI goal selector
(default: true
)
Uses custom hashset/list combination for faster mob spawn checks
(default: true
)
Various entity optimizations
(default: true
)
Various entity collision optimizations
(default: true
)
Skips being pushed by fluids when the nearby chunk sections do not contain this fluid
Requirements:
mixin.util.block_tracking=true
mixin.experimental.entity.block_caching.fluid_pushing=false
(default: true
)
Uses faster block access for block collisions and delayed entity access with grouped boat/shulker for entity collisions when available
Requirements:
mixin.util.chunk_access=true
(default: true
)
Entity movement uses optimized block access and optimized and delayed entity access. Additionally, the supporting block of entities that only move downwards is checked first. This can profit from mixin.experimental.entity.block_caching.block_support, but it is not required.
Requirements:
mixin.util.chunk_access=true
(default: true
)
In chunks with many mobs in ladders a separate list of pushable entities for cramming tests is used
Requirements:
mixin.chunk.entity_class_groups=true
(default: true
)
Skips repeated checks whether the equipment of an entity changed. Equipment updates are detected instead.
Requirements:
mixin.util.item_component_and_count_tracking=true
(default: true
)
Use equipment tracking to skip ticking enchantments (Soul speed) when no such enchantments are present on the equipment of a living entity.
(default: true
)
Skips repeated checks whether the equipment of an entity changed.
(default: true
)
Skip repeatedly writing to the data tracker that an entity is not flying
(default: true
)
Skip hand swinging speed and animation calculations when the hand of an entity is not swinging
(default: true
)
Skip checking whether an entity is inside powder snow for movement speed slowdown when it is not freezing
(default: true
)
Access entities faster when accessing a relatively small number of entity sections
(default: true
)
Block updates skip notifying mobs that won't react to the block update anyways
Requirements:
mixin.util.data_storage=true
(default: true
)
Accesses entities of the correct type directly instead of accessing all nearby entities and filtering them afterwards
(default: true
)
Skips trying to create sprinting particles for all entities on the server side.
(default: false
)
Various experimental optimizations
(default: true
)
Experimental entity optimizations
(default: true
)
Use block listening system to allow skipping stuff in entity code
Requirements:
mixin.util.block_tracking=true
(default: true
)
Use the block listening system to skip supporting block search (used for honey block pushing, velocity modifiers like soulsand, etc)
Requirements:
mixin.util.block_tracking=true
(default: true
)
Use the block listening system to skip block touching (like cactus touching).
Requirements:
mixin.util.block_tracking=true
(default: true
)
Skip searching for fire or lava in the burn time countdown logic when they are not on fire and the result does not make a difference. Also use the block listening system to cache whether the entity is touching fire or lava.
(default: true
)
Use the block listening system to cache entity fluid interaction when not touching fluid currents.
Requirements:
mixin.util.block_tracking=true
(default: true
)
Use the block listening system to cache the entity suffocation check.
Requirements:
mixin.util.block_tracking=true
(default: true
)
Optimize item entity merging by categorizing item entities by item type and only attempting to merge with the same type. Categorizing by stack size allows skipping merge attempts of full item entities or two more than half full item entities.
Requirements:
mixin.util.accessors=true
mixin.util.entity_collection_replacement=true
mixin.util.item_component_and_count_tracking=true
(default: true
)
Experimental optimizations to spawning conditions. Reorders the iteration over entities to match the chunks and chunk sections, reducing the number of cache misses.
(default: true
)
Various world generation optimizations
(default: false
)
World generator settings cache the sea level. Disabled by default due to startup crash.
(default: true
)
Various math optimizations
(default: true
)
Avoids indirection and inlines several functions
(default: true
)
Avoid indirection and inline several functions in Direction, Axis and Box code
(default: true
)
Reduces the sine table size to reduce memory usage and increase access speed
(default: true
)
Optimizations that technically deviate from vanilla behavior, but must not affect gameplay or contraptions. Each optimization includes a description of the differences to vanilla behavior. In case any of these optimizations breaks any of your contraptions or affects your gameplay, please report it to our issue tracker as we consider this to be a bug.
(default: true
)
Mob AI optimizations
(default: true
)
Brain sensor optimizations
(default: true
)
Speed up frog attackable sensor by checking entity type before visibility test. This is slightly non-vanilla because the visibility information is cached for up to a second. If this sensor does not compute the visibility test, a later access might compute the visibility instead. That can cause a different result, since the later computation leads to a more updated result.
(default: true
)
Speed up finding empty spaces mobs fit into. This speeds up entity pose checks and nether portal positioning for colliding mobs (This code is vanilla's nether portal horse suffocation fix). If certain block collision surfaces have coordinates that are different but within 1e-7 of each other, this optimization may cause entities coming from nether portals or changing pose to be placed in a different position or pose than vanilla. This effect only occurs when the decision whether the entity fits into a space depends on a difference in the magnitude of 1e-7 blocks.
(default: true
)
BlockEntity ticking caches whether the BlockEntity can exist in the BlockState at the same location. This deviates from vanilla in the case of placing a hopper in a powered location, immediately updating the cached BlockState (which is incorrect in vanilla). This most likely does not affect your gameplay, as this deviation only affects hoppers, and in vanilla, hoppers never use the cached state information anyway.
Requirements:
mixin.world.block_entity_ticking=true
(default: true
)
Only check positions with expiring tickets during ticket expiration. Can cause reordering of chunks unloading. The chunk unloading order in vanilla is predictable, but depends on the hash of the chunk position of the tickets and the hashes of the other chunk tickets, and the order of creation of the chunk tickets when hash collisions occur. No known contraptions depend on the unload order.
(default: true
)
Avoid indirection when accessing the profiler
(default: true
)
Various VoxelShape optimizations
(default: true
)
Use a faster collection for the full cube test cache
(default: true
)
Entity shape contexts initialize rarely used fields only on first use
(default: true
)
VoxelShape collisions use a faster intersection test for cuboid shapes
(default: true
)
VoxelShapes store position arrays for their shape instead of recalculating the positions
(default: true
)
Merging and intersecting VoxelShapes is optimized using faster position list merging
(default: true
)
Specialized VoxelShape implementations are used for cuboid and empty shapes. Collisions with those shapes are optimized using a cuboid specific implementation
(default: true
)
Various utilities for other mixins
(default: true
)
Allow accessing certain fields and functions that are normally inaccessible
(default: true
)
Allows access to existing BlockEntities without creating new ones
(default: true
)
Chunk sections count certain blocks inside them and provide a method to quickly check whether a chunk contains any of these blocks. Furthermore, chunk sections can notify registered listeners about certain blocks being placed or broken.
Requirements:
mixin.util.data_storage=true
mixin.util.chunk_status_tracking=true
(default: true
)
Access chunks of worlds, chunk caches and chunk regions directly.
(default: true
)
Allows reacting to changes of the load status of chunks.
(default: true
)
Stores lithium's extra data used for various optimizations on a per-world basis. The data is not saved, but allows optimizations to quickly store and access data.
(default: true
)
Allow replacing entity collections with custom collection types.
(default: true
)
System to notify subscribers of certain entity sections about position changes of certain entity types.
Requirements:
mixin.util.entity_section_position=true
mixin.util.data_storage=true
(default: true
)
Entity sections store their position
(default: true
)
Certain BlockEntity Inventories emit updates to their listeners when their stack list is changed or the inventory becomes invalid
(default: true
)
BlockEntity Inventories update their listeners when a comparator is placed near them
Requirements:
mixin.util.block_entity_retrieval=true
(default: true
)
Implements a subscription / publishing system for changes of item stack components and item entity item type.
(default: true
)
World border changes are sent to listeners such as BlockEntities
(default: true
)
Various world related optimizations
(default: true
)
Various BlockEntity ticking optimizations
(default: true
)
Allows BlockEntities to sleep, meaning they are no longer ticked until woken up, e.g. by updates to their inventory or block state
(default: true
)
BlockEntity sleeping for inactive brewing stands
(default: true
)
BlockEntity sleeping for inactive campfires
(default: true
)
BlockEntity sleeping for inactive lit campfires
(default: true
)
BlockEntity sleeping for inactive unlit campfires
(default: true
)
BlockEntity sleeping for inactive furnaces
(default: true
)
BlockEntity sleeping for locked hoppers
(default: true
)
BlockEntity sleeping for closed shulker boxes
(default: true
)
Avoids repeatedly testing whether the BlockEntity is inside the world border by caching the test result and listening for world border changes
Requirements:
mixin.util.world_border_listener=true
(default: true
)
Several changes to the chunk manager to speed up chunk access
(default: true
)
Various optimizations to chunk ticking
(default: true
)
Access FluidState through already known BlockState instead of accessing the world again.
(default: true
)
The four vanilla heightmaps are updated using a combined block search instead of searching blocks separately.
(default: true
)
Various improvements to explosions.
(default: true
)
Various improvements to explosion block damage, e.g. not accessing blocks along an explosion ray multiple times
(default: true
)
Caches entity explosion exposure to avoid duplicate calculations.
(default: true
)
Various improvements to game events (vibrations) that are detected by allays, wardens and several sculk blocks.
(default: true
)
Create game event dispatchers for chunk sections only when needed, i.e. when a listener is added to a section. This reduces memory usage for chunks that do not have any listeners. The dispatchers are accessed more directly instead of indirectly through chunks. In total this speeds up attempting to dispatch events especially when there are no nearby listeners.
Requirements:
mixin.util.data_storage=true
(default: true
)
Faster block and fluid access due to inlining and reduced method size
(default: true
)
Reduces indirection by inlining world height access methods
(default: true
)
Speeds up raycasts with faster block accesses and more efficient fluid handling.
(default: true
)
Removes the 1024 entry biome temperature cache hash map because the cache seems to be slow and rarely hit.
(default: true
)
Use faster tick collections and pack scheduled ticks into integers for easier tick comparisons