KNBillford

🌟 Why Server Owners Love KNBillford

Most trading plugins are either laggy, buggy, full of dupe glitches, or locked behind expensive paywalls. KNBillford delivers a premium, commercial-grade SMP trading system completely free:

• 🔄 Automatic 24-Hour Trade Rotations
  Keep your server's economy fresh every single day! Trades rotate automatically on a live timer with server-wide chat announcements, screen titles, and chime sound effects.

• ⚡ Shift-Click MAX TRADE (Beyond DonutSMP!)
  No more annoying repetitive clicking! Players can simply Shift-Click the Hopper to trade the maximum possible amount their inventory can afford in a single instant click.

• 🎨 Visual In-Game Trade Creator GUI (/billfordadmin create)
  Admins never have to touch confusing config files! Open an interactive visual GUI, drag your input items into the slots, put your reward in the output slot, and activate it instantly on the server.

• ⏱️ Live 1-Second Real-Time GUI Ticker
  The countdown in the Info Book and Hopper ticks live every second in front of the player's eyes without needing to reopen the GUI.

• 🎯 Smart Interactive Hopper Button
  The hopper tells players exactly what they have and what they're missing with live green checkmarks (✔ 16/16) and red trackers (✖ 8/20 - Need 12 more!). When ready, the hopper lights up with an enchanted glow!

• 🛡️ Military-Grade Anti-Dupe Engine
  Built and battle-tested to withstand hacked clients, autoclicker packet flooding, shift-click spam, chest renaming exploits, and inventory glitching. Your server economy stays 100% secure.

• 📊 PlaceholderAPI & Economy Stats Ready
  Display live countdowns, trade names, total server trades, and player trade counts on your Scoreboard, Tablist, Holograms, or Action Bars!

---

🚀 Quick Start (Setup in 30 Seconds!)

1. Download the latest KNBillford.jar.
2. Drop it into your server's plugins/ folder.
3. (Optional) Install PlaceholderAPI if you want countdowns on your scoreboard.
4. Restart your server — that's it! Players can now type /billford to trade!

---

🎮 Commands & Permissions

👥 Player Commands

Command	What it does	Permission
/billford	Opens the Billford trading GUI	billford.use (Default: Everyone)
/billford time	Shows when the next trade arrives & your remaining daily trades	billford.use (Default: Everyone)
/billford trades	Shows full details of the active trade in chat	billford.use (Default: Everyone)
/billford help	Opens the interactive help guide	billford.use (Default: Everyone)

💡 Aliases: /bf, /bill

---

👑 Admin Controls

Command	What it does	Permission
/billfordadmin create [name]	Interactive In-Game Trade Creator! Opens a GUI to drag & drop trades visually	billford.admin (Default: OP)
/billfordadmin presets	View all pre-configured trade offers in a beautiful list	billford.admin (Default: OP)
/billfordadmin setpreset <id>	Instantly activate any preset deal (e.g. logs_for_emeralds)	billford.admin (Default: OP)
/billfordadmin set <mat> <amt> <name>	Custom Trade On The Fly! Hold the input item in hand to set trade	billford.admin (Default: OP)
/billfordadmin refresh	Force-rotate to a brand new trade with full server broadcast	billford.admin (Default: OP)
/billfordadmin reset [player|all]	Reset daily trade limits for one player or the entire server	billford.admin (Default: OP)
/billfordadmin stats	View server-wide total trades and player trade stats	billford.admin (Default: OP)
/billfordadmin status	Quick diagnostic view of the scheduler, active trade, and presets	billford.admin (Default: OP)
/billfordadmin reload	Reload configuration, slot layouts, and active menus without restart	billford.admin (Default: OP)

💡 Aliases: /bfa, /billforda

---

🎨 Super Easy Custom Trades (Hold In Hand!)

Want to make a custom trade without touching config files?

1. Put the item you want players to pay in your main hand (supports custom names, lore, enchants & crate keys!).
2. Run:

   /billfordadmin set DIAMOND 5 "Super Miner Deal"
   

3. Done! Players now trade whatever you were holding for 5 Diamonds!

---

🧩 Scoreboard & Tablist Placeholders

Hook into PlaceholderAPI effortlessly:

Placeholder	Example Output	Description
%knbillford_name%	Multi-Metal Deal	Name of today's trade
%knbillford_time%	14h 22m 10s	Live countdown to next rotation
%knbillford_can_trade%	true / false	Can the player still trade today?
%knbillford_has_traded%	Yes / No	Has player completed today's deal?
%knbillford_trades_completed%	1	Trades completed by player today
%knbillford_trades_max%	1	Max trades allowed per cycle
%knbillford_inputs%	16x Iron Ingot, 12x Gold Ingot	Required ingredients summary
%knbillford_output%	3x Diamond	Trade reward summary

---

💎 25+ Ready-To-Play Presets Included

The plugin comes loaded with balanced economy trades out of the box:

• 🪓 Wood Worker's Deal: 32 Oak Logs ➔ 4 Emeralds
• ⛏️ Stone Mason: 64 Cobblestone ➔ 3 Iron Ingots
• 🥇 Precious Barter: 32 Gold Ingots ➔ 2 Diamonds
• 🌋 Netherite Forger: 24 Diamonds + 1 Netherite Scrap ➔ 2 Ancient Debris
• 🌾 Farmer's Bounty: 32 Wheat + 32 Carrots + 32 Potatoes ➔ 16 Golden Carrots
• 🏹 Monster Bounty: 32 Rotten Flesh + 32 Bones + 16 Gunpowder ➔ 24 XP Bottles
• ...and over 19 more trades ready to rotate!

---

🛠️ Configuration Preview (config.yml)

Everything is 100% customizable with modern Hex color codes (&#RRGGBB):

# Automatic Daily Trade Rotation
rotation:
  enabled: true
  interval-seconds: 86400    # 24 Hours (86400 seconds)
  broadcast: true           # Broadcast in chat when trade changes
  title-enabled: true       # Show flashy title on player screens

# Daily Player Trade Limit
trade-limit:
  enabled: true
  amount: 1                 # 1 trade per player per day

# Custom title and sounds
settings:
  gui-title: "&#333333&lBILLFORD TRADING"
  close-on-trade: false     # Keep GUI open for smooth experience

---