Every switch
All 36 switches of 0.4.3, section by section, with their defaults and the words of the config file - written out of the mod's own code.
On this page 8 parts
Every switch of STYGION Optimize 0.4.3, written out of the mod's own config code (tools/docs/settings-page.py in its repository) - the same words the config file carries beside each line. 36 switches. Switches marked 0.4.1 to 0.4.3 in the changelog reach CurseForge with the next release; What it is has the overview.
config/stygion_optimize-common.toml takes effect without a restart where the game allows it (a few say otherwise); config/stygion_optimize-startup.toml is read once, before the game starts. A switch whose mod is not installed does nothing and says so in the log line STYGION Optimize writes at start.
stygion_optimize-common.toml
#[autosave]
#Autosave (every 5 minutes) and saving players when they leave.
| Switch | Default | What it does |
|---|---|---|
asyncPlayerFiles |
true |
Player data (.dat), statistics and advancements are still collected on the main thread, but compressed and written to disk on a background thread. Each file is written to a temporary file and renamed, so a crash never leaves a half-written file. A player who logs in again waits until their files are on disk. Server stop and /save-all flush wait for every file. |
skipUnchangedAdvancements |
true |
Do not write a player's advancements again when no criterion changed since the last write (checked with a fingerprint of all progress; the first save after joining always writes). |
sableAsyncSync |
true |
Sable (ships) syncs its sub-level storage files to disk (fsync) on the main thread at every autosave. With this on the data is still written on the main thread, only the sync and the closing of the file run on the background thread. Has no effect without Sable. |
logAutosaveOverMs |
0 (-1 - 600000) |
Write one log line with the time of each autosave on the main thread (players, worlds, files skipped) when it took at least this many milliseconds. 0 = every autosave, -1 = never. |
[tick]
#Server tick. Each switch changes only how fast a result is computed, never the result.
| Switch | Default | What it does |
|---|---|---|
spawnBiomeShortcut |
true |
Natural mob spawning looks up the biome of every spawn attempt (vanilla blends the eight nearest 4x4x4 biome cells with a pseudo-random offset). When all eight cells lie in sections that hold one single biome, the answer is that biome whatever the offset, so it is returned without the blending. Anywhere else (biome borders) the vanilla lookup runs. Same biome, same mob, same random numbers as vanilla. |
pathfindingEmptyChunkReuse |
true |
Mob pathfinding asks for blocks in chunks that are not loaded; vanilla builds a new empty chunk (24 empty sections) for every such block lookup. With this on, one empty chunk per position is built per path search and reused. The answers (void air, no fluid) are the same. |
ntglIdleSyncSkip |
true |
NTGL (guns) scans all its synced entity flags of every entity it ever saw, every server tick, to find the ones that changed. With this on the scan is skipped in ticks where no flag was set since the last scan; when one was, the scan runs exactly as before. Has no effect without NTGL. |
inventoryTriggerIndex |
true |
Every changed slot of a player's inventory tests every "inventory changed" advancement criterion the player has not got yet (each recipe of each mod has one: thousands in a big pack). With this on the criteria are indexed by the item they look for, so only those that can match the changed item (and those that cannot be indexed) are tested, with vanilla's own test, in vanilla's order. |
fireCheckSkip |
true |
After every move vanilla scans the blocks inside the entity for fire and lava, only to reset a fire timer that is already reset or to play the "fire went out" sound for an entity that was burning. With this on the scan is skipped when neither can happen (the entity was not burning). |
lightSectionsCopyOnWrite |
true |
After every batch of light changes vanilla copies the light map of every loaded section of the world (hundreds of thousands on a busy server: megabytes per batch, many batches a second while ships fly into new chunks) so other threads can read a stable snapshot. With this on the map is split by 8x8 chunk columns and a copy shares every part that did not change. Same light values; applies when a world loads. |
logSyncChunkLoadsOverMs |
-1 (-1 - 600000) |
Diagnostics: write a log line when the main thread waits at least this many milliseconds for a chunk that is not loaded yet, with the chunk and the code that asked for it (at most one line per caller per minute, with the count since its last line). -1 = off. Costs nothing while no such wait happens. |
structureSearchAsyncChunks |
true |
Explorer's Compass generates a candidate chunk of its structure search on the main thread and the server waits for it (over a second for one chunk far away). With this on the chunk is generated by the world generation threads and the candidate is tried again next tick: the same search, the same structure found, no wait. Has no effect without Explorer's Compass. |
adAstraPlanetCache |
true |
Ad Astra looks up the planet of a level (oxygen, temperature) for every ticking chunk every tick. With this on the answer is kept on the level until Ad Astra reloads its planets. Same values. Has no effect without Ad Astra. |
[fixes]
#Fixes for bugs of other mods.
| Switch | Default | What it does |
|---|---|---|
carryOnSyncSnapshot |
true |
Carry On 2.2.x sends a player's live carry data to other players (when they come into view and on joining); the network thread encodes it while the main thread keeps changing it, which sometimes fails and disconnects the receiving player. With this on the packet takes a copy when it is created (on the main thread). The client gets the same data. Has no effect without Carry On. |
sableNoSyncChunkLoads |
true |
Server. Sable mirrors every block change (ships or not) into its physics world and, when the block is at the edge of the loaded world, loads or generates the neighbouring chunk on the main thread for it (0.5-2.5 s, Sable issue #1160). With this on that update waits until the chunk is loaded anyway and is then applied the same way. Has no effect without Sable. |
parcoolSableMethodCache |
true |
ParCool x Sable looks up ParCool's methods by reflection on every ParCool action tick of every player and throws an exception for each superclass it climbs on the way. With this on each lookup is done once per class and remembered (same method, or none). Has no effect without ParCool x Sable. |
playersDontWaitForChunks |
false |
Changes behaviour slightly, off by default. A player whose own chunk is not loaded yet (carried into new terrain by a fast ship, teleported) makes the main thread wait until it is read or generated, which stalls the whole server. With this on that player's own server tick (movement, effects, food) pauses until the chunk is there, as vanilla already does for spectators and as the client does anyway; the rest of the server keeps running. The chunk loads as before through the player's own ticket. |
quietLoggers |
["tacz_aero_compat"] |
Loggers (usually a mod id) whose INFO and DEBUG lines are dropped; warnings and errors still come through. tacz_aero_compat 1.8.0 writes an INFO line for every gun shot (its raytrace hook), thousands a day on a busy server. Empty = the log as the mods write it. |
movementGuard |
true |
Crash fix. A single move longer than movementGuardMaxBlocks on an axis, or not finite (a player put into a Sable ship plot 20 million blocks away, an infinite velocity from a mod), makes the block collision visit every chunk on the way on the main thread and the server hangs until the watchdog kills it. With this on such a move is dropped: the entity stays where it is for that tick, loses its velocity, and one line per entity a minute goes to the log. No legitimate move comes near the limit. |
movementGuardMaxBlocks |
1024.0 (64.0 - 1.0E7) |
Longest move on one axis in one tick (blocks) that movementGuard lets through. |
sablePlotGuard |
true |
Crash fix. Sable keeps ships in plots far from the world; a teleport aimed at a block of a ship (bed or respawn anchor on a ship, waystone on a ship, commands, other mods) put the player there on the server while the client stayed by the ship, and the server froze. With this on every teleport of a player into a plot lands where that block of the ship is in the world now (on the ship); when the ship is not loaded, on the player's last safe spot or the spawn. Players riding a seat are left to Sable. Has no effect without Sable. |
submarineFloatScanGuard |
true |
Freeze fix. Create: Deep Seas asks every boat each tick whether it floats by walking a column of blocks from the boat's highest corner to its lowest; a Sable ship with absurd numbers made that column millions of blocks tall and the server stood still for seconds. With this on the walk is cut to the world's height: the same answer, without the empty steps. Has no effect without Create: Deep Seas. |
sableDistanceFastPath |
true |
Sable measures every entity distance through ships: both points are copied into new vectors and projected out of a ship's plot, each time (mob spawning asks for the nearest player thousands of times a second). When neither point is in a ship's plot the distance is the plain one, and with this on it is worked out without allocating; points on ships go through Sable as before. Has no effect without Sable. |
atmosphereWeatherFastPath |
true |
Atmosphere (inside Slice & Dice) answers "is it raining here" for every mob each tick through stream pipelines, and its Sable proxy also looks inside every ship within ten blocks. With this on the same answers come from plain loops, and nothing is asked when there is no local weather at all. Has no effect without Atmosphere. |
betterChunkLoadingLogoutFix |
true |
Crash fix. Better Chunk Loading 5.4 crashes the server when a player leaves while one of the chunks it ticketed for them is already gone (NullPointerException in removeTicketfor). With this on such a ticket is removed like one of a chunk that is not loaded yet. Has no effect without Better Chunk Loading. |
cannonClaimGuard |
true |
Claim fix. Create Big Cannons breaks blocks past the explosion event FTB Chunks protects claims with: shells, impacts and shots going through blocks broke claimed bases. With this on a cannon breaks and wears only blocks FTB Chunks would let an explosion break (unclaimed land, a team that allows explosions, or protection switched off); shells still fly, hit, hurt and explode. Has no effect without both mods. |
[mobs]
#Mobs: how often far mobs think, brainless mobs from mob farms; both off by default.
| Switch | Default | What it does |
|---|---|---|
farMobAi |
false |
A mob farther than farMobAiStartDistance from every player of its world chooses new goals (vanilla: every second tick) and runs its brain (villagers, piglins, ...) only every n-th time, n growing with the distance up to farMobAiMaxInterval. Movement, physics, goals it already runs, navigation and despawning stay every tick, so a far mob keeps moving and only notices new things later. Never throttled: mobs with a target, hurt in the last 5 s, named, leashed, tamed, riding or ridden (Create seats and contraptions), on or in a Sable ship, raiders of a raid, bosses (#c:bosses) and farMobAiExclude. |
farMobAiStartDistance |
32 (8 - 512) |
Blocks. Within this distance of a player mobs think every tick as in vanilla. At 1.4x this distance a mob chooses goals half as often, at 2x a quarter as often, and so on. |
farMobAiMaxInterval |
8 (1 - 40) |
The sparsest a far mob thinks: once every this many times. |
farMobAiBrains |
true |
Also run the brains of far brain mobs (villagers, piglins, axolotls, ...) less often. |
farMobAiExclude |
["minecraft:warden", "minecraft:elder_guardian", "minecraft:ender_dragon", "minecraft:wither"] |
Entity ids or tags (#namespace:path) whose AI is never throttled. |
spawnerFarmMobs |
OFF |
Brainless mobs from mob farms. A mob spawned by a farm spawner does not think at all: no goals, targets, pathfinding or brain, it does not attack, explode or pick up items. Its body stays: gravity, water and bubble columns, knockback, damage, burning, drops and experience, so water-stream and grinder farms work as before and the mobs cost only their physics. PLAYER_SPAWNERS: spawners a player (or a machine acting as one) placed, or changed with Apothic Spawners modifiers; dungeon and structure spawners left where they were generated stay dangerous. ALL_SPAWNERS: every mob spawner (never trial spawners). OFF: vanilla. Never brainless: named or leashed mobs, bosses (#c:bosses) and spawnerFarmMobsExclude. |
spawnerFarmMobsExclude |
["minecraft:warden", "minecraft:elder_guardian", "minecraft:ender_dragon", "minecraft:wither"] |
Entity ids or tags (#namespace:path) that keep their AI even from a farm spawner. |
[client]
#Client (single player or a client with this mod installed).
| Switch | Default | What it does |
|---|---|---|
sableResizeBuild |
PLAYER_AFFECTED |
Sable rebuilds the changed sections of a ship near the camera synchronously (a frame stall) every time the ship grows, i.e. with almost every block placed on its outside, for every player nearby. PLAYER_AFFECTED: only sections you changed yourself are built at once, the rest in the background. NONE: everything in the background. NEARBY: as Sable does. Has no effect without Sable. |
stygion_optimize-startup.toml
#[missingIds]
#Blocks and items of mods that are no longer installed.
| Switch | Default | What it does |
|---|---|---|
missingIdAliases |
true |
Vanilla turns a block of a removed mod into air when its chunk loads, and logs an error for every such block palette entry each time the chunk loads again until it is saved. With this on, every id in 'aliases' that no installed mod registers loads as the given block (and as that item in inventories). Ids that a mod does register are left alone. |
aliases |
["createpropulsion:deepslate_platinum_ore=minecraft:deepslate", "createpropulsion:platinum_ore=minecraft:stone"] |
Entries 'old_namespace:old_id=new_namespace:new_id'. The target must exist; a block entry also applies to the item with the same id when that item exists. |
Did this page help?
Opens the feedback panel with this page attached. It lands in the same queue as everything else.