ItemRace is a Minecraft plugin for Paper servers that allows players to compete to get the most items. It is highly configurable, allowing it to be used for short events, long-term competitions, or just keeping track of what items players are getting! ## Default behaviour *Keep in mind that this is only the default behavior and can be configured using the `config.yml` file created in the `ItemRace` directory when the plugin is enabled for the first time. For example, you could make it so players are simply scored on the number of diamonds currently in their inventory and ender chest, or for every type of item they have had at least 3 of in their inventory at some point.* Players must deposit items using `/itemrace deposit`, which will open up the deposit GUI for them to place items inside. ![Deposit GUI - Chest UI with title "Move all items to deposit here"](https://raw.githubusercontent.com/hopperelec/ItemRacePlugin/0bba4488324572b85180a3f2103f3c9b6a9578ef/screenshots/deposit-gui.webp) Players can deposit absolutely any item except for air. Once they close the deposit GUI, those items will move to their ItemRace inventory, which they cannot take items back out of. Players can also deposit items directly into their ItemRace inventory using: - `/itemrace deposit all`: deposit all items in their inventory with the same type as the item in their hand - `/itemrace deposit inventory`: deposit all items in their inventory, regardless of type - `/itemrace deposit (amount)`: deposit `amount` of the type of item in their hand from their inventory - `/itemrace deposit (amount) (item)`: deposit `amount` of `item` from their inventory Players can also create a list of items which get automatically deposited as soon as they enter their own inventory - `/itemrace autodeposit`: opens a GUI to toggle which items to auto-deposit ![Auto-deposit GUI - Double Chest UI with title "Auto-deposit items", containing many items with some of them enchanted, and one button at the bottom](https://raw.githubusercontent.com/hopperelec/ItemRacePlugin/0bba4488324572b85180a3f2103f3c9b6a9578ef/screenshots/auto-deposit-gui.webp) - `/itemrace autodeposit add (item)`: starts auto-depositing `item` - `/itemrace autodeposit remove (item)`: stops auto-depositing `item` Players are scored based on the items currently in their ItemRace inventory. Players will gain one point each time the amount of a type of item they have doubles. That is, they will get a point for their 1st, 2nd, 4th, 8th, 16th, 32nd, 64th, 128th... item of each type, with no limit. For example, if a player deposits 128 dirt and 4 cobblestone, they will earn 11 points (8 points for dirt and 3 points for cobblestone). The current leaderboard can be viewed using `/itemrace leaderboard` ![ItemRace leaderboard shown in chat](https://raw.githubusercontent.com/hopperelec/ItemRacePlugin/0bba4488324572b85180a3f2103f3c9b6a9578ef/screenshots/leaderboard-chat.webp) or using the sidebar which can be toggled using `/itemrace togglescoreboard`. ![ItemRace leaderboard shown in sidebar](https://raw.githubusercontent.com/hopperelec/ItemRacePlugin/0bba4488324572b85180a3f2103f3c9b6a9578ef/screenshots/scoreboard-sidebar.webp) Players can view each other's ItemRace inventories using `/itemrace inventory`, which will open up a paginated GUI listing deposited items. ![Inventory GUI - Double chest with title "hopperelec's deposited items" and with two buttons on the bottom, one named "Next page"](https://raw.githubusercontent.com/hopperelec/ItemRacePlugin/0bba4488324572b85180a3f2103f3c9b6a9578ef/screenshots/deposited-items-gui.webp) From the deposited items GUI, players can also access a list of other players for whom to view the deposited items. ![Players GUI - Double chest with title "ItemRace inventories" containing player skulls, one named "View Phantom_RX's deposited items"](https://raw.githubusercontent.com/hopperelec/ItemRacePlugin/0bba4488324572b85180a3f2103f3c9b6a9578ef/screenshots/players-gui.webp) ## Point award modes These are how the plugin chooses which items to award points for.

AUTO_DEPOSIT_ALL

All items a player picks up are automatically moved into their ItemRace inventory, which they cannot take items out of.

AUTO_DEPOSIT

Similar to AUTO_DEPOSIT_ALL but only items which the player can earn points for will be deposited. This is only really useful if a denylist has been created

DEPOSIT_COMMAND

Similar to AUTO_DEPOSIT, but players choose which items to move to their ItemRace inventory using `/itemrace deposit`. If no arguments are specified, the item in the player's hand is deposited.

DEPOSIT_GUI (default)

Similar to DEPOSIT_COMMAND except, if no arguments are specified, then an inventory GUI is opened. Players can move any items they wish to deposit into that inventory.

MAX_INVENTORY

Similar to AUTO_DEPOSIT, but players do not lose deposited items. Instead, their ItemRace inventory is based on the maximum amount of a given item they have held in their inventory at any time.

INVENTORY

Players are scored based on the items currently in their inventory.

ENDER_CHEST

Similar to INVENTORY, but also includes items in their ender chest.

## ItemRace inventory persisting For award modes which use the ItemRace inventory (which does not include INVENTORY or ENDER_CHEST), the plugin is able to persist (and auto-save at a configurable interval) the contents of each player's ItemRace inventory (and autodeposit list) between server restarts. This data is saved to the file `plugins/ItemRace/data.yml`. ## Permissions - **itemrace.admin:** Permission to use all ItemRace admin commands - **itemrace.reset:** Allows resetting players' scores using `/itemrace reset [player]` - **itemrace.deposit *(default)*:** Allows depositing items in MANUAL_DEPOSIT mode using `/itemrace deposit` - **itemrace.inventory:** Allows viewing players' ItemRace inventories using `/itemrace inventory [player]` - **itemrace.inventory.self *(default)*:** Allows viewing your own ItemRace inventory using `/itemrace inventory` - **itemrace.leaderboard *(default)*:** Allows viewing the ItemRace leaderboard using `/itemrace leaderboard` - **itemrace.togglescoreboard:** Allows toggling the scoreboard using `/itemrace togglescoreboard` - **itemrace.autodeposit *(default)*:** Allows creating a list of items to auto-deposit on a per-player basis using `/itemrace autodeposit`

hopperelec

hopperelec's Plugins

ItemRace by hopperelec

hopperelec's Organizations

Stars

Watching

ItemRace by