VortexBluePrints

# 🌀 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 ` 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: 👉 *(https://github.com/Sauron05/VortexBluePrints/wiki)**

Build. Sell. Earn. — VortexBlueprints*