CraftBook

Table of Contents

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 docs)

If you find any issues with the docs, 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!

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

me4502
- Location: Brisbane
- Join Date: 5/19/2011
- Posts: 2,054
- Member Details
#3755 me4502

View User Profile

Send Message

Posted Jan 31, 2019
In reply to AmigaMan67:

Make sure you're on the latest WorldEdit, that error cannot happen when using it.

Rollback Post to Revision RollBack
amigaman67
- Join Date: 1/30/2019
- Posts: 5
- Member Details
#3756 amigaman67

View User Profile

Send Message

Posted Jan 31, 2019
In reply to Me4502:

As expected......you have the answer! Guess i didn't realize I didn't have the latest edition of W.E.. That was the fix! Thank you! I will see if I can do what I hope to do with it. If so, I'll be glad to make a donation. Thanks again!

Rollback Post to Revision RollBack
SilhouetteJW
- Join Date: 11/17/2017
- Posts: 11
- Member Details
#3750 SilhouetteJW

View User Profile

Send Message

Posted Jan 10, 2019
We've been using the latest dev build #4479 on our 1.13.2 Spigot server. I was really excited as it seems to now have toggleareas working!

Currently, it does not appear that [Gate] and [MC1208] (Multi Setblock) are not functional. Do I need to clear any of my configs or are those still waiting for a more stable release?

Rollback Post to Revision RollBack
me4502
- Location: Brisbane
- Join Date: 5/19/2011
- Posts: 2,054
- Member Details
#3751 me4502

View User Profile

Send Message

Posted Jan 18, 2019
In reply to silhouettejw:

From my testing everything functions. What about gates and MC1208 aren't working? I'd recommend joining the Discord so we can actually discuss it

Rollback Post to Revision RollBack
SilhouetteJW
- Join Date: 11/17/2017
- Posts: 11
- Member Details
#3752 SilhouetteJW

View User Profile

Send Message

Posted Jan 19, 2019
In reply to Me4502:

In particular, they don't seem to be recognized.

Placing a sign with [gate] or [MC1208] on the second line in that build doesn't seem to react or populate the rest of the sign, as if the plugin didn't recognize/act upon the entry.

Rollback Post to Revision RollBack
me4502
- Location: Brisbane
- Join Date: 5/19/2011
- Posts: 2,054
- Member Details
#3753 me4502

View User Profile

Send Message

Posted Jan 19, 2019
In reply to silhouettejw:

Are they enabled?

Rollback Post to Revision RollBack
soyboy4700
- Join Date: 12/27/2018
- Posts: 3
- Member Details
#3748 soyboy4700

View User Profile

Send Message

Posted Jan 1, 2019
hello, I have a problem with craftbooki enabled al the mechanics of craftbook. I wanted to build a bridge and I get the message: Material not usable for a bridge and I also wanted to make a gate with craftbook but the sign does not work or something. I am using the craftbook3.10 Beta 1 version and spigot 1.13.1 version.

Rollback Post to Revision RollBack
me4502
- Location: Brisbane
- Join Date: 5/19/2011
- Posts: 2,054
- Member Details
#3749 me4502

View User Profile

Send Message

Posted Jan 1, 2019
In reply to soyboy4700:

Try the dev builds of CraftBook and WorldEdit, I can confirm it works on those.

Rollback Post to Revision RollBack
SilhouetteJW
- Join Date: 11/17/2017
- Posts: 11
- Member Details
#3746 SilhouetteJW

View User Profile

Send Message

Posted Nov 23, 2018
Hey, we've been using this plugin for some time now on our 1.12.2 server, and it's amazing. Great work, really.

I was wondering, while trying to setup a particular redstone machine, I saw that MC1500 Ranged Output might be what I'm looking for. I realize that you mentioned some of it was really dated on the wiki and may not be entirely supported or work, but it doesn't seem to have any information on how it works or what parameters it needs (looking at the github seems to show that it needs variables on the sign, but no mention of syntax or where).

Do you know if Ranged Output is a working one, and if so, what the proper syntax for making the IC would be?

Rollback Post to Revision RollBack
me4502
- Location: Brisbane
- Join Date: 5/19/2011
- Posts: 2,054
- Member Details
#3747 me4502

View User Profile

Send Message

Posted Nov 28, 2018
In reply to silhouettejw:

It looks like its working.

The IC outputs high for a random period of ticks, inside a range defined on the sign.

The third line contains the range. Eg, 1-4 would be a random duration from 1 to 4.

The fourth line is the length of the duration in redstone ticks (By default it's 1 second (10 redstone ticks), so you can leave it blank for that).

So if you left the last line blank and had

[MC1500]

1-4

You'd get it outputting high for 1 to 4 seconds.

Last edited by me4502: Nov 28, 2018

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

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: 2,054
- Member Details
#3744 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
Gpax971
- Join Date: 8/29/2018
- Posts: 3
- Member Details
#3745 Gpax971

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
Xinaru1991
- Join Date: 7/8/2017
- Posts: 1
- Member Details
#3741 Xinaru1991

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: 2,054
- Member Details
#3742 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
WaverlyCole
- Join Date: 8/3/2018
- Posts: 2
- Member Details
#3739 WaverlyCole

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: 2,054
- Member Details
#3740 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
#3737 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: 2,054
- Member Details
#3738 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
#3734 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
To post a comment, please login or register a new account.