added getUsableItems method that returns an id list
changed broadcast to new format
added docs and various shortcut/helper methods