2 Options EN
exo edited this page 2026-07-19 20:13:48 +02:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

FR | EN

Options reference (inverse view: option → effect → default → patch)

Every Folikaii configuration option: what it does, its default value, the patch(es) it controls and the per-profile recommendation. Complementary view to Patches (patch → option).

Defaults = code values verified in the fr.ekaii.config.modules modules at HEAD. Profiles: C = creaclone (whitelisted creative), A = anarchy (eternel.eu); "bake" = rbtest validation first. Recommendation details: Recommendations.

ekaii instance — all keys of ekaii_config/ekaii_global_config.toml

TOML key What the option does Default Patch(es) Profile C / A
misc.ekaii.config_version TOML schema version, managed by the server (instance bootstrap) 1 infra (batch 0) do not edit
fixes.entity_selector_region_safe.enabled Region-safe @e AABB selectors (off = stock Folia) false 0143 ON / ON
fixes.fishing_hook_cross_region.enabled Region-ownership check of the entity hooked by the fishing rod false 0144 ON / ON
fixes.tamable_cross_region_teleport.enabled Tamed-animal owner teleport across regions (restores vanilla) false 0145 ON / ON
fixes.respawn_anchor_cross_region.enabled Region-safe anchor charge consumption (off = stock synchronous write) false 0149 ON / ON
fixes.schedule_or_execute.enabled scheduleOrExecute for player ops (off = stock schedule(+1 tick)) false 0150 ON / ON
fixes.mc261810.enabled Fireworks not discarded below bedrock (MC-261810) false 0154 OFF / ON
fixes.mc298464.enabled Hoglin CHANGED_DIMENSION combat-tracker leak fix false 0155 OFF / ON
fixes.player_save_fail_hard.enabled Deliberate crash + CrashReport if a player save fails (anti-dupe-rollback) false 0156 ON = decision / NEVER
fixes.hopper_stack_copy.enabled Stack aliasing fix in hopper addItem (anti-dupe) true 0184 keep ON / keep ON
fixes.zombie_reinforcement_no_chunk_load.enabled Zombie reinforcements without sync chunk loads true 0185 keep ON / keep ON
fixes.end_gateway_region_safe.enabled Gateway exit search limited to the tick-region false 0182 OFF / ON
fixes.portal_entity_blacklist.nether_portals Blocks non-player entities in nether portals (breaks portal-based gold farms) false 0206 OFF / OFF (decision)
fixes.portal_entity_blacklist.end_portals Same for End portals false 0206 OFF / OFF
fixes.portal_entity_blacklist.end_gateways Same for gateways false 0206 OFF / OFF
fixes.sculk_catalyst_exp.enabled Correct XP at sculk catalysts (3-part Leaves fix) false 0210 (+p0027, api0016) OFF / OFF (preprod)
fixes.cross_region_move_unwind.enabled Single-tick movement ≥ threshold whose destination lands outside the region → tick unwind + async teleport (off = stock: out-of-region setPos / possible crash) false 0224 OFF / OFF (test pearl/TNT cannons before ON)
fixes.cross_region_move_unwind.threshold_blocks Minimum single-tick movement distance in blocks before the cross-region check runs (Canvas upstream value: 30) 30 0224
anti_lag.falling_block_column_limit.enabled Per-column cap on instant falling blocks false 0189 OFF / ON
anti_lag.falling_block_column_limit.limit Blocks of one column allowed to instant-fall per tick (>1) 32 0189
anti_lag.entity_weak_chunk_guard.enabled Master switch of the weakly-loaded-chunk guard false 0222+0223 OFF / ON after bake
anti_lag.entity_weak_chunk_guard.projectiles Stops/removes projectiles (except pearls) entering non-ENTITY_TICKING chunks true (inert if master off) 0223
anti_lag.entity_weak_chunk_guard.random_stroll RandomStrollGoal avoids non-entity-ticking chunks true (inert if master off) 0222
anti_xray.raytrace.enabled AntiXraySDK hooks (raytracing) in setBlock/block-break false 0221 OFF / OFF strict (reserve)
optimizations.dynamic_activation_brain.enabled AI brain throttling based on player distance (off = stock tick rates) false 0152 ON-after-test / OFF
optimizations.dynamic_activation_brain.start_distance Distance (blocks) beyond which AI is throttled 12 0152
optimizations.dynamic_activation_brain.activation_distance_mod Right-shift of squared distance for priority (higher = less aggressive) 8 0152
optimizations.dynamic_activation_brain.maximum_activation_prio Max tick interval (ticks) of distant brains 20 0152
optimizations.region_tick_flush.enabled Netty flush batched per region tick (off = stock per-packet flush) false 0157 OFF / ON after bake
optimizations.projectile_chunk_load_throttle.enabled Projectile chunk-load throttle, Canvas semantics (supersedes the base's luminol optimizations.projectile limits) false 0158 OFF / ON after bake
optimizations.projectile_chunk_load_throttle.max_loads_per_tick Projectile sync-loads allowed per region tick 10 0158
optimizations.projectile_chunk_load_throttle.max_loads_before_removal Cumulative throttled loads before projectile removal 10 0158
optimizations.projectile_chunk_load_throttle.exclude_ender_pearls Never throttle/remove pearls (protects stasis chambers) true 0158 keep true
optimizations.suffocation_optimization.enabled Skips isInWall 9/10 ticks if invulnerable false 0181 OFF / ON-after-test
optimizations.dont_save_entity.falling_block In-flight falling blocks not saved (kills saved sand lag machines) false 0183 OFF / ON
optimizations.dont_save_entity.primed_tnt Primed TNT not saved (breaks cross-restart cannons) false 0183 OFF / decision
optimizations.sakura_explosions.enabled Gated Sakura explosion/cannon opts (origin early-exit, block-counting) false 0188 OFF / ON after bake
optimizations.clump_xp_orbs.enabled Merges XP orbs into a carrier orb (test mending before production) false 0203 OFF / ON after mending test
optimizations.throttle_failed_spawn_attempts.enabled Throttles spawn attempts that keep failing false 0201 OFF / ON-after-test
optimizations.throttle_failed_spawn_attempts.failed_attempts_threshold Consecutive failures per chunk before the category is throttled 1200 0201
optimizations.throttle_failed_spawn_attempts.throttled_ticks_per_spawn_* Throttled ticks-per-spawn per category (monster=10, creature=4000, ambient=10, axolotls=10, etc.; -1 = never) per category 0201
optimizations.filter_entity_motion_packets.enabled Skips motion packets except for entities that visually need them false 0199 OFF / ON-after-test
optimizations.worldgen.aquifer_optimization C2ME aquifer rewrite — not bit-identical, mandatory seed-identical rbtest false 0212 OFF / OFF (bake)
optimizations.worldgen.beardifier_optimization C2ME beardifier rewrite (claimed bit-identical, validate anyway) false 0212 OFF / OFF (bake)
optimizations.worldgen.end_biome_cache Thread-local End biome cache (exact memoization) false 0212 OFF / OFF (bake)
optimizations.worldgen.end_biome_cache_capacity End biome cache capacity per thread 1024 0212
optimizations.fast_rng.enabled FasterRandomSource for non-worldgen random false 0209 OFF / OFF (preprod)
optimizations.fast_rng.random_generator Underlying java.util.random algorithm "Xoroshiro128PlusPlus" 0209
optimizations.fast_rng.use_direct_impl In-house LCG fast paths instead of the JDK generator false 0209
optimizations.equipment_tracking.enabled Lithium equipment dirty-flag (restart required) false 0214 OFF / OFF (preprod)
optimizations.rail_optimization.enabled Single-pass powered-rail propagation false 0218 to test / OFF (redstone policy)
optimizations.rail_optimization.activation_range Powered-rail propagation range (vanilla = 8) 8 0218
optimizations.tile_entity_snapshot_creation.snapshot_creation Snapshots at Block#getState()/getOwner(). true = stock; false = gain for polling plugins but changed API contract true 0211 (+p0028) true / true (false after CoreProtect/AEF measurement)
function.network_analyser.enabled Registers /networkanalyser (off = command absent, hooks dormant) false 0151 OFF / ON
function.alternative_keepalive.enabled Purpur alternative keepalive (off = stock Paper keepalives) false 0153 OFF / OFF (ON after bake)
function.disable_criterion_triggers.enabled No-ops all SimpleCriterionTriggers (breaks advancement grants) false 0204 OFF / decision
function.restore_clone_command.enabled Registers region-safe /clone + /spreadplayersread at boot only false 0207+0208 ON / OFF
function.packet_obfuscation.enabled foreignValue obfuscation of synched entity data (anti-ESP) false 0213 OFF / OFF (preprod)
function.no_chat_reports.enabled Strips signatures + player chat as system chat (non-reportable) false 0215 OFF / OFF strict
function.lag_compensation.enabled Master switch of TT20 lag compensation (fluids) false 0217 OFF / OFF (preprod)
function.lag_compensation.enable_for_water Compensates water ticking when the region lags false 0217
function.lag_compensation.enable_for_lava Compensates lava ticking false 0217
gameplay.copper_bulb_1gt.enabled Copper bulbs at 1 gametick (scheduled tick) instead of instant false 0202 decision / decision
gameplay.crafter_1gt.enabled Crafters at 1 gametick instead of 4 false 0202 decision / decision
gameplay.combat.disable_attack_hit_delay ATTACK_SPEED=20 spoof: removes the 1.9 attack cooldown (1.8-style delay) false 0216 OFF / decision
gameplay.combat.legacy_blast_protection Pre-1.21 Blast Protection (0.15/level on the best piece) false 0216 OFF / decision
misc.out_of_order_chat_check.enabled Vanilla OUT_OF_ORDER_CHAT kick (true = vanilla) true 0194 true / false if spurious kicks
experiment.schedule_command.enabled Registers /schedule (timer thread-safety not validated) false 0220 OFF / OFF strict

Toggles outside the ekaii instance that Folikaii uses (ours + Lophine/Luminol base)

Selection of the keys actually driven per profile (exhaustive list and traps: RECOMMENDATIONS.md §1).

Key (file) What the option does Default Patch(es) Profile C / A
optimizations.boat_launcher_sleep.enabled (luminol_config) Puts clusters of ≥50 boats from launcher machines to sleep (!) true 0134 (Folikaii) ON / EXPLICIT false
optimizations.boat_launcher_sleep.cluster_threshold / .cluster_check_interval_ticks (luminol_config) Cluster size / check interval 50 / 100 0134
spigot.yml entity-activation-range.copper-golem Dedicated copper-golem activation range 32 (identical) 0133 (+p0024, Folikaii) tune per world
function.portal_rate_limit.enable (+ maximum_portal_teleports_per_tick=200) (luminol) Caps portal TPs per tick and per region (!) key is enable; true base 0050 ON / ON (first defense against portal lag machines)
function.fakeplayer.enable (lophine) Leaves /bot fakeplayers (!) true base 0114 ON-after-test / EXPLICIT false
carpet.general.amsUpdateSuppressionCrashFix (lophine_carpet) Update-suppression crash → no-op (the real gate; lophine_global fixes.update-suppression-crash-fix = dead code) false base 0119 OFF / ON
carpet.general.shulkerBoxCCEReintroduced (lophine_carpet) Reintroduces the shulker update-suppression CCE (requires the catch-crash ON) false base 0120 OFF / ON (gameplay decision)
carpet.general.dustTrapdoorReintroduced (lophine_carpet) Pre-1.20.2 ignore-upwards-update redstone quirk false base 0121 OFF / ON-after-test
experiment.redstone.old-block-remove-behaviour (lophine_global) Pre-26.2 onRemove on ~30 blocks (US/contraption tech) false base 0126 OFF / ON-after-test
carpet.general.instantBlockUpdaterReintroduced (lophine_carpet) InstantNeighborUpdater false base 0122 OFF / OFF — never in production
fixes.item_multitask.enabled (luminol_global) No stopUsingItem on useItemOn (crystal PvP) false base 0047 OFF / ON
fixes.fix_high_velocity_issue.{enabled, warn_on_detected} (luminol_global) Base fix with the same mechanism as 0224 (unwind + async teleport via guardEntityTick) but a pre-collision point check, no threshold and no vehicle/passenger exclusions false / false base 0022 OFF / OFF (prefer the more targeted 0224 lever)
experiment.entity_damage_source_trace.enabled (lophine_global) Cross-region kill credit false base 0088 OFF / ON
experiment.command.save_all_command.enabled (lophine_global) Region-safe /save-all (+ 30 s timeout) false base 0089 ON / ON (+ Velocity CommandWhitelist)
fixes.allow_unsafe_teleportation.enabled (luminol_global) Lets entities through End portals without region checks (THE sand-dupe door) false base 0033 ON (documented) / OFF
misc.disable_warning.disable_moved_wrongly_threshold_warning (luminol_global) Disables moved-wrongly checks false base 0068 ON / OFF (anti-cheat guardrail)
misc.force_disable_packet_limiter_of_paper.force_disable (luminol_global) Disables the Paper packet limiter false base 0064 OFF / OFF (+ paper-global incoming-packet-threshold=300, do not touch)
function.secure_seed.enabled (+ version) (luminol) 1024-bit feature seed against seed-cracking false base 0052/0053 OFF / OFF — destructive on an existing world
function.tripwire_dupe.enabled (luminol) Restores the tripwire dupe (VANILLA20/21/MIXED modes) false base 0045 OFF / OFF (anti-dupe policy)
function.protocol.* (servux litematics/structures/HUD/seed/entity, syncmatica+quota, xaero, jade, rei, bbor, appleskin, PCA, alternative_block_placement) (lophine_global) Builder client protocols all OFF ((!) syncmatica useQuota=false) base 01040130 targeted ON (PCA stays OFF, syncmatica quota ON) / all OFF (share-seed: NEVER)
carpet.general.* builders (creativeNoClip, hopperCounters, noCreeperBlockBreaking, noGhastBlockBreaking, disableBlazeFire, disableGhastFire, creativeOpenContainerForcibly…) (lophine_carpet) Carpet-style builder comfort/protection false base 0116/0117/0127/0128 targeted ON / OFF (antiSpamDisabled stays false)
experiment.command.{function,scoreboard,trigger}_command_enabled, experiment.command.enable_data_command, carpet.general.commandTick Commands re-enabled under Folia (/function, /scoreboard, /trigger, /data, /tick) false base 0039/0046/00900092/0094/0129 ON-after-test / OFF
experiment.global_entities_counter.version (lophine_global) Cross-region global mob caps (DISABLED / DEFAULT_SYNC / DEFAULT_ASYNC / PRECISE; PRECISE requires paper-world per-player-mob-spawns=false) DISABLED base 0118 OFF / ON-after-test
luminol_config/kaiiju_entity_limits.yml ((!) YAML, not TOML) Per-type entity limiter/removal (destructive: removes items/falling blocks) off base 0027 OFF / emergency weapon, calibrate in preprod
optimizations.projectile.max-loads-per-tick (luminol_global) Base projectile chunk-load limit (second lever after 0158) 0 (disabled) base 0061 default / to tune
collision_behavior.mode (lophine) AABB intersection mode (BLOCK_SHAPE_VANILLA / VANILLA / PAPER) BLOCK_SHAPE_VANILLA base 0067 default / VANILLA after test
paper-world misc.legacy-ender-pearl-behavior false = pearls tracked per player (stasis chambers, base 0132 active) false base 0132 keep false / keep false

Default-ON vs default-OFF toggles

Across the ~46 gated patches, everything defaults to OFF (= stock/vanilla) except 4 deliberate default-ONs (plus one in luminol_config):

Key Why default ON Trap?
fixes.hopper_stack_copy.enabled = true (0184) Anti-dupe: the fix is wanted everywhere no
fixes.zombie_reinforcement_no_chunk_load.enabled = true (0185) Removes sync loads, negligible gameplay effect no
misc.out_of_order_chat_check.enabled = true (0194) true = vanilla behavior (the toggle exists to disable it) no
optimizations.tile_entity_snapshot_creation.snapshot_creation = true (0211) true = stock Paper behavior (the gain is at false) no
optimizations.boat_launcher_sleep.enabled = true (0134, luminol_config) 26.1.2 creaclone legacy (!) YES — the only real trap: anarchy must set false explicitly

The projectiles/random_stroll subkeys (0222/0223) and exclude_ender_pearls (0158) default to true but are inert while their master enabled is false.

Behaviors without a toggle

46 of the 92 Folikaii patches have no config lever (deliberate corruption fixes, behavior-identical pure opts, and the 0159 ThreadedTicketLevelPropagator case), plus the off-stack world-unload shutdown reroute (pick 1.9, error path only). Full list and classification: Patches — Togglability audit.

On the Lophine base side, 11 patches are classified base-missing-toggle (changed behavior without a key): including 0028 vanilla End TP, 0065 vanilla hopper, 0072 skip entity move, 0123 trapdoor revert, 0132 pearl loading. Details: CENSUS.md.

Preprod batch confirmation: OFF by default

Verified in the modules at HEAD: all divergent behaviors of the preprod batch default to OFFfast_rng, sculk_catalyst_exp, worldgen.*, equipment_tracking, lag_compensation.*, rail_optimization, raytrace, packet_obfuscation, no_chat_reports, combat.*, schedule_command = false; tile_entity_snapshot_creation.snapshot_creation = true = stock. The only two always-on parts of the preprod batch are proven behavior-identical: 0219 (byte-identical iteration order) and the "proven identical" hunks of 0212.