git404hub

what is box3dunity fr?

tommoore515/box3dunity — explained in plain English

Analysis updated 2026-05-18

16C#Audience · developerComplexity · 4/5LicenseSetup · moderate

tl;dr

C# bindings and a Unity layer for the Box3D physics engine, used mainly to run fast collision queries like raycasts and shape overlaps.

vibe map

mindmap
  root((repo))
    What it does
      Wraps Box3D physics engine
      Provides collision queries
      Character mover for sliding
      Unity debug draw renderer
    Tech stack
      C sharp
      Unity
      Box3D native library
    Use cases
      Raycast and shape queries in Unity
      Build a kinematic character controller
      Run physics tests outside Unity
      Benchmark against Unity PhysX
    Audience
      Unity developers
      Game programmers
    Coverage
      Bodies and shapes supported
      Joints not yet supported

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run fast raycasts and shape overlap queries inside a Unity project.

VIBE 2

Build a kinematic character mover that collides and slides along surfaces.

VIBE 3

Run the same physics code in headless servers or automated tests outside Unity.

VIBE 4

Benchmark collision query speed against Unity's built in PhysX engine.

what's the stack?

C#UnityBox3D

how it stacks up fr

tommoore515/box3dunitycodymullins/starlingcross-yanzheng/vocab-roguelike
Stars161616
LanguageC#C#C#
Setup difficultymoderatemoderateeasy
Complexity4/55/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Only ships prebuilt binaries for Windows x64 and Linux x64, and the native library must match the double precision ABI exactly or it fails to load.

You may freely use, modify, and distribute this software, including for commercial purposes, under the MIT license.

in plain english

Box3DUnity provides C# bindings and a Unity integration layer for Box3D, a 3D physics engine created by Erin Catto. It is an unofficial project and is not affiliated with the original Box3D project. The package is built against version 0.1.0 of Box3D using its double precision, large world variant, and it ships prebuilt for Windows and Linux, though other platforms are welcome as contributions. Both this package and Box3D itself are released under the MIT license. You can install it through Unity's Package Manager by adding it from a git URL, or by copying the folder directly into your project's Assets or Packages directory. The code is organized into three layers. The first is a raw layer that mirrors Box3D's C functions and structures exactly, so it can be compared directly against the original headers. The second is a friendlier C# API with things like a world object, bodies, shapes, and a character mover for handling collisions and sliding along surfaces. The third is a thin Unity specific layer that converts between Unity's own vector and rotation types and adds a renderer for visually debugging shapes in the editor and in builds. Because the first two layers do not depend on the Unity engine at all, the same code can run in headless servers and automated tests as well as inside Unity itself. The README lists what is currently supported: creating and stepping the physics world, various ray and shape queries, a plane solving helper, creating and moving bodies, basic shapes like spheres, capsules, and box hulls, building meshes from raw triangle data, and a debug drawing system. It also lists what is not yet supported, including joints, contact and sensor events, compound shapes, height fields, building shapes from point clouds, and a recording and replay feature, and it invites contributions to fill those gaps. The project treats Box3D mainly as a fast way to answer collision questions, such as raycasts and shape overlaps, rather than as a full replacement for Unity's own physics engine. It includes a benchmark sample that loads ten thousand identical boxes into both a Box3D world and a Unity PhysX scene and compares how quickly each answers the same batch of queries, checking that both engines return matching results before comparing their speed.

prompts (copy fr)

prompt 1
Help me install this Box3D Unity package through the Unity Package Manager using a git URL.
prompt 2
Show me how to create a Box3D world, add a ground body, and cast a ray against it in C#.
prompt 3
Explain the difference between the raw interop layer, the idiomatic API layer, and the Unity adapter layer in this project.
prompt 4
Walk me through enabling debug shape drawing for a Box3D world inside the Unity editor.

Frequently asked questions

what is box3dunity fr?

C# bindings and a Unity layer for the Box3D physics engine, used mainly to run fast collision queries like raycasts and shape overlaps.

What language is box3dunity written in?

Mainly C#. The stack also includes C#, Unity, Box3D.

What license does box3dunity use?

You may freely use, modify, and distribute this software, including for commercial purposes, under the MIT license.

How hard is box3dunity to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is box3dunity for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.