Skip to content

Error codes

Cloth neXt error codes

79 documented codes. Find the code shown in the Bake window for its cause and the first recovery step.

Scene validation

Code	Cause	First step
`CNX-E100`	Unclassified scene validation failure	Correct the highlighted scene setting and retry.
`CNX-E101`	No enabled deformable object	Enable Cloth neXt on at least one Cloth, Cable / Rope, Soft Body, or Rigid Body object.
`CNX-E102`	Invalid or inconsistent Bake range	Use a valid common Bake range on all deformables.
`CNX-E103`	Unsupported or changing topology during preparation	Apply topology-changing modifiers or keep evaluated topology constant.
`CNX-E104`	Invalid material, rest-shape, or solver-quality values	Correct the highlighted value. Shrink cannot be combined with an enabled non-zero Stretch Limit.
`CNX-E105`	Invalid Pinning or constraint setup	Check Pin Groups, Advanced Pin Motion targets, Soft Constraints, target topology, and overlapping Pin Groups.
`CNX-E106`	Incompatible multi-object settings	Give all deformables a compatible range and supported configuration.
`CNX-E107`	Object disappeared during preparation	Restore the named object and do not delete it while Bake is starting.
`CNX-E108`	Invalid Force configuration	Use a supported Force on an Empty and verify that its animated values and transform are finite.
`CNX-E109`	Non-finite or malformed geometry	Repair NaN/Inf coordinates, degenerate geometry, or invalid transforms.

Companion startup

Code	Cause	First step
`CNX-E110`	Unclassified Companion startup failure	Close stale Bake windows and retry.
`CNX-E111`	Companion bundle missing or failed integrity validation	Repair or reinstall the Cloth neXt extension.
`CNX-E112`	Local Companion transport could not start	Close stale Bake windows and retry; check local security software.
`CNX-E113`	Companion process launch failed	Check Windows execution permissions, then repair or reinstall the extension.
`CNX-E114`	Companion readiness handshake timed out	Close the existing Bake window and retry.
`CNX-E115`	Companion window was not visible or topmost	Restore normal desktop/window access and retry.
`CNX-E116`	Companion authentication or protocol mismatch	Close all Bake windows and reinstall the matching extension build.

Bake preparation

Code	Cause	First step
`CNX-E120`	Unclassified preparation or export failure	Check evaluated geometry and the cache folder, then retry.
`CNX-E121`	Cache/work directory is missing or not writable	Choose a writable cache location and check free disk space.
`CNX-E122`	Evaluated geometry export failed	Check modifiers, transforms, and evaluated object geometry.
`CNX-E123`	Simulation scene or parameter encoding failed	Check geometry, materials, Pins, Constraints, Forces, and finite numeric values.
`CNX-E124`	Animated Pin target capture failed	Check each animated Pin target, keep evaluated topology stable, and keep target objects available throughout the Bake range.
`CNX-E125`	Insufficient disk space	Free disk space or move the cache to a larger writable volume.
`CNX-E126`	Bake worker could not start	Retry after other heavy jobs finish; restart Blender if thread creation keeps failing.
`CNX-E127`	Interrupted or stale partial Bake state	Clear the partial result or Rebake; the last complete cache remains safe.
`CNX-E128`	Animated Collider capture failed	Keep the Collider's evaluated topology stable and check the reported frame, transform, and active simulation proxy.
`CNX-E129`	Recovery checkpoint is missing, corrupt, or incompatible	Choose a compatible verified checkpoint, or use Start Fresh after preserving needed files.

Solver startup

Code	Cause	First step
`CNX-E130`	Unclassified solver startup failure	Run the solver health check, then repair the selected managed installation or choose another compatible solver.
`CNX-E131`	Solver executable, native worker, or runtime dependency missing	Restore or repair the verified solver; if security software quarantined it, allow the solver folder.
`CNX-E132`	Solver protocol, schema, or package is incompatible	Install the solver version required by this Cloth neXt release.
`CNX-E133`	Solver health or readiness check failed	Repair the managed solver and inspect its startup diagnostics.
`CNX-E134`	Solver process exited during startup	Inspect the solver stderr tail; update GPU drivers or repair dependencies.
`CNX-E135`	Solver execution permission denied	Allow the signed solver executable and retry.
`CNX-E136`	Configured local solver port is occupied by another service	Close the conflicting service or choose another port; Cloth neXt will not stop foreign processes.

Scene upload

Code	Cause	First step
`CNX-E140`	Unclassified scene upload failure	Check the local solver connection and retry.
`CNX-E141`	Solver connection or response timed out	Retry and check whether security software blocks localhost traffic.
`CNX-E142`	Solver connection closed or broke	Retry after the solver health check succeeds.
`CNX-E143`	Solver rejected or did not acknowledge upload	Inspect the diagnostic log and verify the matching solver version.
`CNX-E144`	Uploaded payload hash or identity mismatch	Repair the solver installation and retry with a fresh Bake.
`CNX-E145`	Malformed or oversized solver response	Repair or update the solver to the supported protocol version.

Solver connection

Code	Cause	First step
`CNX-E146`	solver control server exited while an owned solver descendant remained active	Keep the diagnostic log and retry after Cloth neXt confirms owned-process cleanup.

Water Flow

Code	Cause	First step
`CNX-E147`	Water Flow grid or sequence exceeds its memory budget	Check the reported grid and memory estimate. Shorten the Bake duration or choose a smaller field. Preparing a .gaia cache alone is frame-wise.

Project build

Code	Cause	First step
`CNX-E150`	Unclassified solver project build failure	Inspect scene geometry and the solver diagnostic log.
`CNX-E151`	Solver rejected project build	Inspect geometry, materials, Pins, Constraints, Friction Regions, and Forces in the diagnostic log.
`CNX-E152`	Project build timed out	Simplify the scene or increase stability/performance headroom, then retry.
`CNX-E153`	Contact or geometry initialization failed	Repair intersections, degenerate faces, and invalid collision geometry.
`CNX-E154`	Solver project was unexpectedly busy	Wait for the owned solver to stop, then retry.

Simulation

Code	Cause	First step
`CNX-E160`	Unclassified simulation failure	Inspect the failing frame and solver diagnostic log.
`CNX-E161`	Constraint solver did not converge	Lower Friction first. If it still fails, reduce Pressure and Collision Gap, increase animated Collider sampling, then try a smaller Time Step.
`CNX-E162`	Intersection blocked the simulation from advancing	Use Intersection Diagnostics and Auto Fix Intersections for mapped initial self-intersections. Otherwise separate the geometry; for inflation or self-contact, lower Pressure, add clearance, or use a smaller Time Step.
`CNX-E163`	Simulation stalled or timed out	Inspect the last frame, reduce scene complexity, and retry.
`CNX-E164`	Solver process crashed or exited	Inspect the solver stderr tail for the underlying cause (intersection, non-finite, or convergence) before checking GPU/driver stability.
`CNX-E165`	Non-finite simulation result	Reduce Time Step and extreme Force, material, constraint, or Motion Override values; repair invalid input geometry.
`CNX-E166`	RAM safety limit or solver memory exhaustion	Lower scene complexity; raise the Auto-Cancel on High RAM threshold only when sufficient system memory is available.
`CNX-E167`	Solver completed without every requested frame	Keep the diagnostic log and retry after a solver health check.
`CNX-E168`	Force or parameter instability	Reduce animated Force magnitude and extreme material parameters.
`CNX-E169`	Unexpected solver state	Stop other solver work, run the solver health check, and start a fresh Bake.

Result transfer

Code	Cause	First step
`CNX-E170`	Unclassified result transfer failure	Check disk space and the local solver connection.
`CNX-E171`	Result transfer timed out	Check disk performance and localhost security software, then retry.
`CNX-E172`	Connection broke during result transfer	Retry after a successful solver health check.
`CNX-E173`	Invalid or missing solver output map	Keep the diagnostic log and repair/update the solver.
`CNX-E174`	Requested result frame is missing	Retry; report the diagnostic log if the same frame is missing again.
`CNX-E175`	Result frame is corrupt or cannot be decoded	Check disk integrity and repair/update the solver.
`CNX-E176`	Result size or vertex count mismatch	Restore the original topology and Rebake.

Playback cache

Code	Cause	First step
`CNX-E180`	Unclassified playback-cache failure	Check cache access and target topology.
`CNX-E181`	Playback cache could not be written	Choose a writable cache folder with sufficient free space.
`CNX-E182`	PC2 finalization failed	Check disk space and filesystem reliability, then Rebake.
`CNX-E183`	Object topology changed before import	Restore the topology used when the Bake began and Rebake.
`CNX-E184`	Target object no longer exists	Restore the target object and Rebake.
`CNX-E185`	Playback attachment failed	Remove conflicting cache modifiers or animation and retry.
`CNX-E186`	Cache integrity validation failed	Do not use the partial cache; Rebake to create a verified result.
`CNX-E187`	Multi-object cache set is incomplete or inconsistent	Keep every target object unchanged and Rebake the full set.
`CNX-E188`	Cable / Rope Curve playback could not be applied	Restore the original Cable / Rope Curve topology and remove conflicting Curve animation.

Cleanup

Code	Cause	First step
`CNX-E190`	Unclassified cancellation cleanup failure	Wait for cleanup; restart Blender only if the owned process remains stuck.
`CNX-E191`	Cancellation did not complete in time	Wait briefly, then restart Blender if the owned solver remains active.
`CNX-E192`	Owned solver process could not be stopped	Close Blender after preserving diagnostics, then retry.
`CNX-E193`	Temporary or partial files could not be removed	Close programs using the cache folder and clear the partial result.

Internal

Code	Cause	First step
`CNX-E198`	Bake worker stopped without a terminal result	Preserve diagnostics and restart Blender before retrying.
`CNX-E199`	Unexpected internal failure	Preserve the diagnostic log and report the code and full Blender error.