Home

Description

Chingu is a game development framework for Ruby. It is an extension of the Gosu framework. Chingu is distributed to the world as a Ruby gem.

Leader Name + GitHub ID

Russ S. (russplaysguitar)

Dependencies

• RVM (recommended)
• Ruby 1.8.7 or 1.9.2
• Gosu
• Rake

Installation Steps

1. Check RVM dependencies:

• for name in {bash,awk,sed,grep,ls,cp,tar,curl,gunzip,bunzip2,git,svn} ; do which $name ; done

2. Install RVM: https://rvm.beginrescueend.com/rvm/install/
3. Install Ruby 1.8.7 using RVM: rvm install 1.8.7 (1.9.2 is OK too)
4. Install Gosu dependencies:

• sudo apt-get install g++ libgl1-mesa-dev libpango1.0-dev libboost-dev libsdl-mixer1.2-dev libsdl-ttf2.0-dev libsndfile1-dev

5. Create an rvm gemset for chingu: rvm --create use @chingu
6. Install Gosu: gem install gosu
7. Install Rake: gem install rake
8. Download Chingu: git clone [email protected]:ChicoTeam/chingu.git
9. Build Chingu. From within /chingu/ : gem build chingu.gemspec
10. Install Chingu: gem install chingu-0.9rc7.gem

How to Run

Chingu is now installed as a Ruby Gem on your system, which can be accessed from within any Ruby file. Simply include the following at the beginning of your Ruby files:

require 'rubygems'

require 'chingu'

include Gosu

Demos

• Basic examples here: chingu/examples/
• Game demos:
• chingu/examples/game1.rb (requires texplay gem)
• chingu/examples/game_of_life.rb

Unit Tests

Found in chingu/spec/ . Built using rspec: http://rspec.info/documentation/

Language/Framework References and Guides

• Chingu: http://ippa.se/chingu