Feature Index

This page maps Stratum config sections to implementation files and patch files.

Source of Truth

• Config model: sources/VintagestoryLib/Vintagestory.Server/StratumConfig.cs
• Runtime wiring: sources/VintagestoryLib/Vintagestory.Server/StratumRuntime.cs, sources/VintagestoryLib/Vintagestory.Server/ServerSystemStratum.cs
• Patch behavior: files under patches/
• Link format: GitHub wiki page URLs (for example Feature:-AI-Task-Scan-Throttle)

Deep Dives

• Feature: Packet Back-Pressure
• Feature: Entity Partition Reuse
• Feature: Repulse-Agents Gate and Collision Cap
• Feature: Selection Raytrace Throttle
• Feature: Timed Despawn Stagger and Budget
• Feature: AI Task Scan Throttle
• Feature: Event Tick Adaptive Throttle
• Feature: Startup Wiring and Timer Resolution
• Feature: Chunk Send and Request Management
• Feature: Async Pathfinding Workers and Queue Cleanup
• Feature: Incremental Autosave and Chunk IO Read Pool
• Feature: Body Temperature Tick Throttling
• Feature: Block Tick Smoothing
• Feature: Physics Tracking and State Packet Batching
• Feature: Block Break Guard

Hardening

Packet limits

• Config: PacketLimits
• Runtime: StratumRuntime.PacketLimiter
• Commands: CmdStratum (/stratum packets)
• Patches: patches/VintagestoryLib/Vintagestory.Server/ServerMain.cs.patch

Packet back-pressure

• Config: PacketBackPressure
• Runtime: StratumRuntime.PacketBackPressure
• Patches: patches/VintagestoryLib/Vintagestory.Server/ServerMain.cs.patch

Block break guard

• Config: BlockBreakGuards
• Runtime: StratumBlockBreakGuard
• Commands: CmdStratum (/stratum packets report includes block-break report)

Client mod policy

• Config: ClientModPolicy
• Runtime: StratumRuntime.BuildClientModWhitelist

Performance

Chunk send/generation/request management

• Config: Performance.ChunkSending, ChunkGeneration, ChunkRequestManagement
• Patches: patches/VintagestoryLib/Vintagestory.Server/ServerSystemSendChunks.cs.patch, patches/VintagestoryLib/Vintagestory.Server.Network/TcpNetConnection.cs.patch, ServerMain.cs.patch, chunk-system patches
• Runtime: fair send window, wanted-by chunk request tracking, outbound pressure budget scaling

Join pressure controls

• Config: Performance.Join.CacheStartupPackets, Performance.Join.MaxQueueAdmissionsPerPass
• Runtime/Patches: patches/VintagestoryLib/Vintagestory.Server/ServerMain.cs.patch
• Config model: sources/VintagestoryLib/Vintagestory.Server/StratumConfig.cs

Entity and physics systems

• Config: Performance.Physics, EntityTicking, EntityCollisions
• Patches: patches/VintagestoryLib/Vintagestory.Server/PhysicsManager.cs.patch, ServerSystemEntitySimulation.cs.patch, patches/VSEssentials/Entity/Behavior/BehaviorRepulseAgents.cs.patch

Tick smoothing

• Config: Performance.BlockTicks, AutoSave, EventTick, BlockEntityInit
• Patches: patches/VintagestoryLib/Vintagestory.Server/ServerSystemBlockSimulation.cs.patch, ServerSystemLoadAndSaveGame.cs.patch, patches/VintagestoryLib/Vintagestory.Common/EventManager.cs.patch, patches/VintagestoryApi/Common/Collectible/Block/BlockEntity.cs.patch

AI and body temperature

• Config: Performance.Pathfinding, BodyTemperature
• Patches: patches/VSEssentials/Entity/Pathfinding/PathfindingAsync.cs.patch, patches/VSEssentials/Entity/Pathfinding/Astar/WaypointsTraverser.cs.patch, patches/VintagestoryApi/Server/PathfinderTask.cs.patch, patches/VSEssentials/Entity/AI/AiTaskManager.cs.patch, patches/VSSurvivalMod/Entity/Behavior/BehaviorBodyTemperature.cs.patch
• Runtime: async path workers, stale cleanup, near-player priority under queue pressure, far-task drops, repeated failure cooldowns

Timings and stats

• Config: Performance.Timings
• Runtime: StratumTimings, StratumPerformanceStats
• Commands: CmdStratum (/stratum timings, /stratum performance)

Timer resolution

• Config: Performance.TimerResolution
• Runtime: ServerSystemStratum.OnBeginConfiguration

Identity and server UX

Identity flags

• Runtime: ServerSystemStratum.OnBeginRunGame
• Output: World.Config keys stratum, stratumVersion, stratumBaseGameVersion

Commands/chat/theme/nametags

• Config: Commands, Chat, Theme, Nametags
• Runtime: CmdStratum, command helper classes, chat/theme helpers