Littlebits

LittleBits-Bukkit

Bukkit server-side plugin for integrating with littleBits.

Installation

Just drop the LittleBits-Bukkit.jar in the plugins folder of your Bukkit compatible minecraft server, and restart the server.

Configuration

Before configuring the LittleBits-Bukkit plugin, you need to find the TOKEN of your littleBits CloudBit account. The littleBits have a page describing this process here: http://developers.littlebitscloud.cc/access

Once you have that token, you can either use the in-game command:

/littlebits account add TOKEN

Where you simply copy-paste the 64-character token in place of the TOKEN above, or you can manually add the following section to your plugins/LittleBits-Bukkit/devices.yml file:

accounts:
  <64-character-TOKEN-here>:
    label: My Account

and then do a /littlebits reload (not needed when adding it using the in-game command above).

To test whether the connection to the bitCloud went as planned, invoke the /bits acc list command. If the output is something along the lines of:

All accounts:
  Account: My Account
    - device1 (My Account:00e04c52b9a2, in=0, out=0, connected)

Your are all set to continue.

Usage

The plugin adds a recipe to manually create a littleBits block, using a diamond, an emerald and a repeater. Place the two gems on either side of the comparator, and you will get an enchanted Repeater named littleBits.

This item can also be obtained by invoking:

/littlebits block give [playername]

When this block is placed in the world, it will be unassigned per default. Right-clicking the block will cycle through all the devices registered in the plugin.

Once a device has been associated to a block, that block will start outputting what-ever input the littleBits device in the real-world is receiving.

If a redstone signal (using redstone wire) is directed into the back-side of the littleBits block in minecraft, the littleBits device in the real-world will be instructed to output a signal accordingly.

Note: I/O from the devices in the real-world is from 0-100, where as the redstone signals in the minecraft world is from 0-15.

TODO

• Support changing label of devices (requires admin role in OAuth against littlebits.cc).
• Support registering devices (requires admin scope).
• Support custom recipe for LittleBits device (move recipe to config.yml)
• More minified jar-file (we include too much of apache httpcomponents atm).

License

This is licensed under Apache License v2.0