Skip to main content

Overview

SigmaOrders is a modern, high-performance Minecraft plugin for Paper/Spigot servers that enables players to create, browse, fulfill, and deliver item orders through an intuitive GUI system.

Why This Matters​

SigmaOrders transforms your server's economy by creating a marketplace where players can request items and others can fulfill those requests for payment. This creates player-driven commerce, reduces reliance on admin shops, and encourages active gameplay.

Key Value Proposition​

  • Player-Driven Economy: Players create demand, other players fulfill it
  • Secure Escrow System: Payments are held safely until delivery is confirmed
  • Partial Deliveries: Multiple players can contribute to large orders
  • Modern GUI: Intuitive interface built with InventoryFramework
  • Thread-Safe: Full support for Folia and async operations
  • Performance Optimized: Minimal server thread usage with async database operations

Supported Minecraft Versions​

  • Minimum: Paper 1.21+
  • Java: Java 21 or higher
  • API Version: 1.21

Dependencies​

Required​

  • Vault: Economy integration (required)
  • Paper/Spigot: Server platform (1.21+)

Optional​

  • ItemsAdder: Custom item support (optional, detected automatically)
  • PlaceholderAPI: Placeholder support (optional)

Core Concepts​

Orders​

An order is a request for items created by a player. Each order contains:

  • Item Type: The material/item requested (e.g., DIAMOND, IRON_INGOT)
  • Quantity: How many items are needed
  • Price Per Item: What the order creator will pay per item
  • Status: Current state (PENDING, IN_PROGRESS, DELIVERED, COMPLETED, CANCELLED)

Escrow System​

All payments use an escrow system where money is held in a secure "bank" until items are delivered. This ensures:

  • Order creators can't lose money without receiving items
  • Deliverers are guaranteed payment upon delivery
  • Automatic refunds if orders expire or are cancelled

Delivery & Collection​

  • Delivery: Players fulfill orders by delivering items (can be partial)
  • Collection: Order creators collect delivered items from their orders
  • Payment: Deliverers are paid automatically when items are delivered

Quick Example​

# Player creates an order
/orders create diamond 64 100.0

# Another player delivers items
/orders deliver 1

# Order creator collects items
/orders collect 1

Architecture​

SigmaOrders is built with:

  • Async Operations: All database operations run asynchronously
  • Transaction Safety: Optimistic locking prevents concurrent delivery issues
  • Caching: Order cache for performance
  • Modular Design: Separate managers for orders, economy, items, and database

What's Next?​