Skip to main content

Collection System

How players collect delivered items from their orders.

Overview​

After items are delivered to an order, the order creator can collect them. The system supports partial collection and automatically manages order completion.

Collection Process​

1. Check Your Orders​

/orders myorders

View all your orders and their delivery status.

2. Collect Items​

/orders collect <order-id>

This opens the collection GUI showing:

  • Available items to collect
  • Quantity available
  • Inventory space required

3. Select Items​

  • Choose how many items to collect
  • System checks inventory space
  • Items are added to inventory

4. Complete Collection​

  • Items added to inventory
  • Collection recorded in database
  • Order status updated
  • Order auto-deleted when fully collected

Partial Collection​

Players can collect items in multiple batches:

Order: 64 diamonds delivered
- Collect 32 diamonds → 32 remaining
- Collect 16 diamonds → 16 remaining
- Collect 16 diamonds → Order complete

Inventory Management​

The system handles inventory:

  • Checks available space before collection
  • Prevents collection if inventory full
  • Adds items to available slots
  • Drops items if inventory full (if configured)

Order Completion​

When all items are collected:

  • Order status changes to COMPLETED
  • Remaining escrow refunded (if any)
  • Order auto-deleted to save storage
  • Order removed from active lists

Payment Processing​

If using IMMEDIATE payment method:

  • Payment is made when items are collected
  • Payment goes to deliverers
  • Payment is proportional to items collected

With ESCROW (default):

  • Payment already made on delivery
  • No additional payment on collection

Restrictions​

Players cannot collect if:

  • No items have been delivered
  • Inventory is full
  • Order is cancelled
  • Order is completed

Best Practices​

  1. Collect Promptly: Collect items soon after delivery
  2. Check Inventory: Ensure you have space before collecting
  3. Monitor Orders: Use /orders myorders regularly
  4. Partial Collection: Collect in batches if needed