Introduced at #Inspect 2013, Joybox is the easiest way to build 2D games for iPhones and iPads using RubyMotion. Joybox combines the most popular and widely used 2D game engine for iOS, Cocos2D, folds in the amazing Box2D physics engine, and then wraps them up into a clean Ruby API that will make game development faster and more enjoyable for both beginners and experts alike.
For more information, see the presentation: Cocos2D, an Easier Way.
Latest version (1.1.0)
- Support for all Shapes and Listeners.
- Filters, AABB computations, Queries and Ray Casts.
- Collision support for Physics Sprites.
- Experimental support for actions on Physics Sprites.
- Physics Debug Draw.
Effects and Background Music
- AudioEffect and BackgroundAudio to playback background music and special effects.
Tile Maps Support
- Support for TMX Maps using the TileMap class.
- Complete actions
- Support the default gestures on OSX.
- Adds joybox:retina command to create a Retina version of a TMX Map.
- Support for custom options on the Sprite initialization.
- The commands and templates now install automatically.
- Added 218 specifications and 617 requirements.
Node: The method add_childs is now add_children.
SpriteFrameCache: The method where now starts from 1 instead of 0.
Animation: The delay method is now delay_units, and total_delay is now delay_per_unit.
Menu: The method align_items_in_columns now receive an array for defining how many columns and how many items in which of them.
Physics: Now every object returns their values in pixel coordinates and degrees, if you still need to use the metric values you can access them with the prefix metric_. For example: metric_position.
World: The Method continuos_physics is now deprecated.
Physics Collisions: Now for use when_collide method of the World instance, you need to pass an instance of a PhysicsSprite and it will return in the block the colliding physics sprite if available, or the body that is colliding.
Point: The methods to and from pixel coordinates are now inverted, there was an incorrect naming.
Documentation and Getting Started
If you are looking for the installation process and the documentation, please visit: joybox.io
Also you can look at some examples in this repository: Joybox - Examples
If you run into troubles running your Joybox game, please do the following, in the root folder of your project:
gem uninstall joybox -a gem install joybox rm .repl_history rake clean rake
Troubleshoot the REPL
If the iOS application starts in landscape orientation, please rotate and return it to the original orientation.
(cmd + <= & cmd + =>)
Feedback and Help
For questions and feedback use the project's Google Group
For bug reports use the project's Issue Tracker.
If you wish to help us to stop the madness, there are some ways you can do it:
- Joybox Wrapper (Ruby): This repository ;)
- Box2D Wrapper (C++): Joybox - Box2D
- Documentation (markdown): Joybox - Documentation
To contribute just:
- Fork it
- Create your feature branch (git checkout -b my-new-feature)
- Commit your changes (git commit -am 'Added some feature')
- Push to the branch (git push origin my-new-feature)
- Create new Pull Request
Joybox is released under the MIT License.
Cocos2D: Ricardo Quesada, Zynga and contributors cocos2d for iPhone
Box2D: Erin Catto Box2D | A 2D Physics Engine for Games