Create: Advanced Optimization
A server-focused optimization and diagnostics toolkit for Create on NeoForge.
About
Create: Advanced Optimization is a server-focused performance and diagnostics mod designed for large Create factories, logistics networks and automation-heavy worlds.
It reduces avoidable work in selected Create systems while providing built-in tools to profile machines, belts, fluids, packages, trains and logistics without changing normal Create progression or machine behavior.
Highlights
- Targeted Create performance optimizations
- Spout recipe caching
- Basin and Mechanical Crafter recipe memoization
- Belt tick fast paths
- Belt Funnel and Deployer fast rejection
- Optimized Diving Boots state checks
- Built-in Create performance profiler
- Package Entity and belt diagnostics
- TXT, HTML and JSON report exports
- Compare profiling sessions directly in-game
- MSPT, lag spike and hotspot analysis
- Configurable optimization and diagnostic systems
Requirements
Minecraft: 1.21.1 Loader: NeoForge 21.1.233+ Create: exactly 6.0.10 Java: 21
Create is a required dependency and must be installed separately.
Create: Advanced Optimization intentionally targets Create 6.0.10 exactly to avoid applying low-level optimizations against incompatible Create internals.
Performance Optimizations
Create: Advanced Optimization uses conservative fast paths and caching rather than globally slowing machines or skipping arbitrary ticks.
Active systems include:
- Spout Recipe Cache - caches bounded official Create filling recipe lookups per Spout
- Processing Memoization - reuses Basin and Mechanical Crafter recipe lookup results within safe one-tick windows
- Belt Tick Fast Paths - reduces unnecessary belt maintenance work without changing item movement cadence
- Belt Funnel Fast Rejection - avoids redundant stack operations when an exact insertion cannot succeed
- Deployer Fast Rejection - skips unnecessary copy and split work when a Deployer hand is already full
- Diving Boots Optimization - avoids redundant HeavyBoots marker writes and removals
No recipes are changed.
No machines are intentionally slowed down.
Systems such as trains, railway managers, Redstone Links, global logistics and track synchronization are profiled for diagnostics but are not automatically modified unless explicitly listed as an optimization.
Create Profiler
Profile a busy factory directly in-game and identify which Create systems consume the most server time.
The profiler covers systems including:
- Create machine tickers
- Belts and belt inventories
- Funnels and inventory extraction
- Fluid transport and pipe resolution
- Spouts and filling recipes
- Deployers
- Package Entities
- Global logistics
- Chain Conveyors
- Railway management
- Train map synchronization
- Track graph synchronization
- Redstone Links
- Diving Boots
Each profiling session can export:
- Human-readable TXT report
- Visual HTML report
- Structured JSON report
- Average and maximum MSPT
- Lag spike information
- Create-related hotspots
- Package diagnostics
- Optimization counters
- Alerts and recommendations
Reports are grouped into dedicated export folders and include clickable shortcuts to the generated files.
Diagnostics
Create: Advanced Optimization includes dedicated diagnostic tools for quickly narrowing down problematic Create systems.
/cao diagnose
Provides a combined summary of profiler activity, Package Entity signals and belt diagnostics.
/cao packages top [limit]
Finds loaded chunks containing the highest numbers of active Create packages.
/cao packages stalled [limit]
Identifies Package Entities that appear stationary for unusually long periods.
/cao belts scan [limit]
Scans loaded Create belt controllers and highlights the busiest or largest belt systems.
These tools are designed to help locate the area worth investigating before running more detailed profiling.
Report Comparison
Multiple profiler sessions can be compared directly with:
/cao report compare
The comparison includes changes in:
- Average MSPT
- Maximum MSPT
- Lag spike counts
- Profiled Create time
- Major hotspots
When available, clickable buttons can open both the older and newer HTML reports for side-by-side investigation.
Commands
All commands require permission level 2.
/cao status- View mod, profiler, optimization and package status/cao stats- View optimization and cache activity/cao stats reset- Reset optimization statistics/cao profile start- Start profiling using the configured default duration/cao profile start <seconds>- Start a 5 to 3600 second profiling session/cao profile stop- Stop the current session and export its reports/cao diagnose- Run a combined diagnostic summary/cao report- Export the latest available profiler data/cao report last- View information about the latest export/cao report compare- Compare the latest report exports/cao packages top [limit]- Find package-heavy chunks/cao packages stalled [limit]- Find stationary Package Entities/cao belts scan [limit]- Inspect loaded belt controllers/cao reset- Reset profiler, cache and package diagnostic data
The full /createadvancedoptimization command is also available as an alternative to /cao.
Configuration
Server owners can individually configure:
- Global optimization master switch
- Diagnostics and report generation
- Lag spike threshold
- Default profiler duration
- Package Entity warning threshold
- Spout recipe caching
- Spout cache size
- Processing recipe memoization
- Belt tick fast paths
- Belt Funnel fast rejection
- Deployer fast rejection
- Diving Boots optimization
- Experimental package behavior
- Debug logging
Experimental Package Entity behavior remains disabled by default.
Support the Project
Enjoying Create: Advanced Optimization?
Support future updates and upcoming Our Story projects through Patreon.
For support, profiling reports, compatibility feedback or bug reports, join the Our Story community on Discord.
Game Hosting
Need a server for your Create projects?
Host your server with BisectHosting and use code OURSTORY for 25% OFF.
Every purchase helps support the development of Our Story projects.
Created by LevelsFR
CurseForge • Modrinth • Discord • • GitHub
How to Install Create: Advanced Optimization (Mod)
Create: Advanced Optimization by LevelsFR is verified for Neoforge across Minecraft versions 1.21.1 (latest release: 1.6, file size: 802 KB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.21.1) and platform (Neoforge).
- Make sure you have the compatible loader or environment installed for Neoforge.
- Move the downloaded Create: Advanced Optimization file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add Version
## Changes
- Improved **Create Diving Boots data handling** to avoid creating empty persistent data for living entities that do not wear the boots, while continuing to remove stale
HeavyBootsmarkers from entities with existing data.
## New
- Added **
/cao diagnose** to summarize profiler, PackageEntity, and belt signals. - Added **JSON report exports** with hotspots, package data, counters, alerts, and recommendations.
- Added **
/cao report compare** with MSPT, lag-spike, Create-time, and hotspot comparisons. - Added direct buttons to open the **older and newer HTML reports** from comparisons.
## Changes
- Reports are now grouped into **dedicated per-export folders** containing TXT, HTML, and JSON files.
- Export messages now provide direct buttons to open the **HTML, TXT, JSON, and report folder**.
/cao profile startnow uses the configured default duration when no duration is specified.
## Fixes
- Fixed **PackageEntity peak and spawned counts** carrying over between profiling sessions unless
/cao resetwas used.
## New
- Added **mechanical belt optimizations** that reduce redundant block-state lookups and empty passenger processing without changing belt speed or throughput
- Added
/cao belts scan [limit]to inspect loaded belts and identify the busiest controllers - Added detailed **belt profiling** for segments, controllers, empty inventories, and active item transport
- Added
optimizations.belts.tickFastPathsto enable or disable the new belt optimizations
## New
- Added profiler coverage for **fluid networks**, including pipe flow and source checks
- Added profiler coverage for **funnels** and inventory extraction
- Added profiler coverage for the general **Create machine tick loop**
- Added clearer report sections for **hotspot families**, per-tick cost, and troubleshooting hints
## Changes
- Report chat actions now focus on copying **HTML**, **TXT**, and **folder paths**
- Reports now make **stalled packages** and package-heavy chunks easier to inspect
- Continued support for Minecraft **1.21.1**, NeoForge **21.1.233**, Java **21**, and Create **6.0.10**
## New
- Added **/cao stats** to quickly view optimization and cache activity
- Added **/cao stats reset** to clear statistics without restarting
- Added **English and French language support** for command text
- Added clearer **cache hit, miss, and invalidation stats**
## Changes
- Improved **Spout cache behavior** when disabled
- Improved **Mechanical Crafter memoization** for safer recipe checks
- Improved **Basin memoization** to better respect world context
- Improved **Package Entity diagnostics** so disabled diagnostics stay fully inactive
- Improved profiler reports to show **session-only optimization events**
- Simplified **Diving Boots optimization** to avoid stale entity state
## Fixes
- Fixed a crash when **Mechanical Crafters had no valid recipe**
- Fixed client crash caused by the **Basin optimization mixin**
- Fixed recipe caches not being reliably cleared after **/reload**
- Fixed cache results being reused across **different dimensions**
- Fixed misleading profiler reports showing old optimization counters
## Removed
- Removed the old **Diving Boots no-boots shortcut** that could become unreliable
- Removed misleading global optimization totals from profiler reports
## New
- Added **optimization counters** to show how much work the mod avoids
- Added **belt**, **funnel**, and **deployer** details to CAO reports
- Added **PackageEntity stall diagnostics** to help find blocked package logistics
- Added
/cao packages stalledto locate **stuck or old packages** - Added **exact chunk block ranges** to package hotspot reports
- Added **Open Report Folder** and **Copy Folder Path** buttons to report exports
- Added a disabled-by-default **experimental package setting** for future testing
## Changes
- Improved **Diving Boots checks** for entities not wearing the boots
- Improved **belt funnel handling** in blocked item setups
- Improved **deployer insertion handling** when deployer hands are full
- Reduced CAO diagnostic overhead when no profile is running
- Improved reports with clearer **optimization savings**
