# Create Optimized Trains<\/p>\n
Performance optimization addon for **Create Mod** trains (Forge 1.20.1).<\/p>\n
=============================================<\/p>\n
ATTENTION: THIS MOD IS STILL IN BETA!
\nPLEASE BACK UP YOUR MAP BEFORE USING THE MOD!<\/p>\n
=============================================<\/p>\n
## Features<\/p>\n
### 1. LOD (Level of Detail) for Trains
\n– **FULL** \u2014 Real carriages with full physics (player nearby)
\n– **MEDIUM** \u2014 Simplified physics, normal rendering
\n– **LOW** \u2014 No physics, no collisions, minimal contraption updates
\n– **GHOST** \u2014 Ghost entity, no rendering, abstract data only<\/p>\n
### 2. Carriage Grouping \/ Abstraction
\n– Merges multiple carriages into a single logical entity (`TrainGroup`)
\n– Stores only: length, speed, position, carriage list as NBT
\n– Expands back when the player approaches<\/p>\n
### 3. Safe Multi-threading
\n**Secondary thread (safe):**
\n– Route calculation
\n– Collision prediction
\n– Schedule optimization
\n– Priority management
\n– LOD decisions
\n– Predictive simulation<\/p>\n
**Main thread (required):**
\n– Actual entity movement
\n– Create physics
\n– Rendering
\n– Block interaction<\/p>\n
### 4. Tick Throttling (Partial Updates)
\n– FULL: every tick
\n– MEDIUM: every 3 ticks (configurable)
\n– LOW: every 8 ticks
\n– GHOST: every 20 ticks<\/p>\n
### 5. Render Optimization
\n– Disables animations for distant trains
\n– Skips full rendering for GHOST LOD
\n– Reduces particles and visual effects
\n– Hides internal details when not visible<\/p>\n
### 6. Proxy Entities
\n– Lightweight entity representing the entire train
\n– Replaces dozens of contraptions
\n– Keeps position, speed and direction
\n– Recreates real carriages when needed<\/p>\n
### 7. Smart Chunk Loading Management
\n– Loads only essential chunks
\n– Unloads chunks behind the train earlier
\n– Pre-loads chunks ahead
\n– Anti-thrashing (prevents repeated load\/unload cycles)<\/p>\n
### 8. Physics Optimization
\n– Simplified physics for distant carriages
\n– Disables collisions between carriages at low LOD
\n– Reduces bogie checks
\n– Disables internal contraption physics when far away<\/p>\n
### 9. Networking Optimization
\n– Sends updates only when speed\/direction changes
\n– Batches packets (delta compression)
\n– Reduces sync frequency for distant trains<\/p>\n
### 10. Priority System
\n– Priority by type (EXPRESS > PASSENGER > FREIGHT > LOW)
\n– Conflict resolution at junctions
\n– Track segment reservation
\n– Async conflict analysis<\/p>\n
### 11. Dynamic Performance Monitor
\n– **NORMAL** (TPS >= 18): full fidelity
\n– **DEGRADED** (15 <= TPS < 18): light optimizations\n- **CRITICAL** (TPS < 15): aggressive optimizations, reduced LOD distances\n\n## Configuration\n\nFile: `create_optimized_trains-common.toml`\n\nAll features are individually configurable with distances, intervals and toggles.\n\n## Backported Fixes from Create 6.0.9+\n\nCreate 6.0.9 (for Minecraft 1.21.1) introduced several important fixes that were **never backported to 1.20.1**. Since 1.20.1 is no longer receiving updates from the Create team, this mod backports the following fixes for users staying on 1.20.1:\n\n### Contraption Collision Box GC Pressure (#6902)\n**Original problem:** When train doors open\/close at a station, `gatherBBsOffThread()` combines ALL block collision shapes into a single `VoxelShape` using `Shapes.joinUnoptimized()` \u2014 an O(n\u00b2) operation that creates massive temporary objects. The garbage collector can't keep up, causing **lag spikes of 1-30+ seconds** depending on train complexity.\n\n**Our fix:** `ContraptionCollisionMixin` replaces the collision gathering algorithm with the same O(n) approach used in Create 6.0.9 (commit 8f30c2c). Instead of joining VoxelShapes, it collects AABBs directly from each block's collision shape \u2014 no intermediate allocations, no GC pressure. Also includes related duplicates: #4607, #5685, #9026, #9389.\n\n### Train Stutter from carriageWaitingForChunks\n**Original problem:** In `Train.tick()`, when a carriage enters an unloaded chunk, Create sets `carriageWaitingForChunks` which forces `speed = 0` until the chunk finishes loading. On maps with many trains and limited view distance, this causes **0.5-1.5 second freezes** every time a train crosses a chunk boundary.\n\n**Our fix:** `TrainMixin` redirects all reads of `carriageWaitingForChunks` in `tick()` to always return -1, so speed is never zeroed. Combined with the Smart Chunk Loading system (pre-loading chunks ahead of the train), trains move continuously without stutter.\n\n### Collision Check Performance\n**Original problem:** `collideWithOtherTrains()` runs every tick for every train, which becomes expensive on maps with 20+ trains.\n\n**Our fix:** `TrainMixin` throttles collision checks adaptively based on server performance \u2014 every 4 ticks normally, every 8 when degraded, every 12 when critical. Each train's check is offset by its UUID hash to distribute the load evenly across ticks.\n\n## Dependencies\n\n- Minecraft 1.20.1\n- Forge 47.1.33+\n- Create Mod 6.0.8+\n- Flywheel 1.0.6+ (bundled with Create)\n\n## About us\nPublisher: GreenToastSoftware Games\u00ae\n(C)GreenToastSoftware Corporation. All rights reserved 2020-2026\n<\/p>\n","protected":false},"excerpt":{"rendered":"
Create Optimized Trains \u2014 Performance optimization addon for Create Mod trains.<\/p>\n","protected":false},"featured_media":49747,"template":"","meta":{"_minecraft_slug":"create-optimized-trains","_minecraft_project_id":"lnuz740Q","_minecraft_author":"GreenToastSoftware","_minecraft_license":"MIT","_minecraft_downloads":375,"_minecraft_follows":3,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"create-optimized-trains.zip","_minecraft_size_bytes":2092558,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T18:38:02.989443Z","_minecraft_date_created":"2026-04-17T00:11:41.406992Z","_minecraft_date_modified":"2026-05-12T11:35:43.742990Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/create-optimized-trains","_minecraft_icon_attachment_id":49747,"_minecraft_imported_at":"2026-06-02T14:32:19+00:00","_minecraft_import_hash":"418edf3abfa2cd3e64b1011a7e2c6442","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104],"mod_loader":[106],"minecraft_version":[36,60,93,94,101,102],"class_list":["post-49746","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_loader-forge","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6"],"yoast_head":"\n