Troubleshooting

This section covers common issues and their solutions when working with the Master Spline Tool.

Performance Issues

Tool becomes slow or unresponsive

Problem: The tool becomes laggy, especially during undo/redo operations.

Cause: Very long splines (e.g., 10km master spline) with multiple linked layers create performance bottlenecks.

Solution: Reduce the complexity of your splines:

• Break long splines into shorter segments
• Reduce the number of linked layers
• Simplify complex spline shapes

Spline Visibility Issues

Spline disappears

Problem: Spline becomes invisible or can’t be found.

Cause: Spline may be underground, off-screen, or have color/lighting conflicts.

Solution:

• Use the “Go To Spline” button to locate and focus on the spline
• Check if the spline is underground or positioned off-screen
• Adjust lighting or color settings if there are visibility conflicts

Layer Coordination Issues

Layers not following master spline properly

Problem: Linked splines don’t move correctly with the master spline, or they fold/overlap.

Cause: Master spline has very tight bends or extreme curvature.

Solution:

• Reduce the curvature in the master spline
• Make bends more gradual and less sharp
• Use straighter sections where possible
• Avoid sudden direction changes

Road Design Standards Issues

Road design standards are too restrictive

Problem: The tool moves the road too much when applying design standards, making it unrecognizable.

Cause: Selected preset (e.g., ‘Highway’) has very strict constraints.

Solution:

• Try weaker constraint presets like ‘Mountain Pass’ which adjust the spline less
• Switch off the optimizations entirely and manually adjust the spline
• Use the violation overview to see where the road violates the design standard
• Make manual adjustments to resolve violations

Path Generation Issues

Auto-generated paths are jaggy or go in wrong directions

Problem: The path generation feature creates poor quality routes.

Cause: This is an experimental feature that can produce unexpected results.

Solution:

• Play with the generation parameters to find better settings
• Try generating shorter paths (longer paths are more problematic)
• Be patient - the algorithm can be slow for complex routes
• Consider manual path creation for critical routes

Session Management

Splines disappear between sessions

Problem: Work is lost when restarting the tool.

Cause: Splines are designed not to persist between sessions by default.

Solution:

• Use the round-trip recovery system to import existing splines
• Select objects in the scene tree to estimate spline parameters
• The tool can recover splines from scene meshes automatically

Tool Integration Issues

Other tools won’t link to master spline

Problem: Can’t create linked splines from the master spline.

Cause: User may be looking for a separate link button.

Solution:

• Click directly on the tool creation buttons (e.g., “Create Mesh Spline”) from the master spline
• This automatically creates a new spline and links it in one operation
• No separate linking step is required

When to Report Bugs

If you encounter any of these issues, they may indicate a bug:

• Undo/redo history not working properly
• Tool window freezing without performance cause
• Shape locking not functioning
• File corruption or unreadable data

Recommendation: Reload the tool and try again. If the problem persists, check the console for error messages and report the issue with specific steps to reproduce.