Edit block

Quick Navigation

  1. Materials
  2. Add a new block
  3. Edit a block
  4. Remove a block
  5. Block syntax
  6. Blocks.yml example
  7. Custom blocks

⚠️ If you have OreAnnouncerGUI you can directly use it to add blocks ⚠️

Materials

In OreAnnouncer you can configure any block you want, just be sure it is inside this list:

List Latest Minecraft Materials

Add a new block

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

  NETHERITE_BLOCK:
    enabled: true
    display-name: "Netherite Block"
    display-color: "red"
    alerts:
      user: true
      admin: true
    name:
      singular: netherite
      plural: netherites
    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.

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
  NETHERITE_BLOCK:
    enabled: true
    display-name: "Netherite Block"
    display-color: "red"
    alerts:
      user: true
      admin: true
    name:
      singular: netherite
      plural: netherites
    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)

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':)