Discord

Add/edit block

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.

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
A good editor is strongly recommended! Like Notepad++
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.

OptionValuesDescription
enabledtrue/falseEnable/disable the block
display-nametextDisplay name of the block
display-colortextDisplay color of the block
alerts.user
alert.admin
true/falseAlert users
Alert admins
name.singular
name.plural
textSingular name of the block
Plural name of the block
count.number
count.time
numberNumber of blocks to destroy in X time
X time in seconds
messages.user
messages.admin
messages.console
textOverride user message
Override admin message
Override console message
messages.user-count
messages.admin-count
messages.console-count
textOverride count user message
Override count admin message
Override count count message
soundtextSound name of the alert
light-level0-15Trigger alert if light level is below of X
count-on-destroytrue/falseCount this block for statistics system
tnttrue/falseHandle destroy with TNT
prioritynumberPriority 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':)