README.md

BelovedBlocks

Development builds available for each commit on our Jenkins server.

This plugin is available on BukkitDev.
Please note, this README reflects the last development version. Some features listed here may not be in the version published on BukkitDev.

This plugin was made by Amaury Carrade and Florian Cassayre; it is currently translated in English, French and German.

1. Features
   1. New items
   2. Stonecutter
   3. Saw
2. Commands & permissions
   1. Commands
   2. Permissions
3. Installation & configuration
4. License

Features

The 1.8 version of minecraft has removed the items that corresponds to some unobtainable blocks in survival. Although their corresponding items doesn't exist anymore, the blocks still exist. You can place them by doing a /setblock command with some metadata arguments.

This plugin instances new items that transforms themselves into the desired special block when placed by a player.

Some of the seamless blocks featured by the plugin

Items

Each seamless block is represented by a similar item with a glowing enchantment effect (that can be disabled for each block in the configuration). They also have a custom name (also configurable). The crafts are the same for the four blocks:

The smooth log blocks can also be crafted using the same process, except with wooden logs:

You are also able to craft nether portals...

...and End ones. (The amounts given for each crafting recipe can be changed in the configuration.)

Those crafts can be disabled, or given by permission.

All those items can be salvaged to get the materials back (except portals) ; simply place an item in a crafting grid.

Stonecutter

The stonecutter is a tool that can smooth any of the three double slabs blocks. To use it, simply right click with this tool on the wished block and it will permute to a smooth block. Each use will decrease the item's durability by 1. The unbreaking enchantment does work when applied. The stonecutter can be crafted like shears in exceptions that the iron is replaced by diamonds:

The craft can be disabled.

The basic double slabs block → the seamless version of this block:

The process can be reverted (use the tool on a smooth block to turn it back into the original block).

Saw

The saw is a tool that can move the bark around any of the six log blocks. To use it, simply right click with this tool on the wished log block to move the bark. The bark can have 4 different positions (tree of them follows, the tree axes and one has bark all around the texture). Each use will decrease the item's durability by 1. The unbreaking enchantment does work when applied. The saw can be crafted like this (the symmetric craft also works):

The craft can be disabled.

Note: when breaking blocks with the saw, it has a small chance to break. This percentage can be modified in the configuration.

LogBlock and Prism are supported: block changes with these tools are saved.

Commands & permissions

Commands

A few commands allow you to get the tools and blocks added by this plugin.

The main command is /belovedblocks, or /bb (an alias).

• /bb give tool <stonecutter|saw> [receiver]: gives the needed tool to you, or to the receiver.
• /bb give block <name> [amount] [receiver]: gives the blocks of BelovedBlocks to you (or to the receiver), where name is one of the following:
  • stone, sandstone, red-sandstone, quartz;
  • oak, spruce, birch, jungle, acacia, dark-oak;
  • portal-nether, end-portal.

Tip: use autocompletion.

Permissions

The permissions follows this logic: belovedblocks.<give/use/craft>.<blocks/tools>.<item>[.<self/other>]

As example:

• to allow someone to give to himself only some smooth red sandstone, use the permission belovedblocks.give.blocks.red-sandstone.self;
• to allow someone to give any block to anyone, use belovedblocks.give.blocks;
• to allow someone to use (place) double-stone-slabs, use belovedblocks.use.blocks.stone;
• to allow someone to craft end portals,use belovedblocks.craft.blocks.end-portal.

Installation & configuration

To install this plugin, simply put the .jar file inside the plugins folder of your server.

If you want to use it with Prism, you'll have to add this plugin in the list of plugins allowed to access Prism's API.
To do so, open the Prism's configuration file, located at plugins/Prism/config.yml, and in the prism.tracking.api.allowed-plugins section, add BelovedBlocks:

prism:
  # A lot of things
  tracking:
    # ...
    api:
      enabled: true
      allowed-plugins:
      - # Some other plugins, maybe
      - BelovedBlocks

The plugin can be configured using the config.yml file (it can be found at /plugins/BelovedBlocks/config.yml in your server's folder or here on GitHub).

License

GPLv3. See LICENSE file for more details.