Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
FoOrders lets your players create and fulfill item orders in-game, making your server economy feel alive and interactive.
FoOrders brings structured trading to your server without the hassle. Perfect for survival and/or economy servers looking to level up player interactions.

Features:
- Configurable GUI and order-event sounds through
sounds.yml. - Bedrock support uses the inventory GUI workflow.
- Create orders for any item – Players can request items they need and set a price for delivery.

- Configurable creation tax - Add a percentage-based upfront tax that players see before confirming an order.
- Deliver items for money – Players can fulfill orders to earn money via Vault integration. You can also put in shulkers. Non ordered items and shulkers will automatically be returned.

- Order management – Cancel orders if needed. Delivered items can be collected directly or stored in shulkers for easy delivery.


- Search, filter, and sort – Quickly find orders with flexible search options and sorting features.
- Search player names to find orders from a specific requester.

- Regular /orders [search] command for players
- Clean, intuitive interface – Designed to be simple to use and look good in-game.
- Can now add custom items
- Discord webhook (for checking for suspicious activity)
- History tab (optional, admins can also check any player's history (also optional))
- Admin cancelation of other players (optional, for if an item gets blacklisted after it's already been ordered)
- Blacklist certain items and/or names
- Optional Tax for players when paying for an order
Permissions:
foorders.admin– Access admin commands (/ordersadmin) (and ability to cancel any player's order and add custom items)foorders.maxorders.<number>- Amount of orders that player can set, overrides the default max order in configfoorders.use- Access to /orders (default set to true for players)
Dependencies:
- Vault (for economy integration)
Commands
/orders [<search>]/ordersadmin <reload|version|editor|history> [player] (editor opens custom items menu)
Developer API
Compile against the matching jar (provided in Maven, compileOnly in Gradle); install it locally if needed. Declare FoOrders in your plugin metadata (softdepend for an optional integration).
<dependency>
<groupId>me.foesio</groupId>
<artifactId>FoOrders</artifactId>
<version>4.8</version>
<scope>provided</scope>
</dependency>
import me.foesio.foOrders.api.FoOrdersApi;
import me.foesio.foOrders.api.event.OrderBeforeCreateEvent;
FoOrdersApi api = Bukkit.getServicesManager().load(FoOrdersApi.class);
if (api != null) api.getOpenOrders();
@EventHandler
public void onOrderBeforeCreateEvent(OrderBeforeCreateEvent event) {
Bukkit.getLogger().info(event.getClass().getSimpleName());
}
API methods (overloads grouped):
FoOrdersApi:getOrder,getPlayerOrders,getOpenOrders,quote,createOrder,createOrderForPlayer,createOrderForNpc,cancelOrder,matchesOrder,getCustomItems,getCustomItem,registerCustomItem,unregisterCustomItem,getOrderHistory,getDeliveryHistory.
Other API types: CustomItemSnapshot, HistorySnapshot, OrderActionResult, OrderQuote, OrderRequest, OrderSnapshot.
Events: OrderBeforeCreateEvent, OrderCancelledEvent, OrderClosedEvent, OrderCreatedEvent, OrderDeletedByAdminEvent, OrderDeliveryAcceptedEvent, OrderFilledEvent, OrderItemsClaimedEvent, OrderLifecycleEvent (base).
Browse API and event source for signatures and event details.


