Encoding items

Starting with version 1.1.0, banco supports Base64-encoded items. This allows server owners to configure items more efficiently by converting them into a string format while enabling compatibility with third party plugins which may not be supported natively yet.

Notice about Base64 encoding

While Base64 encoding is supported, the preferred and recommended method for configuring items is still using the native configuration options whenever possible. Native options are easier to read, maintain, and update over time. Base64 encoding should be used primarily as a fallback for items that cannot be represented in the standard format.

Getting a Base64-encoded string

You can easily encode an item by using command /banco encode while holding the item you want to configure in your main hand. Click the resulting message to copy the generated string.

Example

Updating settings

Once you have a Base64 string, you can proceed to configure the item by updating your settings.yml file:

settings.yml

  itemRegistry:
  - type: base64
    string: rO0ABXNyABpvcmcuYnVr...
    value: '1'

Explanation

type must be set to base64
string is the Base64-encoded string
value is the item's economical value