---
title: "OnePhysics guide"
url: https://recursiveai.org/onephysics/docs/guide/
description: "Task-oriented pages with examples that are compiled and run by the test suite. For the exact members, read the XML documentation in your editor. The…"
version: "0.4.0-preview.1"
source: https://github.com/recursive-ai-oss/onephysics-csharp/blob/fa8eed5a2021c452ca8051b6099917e09538b4f4/docs/guide/README.md
---

# OnePhysics guide

Task-oriented pages with examples that are compiled and run by the test suite. For the exact members, read the XML documentation in your editor. The normative, bit-level descriptions for ports live in [../spec](https://github.com/recursive-ai-oss/onephysics-csharp/tree/fa8eed5a2021c452ca8051b6099917e09538b4f4/docs/spec).

| Page | Read it to |
|---|---|
| [Install](https://recursiveai.org/onephysics/docs/install/) | add the package, know the targets |
| [Quick start](https://recursiveai.org/onephysics/docs/quick-start/) | step a world, react to a collision, cast a ray, move a character |
| [The three tiers](https://recursiveai.org/onephysics/docs/tiers/) | choose between one-liners, definitions and the raw tier |
| [Events](https://recursiveai.org/onephysics/docs/events/) | pick per-body handlers or polled events; know the order |
| [Queries, layers and filters](https://recursiveai.org/onephysics/docs/queries-and-layers/) | decide what collides and what a query sees |
| [Rollback and lockstep](https://recursiveai.org/onephysics/docs/rollback/) | snapshot into a ring, restore, resimulate, hash |
| [Determinism](https://recursiveai.org/onephysics/docs/determinism/) | know exactly what is guaranteed, and the coordinate rule |
| [Units and sizes](https://recursiveai.org/onephysics/docs/units/) | avoid half-extent and degree mistakes |
| [Names and conventions](https://recursiveai.org/onephysics/docs/api-names/) | handles, joint one-liners and definitions, callbacks across restore |
| [Soft bodies](https://recursiveai.org/onephysics/docs/soft-bodies/) | make a cloth, a jelly or a pressurised ball; know what they collide with and how they push rigid bodies |
| [Input limits](https://recursiveai.org/onephysics/docs/limits/) | know what is refused |
| [Coming from Unity](https://recursiveai.org/onephysics/docs/unity-mapping/) | find the name of the thing you know |