Skip to content

Migration Guide

Jump to bottom
NadirKhoulali edited this page Jul 23, 2026 · 5 revisions

Migration Guide

UBS can import account data from common server economy/banking plugins.

Supported Sources

  • Generic CSV export
  • EssentialsX userdata (.yml/.yaml)
  • CMI userdata (.yml/.yaml)
  • iConomy text/CSV exports

Commands

  • /ubs admin import csv <path>
  • /ubs admin import essentialsx <path>
  • /ubs admin import cmi <path>
  • /ubs admin import iconomy <path>

Alias: /bank admin import ...

CSV Format

Header is optional. Columns:

player_uuid_or_name,bank_name,account_type,balance,pin,is_primary,history

Notes:

  • player_uuid_or_name: UUID or player name.
  • account_type: enum name or display label.
  • pin: blank or 4 digits.
  • is_primary: optional (true/false/yes/no/1/0).
  • history: optional: timestamp|signedAmount|description;timestamp|signedAmount|description
  • Timestamp format: YYYY-MM-DDTHH:mm:ss.
  • Signed amount: + incoming, - outgoing.

EssentialsX / CMI

Use a userdata folder path or a single YAML file path. Importer reads values like money / balance and maps them to UBS accounts.

iConomy

Importer accepts lines in either format:

  • player,balance
  • player:balance

Player can be UUID or name.

Import Feedback

Each import command provides:

  • created account count
  • updated account count
  • imported history entry count
  • failed row/file count
  • first errors in chat

Detailed warnings are also logged in server logs.

Limitations

  • Histories are imported when source data provides a compatible field/value.
  • Some plugins do not store transaction history in the main balance files.
  • Unsupported fields are ignored instead of failing the whole import run.

Clone this wiki locally