# OneItem<\/p>\n
\n
\n<\/p>\n
**A strict enforcement plugin that guarantees true item uniqueness on your server.**<\/p>\n
*Only one item. No duplicates. No exploits.*<\/p>\n<\/div>\n
—<\/p>\n
## Overview<\/p>\n
**OneItem** is a lightweight but powerful Minecraft server plugin that enforces a simple yet absolute rule:<\/p>\n
> **For each configured item type, only ONE instance may exist on the entire server.**<\/p>\n
Originally designed to control powerful or legendary items such as the **Mace**, OneItem is fully configurable and can be applied to **any vanilla Minecraft item** \u2014 from wooden swords to end-game artifacts.<\/p>\n
The plugin continuously monitors inventories, containers, dropped items, and crafting behavior to ensure that duplicates never exist, while safely tracking and restoring the legitimate unique item when necessary.<\/p>\n
—<\/p>\n
## Core Concept<\/p>\n
– Each tracked item type (e.g. `MACE`) may have **only one legitimate instance**
\n– The first crafted or assigned item becomes the **unique item**
\n– Any additional copies are **automatically deleted**
\n– Crafting is disabled as long as the unique item exists
\n– If the unique item is lost, OneItem restores it intelligently<\/p>\n
This makes OneItem ideal for:
\n– Survival servers with legendary items
\n– RPG \/ lore-based servers
\n– Event rewards
\n– Hardcore or challenge servers
\n– Economy or balance-focused gameplay<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Item Uniqueness Enforcement
\n– **One item per type, server-wide**
\n– Supports **any vanilla item**
\n– Fully configurable via `config.yml` or commands
\n– Works across all worlds<\/p>\n
### Crafting Control
\n– Players may craft the item **only if no unique instance exists**
\n– The **first craft claims the item**
\n– All future crafting attempts are blocked automatically<\/p>\n
### Global Item Tracking
\nOneItem scans:
\n– Player inventories
\n– Ender chests
\n– Containers (chests, barrels, furnaces, etc.)
\n– Shulker boxes (including nested storage)
\n– Dropped items in loaded chunks<\/p>\n
Any duplicate that is **not the legitimate unique item** is immediately removed.<\/p>\n
—<\/p>\n
### Intelligent Recovery System
\nIf the unique item is lost (deleted, despawned, cleared, etc.):<\/p>\n
– It is restored to:
\n – The last known player (if online), or
\n – The last known container, or
\n – A safe fallback location<\/p>\n
#### Offline Safety Rule
\nIf the unique item was last known to be inside the inventory of an **offline player**:
\n– The plugin assumes it still exists
\n– No restoration or duplication occurs
\n– Prevents false duplicates when the player rejoins<\/p>\n
—<\/p>\n
### Indestructible Mode (Optional)
\nConfigurable protection for unique items:
\n– No durability loss
\n– Immune to fire, lava, and heat
\n– Prevents accidental destruction<\/p>\n
—<\/p>\n
### Controlled Transfers
\nTo prevent abuse or duplication:
\n– Unique items **cannot be dropped**
\n– Items can only be transferred via **containers**
\n – Chests
\n – Barrels
\n – Shulker boxes
\n – Furnaces, etc.<\/p>\n
This ensures safe and intentional ownership transfer.<\/p>\n
—<\/p>\n
### Admin Resolution Tools
\nIf OneItem is installed on an existing server with duplicates:<\/p>\n
Admins can choose how to resolve it:<\/p>\n
– **Random existing owner**
\n– **Random online player**
\n– **Specific player (manual assignment)**<\/p>\n
All other copies are removed automatically.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
Main command: `\/oneitem`
\nAliases: `\/oi`, `\/onei`
\nPermission: `oneitem.admin` (default: OP)<\/p>\n
### Core Commands<\/p>\n
| Command | Description | ### Duplicate Resolution<\/p>\n | Command | Description | —<\/p>\n ## Configuration<\/p>\n The configuration file is generated automatically.<\/p>\n “`yaml tracked-items: message-prefix: “&6[OneItem]&r ” Ensures that only one copy of a chosen items exists on the server by automatically tracking, blocking crafting, and removing duplicates.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"one-item","_minecraft_project_id":"WiD0ZDjY","_minecraft_author":"Nevmind","_minecraft_license":"CC-BY-ND-4.0","_minecraft_downloads":222,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"one-item.zip","_minecraft_size_bytes":23587,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:27:12.656559Z","_minecraft_date_created":"2025-12-14T00:41:43.059276Z","_minecraft_date_modified":"2025-12-12T21:02:42.738511Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/one-item","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-06T19:48:28+00:00","_minecraft_import_hash":"7947ca56f746699971e2967af33da112","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-115912","mod","type-mod","status-publish","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|——|———–|
\n| `\/oneitem help` | Show help menu |
\n| `\/oneitem list` | List all tracked unique items |
\n| `\/oneitem add
\n| `\/oneitem remove
\n| `\/oneitem info
\n| `\/oneitem scan` | Force a global scan |<\/p>\n
\n|——|———–|
\n| `\/oneitem randomExisting
\n| `\/oneitem randomOnline
\n| `\/oneitem give
\ncheck-interval-seconds: 180
\nindestructible-items: true<\/p>\n
\n – “MACE”<\/p>\n
\ndebug: false<\/p>\n","protected":false},"excerpt":{"rendered":"