Craftbook

From MinecraftOnline

Jump to: navigation, search

MinecraftOnline is using Craftbook Extra - a fork of Craftbook by getplayerhead.sh?M4411K4&16.png M4411K4.

This article is not intended to replace or duplicate the official Craftbook wiki; the content here is specifically intended to document the features specific to Craftbook Extra which are in use on MinecraftOnline, and act as a friendly how-to guide. Please note that Craftbook Extra is based on Craftbook version 2.0. Not all features described in the Craftbook wiki will work.

Contents

In-game information

You can list CBX signs from inside the game using a newly added information command:

  • /ic keyword|IC - search for a Craftbook IC or other sign type by name or function, or look up function from a craftbook IC code.

MCO-specific enhancements

MinecraftOnline's admins have added some features to Craftbook Extra that are not in the official version maintained by M4411K4, and hence not documented on the Craftbook Extra wiki:

CraftBook Mining Protection

It used to be possible to place [MCX207] (Advanced Bridge) or [MCX208] (Advanced Door) ICs to mine out a 11x1x30 area of stone blocks with the flick of a lever. This did not fit the survival theme, so the mechanic of creating these ICs was changed.

After placement, these ICs cannot remove blocks of the type that is specified on line 3. When the input changes, they check the area that is specified on line 4 for these blocks, ignoring data values (red wool in the area will block a 35:0 IC). If any are found, the IC refuses to work and messages players within 3 blocks of the sign about the problem. Once all offending blocks have been removed and the input changes, the IC will notice that the area is now clear and that you cannot be using it to mine. From that point on, it will function as described on the Craftbook-Extra Wiki.

This boils down to a simple rule for creating [MCX207] and [MCX208]: Remove all blocks of the IC's type from the area that it operates on before you power it.

Wooden button

Craftbook signs, pumpkins, and netherack can be triggered by wooden buttons. → Will soon be integrated in the official release.

[Dispenser] for boats

On MCO, minecart dispensers can also dispense boats. Write "Boat" on line 3 to use this feature. The optional "Push" on line 4 does nothing for boats. → Will soon be integrated in the official release.

Planter for carrots and potatoes

Our versions of the planter ICs [MCX216] and [MCZ216] can plant carrots and potatoes. → Will soon be integrated in the official release.

Trigger Reader range

The original Craftbook Extra allows x- and z-offsets of +-32 for the trigger reader ICs [MCX295] and [MCZ295]. MCO's version can handle +-999.
Note that the chunks with trigger and trigger reader sign must be loaded for this to work, so using a very long range may not give the desired result unless there is a player near each location.

Naturally, trigger readers can read the state of wooden buttons, too.

General improvements over Craftbook 2.0

These are changes in Craftbook Extra that alter functionality from Craftbook standard.

Input swapping

It is possible to swap the inputs and outputs for any 3 input ICs and/or 3 output ICs.

  • Not possible to swap single input or single output.

To swap inputs and outputs just type something like: [MCxxxx]abcdef.

  • "abc" stands for the input arrangement, and "def" for the output arrangement.
  • You can swap inputs by switching around the letters like "bca", or the outputs with "fde".


ICs

MCU300 bounce IC in action
MCU300 bounce IC in action
MCU300 bounce IC in action

Integrated Circuits, or ICs for short, are Craftbook signs that perform actions or alter redstone output based on input and settings, or some aspect of the world state.

MCX112 - Transporter

(admin placement only)
Also known as the teleporter. Transports players to matching destinations.

  • Third line is for destination IC name.
  • Fourth line is for optional message to show on-screen.

It is possible to have multiple teleporters to a single destination.

Transporter pad mode

There is also a "transporter pad" mode when typing [MCX112]p on the second line.

  • The 'p' must be lower case!

This transporter pad mode will teleport players from 2 blocks in front of the sign, and 2 blocks (or higher) up. This allows players to be able to use wood/stone plates to teleport by having redstone under it and linked to the MCX112 sign.

Transporter pad pressure plate reset

  • [MCX112]P will reset pressure plates connected to it - necessary to prevent the stuck pressure plate bug when used for long-distance teleporters.

MCU113 - Destination

(admin placement only)
This is the destination the players that are teleported by MCX112 will go to. Please note the U in MCU113.

  • The third line is the name of the destination that teleporters need to use to link together.
  • Destinations can be turned on and off with redstone wire.

It is possible to have multiple teleporters to a single destination.

MCX116 - Is player above?

Detects if a player is above the IC block at the first empty space a player can fit in. Specific players or groups can be detected instead if set on the IC sign.

  • Line 3:
    option:name is an optional name for a player or group to detect.
    The option value is either p for player or g for group.
    The name value is the name of the player or group to detect.
    If Line 3 is left blank, it will detect all players.

MCZ116 - Is player above? Automatic

Automatic version of MCX116 above.

MCX118 - Is player near?

  • Line 3:
    option:name is an optional name for a player or group to detect.
    The option value is either p for player or g for group.
    The name value is the name of the player or group to detect.
    If Line 3 is left blank, it will detect all players.
  • Line 4:
    range# is an optional block range to detect players around the IC. The range must be a number from 1 to 64. If left blank, the range will be set to 5.

MCZ118 - Is player near? Automatic

Automatic version of MCX118 above.

MCX119 - Is Mob Near?

This IC is a Single Input Single Output (SISO) IC sign. It works to detect mobs or a specific mob with a maximum range of 64.

  • Line 3: name is an optional name for the mob type to be detected. Values can be Mob, Animal, or a mob name that you would use on a spawner IC such as [MCX200]. If Line 3 is left blank, it will detect all mob types.
  • Line 4: range# is an optional block range to detect Mobs around the IC. The range must be a number from 1 to 64. If left blank, the range will be set to 5.

MCZ119 - Is Mob Near? Automatic

Automatic version of MCX119 above.

MCX120 - Command controlled IC

  • You can control MCX120 and MCZ120 with the command /mcx120 [band name] <on/off/state>
    • [band name] is the band/network name on MCX120 or MCZ120.
      • /mcx120 [band name] - will toggle the IC on or off
      • /mcx120 [band name] on - will set the IC on
      • /mcx120 [band name] off - will set the IC off
      • /mcx120 [band name] state - will display a message that the IC is on or off
  • Note: MCX120 needs to be manually updated with a clock signal. MCZ120 is the automatically updating version.
  • The command /mcx120list will list all currently loaded band/network names for this IC.
    • The band/network names will show up in green if "on", red if "off", and gray if the server is doing odd things with this IC. Should never be gray, but can be.

MCZ120 - Automatic command controlled IC

Automatic version of MCX120.

  • The command /mcz120list will list all currently loaded band/network names for this IC, as above.

MCX121

MCX121 Password Command is a Craftbook IC which allows a player to remotely control Redstone circuitry by typing a password-protected command into chat.

The MCX121 supports the following commands:

  • /mcx121pass add name password - to create and name a new password
  • /mcx121pass change name oldpassword newpassword - to change the password associated with a name
  • /mcx121pass has name - to see if the given password name already exists
  • /mcx121remove name - deletes the stored password for the given name (Admin only)
  • /mcx121list - lists all known mcx121 password names but does not reveal their passwords.
  • /mcx121 name password - to toggle the state of all ICs using the name name
  • /mcx121 name password off - to turn off all ICs using the name name
  • /mcx121 name password on - to turn on all ICs using the name name
  • /mcx121 name password state - to check the state of ICs using the name name

MCZ121

Automatic version of MCX121.

MCX130 - Mob Zapper

(admin placement only)
This kills mobs within a specified range (maximum of 64). Specific mobs can be killed if specified on the sign. It is a manual updated sign. Additionally, it is a Single Input Single Output (SISO) IC sign.

MCZ130 - Automatic Mob Zapper

(admin placement only)
A Zero input Single Output (ZISO) automatic sign, it is simply the same exact IC as the MCX130 manual sign only it automatically kills mobs.

MCX132 - Hit Mob Above

(admin placement only)
Damages detected mobs above the IC block at the first empty space a mob can fit in.

MCU132 - Hit Mob Above UISO


MCX200 - Mob Spawner

(admin placement only)
Same as MC1200, but adds support for coloured sheep, squids, and ghasts, as well as charged creepers.

  • To create a colored sheep, on the third line type Sheep:ID where "ID" is a colour id number (0-15).
  • To create a charged creeper, make the third line Creeper:1.

MCX201 - Item Spawner

(admin placement only)
Same as MC1201, but adds "damage" support which allows you to spawn colored dyes, wool, and the different logs.

  • To spawn items with color/damage type item:id where "item" is the item name or number, and "id" is the damage/color value (0-15).

MCX202 - Chest Spawner

Same as MC1202 (equivalent of MCX201 but item must be from a nearby chest).

  • Usage same as MCX201

MCX203 - Chest Collector

Collects items into a nearby chest, when input goes high.

  • Line 3: item-id:color is the specific item to collect. Leave blank if you want to collect all dropped items.
  • Line 4: radius is an optional range to collect dropped items. Radius must be a number from 1 to 8. Default is 8.

MCZ203 - Chest Collector (self-triggered)

Same as MCX203 but collects all the time, not only at clock input.

MCX205 - Block Detector

Detects a specific placed block at specific coordinates and outputs high if block is detected.

  • Line 3: item-id:color is the specific item to collect.
  • Line 4: direction:distance is the direction and optional distance to detect the placed block.
    The direction is either UP or DOWN.
    The distance is an optional distance to check the blocks up to. If no distance is added all blocks above or below will be checked (depending on the direction).

MCZ205 - Block Detector (self-triggered)

Same as MCX205 but collects all the time, not only at clock input.

MCX207 - Advanced bridge

An advanced version of the standard Bridge sign.

  • You are able to specify a width, length, and an up/down offset.
  • The maximum are:
    • width = 11
    • length = 30
    • up/down = between -10 and 10
  • MCX207 and MCX208 are versions that are not allowed to "force" or delete existing blocks.
    • They can still have the "force" option on them, but it will not actually force/delete.
  • To use:
    • <first line blank>
    • [MCX207]
    • blockID#:colour#
    • width:length
      • The colour# is optional, and you can just have the blockID# by itself instead.
      • The fourth line can also have the up/down offset: width:length:offset

MCX208 - Advanced door

An advanced version of the standard Door sign.

MCX209 - Advanced bridge (forcing)

(admin placement only)

  • As #MCX207 - Advanced bridge, but the third line can also have the "force" option added in front:
    • f:blockID#:color# where "f" is the force option.

MCX210 - Advanced door (forcing)

(admin placement only)

  • As #MCX208 - Advanced door, but the third line can also have the "force" option added in front:
    • f:blockID#:color# where "f" is the force option.

MCT233 - Weather Control

(admin placement only)

  • Takes in 3 inputs
  • When the front input is turned "on" it will set the weather based on the left and right inputs.
  • left input = weather on/off
  • right input = stormy weather (chance of lightning) on/off
  • This works similar to [MC3231] Time Control

MCX233 - Simple Weather Control

(admin placement only)

  • 3rd line = duration. Can be left blank. Duration is from 1 to 24000.
  • mode t = storym weather (chance of lightning) (i.e. [MCX233]t)

MCX230 & MCZ230 - Weather Check

(admin placement only)

  • output is "on" when it is raining/snowing
  • [MCZ230] is self-updating version.

MCX231 & MCZ231 - Stormy Weather Check

(admin placement only)

  • output is "on" when the storm mode is on
    • NOTE! The weather can be off and this can be on!
      • meaning even if it's not raining/snowing the storm mode can be on
      • storms will only happen when it's raining/snowing, but the mode can be on.
      • when the storm mode is on while it is NOT raining/snowing, nothing happens.
      • when storm mode is on while it IS raining/snowing then there are chances that lightning will strike in the world.
  • [MCZ231] is self-updating version.

MCX235 False Weather

(admin placement only)

  • Makes players see rain/snow even when it is not raining/snowing.
  • 3rd line = specific player or group. Can be left blank.
    • If left blank, all players will be effected.
      • specific player example:
        • line1:
        • line2: [MCX235]
        • line3: p:PlayerName
        • line4:
      • No spaces allowed in in names
      • specific group example:
        • line1:
        • line2: [MCX235]
        • line3: g:GroupName
        • line4:

MCX236 & MCZ236 - Distance False Weather

(admin placement only)

  • Makes players see false rain/snow when they enter the distance range, and removes the false rain/snow when they leave the distance range.
    • 3rd line = distance. Distance must be from 1 to 127
    • 4th line = message to players in distance range. Can be left blank.
    • When using the manual version [MCX236], turning this IC "off" will stop the fake rain/snow for all players that were affected.

MCX237 - Hide Weather

(admin placement only)

  • Hides the rain/snow from players.
    • Snow will still cover the ground and rain will still put out fires, but players will be unable to see the rain drops and snow flakes.
  • 3rd line = exactly the same as [MCX235] False Weather IC mentioned above

MCX238 & MCZ238 - Distance Hide Weather

(admin placement only)

  • Same as [MCX236] & [MCZ236] Distance False Weather IC, but hides the weather.
  • 3rd & 4th lines = same as [MCX236] & [MCZ236] Distance False Weather IC

MCX242 - Snowball shooter

(admin placement only)
Uses the same format as Craftbook's standard MC1240 arrow shooter.

  • Third line: Either speed or both speed and spread. Speed is a value between 0.2 and 2 and the default value is 0.6. Spread is a value between 0 and 50 and the default value is 12. Leave blank to use default.
    • Speed
    • Speed:Spread
  • Fourth line: Vertical velocity between -1 and 1, with 0 being the default. Leave blank to use default of 0.

MCX243 - Snowball barrage

(admin placement only)
Uses the same format as Craftbook's standard MC1241 arrow barrage. Parameters the same as above.

MCX244 - Egg shooter

(admin placement only)
Same format as MCX242 snowball shooter above.

MCX245 - Egg barrage

(admin placement only)
Same format as MCX243 snowball barrage above.

MCX255 - Lightning

(admin placement only)

Lightning generated by MCX255

Place the sign on the side of a block. When activated by redstone, it will cause lightning to strike the block it is placed on, and occasionally one block on either side. There is a chance of starting a fire on top of and around the affected block.

Lightning ICs can be placed indoors, in which case the lightning effect will pass through the roof in order to strike the specified block.

  • An optional Y-offset can be specified on the 3rd line.

MCX256 - Holy Smite

Charged creepers are one use of lightning and smite ICs.

(admin placement only)
Same functionality as MCX255 but with a radius effect.

  • 3rd line = y-offset. Can be left blank.
  • 4th line = radius. Can be left blank. Max radius is 5.
  • mode 1 = empty circle. Example:
    • line1:
    • line2: [MCX256]1
    • line3:
    • line4:
      • This will cause the lightning to only hit around the IC block leaving the centre unharmed.

MCU440 - Countdown monoflop

A type of count down timer which keeps the output off for a set amount of time, and then sets the output on for an optional set amount of time. If a time is not specified for how long to keep the on state, the output will remain on. The down count starts from the value specified and ends at 0.

There is a mode to set the output back off after one cycle of being on. And there is another mode to swap the output so that the output would start on and then turn off when the time has been reached.

When activated, the count down timer can not be stopped, and can not be reset. The count down needs to either finish or the IC needs to be destroyed.

  • Line 3:
    down_count:clock_rate:on_count is the time and rate to keep the output off and on.
    down_count is the value to start the timer from. The timer will start at this value and end at 0. The down_count must be a value from 1 to 99999.
    clock_rate is the amount of ticks until 1 timer cycle is complete. (ex: every 5 ticks the down count will decrease by 1). The clock_rate must be a value from 5 to 15. If no clock_rate is specified, the clock_rate will be set to 5.
    on_count is the duration to keep the output on after reaching 0 and finishing. If the on_count is not specified, the output will remain on. (Note: for some modes, this will be the duration to remain off instead)

MCX515 - Logs message

(admin placement only)
A IC that logs a message to the server. It is a Single Input Single Output (SISO) sign.

  • Example:
    • line1:
    • line2: [MCX515]
    • line3: (insert message here)
    • line4: (insert message here continued)
      • This will log a message to the server

MCX516 - Log Message & Log Nearby Players

(admin placement only)
Logs a message to the server. It can also report the nearest player and message them with the same log message. It is a Single Input Single Output (SISO)sign.

  • Example: 1
    • line1: range
    • line2: [MCX516]
    • line3: message
    • line4: message continued
    • This will log messages to the server
  • Example: 2
    • line1: range
    • line2: [MCX516]
    • line3:player %p is th
    • line4:e nearest
    • This will log messages as well nearby players
  • Example: 3
    • line1: range
    • line2: [MCX516]+
    • line3: player %p is th
    • line4: e nearest
    • This will log messages as well nearby players and messages with the same log to the player

MCX517 - Message & Log Nearby Players

(admin placement only)

Logs messages as well as players nearby. Unlike MCX 516, it also logs the distance of the player between the player and the IC itself. It is a Single Input Single Output (SISO) sign. Tags that can be used with this sign include " %a " " %p " and /n but only for line 3.

  • Example: 1
    • line1: range
    • line2: [MCX517]
    • line3: Message
    • line4: Message continued
    • Range works only 1-64 blocks
    • Basic server message
  • Example: 2
    • line1: 5
    • line2: [MCX517]
    • line3: player %p is th
    • line4:e nearest
    • Will log a custom message and report the specific player within 5 blocks
  • Example: 3
    • line1: 30
    • line2: [MCX517]+
    • line3: player %p is th
    • line4:e nearest
    • Will log a custom message to the server and report the specific player within 30 blocks. it will also send a copy of the server message


  • Example: 4
    • line1: 30
    • line2: [MCX517]
    • line3: the players %a
    • line4: are in range
    • Basic sign set up which logs a message to the server and reports all players within 30 blocks
  • Example: 5
    • line1: 30
    • line2: [MCX517]+
    • line3: the players %a
    • line4: are in range
    • Basic sign set up which logs a message to the server and reports all players within 30 blocks and sends them a copy of the message

MCU700 - Music

Demonstration for the layout of an MCU700 music IC

Midi ICs that play music. The MCU700 IC must be placed on the side of any block, with a note block placed behind it (in the same way as a switch would be placed at the back of a block with a toggling IC on it).

Midi

Midi files have to be uploaded to the server, so can be created by admins only. If there's sufficient demand, a midi upload function may be added on the website in future.

line1:
line2: [MCU700]
line3: songname.m
line4:

It's possible to adjust the beat/tick speed:

line1:
line2: [MCU700]
line3: filename.m:#
line4:

Where # is the beat/tick speed. Default is 4. A value such as 6 will make the midi play faster, and a value such as 2 will make it play slower. A value of 0 or less will set it back to 4, and the max value is currently 10.

Note: the first track in any midi file is currently skipped.

troubleshooting
* A .mid file (e.g. example.mid) will be referenced as .m (e.g. example.m) on the sign
* check the switch placement if it doesn't play - make it look exactly like the diagram
* you may need to have it run slightly faster than 4 to sound normal - 5 or 6
* unlike normal minecraft note blocks you don't need a space above the note block
* unlike normal minecraft note blocks the material under the note block isn't important

Text music

The MCU700 IC can also play player-written text format music in one of two formats:

Format 1
default
song title
author
2
harp
f#|3---|-4-3|----|
g.|----|-333|5
g#|--4-|----|----|
a.|----|3333|----|
a#|----|5-5-|----|
b.|3---|----|----|
c.|-4-4|----|----|
c#|----|----|-3--|
d.|----|----|-4--|
d#|----|----|---4|
e.|--3-|----|----|
f.|-3--|
f#|---4|----|----|

bdrum
b.|-3--|-3--|-3--|
f#|---4|4---|
a#|4---|----|---4|
f.|---4|---3|---5|
d#|4---|----|----|

harp
e.|3-----|||-4-4|-------|
d#--|-333|--5
  • line1: The format type. In this case "default".
  • line2: Title (not yet used)
  • line3: Author (not yet used)
  • line4: The default "ticks per beat speed" to use if no speed was specified on [MCU700]. So a value of 2 would be 2 ticks until a note is played.
  • line5: The instrument to use. Instruments available:
NAME INSTRUMENT
harp harp
bdrum bass drum
snare snare
hat hat
batk bass attack

Just like the harps in the example, you can have more than one of the same instrument. You need a single empty line between new instruments (after the first) as shown in the example.

  • After the instrument (line6+) is the list of notes and octave #.
  • Notes with # after it are "sharp" and a . after it are regular
  • Notes can be arranged in any order
  • Notes with no beats can be left out.
  • | (vertical line) characters are ignored and so it can be used to help line up beats. In the last "harp" example you can see that | characters can be placed anywhere.
  • - (dash) or spaces count as an empty beat/note.
  • a number specifies what octave to play for the note. You can use a value from 0 to 9, but the numbers will be set to the lowest or highest allowed.
    • Minecraft only has 2 full octaves. The wiki says it starts from F#3 to F#5, but others suggest it starts from F#2 to F#4. This format starts with F#3. Midi and the 2nd text file format start with F#2.
  • There is a max number of lines and beats for text files, but they can be changed in the "craftbook.properties"
Format 2
default2
song title
author
2
harp
# Some kind of comment
#|----------|----------|----------|----------|----------|----------|----------|----------|----------|----------|
4|----------|----------|----------|----------|----------|--------Cc|------Aaf-|fF--Aaf-dD|--FfC--CE-|GF--------|
3|----------|--------cf|-ffA-AAGf-|fDF-fCf-Dc|e-gf------|-f-ffA----|a-fF------|----------|------A---|--fff-----|
2|-AAAAAAAAA|AAfffAfAA-|----------|----------|----fffAfA|A---------|
2|---G---G--|

snare
3|---|A--a|
#|----|----|----|-just a comment line-|--==-|
2|d-dd|-CD-|

Format 2 acts the same as Format 1, but the octaves are on the left instead. To specify Format 2, put default2 on the first line.

Format 2 also includes the ability to add in comments, which can also be used to help with note placements.

  • Comments start with the # character.

Just like format 1:

  • you can use more than one of the same instrument.
  • octaves that aren't used can be left out.
  • octaves can be arranged in any order.
  • you can have more than one of the same octave for an instrument.
  • | (vertical line) characters are ignored.
  • - (dashes) and spaces are counted as empty beats/notes.
  • Uppercase letters are sharps (#) and lowercase are regular notes.

MCU702 - Music (sign)

Music IC that reads music from a sign rather than from a file. Not yet implemented.


MC1510 - Remote messaging

(admin placement only)

Previously had a bug with permissions, now fixed.

Books

Page reader

Page readers are created by placing a sign on a bookshelf block with:

  • Line 1: namespace
  • Line 2: [Book]
  • Line 3: book
  • Line 4: pages

By default, players have access to their own namespace and the global namespace.

  • To access the global namespace, type "@" without the quotes on the first line.
  • The "book" on the third line is the .txt file name without ".txt" at the end.
  • Pages on the fourth line can be left blank. The Page Reader will only read from page 1 if left blank. To read more pages, put on the fourth line: start#:end# where "start#" and "end# "are page numbers separated by ":".
  • Book titles are stored in the first line of the book .txt file.

When reading through a range of pages (such as pages 3 to 14), you can *reset* back to the start page by left-clicking the bookshelf.

Commands

  • /cbpage - book writing interface.
    • If writing pages using the in-game commands, any pages after the max pages allowed will be deleted!
      • By default, the max page is 20, so page 21 and up will be deleted if using the in-game commands.
      • Pages from in-game writing also have a max character limit of 400 characters by default.
  • <br> is used to split a page to a new line.

Example:

The brown<br>fox.

Will show as:

The brown
fox.

Miscellaneous features

Maps

Map signs are created by placing a sign on a bookshelf with the text:

  • Line 1: map number
  • Line 2: [Map]

Right-clicking on the bookshelf (not the sign itself!) with a map item currently selected will then change the number of the player's map to the one denoted on the sign.

See also

External links


Personal tools