UBS-API-Bridge

UBS API Bridge is a server-side integration library that provides a simplified bridge to the public API of Ultimate Banking System.

It allows compatible mods and server-side integrations to query banking information and perform UBS transactions without directly implementing the complete UBS API workflow.

Features

• Checks whether the Ultimate Banking System API is available
• Reads the installed UBS API version
• Checks whether a player has a primary bank account
• Retrieves primary account IDs and balances
• Deposits money into a player's primary account
• Withdraws money from a player's primary account
• Checks whether an account can send or receive a specified amount
• Formats monetary values consistently
• Records detailed transaction traces for troubleshooting
• Provides read-only diagnostic probes
• Includes an optional $0.01 deposit-and-withdraw diagnostic

Requirements

• Minecraft 1.21.1
• NeoForge 21.1.220 or newer
• Ultimate Banking System 2.1.0

Installation

1. Install Ultimate Banking System 2.1.0.

2. Place UBS API Bridge in the server's mods folder.

3. Install or create a compatible mod or server-side integration that calls the bridge.

4. Restart the server.

Important

UBS API Bridge is an integration library and does not add commands, menus, blocks, items, shops, quests, or other standalone gameplay features.

Installing it by itself will not visibly change the game. Another mod or server-side integration must call its bridge functions.

It does not automatically connect Ultimate Banking System to every shop, auction, quest, bounty, or economy mod.

Diagnostics

Detailed diagnostic information is written to:

logs/ubs-api-bridge-debug.log

The optional live round-trip diagnostic deposits $0.01 and then withdraws $0.01. The final balance change is $0.00, but both operations may remain visible in the player's UBS transaction history.

Compatibility

Version 1.2.0 was created for Ultimate Banking System 2.1.0. UBS versions outside the 2.1.x range are not supported.

This is an unofficial integration library. Ultimate Banking System is required and is not included.

中文說明

UBS API Bridge 是用於 Ultimate Banking System 2.1.0 的伺服器端 API 橋接模組。

它能讓其他模組或伺服器整合程式查詢玩家的主要銀行帳戶與餘額，並透過 UBS 執行存款、提款及交易診斷。

本模組不會自行新增指令、介面、方塊、物品、商店或任務。單獨安裝不會讓遊戲出現可見變化，必須由其他相容模組或伺服器程式呼叫。