🍩 DonutHelper — The Ultimate Utility Suite for DonutSMP

DonutHelper is an essential, feature-packed client modification designed specifically for DonutSMP. Whether you are trading high-value items, managing your reputation, running community giveaways, or dominating the Auction House, DonutHelper provides a seamless, secure, and modern experience.

🛡️ MiddleDonut — Secure Escrow & Middleman System

Say goodbye to trade scams! MiddleDonut provides an automated, trustless escrow service with integrated staff support.

• Automated Trading (/middle trade <player> <amount>): Initiates secure escrow trades that execute payments automatically upon mutual agreement.
• Pre-Trade Transparency: Displays locked funds, platform fee breakdowns, and dispute terms before you finalize any deal.
• 3-Way In-Game Dispute GUI: Private mediation interface accessible exclusively by the Buyer, Seller, and assigned Staff.
• Automated Evidence Scanner: Automatically records surrounding sign texts (15-block radius) and recent chat logs the second a dispute is opened.
• Tiered Dispute Resolution:
  • Trades under 1B: Managed by 1 Mod + 1 Head Staff.
  • Trades 1B+: Automatically flagged as HIGH VALUE and routed strictly to Head Staff/Admins.
• Asynchronous Offline Freeze (PENDING_OPENING): Immediately freezes API funds even if no staff are online, holding them safely until staff review.

🏅 Reputation & Vouchers System

Build your trust within the community or audit players before doing business.

• Interactive GUI (/voucher): Redesigned dashboard featuring player heads, search functionality, and real-time scam/legit status pills.
• Player Audits (/voucher check <player>): Instant access to a player's verified reputation counts.
• Community Reporting (/voucher add <player> <scam|legit>): File vouchers against players to be audited by staff before hitting their public score.
• Staff Controls & Web Portal: Direct staff bypass (/voucher admin) and a dedicated Web Admin Portal for single-click approvals, denials, and deletions.
• Anti-Abuse Protection: Automatically filters out duplicate pending vouchers and self-vouching.

🎁 Integrated Giveaways Engine

Host and participate in server giveaways directly through an intuitive UI.

• Giveaway Hub (/giveaway): A visual two-column card grid displaying active prizes, hosts, total participants, and a 1-click JOIN button.
• Direct Chat Actions (/giveaway join <id> & /giveaway notify): Join active pools directly from chat or re-trigger missed notifications.
• My Winnings Tab: Track every reward you have won across your DonutSMP career.
• Smart Alert Queue: One-time chat alerts when giveaways go live, offline reconnection notifications, and instant winner announcements.
• Staff Pool Creation: Host-funded prize pools with automated random winner drawing and fallback host refunds.

🛒 Auction House & Rank Speed Engine

Optimization tools to streamline your economy game.

• Instant Search (/ahsearch): Rapidly look up item prices on the Auction House without menu delays.
• Rank-Scaled Multi-Sell (/ahmulti): Speed up item listing with auto-sell delays calibrated to your active rank tier:
  • Default: 0.5s per item
  • Bronze: 0.4s per item
  • Silver: 0.3s per item
  • Gold: 0.26s per item (Maximum legal server speed limit)
  • Note: Automatically reverts to default speed when rank expiration occurs.

👥 Social, Parties & Communications

Keep in touch with your allies and stay informed.

• Friend & Request Hub (/dh & /dh requests): Manage incoming friend requests with interactive buttons and check active plan durations (/dh rank).
• Non-Spammy Alerts: Intelligent online toasts and single-session friend status alerts.
• Staff & Owner Integration: In-game rendering of Discord owner messages ([★ Owner ★]) with audio pings, plus real-time deposit alerts and reconnect summaries for staff accounts.
• Mod User Radar (/dh online): View active DonutHelper users on the server for easier teleportation and interaction.

⚙️ Requirements & Compatibility

• Server: Exclusively built for DonutSMP
• Platform: Minecraft 1.21.11 (Fabric)
• Note: Support for +26.X versions will be available once the Vulkan API reaches higher stability.

DonutHelper is actively updated. Make sure you are always running the latest version to ensure full compatibility with the DonutSMP backend!