Important
This Project is WIP and probably has bugs. Further testing needed, gladly open issues
JobActions is a powerful Minecraft plugin that enables players to create, list, and fulfill orders for items using an in-game currency system. The plugin provides an intuitive chest-based graphical user interface (GUI) for seamless order management.
This plugin requires the following dependencies to function properly:
- Vault - Economy API wrapper
- Economy Plugin (one of the following):
- Permissions Plugin:
- LuckPerms (recommended)
- Any Vault-compatible permissions plugin
- 📝 Create Orders - Players can create orders for specific items or items they're currently holding
- ❌ Cancel Orders - Players can cancel their own orders at any time
- 🏪 Order Market - Interactive chest GUI displaying all open community orders
- 📋 List Orders - View and manage all orders through an intuitive GUI
- 📦 Receive Orders - Collect fulfilled orders through a dedicated vault GUI
- 🔐 Permissions System - Fine-grained control over who can create, list, cancel, and receive orders
- ⚙️ Customizable Configuration - Set order limits, fees, timeouts, and more
/order create <item|hand> <amount> <price>
Creates an order for a specified item or the item currently in your hand.
Parameters:
item- The item name (e.g.,oak_planks)hand- Use the item currently held in your handamount- The quantity of itemsprice- The price in your server's currency
Examples:
/order create oak_planks 128 100
/order create hand 64 1000
/order cancel [orderID]
Deletes a specific order by ID or opens the cancel GUI.
Examples:
/order cancel 12345 # Cancel a specific order
/order cancel # Open the cancel GUI
/market
Opens the market GUI where all current orders are displayed. Item stacks are interactive, with order information stored in the item's metadata/lore.
/order list [user|item]
Note: This function is not yet fully implemented.
Lists orders with optional filtering by user or item. Opens a GUI for managing orders.
Examples:
/order list ArasBuilds # Filter by username
/order list diamond # Filter by item name
/order vault
Opens the vault GUI where you can receive your fulfilled orders.
| Permission | Description |
|---|---|
JobActions.create |
Allows players to create orders |
JobActions.list |
Allows players to list orders |
JobActions.cancel.self |
Allows players to cancel their own orders |
JobActions.cancel.others |
Allows players to cancel other players' orders |
JobActions.received |
Allows players to receive fulfilled orders |
The config.yml file provides extensive customization options:
# Debug mode activated?
debug: false
# Order system configuration
Order:
# Base fee charged when creating a new order (prevents abuse as teleportation)
order-basefee: 10
# Additional fee as percentage of order price
order-fee-percentage: 10
# Enable percentage-based fees
order-fee-percentage-activated: true
# Enable base fee
order-base-fee-activated: true
# Maximum number of simultaneous orders per player
order-limit: 5
# Maximum items per order (in stacks: 320 = 5 stacks of 64)
order-limit-stack-count: 5
# Order expiration time in minutes
order-timeout: 60
# Interval for checking order expiration (in minutes)
order-time-interval: 10080
# Enable automatic order expiration
order-timeout-activated: true- Download the latest release of JobActions
- Place the
.jarfile in your server'spluginsfolder - Ensure all dependencies (Vault, economy plugin, permissions plugin) are installed
- Start or restart your Spigot/Paper server
- Configure the plugin by editing
plugins/JobActions/config.yml - Reload the plugin or restart the server to apply changes
Contributions are welcome! If you encounter bugs or have suggestions:
- Check existing issues
- Open a new issue with detailed information
- Submit pull requests with improvements
This project is licensed under the MIT License - see the LICENSE file for details.
For support, bug reports, or feature requests, please open an issue on GitHub.
Made with ❤️ for the Minecraft community
