Tubriks & Bills

TUBRIKS & BILLS

Tubriks & Bills is a server-oriented physical economy, world-progression, and PvP gear framework for Minecraft Forge 1.16.5.

Instead of virtual database balances, all currency exists as physical items. The mod provides a self-contained closed economic loop out of the box: controlled currency emission via resource buybacks, admin-managed securities, server-wide crowdfunding to expand the World Border and unlock the Nether, and 9 custom armor sets.

Technical & Server Compatibility

• Required on both Server and Client.
• Automatic Config Sync: Players do not need manual config files; tubricks_and_bills-common.toml values sync automatically to the client on login and on /economy reload.
• Hybrid Core Ready (Mohist / Arclight 1.16.5): Respects WorldGuard / Towny / GriefPrevention block break cancellations, pvp: deny regions, and avoids false triggers on anti-cheats (Grim, Vulcan, Matrix).

---

Closed-Loop Economy Architecture

1. Emission (Resource Buyer): Players sell undamaged mined/farmed items for Tubriks under configurable per-player and global server daily limits.
2. Investment & Liquidity (The Banker): Players buy and sell 4 types of Securities with admin-controlled prices, a 1 TB sell spread, and a configurable daily cash payout cap (dailyOutLimit).
3. Currency Burn & Progression (World Regulator): Players pool Tubriks into two global server banks to expand the World Border and unlock Nether access.
4. Endgame Gear & Repair Sink (Black Market & Repairer): Securities are traded for 9 custom Tier 1 & Tier 2 armor sets. Custom armor never vanishes on breakage or death — it enters a Broken state and requires Tubriks to repair.

Core Mechanics

1. Physical Currency

• 5 Denominations: 1, 5, 10, 50, and 100 Tubriks (stack size: 64, fire and lava immune).
• Crafting: No raw resource recipes. Up/down denomination conversion recipes work in the 2x2 inventory grid and 3x3 crafting table (1x5 <-> 5x1, 2x5 <-> 1x10, 1x50 <-> 5x10, 2x50 <-> 1x100, 5x1 -> 1x5, 5x10 -> 1x50).

2. Securities (Bonds) & Personal Deposits

• 4 Tradable Bonds: construction (Construction Bond), trading (Trading Bill), military (Military Bond), and treasury (Treasury Note). Fire and lava immune, stack size 64.
• Pricing & Spread: Admins set integer prices via /economy set <type> <price>.
  • Price 0 = trading disabled.
  • Price 1 = buy-only (1 - 1 = 0 sell payout).
  • Selling a bond with price P > 1 pays P - 1 Tubriks; the 1 TB spread is logged in CommissionPot.
• Personal Deposit (tubricks_and_bills:personal_deposit): Non-stackable, fireproof savings item that stamps Overworld creationTime NBT on pickup and appreciates over server uptime (S = depositInitialPrice, default 100.0):
  • Days 0–7: +7.14%/day (up to +50% at Day 7)
  • Days 7–14: +3.57%/day (up to +75% at Day 14)
  • Days 14–21: +2.14%/day (up to +90% at Day 21)
  • After Day 21: +0.28%/day (~+1.96%/week)

3. The 5 Server NPCs

All 5 NPCs have NoAI and 100% immunity to all types of damage and knockback.

• The Banker (banker): Bond exchange terminal. Global prices and In/Out volume stats are stored in world/data/tubricks_and_bills_worldvars.dat and synced across all dimensions.
• Resource Buyer (market): 54-slot shop (LMB = sell 1, RMB = sell up to 64). Accepts only undamaged items (!isDamaged()) and ignores NBT/enchantments.
• Black Market Dealer (seller): 54-slot shop selling configured items (default: all 36 custom armor pieces for 10 Treasury Notes each, limit 1 per player / 2 per server).
• World Regulator (expander): Server-wide crowdfunding hub with two independent pools:
  • World Border: Starts at 500x500 (expanderStartSize), expands by +400 blocks per level (expanderSizeStep), with base cost 1,500 TB (expanderOwBaseCost) and 1.11x geometric scaling (expanderOwCoeff). Fully customizable in config.
  • Nether Lock: Blocks portal ignition, strips minecraft:nether_portal blocks on chunk load, and cancels non-OP dimension travel until the server pools 25,000 TB (default, customizable in config).
• Equipment Repairer (repairer): Restores damaged or broken mod armor for Tubriks (supports both full and partial durability repairs). A full repair costs strictly 240 TB for Tier 1 and 960 TB for Tier 2 — these fixed prices act as baseline anchors for balancing your server economy.

---

Custom Armor System (9 Sets / 36 Items)

Global Armor Rules

• Base Protection: 3 / 8 / 6 / 3 (20 total armor points, diamond equivalent) across all sets.
• Non-Destructible ("Broken" State): At maxDamage - 1 (1 durability left), pieces switch to Broken (0 armor, 0 toughness, 0 KB resistance, set bonus disabled) instead of vanishing.
• Death Retention: On player death (with or without keepInventory), equipped and carried mod armor never drops on the ground; it returns to the player's inventory upon respawn in the Broken state.
• No Anvils / No Mending: AnvilUpdateEvent is cancelled for mod armor, enchantability is 0, and Mending is blocked on the item level.
• 10s Attunement & Swap Penalty: Full-set bonuses activate 10 seconds (200 ticks) after equipping all 4 intact pieces of the same set. Removing or swapping any piece applies 3 seconds of Weakness I and Slowness I.
• Fixed Repair Costs:
  • Tier 1 Full Set: 240 TB (48 Helmet / 72 Chestplate / 72 Leggings / 48 Boots).
  • Tier 2 Full Set: 960 TB (200 Helmet / 280 Chestplate / 280 Leggings / 200 Boots).

Set Stats & Mechanics

Tier	Set Name	Toughness / KB Res	Full-Set Mechanics
T1	Phantom Walk	2.5 / 25%	Permanent Speed I. Taking any projectile hit grants Speed II for 4s (12s cooldown).
T1	Basalt Warden	2.5 / 75%	+15% melee axe damage. Reduces shield disable cooldown from enemy axe hits from 5s to 3s.
T1	Deepslate Excavator	2.0 / 0%	+25% pickaxe mining speed, Night Vision while sneaking, 10% chance for bonus ore drops without Silk Touch.
T1	Abyssal Voyager	2.0 / 0%	Permanent Water Breathing, +60% swim speed, no underwater/floating mining penalty, +2 Luck, ~20% faster fishing lure. (PvP hit disables swim boost for 15s + 3s Slowness I).
T1	Hellfire Wanderer	2.0 / 0%	Permanent Fire Resistance, Speed I in the Nether, +20% damage against Nether mobs.
T2	Crimson Fury	3.5 / 50%	Every 3rd consecutive melee sword hit on the same player (within 2.5s) deals +2 true armor-piercing damage and heals 1 HP.
T2	Warped Pulse	3.5 / 50%	Halves Poison, Wither, Slowness, and Weakness durations; -25% magic damage taken. Dropping to <= 6.0 HP (3 hearts) triggers Regeneration II (4s) and pushes enemies outside a 5-block radius (60s cooldown).
T2	Void Hunter	3.5 / 50%	+20% arrow and thrown trident damage. Hitting a player from > 20 blocks applies Glowing (6s) to target and grants Invisibility + Speed I (3s) to shooter.
T2	Ancient Echo	3.5 / 50%	Charged (> 90%) melee axe hit marks target with Glowing and teleports them back to the strike coordinates after 3s, dismounting vehicles (10s per-target cooldown).

---

Documentation, Config & Commands

• In-Game Guide: /tbguide (available to all players) opens an interactive clickable reference in English or Russian based on client locale.
• Auto-Extracted Manuals: On launch, full Player and Server Administrator Guides (EN & RU) — including exact formulas, NBT tags, .dat file structures, and wipe launch checklists — are automatically written to config/tubricks_and_bills/.
• Main Config: config/tubricks_and_bills-common.toml (supports live hot-reloading via /economy reload).

Command Overview

• Player (OP 0): /tbguide, /economy list, /economy stats
• Admin (OP 2):
  • Exchange & Config: /economy set <construction|trading|military|treasury> <price>, /economy commission [reset], /economy adminstats [reset], /economy reload
  • Shops: /market <add|setprice|remove|turnover|resetlimits>, /seller <add|remove|resetlimits>
  • World Regulator: /expander <lock|unlock> <ow|nether>, /expander nether <open|close>, /drain1, /drain3, /drain5, /drainstop
  • NPC Management: /npc list, /npc kill <banker|market|seller|expander|repairer|all> [nearest|radius]

Feedback & Bug Reports

For questions, feature requests, or bug reports, leave a comment on the platform where you downloaded the mod.

Credits & Assets

• Tier 1 armor textures from TaTe's Custom Armors and Elytras by TaTe — used under the MIT License.
• Tier 2 armor textures (including custom recolors) from Mythic Upgrades by TriQue — used under the MIT License.