CraftBook

Table of Contents

For 1.9+ (1.12/1.11/etc) Spigot, see if you wish to support us! Here ($2.50), alternatively Here (Free), which is free.

For 1.13+ use this link here.

CraftBook is a heavily customizable plugin that adds a number of new mechanics to Minecraft with no client mods required. As one of Minecraft's oldest mods/plugins, we were the first to bring you Minecraft computers, Redstone ICs, moving bridges, and more! Here's a short list:

Modular, and extremely light on your server.
Enable features that you need, disable ones that you don't. Even tweak features to your liking.
Adds heaps of mechanics that allow you to mimic large portions of FTB/Tekkit with a vanilla client.
Redstone ICs (Logic gates, Sensors, Many others)
Elevators for your server so people can jump between floors quickly. (Or smoothly, if you choose so)
Working cauldrons so players can cook inside them.
Your own custom crafting recipes.
Hidden switches for players.
Togglable areas and bridges.
Chairs you can sit on.
Working pipes that can transfer items from place to place.
Footprints where your players walk.
Mobs and players drop their heads.
The ability to bind commands to items, with cool-downs, permissions and timers.
And much more... (Seriously, check the wiki)

The CraftBook wiki is currently being revamped! Progress can be viewed here! If you find any issues with the wiki (Especially in pages marked 100% of missing), please report them here.

Want to script plugins without knowing Java? Consider CommandHelper. Want to add /homes /warps /tp /bring, etc.? Try CommandBook.

Getting Started

Installation

Bukkit is currently required.

Install WorldEdit first. (DON'T FORGET THIS)
Install any other plugins required for specific features you want.
Download CraftBook and copy the .jar into plugins/.
Run your server once to generate the files.
Edit plugins/CraftBook/config.yml to your liking, and enable anything you want to use.
Note: For optimal performance, only enable what you need. If you are running a version prior to 3.8.1, check the config to see if any features are enabled that you don't want.
Restart the server for the settings to take effect.

You'll have to read the wiki (see below) to find the permissions you need.

Documentation

For Permissions, Configuration, A list of features and more, check out the wiki

Learning More

Project leader: Contact Me4502 on Twitter
Lead developers: Me4502, Dark_Arc
Project started: On October 22nd 2010 (Bukkit was started January 2011)
Official Discord Server: Click here!
Official Minecraft Server: Come join us at play.fortunemc.net

See more videos (Tutorials, Usage, More!)

Quote from metrics:
We use metrics to collect stats! We only collect basic things such as version type, and players online. Visit mcstats.org if you would like to learn more about the stats collected. Go into /plugins/PluginMetrics/config.yml to disable stat collecting if you wish.

Quote from auto updater:
We use an auto updater to check for updates! If you wish to disable it, set update-check: false in the config.yml file.

Testimonials

Quote from testimonials:

CraftBook is an amazing plugin helping our users build amazing creative structures all over EcoCityCraft. Highly recommend this to other owners/communities. — andrewkm of EcoCityCraft

CraftBook is great, we've used it for more than 3 years and we recommend it to everyone. — sawine of MineTown

Thank You

Thank you to the following individuals and organizations (Any donation of $30 or over qualifies you for this list)

All our donators - A list of donors is available here.

Want to support CraftBook yourself? The best way to thank us for working on CraftBook, is to donate. We greatly appreciate it!

Comments

Gpax97114352
- Join Date: 8/29/2018
- Posts: 3
- Member Details
#3726 Gpax97114352

View User Profile

Send Message

Posted Aug 29, 2018
Doesn't work on my 1.13 server. I tried all the recent dev builds and they all load successfully but none of the functions or commands work.

Rollback Post to Revision RollBack
Me4502
- Location: Brisbane
- Join Date: 5/19/2011
- Posts: 1,605
- Member Details
#3727 Me4502

View User Profile

Send Message

Posted Aug 29, 2018
In reply to Gpax97114352:

What are the errors? And are you using the right dev builds? http://builds.enginehub.org/job/craftbook?branch=spigot/1.13

Rollback Post to Revision RollBack
Gpax97114352
- Join Date: 8/29/2018
- Posts: 3
- Member Details
#3728 Gpax97114352

View User Profile

Send Message

Posted Aug 30, 2018
In reply to Me4502:

Not sure what happened but I reloaded the plugins and it worked fine. Thanks for the help anyway :)

Rollback Post to Revision RollBack
XiNaru
- Join Date: 7/8/2017
- Posts: 1
- Member Details
#3724 XiNaru

View User Profile

Send Message

Posted Aug 18, 2018
can anyone pls help me`? i have activate gate and ics, but the ics dont work now. i not good in english, sry.

Rollback Post to Revision RollBack
Me4502
- Location: Brisbane
- Join Date: 5/19/2011
- Posts: 1,605
- Member Details
#3725 Me4502

View User Profile

Send Message

Posted Aug 18, 2018
In reply to XiNaru:

Please do `/cb report -p` and provide me with the link it gives.

What IC are you trying to use? And what happens when you make it? Can you please provide a screenshot of it?

Rollback Post to Revision RollBack
waverlycole46369
- Join Date: 8/3/2018
- Posts: 2
- Member Details
#3722 waverlycole46369

View User Profile

Send Message

Posted Aug 3, 2018
1.13?

Rollback Post to Revision RollBack
Me4502
- Location: Brisbane
- Join Date: 5/19/2011
- Posts: 1,605
- Member Details
#3723 Me4502

View User Profile

Send Message

Posted Aug 3, 2018
In reply to waverlycole46369:

1.13 dev builds have been around for about 2 weeks now, http://builds.enginehub.org/job/craftbook?branch=spigot/1.13

Rollback Post to Revision RollBack
Celadrieldor
- Join Date: 4/27/2010
- Posts: 7
- Member Details
#3720 Celadrieldor

View User Profile

Send Message

Posted Mar 8, 2018
**Troubleshooting via discord chat with author Me4502**

Hey everyone, I was trying to set up Dispenser Recipes, but so far wasn't having any luck in my permission nodes - now I haven't been able to test it myself on the server, just what was reported to me through my discord when i had a user test it after assigning the nodes found in the wiki.

Any ideas on this? he said they acted like normal dispensers with random items being thrown out.

Last edited by Celadrieldor: Mar 9, 2018

Rollback Post to Revision RollBack
Me4502
- Location: Brisbane
- Join Date: 5/19/2011
- Posts: 1,605
- Member Details
#3721 Me4502

View User Profile

Send Message

Posted Mar 10, 2018
In reply to Celadrieldor:

To recap solution from Discord,

Spigot introduced a bug in 1.12 that prevents it working when there’s only 1 of the items in the dispenser (it tells plugins what items were in the dispenser after shooting it out rather than before now), so you need 2 of each item for it to work now. I’m trying to push for it to be fixed.

Rollback Post to Revision RollBack
retnikt
- Join Date: 3/2/2018
- Posts: 2
- Member Details
#3717 retnikt

View User Profile

Send Message

Posted Mar 2, 2018
I just wrote a bug report here, and in the process of investigating that bug, I came across another.

Ttitle:

/recp save command does not save NBT data (enchantments, lore etc) of items

To avoid taking up the entire comment page I am putting in a spoiler:

/recp save command does not save enchantments or potion data of items

Summary

When a recipe is saved using the command /recp save in game, using an item with enchantments, or potion effects.

What I did

I put these items in this layout in my inventory:

and then ran /recp save test1 shapeless

Expected behaviour

The following should have been saved in crafting-recipes.yml:

test1: type: Shapeless ingredients: 'FLINT ': 1 'POTION:INCREASE_DAMAGE;3600;1 ': 1 results: 'GLASS_BOTTLE ': 1

(I think I've understood the potion item syntax correctly)

As a result, a flint and only a strength potion should yield an empty bottle.

A flint and any other potion should not yield anything.

Actual behaviour

The following was saved in crafting-recipes.yml:

test1: type: Shapeless ingredients: 'FLINT ': 1 'POTION ': 1 results: 'GLASS_BOTTLE ': 1

As a result, a flint and any potion yields an empty bottle.

Notes

This behaviour also occurs when using a furnace or shaped recipe.

This behaviour occurs when set as the output item(s).

This behaviour occurs regardless of any other items used in the recipe.

This behaviour occurs with enchanted books and potions.

This behaviour does not occur with enchanted tools or items with custom names or lore.

Environment

(This seems to happen regardless of other plugins or CraftBook configuration, so I am posting the minimum relevant information):

CraftBook 3.9u21

WorldEdit 6.1.7.3

Spigot 1.12.2 with Java 1.8.0_151 on Ubuntu 16.04 LTS

Plugins: WorldEdit, CraftBook

Enabled Mechanics of CraftBook: Variables, Custom Crafting

Thanks, retnikt.
Rollback Post to Revision RollBack
Me4502
- Location: Brisbane
- Join Date: 5/19/2011
- Posts: 1,605
- Member Details
#3719 Me4502

View User Profile

Send Message

Posted Mar 2, 2018
In reply to retnikt:

This issue is a bit weirder, I’ll have a look at it as well as it should be working. Some NBT data can’t be saved, like attributes, as Spigot doesn’t provide it to the plugin, but damage values should definitely be saved so I’ll have a look when I get a chance.

Rollback Post to Revision RollBack
retnikt
- Join Date: 3/2/2018
- Posts: 2
- Member Details
#3716 retnikt

View User Profile

Send Message

Posted Mar 2, 2018
Hi. I would like to make a bug report, but the YouTrack website's license* has expired and the GitHub repository has issues disabled, so I am posting it here.

Title:

/recp save command does not save quantity of non-stackable items in shapeless or furnace recipes

To avoid taking up the entire comment page I am putting in a spoiler:

/recp save command does not save quantity of non-stackable items in shapeless or furnace recipes

Summary

When a recipe is saved using the command /recp save in game, using more than one of the same non-stackable item in a shapeless recipe causes it to save as having only one item, so the recipe works with only one of these items.

What I did

I put these items in this layout in my inventory:

then ran the command /recp save test1 shapeless

There were no errors in the console, and no client-side error message.

Expected Behaviour

The following should have been saved in crafting-recipes.yml:

crafting-recipes: test1: type: Shapeless ingredients: 'CAKE ': <strong>2</strong> results: 'GOLDEN_APPLE ': 1

As such, putting two cake in the crafting grid (in any place) should yield a Golden Apple.

Putting one or more than three cakes in the crafting grid (in any place) should not yield anything.

Actual Behaviour

The following was saved in crafting-recipes.yml:

crafting-recipes: test1: type: Shapeless ingredients: 'CAKE ': 1 results: 'GOLDEN_APPLE ': 1

As such, putting one cake in the crafting grid (in any place) yields a Golden Apple.

Putting two or more cakes in the crafting grid (in any place) does not yield anything.

Notes

This behaviour also occurs when using a furnace recipe, even though it is not possible to put multiple non-stackable (e.g. Cake) items in a furnace.

This behaviour occurs regardless of the output items.

This behaviour occurs regardless of any other items used in the recipe.

This behaviour occurs if multiple of different non-stackable items are used (e.g. 2 cakes and 2 beetroot soups) (you have to only use one of each to get the desired output)

This behaviour does not occur when using a shaped recipe.

This behaviour does not occur when using different non-stackable items.

This behaviour does not occur when using stackable items.

Environment

(This seems to happen regardless of other plugins or CraftBook configuration, so I am posting the minimum relevant information):

CraftBook 3.9u21

WorldEdit 6.1.7.3

Spigot 1.12.2 with Java 1.8.0_151 on Ubuntu 16.04 LTS

Plugins: WorldEdit, CraftBook

Enabled Mechanics of CraftBook: Variables, Custom Crafting

Thanks, retnikt.

* PS: get a new YouTrack license for https://dev.enginehub.org/youtrack/oauth (linked on wiki as http://redmine.sk89q.com/projects/craftbook but it redirects)
Rollback Post to Revision RollBack
Me4502
- Location: Brisbane
- Join Date: 5/19/2011
- Posts: 1,605
- Member Details
#3718 Me4502

View User Profile

Send Message

Posted Mar 2, 2018
In reply to retnikt:

Hey, firstly with the license - Jetbrains is being /really/ slow to respond, we’ve been putting requests in for a few weeks.

I’ll have a look at that. May require a bit of a workaround, as presumably Spigot has changed the api to prevent setting amounts on stacks that aren’t possible in the vanilla game.

Ill probably have some time this afternoon or tomorrow.

Rollback Post to Revision RollBack
i_thefenix_i
- Join Date: 2/22/2018
- Posts: 6
- Member Details
#3712 i_thefenix_i

View User Profile

Send Message

Posted Feb 23, 2018
Hi! I have a question, Sitting in chairs used to work but since today I restarted my servers and I got the following error 23.02 12:18:16 [Server] WARN Failed to load mechanic: Chairs Someone who could help me with this?

Rollback Post to Revision RollBack
Me4502
- Location: Brisbane
- Join Date: 5/19/2011
- Posts: 1,605
- Member Details
#3713 Me4502

View User Profile

Send Message

Posted Feb 24, 2018
In reply to i_thefenix_i:

What's the full error? If it failed to load chairs, in most cases it's because you don't have ProtocolLib installed.

Rollback Post to Revision RollBack
i_thefenix_i
- Join Date: 2/22/2018
- Posts: 6
- Member Details
#3714 i_thefenix_i

View User Profile

Send Message

Posted Feb 25, 2018
In reply to Me4502:

That was the full error I got in the console... And I used to have problems with ProtocolLib it gave errors in my server so I updated the version the errors stopped but I still couldn't load in the Chairs I'm goin to try it again tonight. Reinstall both craftbook and ProtocolLib

Rollback Post to Revision RollBack
Me4502
- Location: Brisbane
- Join Date: 5/19/2011
- Posts: 1,605
- Member Details
#3715 Me4502

View User Profile

Send Message

Posted Feb 26, 2018
In reply to i_thefenix_i:

Are you using something like Multicraft? Or another panel? They quite often hide errors. Are you able to check if there's anything extra in the server logs? That message should never occur without an associated error, as that appears when an error occurs.

Rollback Post to Revision RollBack
ixLoDell
- Join Date: 12/15/2017
- Posts: 1
- Member Details
#3711 ixLoDell

View User Profile

Send Message

Posted Dec 23, 2017
Awesome!

Rollback Post to Revision RollBack
Gustavo_Master
- Location: Paraíba
- Join Date: 10/28/2017
- Posts: 2
- Member Details
#3709 Gustavo_Master

View User Profile

Send Message

Posted Nov 6, 2017
The plugin is amazing, but a new error appeared, I updated it to latest version and every time I start my server this appears:

[14:17:24 ERROR]: Could not load 'plugins\CraftBook 3.9u19.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.NoClassDefFoundError: com/sk89q/minecraft/util/commands/CommandPermissionsException
at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.java:131) ~[PaperSpigot.jar:git-Paper-1248]
at org.bukkit.plugin.SimplePluginManager.loadPlugin(SimplePluginManager.java:328) ~[PaperSpigot.jar:git-Paper-1248]
at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager.java:251) [PaperSpigot.jar:git-Paper-1248]
at org.bukkit.craftbukkit.v1_12_R1.CraftServer.loadPlugins(CraftServer.java:309) [PaperSpigot.jar:git-Paper-1248]
at net.minecraft.server.v1_12_R1.DedicatedServer.init(DedicatedServer.java:225) [PaperSpigot.jar:git-Paper-1248]
at net.minecraft.server.v1_12_R1.MinecraftServer.run(MinecraftServer.java:616) [PaperSpigot.jar:git-Paper-1248]
at java.lang.Thread.run(Unknown Source) [?:1.8.0_151]
Caused by: java.lang.NoClassDefFoundError: com/sk89q/minecraft/util/commands/CommandPermissionsException
at java.lang.Class.forName0(Native Method) ~[?:1.8.0_151]
at java.lang.Class.forName(Unknown Source) ~[?:1.8.0_151]
at org.bukkit.plugin.java.PluginClassLoader.<init>(PluginClassLoader.java:68) ~[PaperSpigot.jar:git-Paper-1248]
at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.java:127) ~[PaperSpigot.jar:git-Paper-1248]
... 6 more
Caused by: java.lang.ClassNotFoundException: com.sk89q.minecraft.util.commands.CommandPermissionsException
at java.net.URLClassLoader.findClass(Unknown Source) ~[?:1.8.0_151]
at org.bukkit.plugin.java.PluginClassLoader.findClass(PluginClassLoader.java:105) ~[PaperSpigot.jar:git-Paper-1248]
at org.bukkit.plugin.java.PluginClassLoader.findClass(PluginClassLoader.java:90) ~[PaperSpigot.jar:git-Paper-1248]
at java.lang.ClassLoader.loadClass(Unknown Source) ~[?:1.8.0_151]
at java.lang.ClassLoader.loadClass(Unknown Source) ~[?:1.8.0_151]
at java.lang.Class.forName0(Native Method) ~[?:1.8.0_151]
at java.lang.Class.forName(Unknown Source) ~[?:1.8.0_151]
at org.bukkit.plugin.java.PluginClassLoader.<init>(PluginClassLoader.java:68) ~[PaperSpigot.jar:git-Paper-1248]
at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.java:127) ~[PaperSpigot.jar:git-Paper-1248]
... 6 more

Rollback Post to Revision RollBack
Me4502
- Location: Brisbane
- Join Date: 5/19/2011
- Posts: 1,605
- Member Details
#3710 Me4502

View User Profile

Send Message

Posted Nov 6, 2017
In reply to Gustavo_Master:

You need WorldEdit to use CraftBook.

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.