Skip to main content

ItemsAdder Integration

Support for ItemsAdder custom items.

Overview​

SigmaOrders automatically detects and supports ItemsAdder custom items, allowing players to order custom items from the ItemsAdder plugin.

Detection​

The plugin automatically detects ItemsAdder:

  • Checks if ItemsAdder is installed
  • Detects on server startup
  • Re-checks after world load (handles POSTWORLD load order)
  • Shows status in console

Usage​

Creating Orders with Custom Items​

When creating an order:

  • Custom items are detected automatically
  • ItemsAdder item ID is stored
  • Item validation uses ItemsAdder API
  • Custom item names are displayed instead of base material names

Delivering Custom Items​

When delivering items:

  • System validates custom item ID
  • Matches ItemsAdder items correctly
  • Supports all ItemsAdder item types
  • Custom item names are preserved and displayed

Custom Item Name Display​

ItemsAdder custom items now display their custom names instead of base material names throughout all GUIs:

  • Order creation GUI: Shows custom item names
  • Order details GUI: Displays custom item names
  • Order search results: Custom names in search results
  • Announcement hover tooltips: Custom names in tooltips
  • Confirm order buttons: Custom names in buttons

This provides a better user experience when working with ItemsAdder custom items.

Configuration​

No special configuration needed:

  • Integration is automatic
  • Works if ItemsAdder is present
  • Gracefully handles if ItemsAdder is not installed

Console Status​

On server startup, you'll see:

[SigmaOrders] ✓ ItemsAdder integration enabled

Or if ItemsAdder is not installed:

[SigmaOrders] ✗ ItemsAdder integration disabled

API Support​

The API supports ItemsAdder items:

  • OrderItem.getCustomItemId() returns ItemsAdder item ID
  • Item validation works with custom items
  • All operations support custom items

Best Practices​

  1. Verify Detection: Check console for ItemsAdder status
  2. Test Custom Items: Test ordering custom items
  3. Update ItemsAdder: Keep ItemsAdder updated
  4. Report Issues: Report any integration issues