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
Comments