KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

cubez

★ 34 Open GitHub ↗

Cubez is a 3d physics engine written natively in Go.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Cubez v0.1.0
============

Cubez is a 3d physics library written in the [Go][golang] programming language. It is
 mostly a port of [cyclone-physics][cyclone] by Ian Millington and using his book
"Game Physics Engine Design" as a reference.

Current Features
----------------

* Full 3d rigid body real-time physics simulation suitable for games; meaning
  both linear velocity as well as angular velocity are calculated.
* Collision detection between collider primitives.
* Primitives supported: planes, spheres, cubes.
* Math library defaults to 64-bit floats but can easily be tuned down to 32-bit.

Examples
--------

Ballistic: shoot spheres at a cube by pressing the space bar.

![ballistic][ballistic_ss]

Cubedrop: hit the space bar to drop some cubes onto the ground

![cubedrop][cubedrop_ss]

OS Support
----------

Cubez is known to work on the following:

* Windows 7 x64 with mingw-w64 (see this [tutorial][am_mingw64] if necessary)
* Linux (Ubuntu 14.04)

At present, I suspect it should work on any Windows or Linux 64-bit system for which
there is an acceptable Go x64 and gcc x64 compiler set available.

Support for 32-bit systems is untested.

Dependencies
------------

The only dependency on the core `cubez` package is the math package included in `cubez`.

For the examples, you will need GLFW 3.1.x installed on your system, and you will need
to install the go-gl project's [gl][gogl_gl], [glfw][gogl_glfw] and [mathgl][gogl_mgl]
libraries. Your system will also need to be OpenGL 3.3 capable.

The examples use a basic OpenGL *framework-in-a-file* inspired by my graphics engine
called [fizzle][fizzle]. This way the full [fizzle][fizzle] library is not a dependency.

Installation
------------

If you don't have the dependencies for the examples and wish to install them,
you can do so with the following commands:

```bash
go get github.com/go-gl/gl/v3.3-core/gl
go get github.com/go-gl/mathgl/mgl32
go get github.com/go-gl/glfw/v3.1/glfw
```

The library itself can be installed with the following command:

```bash
go get github.com/tbogdala/cubez
```

To build the examples, run the following in a shell:

```bash
 cd $GOPATH/src/github.com/tbogdala/cubez/examples
./build.sh
```

Documentation
-------------

Currently, you'll have to use godoc to read the API documentation and check
out the examples to figure out how to use the library.

Known Limitations
-----------------

* slim down the public interface to the library to only export what's needed
* introduce a way to set the restitution and friction for contacts

Roadmap
-------

* more benchmarks
* unit tests for collisions
* more collision primitives
* include some coarse collision detection to ease the O(n^2) pain with
  resolving contacts in one big slice

License
-------

Cubez is released under the BSD license. See the [LICENSE][license-link] file for more details.

Release History
---------------

No tagged releases yet.

[golang]: https://golang.org/
[license-link]: https://raw.githubusercontent.com/tbogdala/cubez/master/LICENSE
[cyclone]: https://github.com/idmillington/cyclone-physics
[fizzle]: https://github.com/tbogdala/fizzle
[gogl_gl]: https://github.com/go-gl/gl
[gogl_glfw]: https://github.com/go-gl/glfw
[gogl_mgl]: https://github.com/go-gl/mathgl
[am_mingw64]: http://animal-machine.com/blog/150723_mingw-w64_and_Go.md

[ballistic_ss]: https://raw.githubusercontent.com/tbogdala/cubez/master/examples/screenshots/ballistic-150912.jpg
[cubedrop_ss]: https://raw.githubusercontent.com/tbogdala/cubez/master/examples/screenshots/cubedrop-150912.jpg

cubez

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README