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.

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

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,491
- 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,491
- 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,491
- 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,491
- 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,491
- 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,491
- 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
Gravityle
- Join Date: 5/30/2017
- Posts: 1
- Member Details
#3706 Gravityle

View User Profile

Send Message

Posted May 30, 2017
hey i just installed the plugin for my server but when i try to make something it wont work

please somebody help me out

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

View User Profile

Send Message

Posted May 30, 2017
In reply to Gravityle:

Hi, what do you mean by it won't work? Have you enabled what you want to use? How are you doing it? Are there any errors/messages?

Rollback Post to Revision RollBack
InfernoMCServNu
- Join Date: 8/31/2016
- Posts: 12
- Member Details
#3702 InfernoMCServNu

View User Profile

Send Message

Posted May 5, 2017
Working on permissions on my server and I began to test some things out. I have tried many times, but I cannot get the command items permission craftbook.mech.commanditems to work. This breaks my server as the gamemode is literally based off of them. Is this a bug or is the perm wrong? If you need any more information or if you want me to post it on the bug reporting website, just ask and I will provide it, thanks!

20min of thinking later:

Tried adding the permission using PEX and it worked fine!
I was using a plugin called Accentials and its built in group handling system, clearly something went wrong and it didn't want to work for some reason. ;-;

Last edited by InfernoMCServNu: May 5, 2017

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

View User Profile

Send Message

Posted May 5, 2017
In reply to InfernoMCServNu:

Hi, if it works in Pex, and not in the other plugin - something is wrong with the way the other plugin assigns permissions.

Rollback Post to Revision RollBack
InfernoMCServNu
- Join Date: 8/31/2016
- Posts: 12
- Member Details
#3704 InfernoMCServNu

View User Profile

Send Message

Posted May 6, 2017
In reply to Me4502

Tested all of the other permissions and they all work. Its just the Craftbook permissions. However, the plugin has not been updated for a year so It is most likely a bug in the code. Will report it on their bug tracker and hopefully it will be fixed when they update it soon.

Thanks for replying anyway :D

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

View User Profile

Send Message

Posted May 6, 2017
In reply to InfernoMCServNu:

As a secondary permissions plugin, it should be assigning permissions through something like Vault. Only primary permissions plugins should directly access the Bukkit API.

WEPIF has a mode that allows misbehaving plugins to still work however, if you open your WEPIF.yml file, set the resolver to DinnerPerms and it'll accept incorrectly assigned permission nodes. However, this will break the ability for things to grab the players group, eg CraftBook ICs, WorldGuard regions, etc.

Rollback Post to Revision RollBack
d4rk0c34n
- Join Date: 4/25/2017
- Posts: 2
- Member Details
#3698 d4rk0c34n

View User Profile

Send Message

Posted Apr 25, 2017
Can u make it pls for 1.11.2? :) thx.

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