Docs master

html/master/_sources/index.rst.txt

@@ -12,6 +12,7 @@ Crown |version| Manual
     importing_resources/index
     units/index
     rendering/index
+    physics/index
     gameplay/index
     deploying/index
     reference/index

html/master/_sources/physics/global_physics_config.rst.txt

@@ -0,0 +1,111 @@
+=====================
+Global Physics Config
+=====================
+
+The ``global.physics_config`` resource defines physics materials, collision
+filters, and actor classes used by Crown's physics simulation. The file is
+stored in SJSON format and must be edited manually.
+
+Example
+=======
+
+.. code-block::
+
+    materials = {
+        default = { friction = 0.8 restitution = 0.81 }
+    }
+
+    collision_filters = {
+        no_collision = { collides_with = [] }
+        default = { collides_with_all_except = [ "no_collision" ] }
+    }
+
+    actors = {
+        static = { dynamic = false }
+        dynamic = { dynamic = true }
+        keyframed = { dynamic = true kinematic = true disable_gravity = true }
+        trigger = { trigger = true }
+    }
+
+.. _physics_materials:
+
+Materials
+=========
+
+Physics materials define surface response parameters for :ref:`actors
+<Actors>`. Create a new material by adding an entry to the ``materials``
+object:
+
+.. code-block::
+
+    materials = {
+        default = ...
+        slippery = { friction = 0.1 }
+    }
+
+Common material properties:
+
+* ``friction``: general contact friction; larger values increase resistance to
+  sliding.
+* ``rolling_friction``: torsional friction orthogonal to the contact normal;
+  helps stop spheres rolling forever.
+* ``spinning_friction``: torsional friction around the contact normal; useful
+  for grasping.
+* ``restitution``: coefficient of restitution; 1 = perfectly elastic
+  collision, < 1 = inelastic.
+
+Collision filters
+=================
+
+Collision filters control which :ref:`actors <Actors>` interact with which. Define a
+filter by adding an entry to the ``collision_filters`` object:
+
+.. code-block::
+
+    collision_filters = {
+        ...
+        wall = {}
+        player = { collides_with = [ "wall" ] }
+    }
+
+The filter name (for example ``player``) can then be assigned to actors. Use
+``collides_with`` to list specific filters this filter should collide with,
+or ``collides_with_all_except`` to collide with everything except the
+specified filters.
+
+Collision rule
+--------------
+
+Two actors A and B generate collisions if either of the following is true:
+
+* A's filter has B in its ``collides_with`` set, or
+* B's filter has A in its ``collides_with`` set.
+
+Actor classes
+=============
+
+Actor classes are used to specify simulation properties to apply
+to :ref:`Actors`. Define classes inside the ``actors`` object:
+
+.. code-block::
+
+    actors = {
+        static = { dynamic = false }
+        dynamic = { dynamic = true }
+        keyframed = { dynamic = true kinematic = true disable_gravity = true }
+        trigger = { trigger = true }
+    }
+
+Common actor class properties:
+
+* ``linear_damping``: resistance applied to linear motion; useful to slow down
+  objects unaffected by friction.
+* ``angular_damping``: resistance applied to angular motion.
+* ``dynamic``: when true, the actor is simulated each frame by the physics
+  engine. If false, the actor cannot move but just collide.
+* ``kinematic``: when true, the actor is driven externally (animation or code)
+  rather than by physics. Kinematic objects push dynamic objects away but are
+  unaffected by them.
+* ``disable_gravity``: disables gravity for the actor.
+* ``trigger``: actor does not produce collision responses but still generates
+  overlap events.

html/master/_sources/physics/index.rst.txt

@@ -0,0 +1,9 @@
+=======
+Physics
+=======
+
+.. toctree::
+    :maxdepth: 2
+
+    rigid_bodies
+    global_physics_config

html/master/_sources/physics/rigid_bodies.rst.txt

@@ -0,0 +1,88 @@
+============
+Rigid Bodies
+============
+
+Crown provides rigid body simulation through the Actor Component. Actors are
+the core objects that participate in the physics simulation, giving realistic
+physical behaviour.
+
+.. figure:: images/actor_component.png
+   :align: center
+
+   The Actor Component shown in the Inspector.
+
+Colliders
+=========
+
+Colliders define an Actor's physical shape. The shape can be derived from mesh
+geometry or specified manually. When using a mesh as the source you can
+choose between fast analytic shapes (``sphere``, ``capsule`` or ``box``) or
+more accurate representations such as ``convex_hull`` or ``mesh``.
+
+.. figure:: images/collider_component.png
+   :align: center
+
+   The Collider Component shown in the Inspector.
+
+Analytic shapes are much cheaper to simulate and are recommended whenever they
+provide acceptable results; use convex or full mesh shapes only when you need
+precise collision geometry.
+
+Only analytic shapes can be specified manually.
+
+Actors
+======
+
+Actors provide physical behaviour to the Unit they are attached to. An Actor
+defines the physical object's :ref:`class <Actor classes>`,
+its :ref:`material <physics_materials>`, :ref:`collision filter <Collision
+filter>`, mass, and other simulation properties.
+
+Actor Class
+-----------
+
+A project defines a set of global actor classes. The default classes are
+described below:
+
+* ``static``: immovable actors, they just collide.
+* ``dynamic``: fully simulated actors affected by forces and collisions.
+* ``keyframed``: actors driven by animation or code; they push away dynamic
+  actors but are not influenced by them.
+* ``trigger``: non-blocking actors used to detect overlap events.
+
+You can define additional classes and tune class behavior in the :ref:`Global
+Physics Config`.
+
+Collision Filter
+----------------
+
+Collision filters control which actors interact with which. The ``default``
+filter applied to new actors allows interaction with other actors using the
+same ``default`` filter. A ``no_collision`` filter is available to make
+actors ignore collisions entirely.
+
+Custom, arbitrarily complex filters can be added and configured via
+the :ref:`Global Physics Config`.
+
+Material
+--------
+
+Materials specify the physical properties of actors. Create new materials in
+the :ref:`Global Physics Config`.
+
+Movers
+======
+
+The Mover Component is a specialized kinematic actor that implements classic
+collide-and-slide behavior and is better suited for character controllers and
+NPCs that require deterministic movement under direct control of the player
+or scripts.
+
+.. figure:: images/mover_component.png
+   :align: center
+
+   The Mover Component shown in the Inspector.
+
+The Mover uses a configurable capsule collider aligned vertically to the world
+Z axis. It supports configurable maximum slope angle to limit climbing and
+adjustable center point.

html/master/changelog.html

@@ -88,6 +88,7 @@
 <li class="toctree-l1"><a class="reference internal" href="importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="reference/index.html">Reference</a></li>
@@ -139,8 +140,8 @@
 <li><p>Tools: added the ability to unselect all objects with <code class="docutils literal notranslate"><span class="pre">Shift+Ctrl+A</span></code> keyboard shortcut.</p></li>
 <li><p>Runtime: Linux: switched to Vulkan for rendering.</p></li>
 <li><p>Runtime: added support to stencil testing in shaders.</p></li>
-<li><p>Runtime: changed the semantic of collision filters. See <span class="xref std std-ref">Global Physics Config</span> for details.</p></li>
-<li><p>Runtime: added a new <code class="docutils literal notranslate"><span class="pre">collides_with_all_except</span></code> field to the <code class="docutils literal notranslate"><span class="pre">collision_filters</span></code> object in the <span class="xref std std-ref">Global Physics Config</span>.</p></li>
+<li><p>Runtime: changed the semantic of collision filters. See <a class="reference internal" href="physics/global_physics_config.html#global-physics-config"><span class="std std-ref">Global Physics Config</span></a> for details.</p></li>
+<li><p>Runtime: added a new <code class="docutils literal notranslate"><span class="pre">collides_with_all_except</span></code> field to the <code class="docutils literal notranslate"><span class="pre">collision_filters</span></code> object in the <a class="reference internal" href="physics/global_physics_config.html#global-physics-config"><span class="std std-ref">Global Physics Config</span></a>.</p></li>
 <li><p>Data Compiler: resource packages are now LZ4-compressed.</p></li>
 <li><p>Lua: <code class="docutils literal notranslate"><span class="pre">Window.set_cursor_mode()</span></code> will now return a boolean value to indicate if the operation succeeded.</p></li>
 </ul>

html/master/copyright.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="reference/index.html">Reference</a></li>

html/master/deploying/android.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="index.html">Deploying</a><ul class="current">
 <li class="toctree-l2 current"><a class="current reference internal" href="#">Deploying to Android</a><ul>

html/master/deploying/desktop.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="index.html">Deploying</a><ul class="current">
 <li class="toctree-l2"><a class="reference internal" href="android.html">Deploying to Android</a></li>

html/master/deploying/html5.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="index.html">Deploying</a><ul class="current">
 <li class="toctree-l2"><a class="reference internal" href="android.html">Deploying to Android</a></li>

html/master/deploying/index.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">Deploying</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="android.html">Deploying to Android</a></li>

html/master/gameplay/index.html

@@ -30,7 +30,7 @@
     <link rel="search" title="Search" href="../search.html" />
     <link rel="copyright" title="Copyright" href="../copyright.html" />
     <link rel="next" title="Scripting in Lua" href="lua_scripting.html" />
-    <link rel="prev" title="Shading Environment" href="../rendering/shading_environment.html" /> 
+    <link rel="prev" title="Global Physics Config" href="../physics/global_physics_config.html" /> 
 </head>
 
 <body class="wy-body-for-nav"> 
@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">Writing Gameplay</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="lua_scripting.html">Scripting in Lua</a></li>
 <li class="toctree-l2"><a class="reference internal" href="objects_binding.html">Objects binding and lifetime</a></li>
@@ -134,7 +135,7 @@
            </div>
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
-        <a href="../rendering/shading_environment.html" class="btn btn-neutral float-left" title="Shading Environment" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../physics/global_physics_config.html" class="btn btn-neutral float-left" title="Global Physics Config" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
         <a href="lua_scripting.html" class="btn btn-neutral float-right" title="Scripting in Lua" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 

html/master/gameplay/lua_scripting.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="index.html">Writing Gameplay</a><ul class="current">
 <li class="toctree-l2 current"><a class="current reference internal" href="#">Scripting in Lua</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="#what-is-lua">What is Lua</a></li>

html/master/gameplay/objects_binding.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="index.html">Writing Gameplay</a><ul class="current">
 <li class="toctree-l2"><a class="reference internal" href="lua_scripting.html">Scripting in Lua</a></li>
 <li class="toctree-l2 current"><a class="current reference internal" href="#">Objects binding and lifetime</a><ul>

html/master/gameplay/unit_interaction.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="index.html">Writing Gameplay</a><ul class="current">
 <li class="toctree-l2"><a class="reference internal" href="lua_scripting.html">Scripting in Lua</a></li>
 <li class="toctree-l2"><a class="reference internal" href="objects_binding.html">Objects binding and lifetime</a></li>

html/master/genindex.html

@@ -51,6 +51,7 @@
 <li class="toctree-l1"><a class="reference internal" href="importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="reference/index.html">Reference</a></li>

html/master/getting_started/basic_concepts.html

@@ -75,6 +75,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/getting_started/create_new_project.html

@@ -69,6 +69,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/getting_started/for_the_impatient.html

@@ -69,6 +69,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/getting_started/import_existing_project.html

@@ -69,6 +69,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/getting_started/index.html

@@ -67,6 +67,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/glossary.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="reference/index.html">Reference</a></li>

html/master/hackers/building.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/hackers/console_api.html

@@ -60,6 +60,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/hackers/index.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/importing_resources/importing_fonts.html

@@ -77,6 +77,7 @@
 </li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/importing_resources/importing_resources.html

@@ -75,6 +75,7 @@
 </li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/importing_resources/importing_scenes.html

@@ -79,6 +79,7 @@
 </li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/importing_resources/importing_sounds.html

@@ -72,6 +72,7 @@
 </li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/importing_resources/importing_sprites.html

@@ -77,6 +77,7 @@
 </li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/importing_resources/importing_textures.html

@@ -69,6 +69,7 @@
 </li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/importing_resources/index.html

@@ -69,6 +69,7 @@
 </li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/index.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
-    <meta property="article:modified_time" content="2026-02-18T11:21:18+00:00" /><meta property="og:title" content="Crown 0.61.0 Manual" />
+    <meta property="article:modified_time" content="2026-02-20T16:57:51+00:00" /><meta property="og:title" content="Crown 0.61.0 Manual" />
 <meta property="og:type" content="website" />
 <meta property="og:url" content="https://docs.crownengine.org/html/latest/index.html" />
 <meta property="og:site_name" content="Crown 0.60.0 Manual" />
@@ -60,6 +60,7 @@
 <li class="toctree-l1"><a class="reference internal" href="importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="reference/index.html">Reference</a></li>
@@ -176,6 +177,11 @@
 <li class="toctree-l2"><a class="reference internal" href="rendering/shading_environment.html">Shading Environment</a></li>
 </ul>
 </li>
+<li class="toctree-l1"><a class="reference internal" href="physics/index.html">Physics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="physics/rigid_bodies.html">Rigid Bodies</a></li>
+<li class="toctree-l2"><a class="reference internal" href="physics/global_physics_config.html">Global Physics Config</a></li>
+</ul>
+</li>
 <li class="toctree-l1"><a class="reference internal" href="gameplay/index.html">Writing Gameplay</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="gameplay/lua_scripting.html">Scripting in Lua</a></li>
 <li class="toctree-l2"><a class="reference internal" href="gameplay/objects_binding.html">Objects binding and lifetime</a></li>
@@ -242,7 +248,7 @@
 
   <div role="contentinfo">
     <p>&#169; <a href="copyright.html">Copyright</a> Except where otherwise noted, content on this page is licensed under a CC-BY-SA 4.0 Int. License.
-      <span class="lastupdated">Last updated on Feb 18, 2026.
+      <span class="lastupdated">Last updated on Feb 20, 2026.
       </span></p>
   </div>
 

html/master/installing_crown/hardware_requirements.html

@@ -70,6 +70,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/installing_crown/index.html

@@ -66,6 +66,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/installing_crown/installing_on_linux.html

@@ -70,6 +70,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/installing_crown/installing_on_windows.html

@@ -69,6 +69,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/introduction.html

@@ -70,6 +70,7 @@
 <li class="toctree-l1"><a class="reference internal" href="importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="reference/index.html">Reference</a></li>

html/master/level_editor/console.html

@@ -79,6 +79,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/level_editor/index.html

@@ -70,6 +70,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/level_editor/inspector.html

@@ -76,6 +76,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/level_editor/level_editor.html

@@ -74,6 +74,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/level_editor/level_tree.html

@@ -77,6 +77,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/level_editor/level_viewport.html

@@ -94,6 +94,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/level_editor/project_browser.html

@@ -81,6 +81,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/level_editor/texture_settings.html

@@ -82,6 +82,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/lua_api.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="reference/index.html">Reference</a></li>

html/master/physics/global_physics_config.html

@@ -0,0 +1,256 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
+
+    <meta property="article:modified_time" content="2026-02-20T16:57:51+00:00" /><meta property="og:title" content="Global Physics Config" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://docs.crownengine.org/html/latest/physics/global_physics_config.html" />
+<meta property="og:site_name" content="Crown 0.60.0 Manual" />
+<meta property="og:description" content="The global.physics_config resource defines physics materials, collision filters, and actor classes used by Crown’s physics simulation. The file is stored in SJSON format and must be edited manually. Example: Materials: Physics materials define surface response parameters for a..." />
+<meta name="description" content="The global.physics_config resource defines physics materials, collision filters, and actor classes used by Crown’s physics simulation. The file is stored in SJSON format and must be edited manually. Example: Materials: Physics materials define surface response parameters for a..." />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Global Physics Config &mdash; Crown 0.60.0 Manual 0.61.0 documentation</title>
+      <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
+    <link rel="shortcut icon" href="../_static/org.crownengine.Crown.svg"/>
+    <link rel="canonical" href="https://docs.crownengine.org/html/latest/physics/global_physics_config.html" />
+  <!--[if lt IE 9]>
+    <script src="../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
+        <script src="../_static/jquery.js"></script>
+        <script src="../_static/underscore.js"></script>
+        <script src="../_static/doctools.js"></script>
+    <script src="../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../genindex.html" />
+    <link rel="search" title="Search" href="../search.html" />
+    <link rel="copyright" title="Copyright" href="../copyright.html" />
+    <link rel="next" title="Writing Gameplay" href="../gameplay/index.html" />
+    <link rel="prev" title="Rigid Bodies" href="rigid_bodies.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search" >
+            <a href="../index.html">
+            <img src="../_static/org.crownengine.Crown.svg" class="logo" alt="Logo"/>
+          </a>
+              <div class="version">
+                Crown 0.60.0 Manual
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../changelog.html">Changelog</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../introduction.html">Introduction</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../installing_crown/index.html">Installing Crown</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../getting_started/index.html">Getting Started</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../level_editor/index.html">Level Editor</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1 current"><a class="reference internal" href="index.html">Physics</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="rigid_bodies.html">Rigid Bodies</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Global Physics Config</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#example">Example</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#materials">Materials</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#collision-filters">Collision filters</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#collision-rule">Collision rule</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#actor-classes">Actor classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../lua_api.html">Lua API reference</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../glossary.html">Glossary</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../copyright.html">License</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../hackers/index.html">Engine Hackers</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../index.html">Crown 0.60.0 Manual</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../index.html" class="icon icon-home"></a> &raquo;</li>
+          <li><a href="index.html">Physics</a> &raquo;</li>
+      <li>Global Physics Config</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../_sources/physics/global_physics_config.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="global-physics-config">
+<h1>Global Physics Config<a class="headerlink" href="#global-physics-config" title="Permalink to this headline">¶</a></h1>
+<p>The <code class="docutils literal notranslate"><span class="pre">global.physics_config</span></code> resource defines physics materials, collision
+filters, and actor classes used by Crown’s physics simulation. The file is
+stored in SJSON format and must be edited manually.</p>
+<section id="example">
+<h2>Example<a class="headerlink" href="#example" title="Permalink to this headline">¶</a></h2>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">materials</span> <span class="o">=</span> <span class="p">{</span>
+    <span class="n">default</span> <span class="o">=</span> <span class="p">{</span> <span class="n">friction</span> <span class="o">=</span> <span class="mf">0.8</span> <span class="n">restitution</span> <span class="o">=</span> <span class="mf">0.81</span> <span class="p">}</span>
+<span class="p">}</span>
+
+<span class="n">collision_filters</span> <span class="o">=</span> <span class="p">{</span>
+    <span class="n">no_collision</span> <span class="o">=</span> <span class="p">{</span> <span class="n">collides_with</span> <span class="o">=</span> <span class="p">[]</span> <span class="p">}</span>
+    <span class="n">default</span> <span class="o">=</span> <span class="p">{</span> <span class="n">collides_with_all_except</span> <span class="o">=</span> <span class="p">[</span> <span class="s2">&quot;no_collision&quot;</span> <span class="p">]</span> <span class="p">}</span>
+<span class="p">}</span>
+
+<span class="n">actors</span> <span class="o">=</span> <span class="p">{</span>
+    <span class="n">static</span> <span class="o">=</span> <span class="p">{</span> <span class="n">dynamic</span> <span class="o">=</span> <span class="n">false</span> <span class="p">}</span>
+    <span class="n">dynamic</span> <span class="o">=</span> <span class="p">{</span> <span class="n">dynamic</span> <span class="o">=</span> <span class="n">true</span> <span class="p">}</span>
+    <span class="n">keyframed</span> <span class="o">=</span> <span class="p">{</span> <span class="n">dynamic</span> <span class="o">=</span> <span class="n">true</span> <span class="n">kinematic</span> <span class="o">=</span> <span class="n">true</span> <span class="n">disable_gravity</span> <span class="o">=</span> <span class="n">true</span> <span class="p">}</span>
+    <span class="n">trigger</span> <span class="o">=</span> <span class="p">{</span> <span class="n">trigger</span> <span class="o">=</span> <span class="n">true</span> <span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</section>
+<section id="materials">
+<span id="physics-materials"></span><h2>Materials<a class="headerlink" href="#materials" title="Permalink to this headline">¶</a></h2>
+<p>Physics materials define surface response parameters for <a class="reference internal" href="rigid_bodies.html#actors"><span class="std std-ref">actors</span></a>. Create a new material by adding an entry to the <code class="docutils literal notranslate"><span class="pre">materials</span></code>
+object:</p>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">materials</span> <span class="o">=</span> <span class="p">{</span>
+    <span class="n">default</span> <span class="o">=</span> <span class="o">...</span>
+    <span class="n">slippery</span> <span class="o">=</span> <span class="p">{</span> <span class="n">friction</span> <span class="o">=</span> <span class="mf">0.1</span> <span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>Common material properties:</p>
+<ul class="simple">
+<li><p><code class="docutils literal notranslate"><span class="pre">friction</span></code>: general contact friction; larger values increase resistance to
+sliding.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">rolling_friction</span></code>: torsional friction orthogonal to the contact normal;
+helps stop spheres rolling forever.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">spinning_friction</span></code>: torsional friction around the contact normal; useful
+for grasping.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">restitution</span></code>: coefficient of restitution; 1 = perfectly elastic
+collision, &lt; 1 = inelastic.</p></li>
+</ul>
+</section>
+<section id="collision-filters">
+<h2>Collision filters<a class="headerlink" href="#collision-filters" title="Permalink to this headline">¶</a></h2>
+<p>Collision filters control which <a class="reference internal" href="rigid_bodies.html#actors"><span class="std std-ref">actors</span></a> interact with which. Define a
+filter by adding an entry to the <code class="docutils literal notranslate"><span class="pre">collision_filters</span></code> object:</p>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">collision_filters</span> <span class="o">=</span> <span class="p">{</span>
+    <span class="o">...</span>
+    <span class="n">wall</span> <span class="o">=</span> <span class="p">{}</span>
+    <span class="n">player</span> <span class="o">=</span> <span class="p">{</span> <span class="n">collides_with</span> <span class="o">=</span> <span class="p">[</span> <span class="s2">&quot;wall&quot;</span> <span class="p">]</span> <span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>The filter name (for example <code class="docutils literal notranslate"><span class="pre">player</span></code>) can then be assigned to actors. Use
+<code class="docutils literal notranslate"><span class="pre">collides_with</span></code> to list specific filters this filter should collide with,
+or <code class="docutils literal notranslate"><span class="pre">collides_with_all_except</span></code> to collide with everything except the
+specified filters.</p>
+<section id="collision-rule">
+<h3>Collision rule<a class="headerlink" href="#collision-rule" title="Permalink to this headline">¶</a></h3>
+<p>Two actors A and B generate collisions if either of the following is true:</p>
+<ul class="simple">
+<li><p>A’s filter has B in its <code class="docutils literal notranslate"><span class="pre">collides_with</span></code> set, or</p></li>
+<li><p>B’s filter has A in its <code class="docutils literal notranslate"><span class="pre">collides_with</span></code> set.</p></li>
+</ul>
+</section>
+</section>
+<section id="actor-classes">
+<h2>Actor classes<a class="headerlink" href="#actor-classes" title="Permalink to this headline">¶</a></h2>
+<p>Actor classes are used to specify simulation properties to apply
+to <a class="reference internal" href="rigid_bodies.html#actors"><span class="std std-ref">Actors</span></a>. Define classes inside the <code class="docutils literal notranslate"><span class="pre">actors</span></code> object:</p>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">actors</span> <span class="o">=</span> <span class="p">{</span>
+    <span class="n">static</span> <span class="o">=</span> <span class="p">{</span> <span class="n">dynamic</span> <span class="o">=</span> <span class="n">false</span> <span class="p">}</span>
+    <span class="n">dynamic</span> <span class="o">=</span> <span class="p">{</span> <span class="n">dynamic</span> <span class="o">=</span> <span class="n">true</span> <span class="p">}</span>
+    <span class="n">keyframed</span> <span class="o">=</span> <span class="p">{</span> <span class="n">dynamic</span> <span class="o">=</span> <span class="n">true</span> <span class="n">kinematic</span> <span class="o">=</span> <span class="n">true</span> <span class="n">disable_gravity</span> <span class="o">=</span> <span class="n">true</span> <span class="p">}</span>
+    <span class="n">trigger</span> <span class="o">=</span> <span class="p">{</span> <span class="n">trigger</span> <span class="o">=</span> <span class="n">true</span> <span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>Common actor class properties:</p>
+<ul class="simple">
+<li><p><code class="docutils literal notranslate"><span class="pre">linear_damping</span></code>: resistance applied to linear motion; useful to slow down
+objects unaffected by friction.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">angular_damping</span></code>: resistance applied to angular motion.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">dynamic</span></code>: when true, the actor is simulated each frame by the physics
+engine. If false, the actor cannot move but just collide.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">kinematic</span></code>: when true, the actor is driven externally (animation or code)
+rather than by physics. Kinematic objects push dynamic objects away but are
+unaffected by them.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">disable_gravity</span></code>: disables gravity for the actor.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">trigger</span></code>: actor does not produce collision responses but still generates
+overlap events.</p></li>
+</ul>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="rigid_bodies.html" class="btn btn-neutral float-left" title="Rigid Bodies" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../gameplay/index.html" class="btn btn-neutral float-right" title="Writing Gameplay" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; <a href="../copyright.html">Copyright</a> Except where otherwise noted, content on this page is licensed under a CC-BY-SA 4.0 Int. License.
+      <span class="lastupdated">Last updated on Feb 20, 2026.
+      </span></p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(true);
+      });
+  </script>
+    <!-- Theme Analytics -->
+    <script async src="https://www.googletagmanager.com/gtag/js?id=G-XNVGCMNDZH"></script>
+    <script>
+      window.dataLayer = window.dataLayer || [];
+      function gtag(){dataLayer.push(arguments);}
+      gtag('js', new Date());
+
+      gtag('config', 'G-XNVGCMNDZH', {
+          'anonymize_ip': true,
+      });
+    </script> 
+
+</body>
+</html>

html/master/physics/index.html

@@ -0,0 +1,167 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
+
+    <meta property="article:modified_time" content="2026-02-20T16:57:51+00:00" /><meta property="og:title" content="Physics" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://docs.crownengine.org/html/latest/physics/index.html" />
+<meta property="og:site_name" content="Crown 0.60.0 Manual" />
+<meta property="og:description" content="Rigid Bodies- Colliders, Actors, Movers., Global Physics Config- Example, Materials, Collision filters, Actor classes.." />
+<meta name="description" content="Rigid Bodies- Colliders, Actors, Movers., Global Physics Config- Example, Materials, Collision filters, Actor classes.." />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Physics &mdash; Crown 0.60.0 Manual 0.61.0 documentation</title>
+      <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
+    <link rel="shortcut icon" href="../_static/org.crownengine.Crown.svg"/>
+    <link rel="canonical" href="https://docs.crownengine.org/html/latest/physics/index.html" />
+  <!--[if lt IE 9]>
+    <script src="../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
+        <script src="../_static/jquery.js"></script>
+        <script src="../_static/underscore.js"></script>
+        <script src="../_static/doctools.js"></script>
+    <script src="../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../genindex.html" />
+    <link rel="search" title="Search" href="../search.html" />
+    <link rel="copyright" title="Copyright" href="../copyright.html" />
+    <link rel="next" title="Rigid Bodies" href="rigid_bodies.html" />
+    <link rel="prev" title="Shading Environment" href="../rendering/shading_environment.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search" >
+            <a href="../index.html">
+            <img src="../_static/org.crownengine.Crown.svg" class="logo" alt="Logo"/>
+          </a>
+              <div class="version">
+                Crown 0.60.0 Manual
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../changelog.html">Changelog</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../introduction.html">Introduction</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../installing_crown/index.html">Installing Crown</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../getting_started/index.html">Getting Started</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../level_editor/index.html">Level Editor</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Physics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="rigid_bodies.html">Rigid Bodies</a></li>
+<li class="toctree-l2"><a class="reference internal" href="global_physics_config.html">Global Physics Config</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../lua_api.html">Lua API reference</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../glossary.html">Glossary</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../copyright.html">License</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../hackers/index.html">Engine Hackers</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../index.html">Crown 0.60.0 Manual</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../index.html" class="icon icon-home"></a> &raquo;</li>
+      <li>Physics</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../_sources/physics/index.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="physics">
+<h1>Physics<a class="headerlink" href="#physics" title="Permalink to this headline">¶</a></h1>
+<div class="toctree-wrapper compound">
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="rigid_bodies.html">Rigid Bodies</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="rigid_bodies.html#colliders">Colliders</a></li>
+<li class="toctree-l2"><a class="reference internal" href="rigid_bodies.html#actors">Actors</a></li>
+<li class="toctree-l2"><a class="reference internal" href="rigid_bodies.html#movers">Movers</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="global_physics_config.html">Global Physics Config</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="global_physics_config.html#example">Example</a></li>
+<li class="toctree-l2"><a class="reference internal" href="global_physics_config.html#materials">Materials</a></li>
+<li class="toctree-l2"><a class="reference internal" href="global_physics_config.html#collision-filters">Collision filters</a></li>
+<li class="toctree-l2"><a class="reference internal" href="global_physics_config.html#actor-classes">Actor classes</a></li>
+</ul>
+</li>
+</ul>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../rendering/shading_environment.html" class="btn btn-neutral float-left" title="Shading Environment" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="rigid_bodies.html" class="btn btn-neutral float-right" title="Rigid Bodies" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; <a href="../copyright.html">Copyright</a> Except where otherwise noted, content on this page is licensed under a CC-BY-SA 4.0 Int. License.
+      <span class="lastupdated">Last updated on Feb 20, 2026.
+      </span></p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(true);
+      });
+  </script>
+    <!-- Theme Analytics -->
+    <script async src="https://www.googletagmanager.com/gtag/js?id=G-XNVGCMNDZH"></script>
+    <script>
+      window.dataLayer = window.dataLayer || [];
+      function gtag(){dataLayer.push(arguments);}
+      gtag('js', new Date());
+
+      gtag('config', 'G-XNVGCMNDZH', {
+          'anonymize_ip': true,
+      });
+    </script> 
+
+</body>
+</html>

html/master/physics/rigid_bodies.html

@@ -0,0 +1,238 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
+
+    <meta property="article:modified_time" content="2026-02-20T16:57:51+00:00" /><meta property="og:title" content="Rigid Bodies" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://docs.crownengine.org/html/latest/physics/rigid_bodies.html" />
+<meta property="og:site_name" content="Crown 0.60.0 Manual" />
+<meta property="og:description" content="Crown provides rigid body simulation through the Actor Component. Actors are the core objects that participate in the physics simulation, giving realistic physical behaviour. The Actor Component shown in the Inspector., Colliders: Colliders define an Actor’s physical shape. Th..." />
+<meta property="og:image" content="https://docs.crownengine.org/html/latest/_images/actor_component.png" />
+<meta property="og:image:alt" content="Crown 0.60.0 Manual" />
+<meta name="description" content="Crown provides rigid body simulation through the Actor Component. Actors are the core objects that participate in the physics simulation, giving realistic physical behaviour. The Actor Component shown in the Inspector., Colliders: Colliders define an Actor’s physical shape. Th..." />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Rigid Bodies &mdash; Crown 0.60.0 Manual 0.61.0 documentation</title>
+      <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
+    <link rel="shortcut icon" href="../_static/org.crownengine.Crown.svg"/>
+    <link rel="canonical" href="https://docs.crownengine.org/html/latest/physics/rigid_bodies.html" />
+  <!--[if lt IE 9]>
+    <script src="../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
+        <script src="../_static/jquery.js"></script>
+        <script src="../_static/underscore.js"></script>
+        <script src="../_static/doctools.js"></script>
+    <script src="../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../genindex.html" />
+    <link rel="search" title="Search" href="../search.html" />
+    <link rel="copyright" title="Copyright" href="../copyright.html" />
+    <link rel="next" title="Global Physics Config" href="global_physics_config.html" />
+    <link rel="prev" title="Physics" href="index.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search" >
+            <a href="../index.html">
+            <img src="../_static/org.crownengine.Crown.svg" class="logo" alt="Logo"/>
+          </a>
+              <div class="version">
+                Crown 0.60.0 Manual
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../changelog.html">Changelog</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../introduction.html">Introduction</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../installing_crown/index.html">Installing Crown</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../getting_started/index.html">Getting Started</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../level_editor/index.html">Level Editor</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1 current"><a class="reference internal" href="index.html">Physics</a><ul class="current">
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Rigid Bodies</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#colliders">Colliders</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#actors">Actors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#actor-class">Actor Class</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#collision-filter">Collision Filter</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#material">Material</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#movers">Movers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="global_physics_config.html">Global Physics Config</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../lua_api.html">Lua API reference</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../glossary.html">Glossary</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../copyright.html">License</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../hackers/index.html">Engine Hackers</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../index.html">Crown 0.60.0 Manual</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../index.html" class="icon icon-home"></a> &raquo;</li>
+          <li><a href="index.html">Physics</a> &raquo;</li>
+      <li>Rigid Bodies</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../_sources/physics/rigid_bodies.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="rigid-bodies">
+<h1>Rigid Bodies<a class="headerlink" href="#rigid-bodies" title="Permalink to this headline">¶</a></h1>
+<p>Crown provides rigid body simulation through the Actor Component. Actors are
+the core objects that participate in the physics simulation, giving realistic
+physical behaviour.</p>
+<figure class="align-center" id="id1">
+<img alt="../_images/actor_component.png" src="../_images/actor_component.png" />
+<figcaption>
+<p><span class="caption-text">The Actor Component shown in the Inspector.</span><a class="headerlink" href="#id1" title="Permalink to this image">¶</a></p>
+</figcaption>
+</figure>
+<section id="colliders">
+<h2>Colliders<a class="headerlink" href="#colliders" title="Permalink to this headline">¶</a></h2>
+<p>Colliders define an Actor’s physical shape. The shape can be derived from mesh
+geometry or specified manually. When using a mesh as the source you can
+choose between fast analytic shapes (<code class="docutils literal notranslate"><span class="pre">sphere</span></code>, <code class="docutils literal notranslate"><span class="pre">capsule</span></code> or <code class="docutils literal notranslate"><span class="pre">box</span></code>) or
+more accurate representations such as <code class="docutils literal notranslate"><span class="pre">convex_hull</span></code> or <code class="docutils literal notranslate"><span class="pre">mesh</span></code>.</p>
+<figure class="align-center" id="id2">
+<img alt="../_images/collider_component.png" src="../_images/collider_component.png" />
+<figcaption>
+<p><span class="caption-text">The Collider Component shown in the Inspector.</span><a class="headerlink" href="#id2" title="Permalink to this image">¶</a></p>
+</figcaption>
+</figure>
+<p>Analytic shapes are much cheaper to simulate and are recommended whenever they
+provide acceptable results; use convex or full mesh shapes only when you need
+precise collision geometry.</p>
+<p>Only analytic shapes can be specified manually.</p>
+</section>
+<section id="actors">
+<h2>Actors<a class="headerlink" href="#actors" title="Permalink to this headline">¶</a></h2>
+<p>Actors provide physical behaviour to the Unit they are attached to. An Actor
+defines the physical object’s <a class="reference internal" href="global_physics_config.html#actor-classes"><span class="std std-ref">class</span></a>,
+its <a class="reference internal" href="global_physics_config.html#physics-materials"><span class="std std-ref">material</span></a>, <a class="reference internal" href="#collision-filter"><span class="std std-ref">collision filter</span></a>, mass, and other simulation properties.</p>
+<section id="actor-class">
+<h3>Actor Class<a class="headerlink" href="#actor-class" title="Permalink to this headline">¶</a></h3>
+<p>A project defines a set of global actor classes. The default classes are
+described below:</p>
+<ul class="simple">
+<li><p><code class="docutils literal notranslate"><span class="pre">static</span></code>: immovable actors, they just collide.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">dynamic</span></code>: fully simulated actors affected by forces and collisions.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">keyframed</span></code>: actors driven by animation or code; they push away dynamic
+actors but are not influenced by them.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">trigger</span></code>: non-blocking actors used to detect overlap events.</p></li>
+</ul>
+<p>You can define additional classes and tune class behavior in the <a class="reference internal" href="global_physics_config.html#global-physics-config"><span class="std std-ref">Global Physics Config</span></a>.</p>
+</section>
+<section id="collision-filter">
+<h3>Collision Filter<a class="headerlink" href="#collision-filter" title="Permalink to this headline">¶</a></h3>
+<p>Collision filters control which actors interact with which. The <code class="docutils literal notranslate"><span class="pre">default</span></code>
+filter applied to new actors allows interaction with other actors using the
+same <code class="docutils literal notranslate"><span class="pre">default</span></code> filter. A <code class="docutils literal notranslate"><span class="pre">no_collision</span></code> filter is available to make
+actors ignore collisions entirely.</p>
+<p>Custom, arbitrarily complex filters can be added and configured via
+the <a class="reference internal" href="global_physics_config.html#global-physics-config"><span class="std std-ref">Global Physics Config</span></a>.</p>
+</section>
+<section id="material">
+<h3>Material<a class="headerlink" href="#material" title="Permalink to this headline">¶</a></h3>
+<p>Materials specify the physical properties of actors. Create new materials in
+the <a class="reference internal" href="global_physics_config.html#global-physics-config"><span class="std std-ref">Global Physics Config</span></a>.</p>
+</section>
+</section>
+<section id="movers">
+<h2>Movers<a class="headerlink" href="#movers" title="Permalink to this headline">¶</a></h2>
+<p>The Mover Component is a specialized kinematic actor that implements classic
+collide-and-slide behavior and is better suited for character controllers and
+NPCs that require deterministic movement under direct control of the player
+or scripts.</p>
+<figure class="align-center" id="id3">
+<img alt="../_images/mover_component.png" src="../_images/mover_component.png" />
+<figcaption>
+<p><span class="caption-text">The Mover Component shown in the Inspector.</span><a class="headerlink" href="#id3" title="Permalink to this image">¶</a></p>
+</figcaption>
+</figure>
+<p>The Mover uses a configurable capsule collider aligned vertically to the world
+Z axis. It supports configurable maximum slope angle to limit climbing and
+adjustable center point.</p>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="index.html" class="btn btn-neutral float-left" title="Physics" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="global_physics_config.html" class="btn btn-neutral float-right" title="Global Physics Config" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; <a href="../copyright.html">Copyright</a> Except where otherwise noted, content on this page is licensed under a CC-BY-SA 4.0 Int. License.
+      <span class="lastupdated">Last updated on Feb 20, 2026.
+      </span></p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(true);
+      });
+  </script>
+    <!-- Theme Analytics -->
+    <script async src="https://www.googletagmanager.com/gtag/js?id=G-XNVGCMNDZH"></script>
+    <script>
+      window.dataLayer = window.dataLayer || [];
+      function gtag(){dataLayer.push(arguments);}
+      gtag('js', new Date());
+
+      gtag('config', 'G-XNVGCMNDZH', {
+          'anonymize_ip': true,
+      });
+    </script> 
+
+</body>
+</html>

html/master/reference/boot_config.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="index.html">Reference</a><ul class="current">

html/master/reference/command_line.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="index.html">Reference</a><ul class="current">

html/master/reference/console_commands.html

@@ -63,6 +63,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="index.html">Reference</a><ul class="current">

html/master/reference/index.html

@@ -61,6 +61,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">Reference</a><ul>

html/master/rendering/index.html

@@ -66,6 +66,7 @@
 <li class="toctree-l2"><a class="reference internal" href="shading_environment.html">Shading Environment</a></li>
 </ul>
 </li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/rendering/lighting.html

@@ -78,6 +78,7 @@
 <li class="toctree-l2"><a class="reference internal" href="shading_environment.html">Shading Environment</a></li>
 </ul>
 </li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/rendering/materials.html

@@ -73,6 +73,7 @@
 <li class="toctree-l2"><a class="reference internal" href="shading_environment.html">Shading Environment</a></li>
 </ul>
 </li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>
@@ -155,7 +156,7 @@ the <a class="reference internal" href="../lua_api.html#renderworld"><span class
 <section id="modifying-material-properties">
 <h2>Modifying Material properties<a class="headerlink" href="#modifying-material-properties" title="Permalink to this headline">¶</a></h2>
 <p>Once a material is assigned, you can modify its properties dynamically from
-Lua scripts using the <a class="reference internal" href="../lua_api.html#material"><span class="std std-ref">Material</span></a> API.</p>
+Lua scripts using the <a class="reference internal" href="../physics/rigid_bodies.html#material"><span class="std std-ref">Material</span></a> API.</p>
 </section>
 </section>
 

html/master/rendering/shading_environment.html

@@ -31,7 +31,7 @@
     <link rel="index" title="Index" href="../genindex.html" />
     <link rel="search" title="Search" href="../search.html" />
     <link rel="copyright" title="Copyright" href="../copyright.html" />
-    <link rel="next" title="Writing Gameplay" href="../gameplay/index.html" />
+    <link rel="next" title="Physics" href="../physics/index.html" />
     <link rel="prev" title="Materials" href="materials.html" /> 
 </head>
 
@@ -78,6 +78,7 @@
 </li>
 </ul>
 </li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>
@@ -191,7 +192,7 @@ range of the monitor.</p>
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
         <a href="materials.html" class="btn btn-neutral float-left" title="Materials" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
-        <a href="../gameplay/index.html" class="btn btn-neutral float-right" title="Writing Gameplay" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+        <a href="../physics/index.html" class="btn btn-neutral float-right" title="Physics" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
   <hr/>

html/master/search.html

@@ -54,6 +54,7 @@
 <li class="toctree-l1"><a class="reference internal" href="importing_resources/index.html">Importing Resources</a></li>
 <li class="toctree-l1"><a class="reference internal" href="units/index.html">Units</a></li>
 <li class="toctree-l1"><a class="reference internal" href="rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="reference/index.html">Reference</a></li>

html/master/units/creating_units.html

@@ -72,6 +72,7 @@
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/units/index.html

@@ -65,6 +65,7 @@
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>

html/master/units/introduction.html

@@ -73,6 +73,7 @@
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>