RandomSeed must come from SlideConfig.RandomSeed (or equivalent) — never use Random.CreateFromIndex(0) or a frame-time seed.SlideSpawnSystem mixes config.RandomSeed with a per-spawn counter via DeterministicRandom.MixSeed(seed, counter + 1u) to produce avalanche-separated seeds. Seeding from ElapsedTime or a bare 0 produces identical spawn sequences across replays and breaks deterministic testing. Same pattern applies to MergeConfig.RandomSeed, SortConfig.RandomSeed, PlacementConfig.RandomSeed.
[MovedFrom] aliases are shims, not source truth. All 8 namespaces carry [MovedFrom(sourceNamespace: "DOTSPuzzle.*")] so old consumer assemblies still compile, but the REAL types live in DOTSPuzzleModes.*. Write new code against DOTSPuzzleModes.* directly.
LayerAccessibilityUtility (namespace DOTSPuzzleModes.Common) is shared plumbing for both ScrewAccessibilitySystem (Sort) and TileAccessibilitySystem (TrayMatch). Use AccumulateMin + IsAccessibleMin for Screw (outermost layer = min index); use AccumulateMax + IsAccessibleMax for TrayMatch (topmost tile = max layer). Do NOT reimplement this per-system.
SortUnit.Color == 0 means empty (matches PuzzleConstants.SortColorEmpty). Index 0 is reserved — don’t assign color 0 to a real unit.
TileData.LayerIndex is 0 = bottom of pile. Accessibility is the HIGHEST layer (IsAccessibleMax), not the lowest. Inverting the rule shows all tiles as accessible.
Vehicle occupied cells are derived, not stored. For horizontal: columns HeadX to HeadX + Length - 1 at row HeadY. For vertical: rows HeadY to HeadY + Length - 1 at column HeadX. Never store a separate occupancy list.
All 8 modes run inside PuzzleSystemGroup (from DOTSPuzzle). Add [UpdateInGroup(typeof(PuzzleSystemGroup))] on any new mode-specific system; omitting it leaves the system running in SimulationSystemGroup and breaking phase ordering.
PlacementPiece is a buffer on the board entity, not per-cell.LineClearResult is also a buffer, drained each frame by LineClearSystem. Do not query for LineClearResult as a singleton.
QueueBlock.BlockType uses PuzzleConstants.BlockType* constants — check those constants before adding new block types; duplicating a value produces silent dispatch-routing bugs.