Tubriks & Bills

TUBRIKS & BILLS

IMPORTANT: Items in this mod do not have survival crafting recipes. They are designed to be distributed via administration, commands, or quests. For a fully functioning economy, it is recommended to use the built-in functionality alongside third-party plugins or mods.

Tubriks & Bills is a specialized economic framework designed for Roleplay (RP) and Political servers. Unlike standard currency mods, there are no crafting recipes. All financial instruments are intended to be integrated into gameplay through server administration and events. This mod transforms the economy from a simple resource exchange into a full-fledged banking system with investments, inflation, and securities.

1. Currency System

The mod adds a physical currency called "Tubriks".
5 Denominations: 1, 5, 10, 50, and 100 Tubriks.
Exchange: While there are no "vanilla" recipes, you can exchange denominations (e.g., placing five 1-Tubrik coins in a crafting grid to get one 5-Tubrik coin).

2. Securities (Bonds)

Types: Construction, Trading, Military, and Treasury Bonds.
Logic: Each bond has a dynamic market price.
Indication: Current prices are shown in the item tooltip. If the price is set to 0, trading for that asset is blocked. Prices can only be changed by an administrator via commands.

3. Trade Terminal (GUI)

A professional interface for interacting with the Banker.
Functions: Buy/Sell bonds and view market rates.
Interactive UI: The active selection button is highlighted with a green frame, clearly showing which asset is selected.
Statistics: Displays daily turnover (In/Out). In shows the amount received by the banker in the last 24h, while Out shows the amount paid out to players.

4. Personal Deposits

A unique asset with automatic value growth.
Growth: Value depends on the "age" of the item (days spent in-game).
Warning: Excessive use of deposits can lead to hyperinflation. Distribution of these items should be strictly controlled by administration.

5. Administration & Language

Control: All economic manipulations are performed via console or command blocks.
Languages: Full support for English and Russian (switches automatically based on the client settings).

FULL COMMAND LIST

For Operators (OP):
/economy set construction [value] — Set Construction Bond price.
/economy set trading [value] — Set Trading Bill price.
/economy set military [value] — Set Military Bond price.
/economy set treasury [value] — Set Treasury Note price.
/economy adminstats — Show total In/Out turnover since world start.
/economy commission — Show total Tubriks "consumed" by the buy/sell spread.
/economy commission reset — Reset the commission counter.
/killtraders — instantly removes all Tubrik Traders across all dimensions.

For All Players:
/economy list — List all current bond prices.
/economy stats — View daily bank turnover (In/Out)

ADVANCED UNDERSTANDING

1. Personal Deposit Mechanics

The value grows automatically according to the following formula: **Price = StartPrice * (1 + K)^t
StartPrice: Initial value (configurable).
t: Time owned (in real days).
**K (Growth Coefficient):**1st week: +50% / week
2nd week: +20% / weekAfter
1 month: Stable +2% / week

2. The Banker (Trader)

Admins can spawn the Banker using a Spawn Egg.
! ATTENTION ! The Banker is invulnerable, immobile, and does not spawn naturally.
Buy/Sell: Access the menu via Right-Click.
Spread: The Banker buys assets 1 Tubrik cheaper than the market price. This spread prevents instant market speculation.
Blocking: If a price is set to 0, the GUI button is disabled, and the tooltip displays "Not currently traded".

3. Technical Configuration (Config)

Config file location: [server_folder]/config/tubricks_and_bills-server.toml

dailyOutLimit (Default: 1000): Maximum Tubriks the banker can pay out per cycle. Prevents economic collapse.
traderMessageChance (Default: 0.4): 40% chance for the banker to send a chat message during a deal.
depositInitialPrice (Default: 100.0): Base price for Deposit growth calculations.
tickRateEconomy (Default: 1,728,000): Duration of one cycle (24 hours). Resets daily limits and In/Out stats.