Edit block

{info} If you have OreAnnouncerGUI you can directly use it to add blocks with the in game menu

Materials

In OreAnnouncer you can configure any block you want, just be sure that is a valid material name.

{info} List of latest Minecraft materials

Add a new block

To add a new block you just have to add this configuration into your blocks.yml file.

  ANCIENT_DEBRIS:
    enabled: true
    display-name: "Ancient Debris"
    display-color: "red"
    alerts:
      user: true
      admin: true
    name:
      singular: "ancient debris"
      plural: "ancient debris"
    sound: ENTITY_PLAYER_LEVELUP
    light-level: 15
    count-on-destroy: true
    priority: 120

{info} A good editor is strongly recommended! Like Notepad++

{warning} Be careful to TABS and SPACES, just be sure that what you are inserted is like the others

Edit a block

If you wanna edit a block just start to edit it! If you remove an option, it will automatically take the default value.

If you set a message to '', you will hide it.

Remove a block

You can remove a block by deleting the configuration block.

Block syntax

The block must start with a valid MATERIAL_NAME, check this page for existing materials.

Option Values Description
enabled true/false Enable/disable the block
display-name text Display name of the block
display-color text Display color of the block
alerts.user
alert.admin
true/false Alert users
Alert admins
name.singular
name.plural
text Singular name of the block
Plural name of the block
count.number
count.time
number Number of blocks to destroy in X time
X time in seconds
messages.user
messages.admin
messages.console
text Override user message
Override admin message
Override console message
messages.user-count
messages.admin-count
messages.console-count
text Override count user message
Override count admin message
Override count count message
sound text Sound name of the alert
light-level 0-15 Trigger alert if light level is below of X
count-on-destroy true/false Count this block for statistics system
tnt true/false Handle destroy with TNT
priority number Priority number (-1 to disable) default 0

Blocks.yml example

blocks:
  DIAMOND_ORE:
    enabled: true
    display-name: "Diamond Ore"
    display-color: "aqua"
    alerts:
      user: true
      admin: true
    name:
      singular: diamond
      plural: diamonds
    count:
      number: 20
      time: 600
    sound: ENTITY_PLAYER_LEVELUP
    light-level: 15
    count-on-destroy: true
    priority: 90
  ANCIENT_DEBRIS:
    enabled: true
    display-name: "Ancient Debris"
    display-color: "red"
    alerts:
      user: true
      admin: true
    name:
      singular: "ancient debris"
      plural: "ancient debris"
    sound: ENTITY_PLAYER_LEVELUP
    light-level: 15
    count-on-destroy: true
    priority: 120

Custom blocks

You can add custom blocks handled by plugins ItemMods and MMOItems, the syntax of the block change from MATERIAL_NAME into ITEMMODS_<NAME> and MMOITEMS_<ID>.

An example of these two blocks:

blocks:
  ITEMMODS_CUSTOMITEM:
    enabled: true
    display-name: "ItemMods custom item"
    display-color: "aqua"
    # ...
  MMOITEMS_1:
    enabled: true
    display-name: "MMOItems item #1"
    display-color: "aqua"
    # ...

How to retrieve ItemMods name:

  1. Open GUI with /im
  2. Select menu Items
  3. The custom item name is what you are looking for (e.g. customitem #1)

To correctly setup ItemMods, follow the official guide here.

How to retrieve MMOItems id:

  1. Open file custom-blocks.yml in MMOItems folder
  2. Get the number of the specific block (e.g. '1': or '2':)
© AlessioDP 2015-2021