🌀 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:
housespawnfarmpvpredstoneshopdungeonmedievalscifidecor - 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:
BlueprintPublishEventBlueprintPurchaseEventBlueprintBuildCompleteEventRoyaltyPaidEvent
⚙️ 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
