Page 1 of 1

Ruby Plugin

Posted: Fri Dec 28, 2007 1:06 am
by catay
It isn't Python, nor Perl , not even PHP, but it's Ruby !!!! ;)

I want to announce the initial alpha release of the BZFlag Ruby plugin.

=> http://catay.be/bzplugins/Ruby/Ruby-0.1.0.tar.bz2

For the people that are not acquainted with Ruby have a look at
the following url : http://www.ruby-lang.org/en/

Quote from the Ruby homepage :
'Ruby is a dynamic, open source programming language with a focus on
simplicity and productivity. It has an elegant syntax that is natural
to read and easy to write.'

The Ruby plugin provides Ruby bindings to the native bzfs API. It was
inspired on the proof of concept Python plugin that shippes with the
official BZFlag source.

It is currently possible to make simple Ruby plugins. You can
write Ruby plugins that react on events and even modify the
event data when possible. Below the 'plugins' directory you will
find some working Ruby plugins (airspawn.rb,timelimit.rb, tutor.rb).

I am not going to explain here how it all works. The README.txt file
contains a small tutorial on how to make a basic Ruby plugin.
There is also 'rdoc' documentation available below the 'doc'
directory. You can browse to it with your browser.

Also take into account that NOT the whole native bzfs API
is exposed yet. A LOT of stuff is still missing. I basically
just did the easiest stuff. :)

This code is still very very experimental, ugly and very buggy.
It will probably crash your bzfs and leak memory.
The code is also ONLY tested on Linux (mainly Debian 4.0).
The makefile is also ugly as hell ... and so on and so on.

My main motivation for making it public already is that I
want feedback on how to improve it and to see if it will be
usefull to some people.

Don't hesitate to contact me when you have questions about it !

Take care.

catay