---
title: "PhysicsEditor - Edit your box2d and chipmunk shapes!"
description: "PhysicsEditor is an editor for collision polygons for physics engines like box2d or chipmunk"
canonical: "https://www.codeandweb.com/physicseditor"
source: "html"
---

# PhysicsEditor - Edit your box2d and chipmunk shapes!

2d collision shape editor

# PhysicsEditor

Edit your collision shapes for Box2d, Chipmunk, Ninja, P2, Arcade

Works with any game engine, including:

[Download PhysicsEditor 2.1.0](https://www.codeandweb.com/physicseditor/download/2.1.0/win)

for Windows

[Also available for macOS and Linux](https://www.codeandweb.com/physicseditor/download.md)

## The fastest way to create collision shapes

Create your collision shapes in 5 simple steps:

![Create physic collision shapes in seconds](https://www.codeandweb.com/static/1703407cf08bdd81c397524ec21fbace/19e02/physics-shapes-in-17-seconds.png)

Ready to dive in?

Try PhysicsEditor today.

[Download](https://www.codeandweb.com/physicseditor/download.md)

## Adapts to your needs.

Configure PhysicsEditor's UI and output formats to mach your needs.

## Your workflow

**Many engines supported out of the box**

PhysicsEditor is pre-configured with a variety of game and physics engines such as Box2d, Nape, P2 and others.

**Need additional parameters?**

Add custom parameters to global settings, physics bodies or fixtures. Supported are: Numbers, strings, booleans and bit fields.

**Create your own data format**

XML? JSON? Source code? No Problem: Use the built-in template engine to create your own output formats.

## Don't know how to get started?

Check out our tutorials section for help!

### Cocos2d-x

How to use physics with cocos2d-x

[Tutorial](https://www.codeandweb.com/physicseditor/tutorials/creating-physics-shapes-for-cocos2d-x.md)

### Phaser

How to create physics shapes for Phaser 3 and Matter JS

[Tutorial](https://www.codeandweb.com/physicseditor/tutorials/how-to-create-physics-shapes-for-phaser-3-and-matterjs.md)

### libGDX

LibGDX Beginner Tutorial: Sprite Sheets & Physics with Box2d

[Tutorial](https://www.codeandweb.com/physicseditor/tutorials/libgdx-physics.md)

More tutorials are available in our [tutorials section](https://www.codeandweb.com/physicseditor/tutorials.md).

## Easy to use editor

### Shape tracer

Let PhysicsEditor create the collision outlines automatically

**Tracer with live preview**

The tracer displays the traced shape in while you tweak the settings.

Use the tracer tolerance to get the optimum ratio between shape fit and vertex count.

![Automatically create collision outlines based on the sprite's transparency.](https://www.codeandweb.com/static/09b6bbb52f5ee733c06880781d03e381/87706/shapetracer%402x.png)

Automatically create collision outlines based on the sprite's transparency.

### Shape editor

Use the vector editing tools to manually tweak your shapes

**Shape creation tools**

Use the shape editor to create the collision elements, your physics engine supports: Circles and polygons

**Multiple fixtures per body**

Create detailed fixtures for each body part to distinguish where a collision was detected: Head, limbs, torso.

**Use sensors to detect incoming collisions**

Sensors can detect if a game object is close to another without already touching it. E.g. let your game character stretch out his arms before hitting a wall.

![Editing collision shapes: Fixtures per body part, sensors.](https://www.codeandweb.com/static/c9760c902fb809f38f7116ebe6c3117c/87706/fixtures%402x.png)

Editing collision shapes: Fixtures per body part, sensors.

### Convex decomposition

**Done for you....**

Almost all physics engines do not support concave collision shapes. The shapes have to be destructured into convex sub-polygons.

You don't have to care about this because PhysicsEditor automatically exports the shapes as convex polygons.

![Convex decomposition: Split a concave polygon into convex sub polygons.](https://www.codeandweb.com/static/f2ebb972ae9042197e41352be372fd8f/87706/convex-decomposition%402x.png)

Convex decomposition: Split a concave polygon into convex sub polygons.

## Collision & Physics Parameters

### Physics parameters

These parameters define how an object behaves in the physics engine

**Physics parameters**

Edit physics parameters on fixtures and collision bodies: Mass/Density, Friction, Restitution, Elasticity, Bounce

**Collision parameters**

Edit collision parameters on fixtures and collision bodies: Collision groups, categories, masks and filters.

**Own parameters**

Create and edit your own custom parameters by creating a custom exporter.

![Set physics and collision parameters: Density, restitution, collision group, bits mask and more](https://www.codeandweb.com/static/4a26262418fd773dea84d177ad7b231b/87706/physics-parameters%402x.png)

Set physics and collision parameters: Density, restitution, collision group, bits mask and more.

Ready to dive in?

Try PhysicsEditor today.

[Download](https://www.codeandweb.com/physicseditor/download.md)