Skip to content

Migrating from v0.x to 1.x

banco 1.0 introduces some new features that are incompatible with previous versions. Migrating your settings file will make it possible to take advantage of those features.

Note

Legacy setups will continue to be supported until version 1.4

Legacy colors

Legacy colors (&a, &2...) are no longer supported. From now on you can use the modern MiniMessage format.

For example:

Colors (0.x)
# ...
lore:
- §7This is a simple setup example!
- §7You can use §bcolours §7to format text
- ' '
- §dCustom model data §7is also supported!

Colors (1.x)
# ...
lore:
- <gray>This is a simple setup example!</gray>
- <gray>You can use <aqua>colours</aqua> to format text</gray>
- ' '
- <gray><purple>Custom model data</purple> is also supported!</gray>

Item registry

Items are now registered by using the itemRegistry section in your settings.yml file. You'll need to delete your current items section:

Items (0.x)
  items:
  - name: GOLD_INGOT
    displayName: §6Example
    lore:
    - §7Example item
    customModelData: 1
    glowEffect: false
    value: '1'
Items (1.x)
  itemRegistry:
  - type: vanilla
    material: GOLD_INGOT
    value: '1'
    customization:
      displayName: §6Example
      lore:
      - §7Example item
      customModelData: 1
      glowEffect: false

We recommend having a look at Adding items, which is an in depth tutorial on the new item registry feature.

Common pitfalls

The itemRegistry section is ignored

If you have a legacy items section, the item registry will be disabled. Once items are migrated you should completely remove the section from your settings file.