Quick Start Guide
Quick Start Guide
To install Sensible Toolbox:
- Download the latest release from dev.bukkit.org
- Optional dependency: install ProtocolLib for glowing items, working Sound Muffler and a few more features (recommended)
- Optional dependency: install HoloAPI for popup info holograms on certain blocks (reduces chat clutter!)
- Copy SensibleToolbox.jar into your
- Restart or reload your server
This guide is best used if you have op status, although most of Sensible Toolbox's features are accessible to players by default.
Sensible Toolbox (hereafter referred to as STB) adds a ton of new functionality and this guide should give you a good overview of what to expect. More detailed information about each item, block and system is included in the Items section of this site.
The Recipe Book
To get started, get yourself a Recipe Book. Since STB adds many recipes, this item will make your life very much easier when trying to craft or obtain stuff. Just get a book and a crafting table, and combine them (shapeless), to get the Recipe Book. Hold it in your hand, and right-click.
The resulting popup window shows every single craftable item in the game, including furnace recipes. The bottom row of the GUI window includes several buttons: in the bottom right are buttons to skip to the next and previous pages of recipes. Bottom left is an indicator showing the recipe page you're on (a typical server will have around 9 pages, but it could be more if you've added other plugins which add recipes), as well as a toggle button to display all recipes, vanilla recipes only, or STB recipes only.
Clicking on a craftable item will switch the book to displaying the recipe window for that item. There could be multiple recipes for creating an item; in that case you'll see two buttons on the left and right-hand edges for cycling through the recipes. Bottom right is a button to take you back to the item list.
You can also click on items in the recipe window to drill further down (e.g. when viewing the recipe for a piston, you can click on one of the wood blocks to see how they're made). In that case, a second button will appear in the bottom right to go back to the previous recipe. You can drill as far down as you like, which could be many levels for some complex recipes.
You can search for a particular recipe too; with a Recipe Book anywhere in your inventory, type
/stb recipe <search-term> where
search-term is any string you want to search for. E.g.
stb recipe wood will show recipes for all items with "wood" in the item name. When you're in search mode, you'll see another button bottom left indicating the active search filter; you can click it to clear the filter and display all items again.
Another useful feature of the Recipe Book is automatic item fabrication. If you right click the book on a crafting table (or have a crafting table targeted and close enough when using
stb recipe ...), another button will be available on the bottom row of the recipe view: Fabricate. Clicking this will automatically make the item for you, if you have the materials. If you don't, you'll be told what's missing. If you have the stb.fabricate.free permission node (true for ops by default), then you don't need to have the materials.
Advanced Recipe Book
If you take your recipe book and craft it together with a diamond, you'll get the Advanced Recipe Book. This acts very much like the basic recipe book, with one important advantage: in fabrication mode, crafting ingredients can also be pulled from any inventory (vanilla or STB) that is adjacent to the crafting table.
So, for example, you can fill a chest with cobblestone, wood, iron ingots and redstone, then put a workbench beside it, target that workbench and type
/stb recipe piston, and fabricate pistons from the ingredients in the chest!
The video review of v0.0.1 by MusicTechnician is well worth watching.
After that, have a read of the reference sections for each part of STB: Items