Paper plugin · v1.0.0
Player market stalls that feel like a real bazaar
Rentable player market stalls with Citizens NPC vendors, chest stock, and GUI management.
Why StallCraft
Wand-based setup
Define cuboid bounds, NPC counter spot, and linked stock chests — no ugly sign-on-a-chest shops.
NPC identity
Citizens vendors auto-spawn on rent. Renters choose name, skin, and shop title in a setup wizard.
Chest-first stock
Hopper-friendly linked chests plus optional virtual GUI stock. Price Board GUI for per-slot pricing.
Lease economy
Timed rentals, grace period, auto-renew, configurable offline sales, and Vault tax on sales.
For players
- /stallcraft browse — rent an available stall in a market hall
- Setup wizard — NPC name, skin (owner/username), shop title
- /stallcraft manage — price board, virtual stock, renew, auto-renew, vacate
- Customers right-click NPC — paginated shop GUI with Vault purchases
- Build protection inside your leased cuboid while the lease is active
For admins
- /stallcraft wand — corner A/B, NPC anchor, link stock chests
- /stallcraft market create <id> — create a market hall
- /stallcraft create <market> <stallId> — save wand selection + setup GUI
- /stallcraft edit <stallId> — adjust rent, stock mode, offline sales override
- /stallcraft config — in-game admin menu; presets: default, theryn
Integrations
- VaultRequired — rent payments and shop sales
- CitizensNPC vendor spawn, skin, and click-to-shop
- WorldGuardParent market region reference (optional)
- LandsSoft hook for future wilderness markets
- PlaceholderAPIstall_id, rent_expiry, sales_today placeholders
- CMIEconomy via Vault; optional mail on expiry (future)
Quick start
- 1.Download StallCraft-1.0.0.jar from GitHub Releases or Hangar
- 2.Requires Vault + economy plugin and Citizens for NPC vendors
- 3./stallcraft market create dawnreach
- 4./stallcraft wand → define stall → /stallcraft create dawnreach stall_01
- 5.Players: /stallcraft browse dawnreach → rent → stock chest → set prices
Commands
| Command | Permission | Description |
|---|---|---|
| /stallcraft browse [market] | stallcraft.browse | Browse and rent stalls |
| /stallcraft manage | stallcraft.manage | Manage your rented stall |
| /stallcraft wand | stallcraft.wand | Get the stall setup wand |
| /stallcraft create <market> <stall> | stallcraft.create | Create stall from wand selection |
| /stallcraft config | stallcraft.config | Open admin config GUI |
| /stallcraft reload | stallcraft.reload | Reload configuration |
| /stallcraft version | stallcraft.admin | Version and hook status |
Compatibility
- Server: Paper 1.21.1 or newer (required)
- Java: 21 or newer
- Tested on: Paper 1.21.1, 1.21.4, 26.1
- Hard deps: Vault
- Soft deps: Citizens, WorldGuard, PlaceholderAPI