Common Issues

Vault plugins don't see Obfeco

  • Check Vault or VaultUnlocked is installed and enabled (/plugins).
  • Check vault.enabled: true in config.yml, then restart. The hook is only set up at startup.
  • Check vault.primary-currency matches a file in currencies/ (without .yml).
  • Run /vault-info. If another economy plugin is listed, remove it; running two economies at once leads to confusing balances.

Placeholders show as plain text

  • Check PlaceholderAPI is installed and placeholder.enabled: true in config.yml, then restart.
  • Use the currency id, not its display name: %obfeco_gems_balance%, not %obfeco_Gems_balance% if the file is gems.yml.
  • Test with /papi parse me %obfeco_<currency>_balance%. An unknown currency or format returns the placeholder unchanged.

See PlaceholderAPI for every format.

"You do not have permission to use this command"

Each subcommand has its own node, and the player ones default to op. See Commands & Permissions. A common catch: obfeco.admin doesn't include the player commands, so an admin who should use balance, pay or top needs those nodes too.

"You cannot delete the primary currency"

Change vault.primary-currency to another currency, /obfeco reload, then delete it.

The category menu doesn't appear

Both conditions must be true: gui.currency-manager.use-categories: true in config.yml and at least one category in categories.yml. Then /obfeco reload. See Categories.

A currency shows under "Uncategorized"

Its category id doesn't match one in categories.yml. Folder names count: a file in currencies/event/ belongs to category event, not events. Fix the id or move the file and reload.

Colors in a display name show as raw tags or & codes

Obfeco uses MiniMessage. Write <gold>Coins, not &6Coins. In other plugins, the _name placeholder returns the raw MiniMessage text, so use a plugin that understands MiniMessage or set a plain display name.

The sign prompt doesn't open or does nothing

The Currency Manager uses a temporary sign placed two blocks above you. Make sure you're not at build height and that a protection plugin isn't cancelling the sign edit. Closing the "Create New Currency" sign without typing a name cancels the creation.

Migration says "CoinsEngine plugin not found!"

The plugins/CoinsEngine/ folder must exist on this server. See Migration Guide.

For anything else, see Troubleshooting.