🌀 VortexBlueprints — Blueprint Marketplace & Creator Economy

Players capture builds. Sell them. Earn royalties forever.
The most complete blueprint economy system ever built for Paper and Folia.

---

✨ What Is VortexBlueprints?

VortexBlueprints transforms your server into a living creator marketplace. Players select any structure with a wand, publish it as a blueprint, set a price and license type, and start earning royalties automatically every time another player builds their design.

It's not just a schematic tool. It's a full creator economy — with originality protection, team revenue splits, moderation queues, analytics dashboards, rating GUIs, dispute resolution, Discord notifications, and a built-in web panel for remote moderation.

---

🚀 Core Features

🏗️ Blueprint Capture & Publishing

• Select any cuboid region with the VortexBlueprints wand or /vbp pos1 / /vbp pos2
• Publish with a price, category, license type, build style, royalty rate, and description
• Rotation-aware placement so builds always face the correct direction
• Preview footprint before committing a build

🛒 Global Marketplace

• Full inventory GUI marketplace with six browsing views:
  • 🌟 Featured · 📈 Trending · 🆕 Newest · 💰 Cheapest · 💎 Profitable · 👑 Top Creator
• Category filtering: house spawn farm pvp redstone shop dungeon medieval scifi decor
• One-click buy, build, preview, rate, and inspect — all from the GUI

🔒 Originality Engine

• Every blueprint is fingerprinted at capture time
• Similarity scoring compares the new build against all existing listings
• Exact duplicates are blocked. Near-copies are flagged for review. Original builds go live instantly.
• Players can open disputes against listings they believe are derived from their own work

💸 Economy & Royalties

• Vault-compatible with a built-in credit wallet fallback — no economy plugin required
• Per-listing royalty percentage paid on every build
• Team ownership system — split revenue across multiple co-owners with configurable share percentages
• Milestone progression system with badge rewards

🎨 Build Styles

Style	Description
instant	Entire structure placed at once
animated	Chunked paste over multiple ticks with visual feedback
drone	Animated paste with drone-style particles
crate	Crate-opening particle and sound effect during paste

📜 License Types

License	Description
single_use	One build per purchase
pack_five	Five builds per purchase
pack_twenty	Twenty builds per purchase
showcase	Limited display use
exclusive	One buyer, listing archived after sale

⭐ Ratings & Analytics

• GUI-based rating flow — quality, accuracy, and usefulness scoring
• Rate from /vbp rate <id> or directly from the blueprint detail GUI
• Creator analytics GUI — revenue, royalties, views, purchases, conversion rate, badges, top categories, timeline

🛡️ Moderation

• Review queue GUI for pending originality approvals
• Dispute queue GUI for active originality challenges
• /vbp probe protection — live diagnosis of all claim hooks at any location
• Built-in web panel for remote review and dispute resolution
• Discord webhook notifications for publications, milestones, reviews, and disputes

🔌 Protection Integrations

WorldGuard · Towny · Lands · GriefPrevention · Residence · PlotSquared

📡 Developer API

Fire-and-listen Bukkit events:

• BlueprintPublishEvent
• BlueprintPurchaseEvent
• BlueprintBuildCompleteEvent
• RoyaltyPaidEvent

---

⚙️ Requirements

Requirement	Version
Server	Paper or Folia 1.21.x
Java	21+
Economy	Vault (optional)
Storage	SQLite (default) or MySQL

---

📖 Commands (Quick Reference)

/vbp wand → Get the selection wand
/vbp save → Publish a blueprint
/vbp market → Open the marketplace GUI
/vbp build → Build a blueprint
/vbp rate → Open the rating GUI
/vbp analytics → Open creator analytics
/vbp review gui → Open the moderation review queue
/vbp panel → Print the web panel URL

---

📚 Documentation

Full setup, configuration, API reference, and moderation guide:
👉 GitHub Wiki

---

Build. Sell. Earn. — VortexBlueprints