Moonlit Broker

### **1.0.4 — Major Bounty Improvements: Feels Like a Real Contract System** 🌙📜 Less backtracking. Less spam. Smarter flow. --- * **Automatic base settlement:** When a contract is completed, base rewards (🪙 Silver Notes + 📜 Trade Scroll) are granted automatically. If your inventory is full, settlement is safely deferred — once space is available, it auto-completes. Rewards never drop on the ground. * **Smoother coin rewards:** Coins are now stored first and delivered automatically the next time you interact with a Moonlit Broker (before the trade UI opens). Cooldown status is clearly indicated. * **More interesting targets:** Contracts no longer lock to the mob that dropped them. Targets are drawn from a pool and now feature **Common / Elite / Rare** tiers with colored indicators. * **Elite & Rare feel more rewarding:** Higher coin chances for Elite and Rare contracts. Common contracts remain unchanged. Overall economy remains protected by cooldowns and caps. * **Cross-dimension friendliness:** Overworld contracts will try to avoid Nether / End / Ocean Monument targets when possible. Location hints are provided when needed — rate-limited to prevent spam. * **Improved stability:** Added pool guardrails, audit logging, and extra protection against edge-case duplication, loss, or spam issues. --- A cleaner, more immersive bounty loop — built for exploration and long-term progression. ✨

🗡️ Fixed the duplicate Katana acquisition bug. Once you already own a Katana, the normal purchase offer will stay visible but correctly show as “Sold Out” ✅ — it will no longer get wrongly swapped into another purchasable route. 🔁 Adjusted when “Reclaim” (contract recovery) appears. The Reclaim entry will only show up if the Katana is NOT in your main inventory / offhand / armor slots 🎒🖐️🛡️ 🔒 Reclaim logic is now hardened. After reclaiming, only the newest Katana instance remains contract-valid ✨ Older copies will enter a Dormant state 😴 and can’t be used as an active “main blade” to trigger effects anymore. 🧷 Fixed an edge-case desync: in rare situations the trade item could be received but the ownership state didn’t get written. This is now prevented, so it won’t enable repeat purchases later 🛠️ 🔊 Fixed the merchant sound glitch: sometimes a trade could succeed but still play a deny/disagree sound ❌ Now clicking a valid trade offer won’t trigger the wrong “NO” sound anymore ✅ 🛑 Real server-side rejections still behave correctly. If a trade is genuinely invalid (already owned / conflicting state, etc.), the server will block delivery and show a proper message as intended 📢

🧠 Not-Registered Hints No Longer Spam (More Friendly) The “not registered yet” hint is now **persistently rate-limited**: if you haven’t met a Moonlit Broker, killing mobs will **not** repeatedly spam your actionbar. By default, the reminder is now sent to **chat**, and each player will see it **at most once per in-game day** (so it won’t clutter combat visibility). After you **successfully register for the first time**, you’ll also get a one-time confirmation message: **You can now receive Bounty Contracts as drops from eligible mobs.**

Moonlit Broker v1.0.1 — Major Bounty & Mark Experience Overhaul + Behavior Fixes ✅ Key changes (you’ll feel them immediately) Bounty Contracts now feel more “natural” Common hostile mobs can now drop Bounty Contracts at a low rate (no longer skewed only toward elite/high-tier mobs). Contracts are generated in common / elite / rare tiers. No more keeping a Mark in your inventory just to trigger bounties The system now uses “historical registration”: once you’ve interacted with the Moonlit Broker and registered, you can trigger Bounty Contract drops. Your Mark can stay in a chest / backpack expansion—no more wasted inventory slot. If you’re not registered, you’ll get a hint—but it won’t spam If you haven’t registered yet, killing eligible mobs may occasionally remind you to visit the Moonlit Broker to register (30s limit per player). After you successfully register for the first time, you’ll also get a one-time confirmation message: You can now receive Bounty Contracts as drops from eligible mobs. 🧾 Contracts are safer (updates won’t screw you over) Expired contracts can be recycled for a refund If a contract’s target becomes invalid in a new version (e.g., removed from the target pool), turning it in will show “Contract expired”, then: the contract is reclaimed, and you get a small Silver Note refund (default x1). 🔇 Fixes & QoL Removed leftover Wandering Trader milk/potion drinking behavior + subtitles You will no longer see things like: “Wandering Trader drinks milk”. “Contract not established …” message is now unambiguous That message is actually related to the Katana Contract (not the Bounty Contract). The text now explicitly says it’s about the Katana Contract, and it has a 30s rate limit—no more combat spam, and no more confusion that bounties are broken. 🛠 Player / Server Admin Commands /moonlit status: Check whether you are registered (Mark bound) /moonlit check_mark <player> (admin): Check a player’s registration status /moonlit reset_mark <player> (admin): Reset a player’s registration (and clear bounty drop cooldown)

🌙 Moonlit Broker An RPG-style Fabric mod that adds a mysterious merchant, a contract-bound katana system, and a tiered economy progression. ✨ Core Features Mysterious Merchant NPC with a tiered trade system (Top / Shelf / Spark) Contract-bound legendary katanas with unique combat effects Bounty hunting & milestone progression Multi-currency economy loop (Silver Notes / Trade Scrolls / Bounty Contracts / Mysterious Coins) Multiplayer-friendly: server-authoritative validation & anti-duplication trade logic ✅ Requirements Minecraft: 1.21.1 Fabric Loader: 0.15.11+ Fabric API: 0.116.8+1.21.1 Java: 21 📦 Installation Install Fabric Loader + Fabric API Drop the mod .jar into: .minecraft/mods/ Launch the game. 🧾 Notes This file is the full playable build with complete in-game textures. The GitHub repository is code-open / asset-closed by design (placeholder textures are used there). 🐛 Known Issues / Feedback If you encounter missing textures, crashes, or balance issues, please report it in the Issues page (or comments).