Mineuniverse
Log in Register
Plugins

RubyBukkit

Write plugins in JRuby
by _ForgeUser6848200
Download Claim this project
5,100 downloads
0 likes
Updated Jun 30, 2026
0 hypes
Developer Tools

Write plugins in JRuby!

Rubybukkit is a custom plugin loader that enables you to write Bukkit plugins as short Ruby/JRuby scripts.


Features

  • Loads Bukkit plugins written in Ruby/JRuby


Installation

  • Download the plugin from the Files tab and drop it into the plugins folder
  • Create the folder plugins/RubyBukkit (or let the plugin create it on server start); this folder will contain the JRuby runtime and all your Ruby plugins
  • Download the JRuby runtime version 1.6.x from http://jruby.org/download (get JRuby 1.6.x Binary as tar.gz or zip)
  • Extract the file jruby.jar in the lib folder from that archive and drop it into plugins/RubyBukkit


Plugin Source

The source code is available in the Github repository: https://github.com/Zeerix/RubyBukkit

I will accept Pull Requests if I have the time and I find them useful.


Configuration

The plugin will create a default configuration file on startup as plugins/RubyBukkit/config.yml.

1
2
3
4
5
6
settings:
    plugins-path: plugins/RubyBukkit
    debug: true
runtime:
    ruby-version: '1.8'
    jruby-path: plugins/RubyBukkit/jruby.jar
plugins-path
the folder which this plugins looks for Ruby plugins in. All files with extension .rb are loaded.
debug
enables/disabled debug output about plugin loading
ruby-version
JRuby version compatibility mode: '1.8' or '1.9'
jruby-path
location of the jruby runtime


Example plugins

Here is a list of some example plugins. There is also an explanation on How to Write a Ruby Plugin in the forum.

  • [GEN/INFO] OnlinePlayers - Displays list of online players on login and by a command.
  • [WGEN] RubyMoon - Ruby version of the custom map generator BukkitFullOfMoon by Dinnerbone.
  • [ADMN] GarbageCollect - Registers a command that forces a garbage collection cycle.
  • [INFO] Uptime - Displays time since server start on /uptime.
  • [MISC/MECH] CustomRecipes - Adds some custom recipes for the crafting grid. Can easily be changed to add new recipes.

Donation

If you like RubyBukkit, you can donate some Bitcoins to my address.
One-time addresses and other forms of donation on request.

Bitcoins: 12RnhW6hMUJuHACNMgsmuGRzuWMswpchQf

RubyBukkit 0.8
MC CB 1.2.4-R1.0, CB 1.1-R6
Beta 2012-03-03 Get
RubyBukkit 0.7.1
MC CB 1.1-R4, CB 1.1-R1
Beta 2012-01-25 Get
RubyBukkit 0.6
MC CB 1.0.1-R1
Beta 2012-01-13 Get
RubyBukkit 0.5
MC CB 1.0.1-R1, CB 1337
Beta 2011-12-10 Get

You Might Also Like

WorldGuard Custom Flags
WorldGuard Custom Flags
97,851
HoloAPI
Advanced and powerful holographic displays
93,959
Minequery
Minequery
91,099
SQLibrary
SQLibrary aims to streamline driver wrappers in Java for every database engine
85,675
WolfyUtilities
Utils and APIs: Config, Language and Inventory API, Protection Utils: WorldGuard, LWC, PlotSquared
84,728
DisguiseTester
Experiment with disguises!
9,677