https://github.com/jakecoffman/cp

A pure Go physics library with no dependencies. Unofficial Chipmunk2D port.
https://github.com/jakecoffman/cp

chipmunk2d physics physics-2d

Last synced: about 2 months ago
JSON representation

A pure Go physics library with no dependencies. Unofficial Chipmunk2D port.

• Host: GitHub
• URL: https://github.com/jakecoffman/cp
• Owner: jakecoffman
• License: mit
• Created: 2017-08-05T02:01:21.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2024-02-17T04:23:04.000Z (7 months ago)
• Last Synced: 2024-06-19T14:13:11.454Z (3 months ago)
• Topics: chipmunk2d, physics, physics-2d
• Language: Go
• Homepage: https://chipmunk-physics.net
• Size: 339 KB
• Stars: 271
• Watchers: 7
• Forks: 17
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# cp

[![GoDoc](https://godoc.org/github.com/jakecoffman/cp?status.svg)](https://pkg.go.dev/github.com/jakecoffman/cp/v2)

[![Sourcegraph](https://sourcegraph.com/github.com/jakecoffman/cp/-/badge.svg)](https://sourcegraph.com/github.com/jakecoffman/cp?badge)

Go port of [Chipmunk2D](https://github.com/slembcke/Chipmunk2D) physics library. 

```Go

import "github.com/jakecoffman/cp/v2"

```

## Project status

Stable -- most features are implemented and the demos are very close to Chipmunk2D demos. 

## Examples

- [github.com/jakecoffman/cp-examples](https://github.com/jakecoffman/cp-examples) contains the port of all of the Chipmunk2D demos.

- [github.com/hajimehoshi/ebiten/blob/main/examples/chipmunk/main.go](https://github.com/hajimehoshi/ebiten/blob/main/examples/chipmunk/main.go) is an example using Ebitengine

- [github.com/gen2brain/raylib-go/blob/master/examples/physics/chipmunk/main.go](https://github.com/gen2brain/raylib-go/blob/master/examples/physics/chipmunk/main.go) is an example with raylib's Go port

## Documentation

The official chipmunk docs are a really good place to start: https://chipmunk-physics.net/release/ChipmunkLatest-Docs/

## Features

Same features as Chipmunk2D:

- Designed specifically for 2D video games.

- Circle, convex polygon, and beveled line segment collision primitives.

- Multiple collision primitives can be attached to a single rigid body.

- Fast broad phase collision detection by using a bounding box tree with great temporal coherence or a spatial hash.

- Extremely fast impulse solving by utilizing Erin Catto’s contact persistence algorithm.

- Supports sleeping objects that have come to rest to reduce the CPU load.

- Support for collision event callbacks based on user definable object types types.

- Flexible collision filtering system with layers, exclusion groups and callbacks.

- Can be used to create all sorts of effects like one way platforms or buoyancy areas. (Examples included)

- Supports nearest point, segment (raycasting), shape and bounding box queries to the collision detection system.

- Collision impulses amounts can be retrieved for gameplay effects, sound effects, etc.

- Large variety of joints – easily make vehicles, ragdolls, and more.

- Joint callbacks.

- Can be used to easily implement breakable or animated joints. (Examples included)

- Maintains a contact graph of all colliding objects.

- No external dependencies.

- Many language bindings available.

- Simple, read the documentation and see!

- Unrestrictive MIT license