Tensio: Advanced Rope Physics

Official Resources

• Documentation: https://fatihbykl.github.io/docs/tensio/
• Discord Community: https://discord.gg/CGpunqn49e
• Support Email: [email protected]

TENSIO: High-Performance DOTS Rope & Chain Physics

Tensio is a cutting-edge rope and chain simulation framework designed for developers who need more than just a visual line renderer. Whether you are building a grappling hook mechanic, complex physics puzzles, or highly reactive environments, Tensio provides the industrial-grade stability required for gameplay-critical physics.

Built entirely on the Extended Position Based Dynamics (XPBD) method and fully leveraging Unity's Data-Oriented Technology Stack (DOTS), Tensio simulates elasticity, stiffness, mass, and aerodynamics across hundreds of ropes simultaneously with virtually zero CPU overhead.

KEY FEATURES

Advanced XPBD Physics Solver

• Motion Interpolation: The physics solver smoothly interpolates with the render loop, completely eliminating visual ghosting for buttery-smooth rope motion at any framerate.
• Isometric Bending Constraints: Ropes resist unnatural folding and buckling, maintaining realistic 'U' shapes even under high compression.
• Fictitious Mass Scaling: Create infinitely stable heavy chains. Attach massive Rigidbody weights to the bottom of a chain without artificially stretching the top segments.
• Coulomb Friction & Restitution: True physical friction based on penetration depth. Ropes slide naturally across surfaces but physically "bite" and hold tight when pulled over sharp edges.
• Two-Way Coupling: Real physical interaction; ropes apply forces to Rigidbodies, and Rigidbodies dynamically pull on ropes.
• Zero-Pop Initialization: Ropes pre-simulate in the editor using actual gravity and exact zero-velocity damping. They wake up perfectly settled on the very first frame with absolutely zero start-up jitters.

Intuitive Editor & Workflow

• Smart Debris Management: Automatically clean up severed, unpinned rope pieces during intense slicing. Choose between Simulated or highly-optimized Rigid modes, complete with smooth scale-to-zero animations to preserve performance.
• Unity Splines Integration: Rapidly design and route cables across your scenes using Unity’s official Splines package.
• 1-Click Static Mesh Baking: Instantly freeze a simulated rope at its perfect resting position and bake it into a highly optimized Static Mesh asset. Perfect for zero-cost environment dressing (power lines, vines, etc.).
• Teleportation Protection: Move pinned anchors freely via script or Scene View without triggering explosive physics "whip" effects.

Powerful Runtime API

• Smart Splitting: Slice ropes at any point in real-time using splitAtWorldPosition(worldPos).
• Dynamic Forces: Easily apply physical impacts using AddExplosionForce or push specific particles via code.
• Winching & Pinning: Smoothly reel ropes in or out using the ChangeLength() helper, and dynamically drop or attach weights mid-gameplay.

Procedural Rendering & Collisions

• Braided Geometry & Torsional Twist: Generate realistic multi-strand ropes. Apply procedural visual twist with explicit tangents for flawless URP/HDRP normal map lighting.
• Stretch-Reactive Twist: Physics meets art! Twist density dynamically reacts to physical tension, causing ropes to realistically uncoil when pulling heavy weights.
• Animated Spinning: Animate the twist offset over time to effortlessly simulate drills or rapidly rotating mechanical shafts.
• Visual Stress: Responsive procedural tube meshes physically thin out and change color as tension increases. Specialized chain link rendering is also included.
• Self & Inter-Rope Collision: Ropes will not pass through themselves, and multiple ropes can tangle and interact complexly.
• Aerodynamics: Built-in wind and turbulence simulation with realistic air drag.

Immersive 3D Spatial Audio

• Dynamic Tension SFX: Procedural creaking and snapping sounds modulate pitch and volume based on real-time stress. Hear the rope strain before it breaks!
• 3D Spatial Tracking: Audio sources dynamically slide along the length of massive cables to stay closest to the player's AudioListener.
• Impact Pooling & Mixer Routing: Multiple impact sounds overlap naturally without cutting off, all fully routable to your Unity Audio Mixer.

Third-Party Notice: This asset uses various audio and texture files under the CC0 1.0 Universal License; see the Third-Party Notices.txt file in the package for details.