OneItem
一款严格的执行插件,确保服务器上的物品唯一性。
仅一件。无重复。无漏洞利用。
概述
OneItem 是一款轻量但功能强大的 Minecraft 服务器插件,它强制执行一条简单却绝对的规则:
对于每个配置的物品类型,整个服务器上只能存在一个实例。
OneItem 最初设计用于控制强大或传奇物品(如 Mace),但它完全可配置,并适用于 任何原版 Minecraft 物品 —— 从木剑到终局神器均可。
该插件持续监控玩家背包、容器、掉落物以及合成行为,以确保不存在重复物品,并在必要时安全地追踪和恢复合法的唯一物品。
核心概念
- 每种被追踪的物品类型(例如
MACE)只能有 一个合法实例
- 第一个被合成或分配的物品将成为 唯一物品
- 任何额外的副本都会 被自动删除
- 只要唯一物品存在,合成即被禁用
- 如果唯一物品丢失,OneItem 会智能地将其恢复
这使得 OneItem 非常适合以下场景:
- 拥有传奇物品的生存服务器
- RPG / 剧情向服务器
- 活动奖励
- 硬核或挑战型服务器
- 注重经济或平衡性的玩法
功能
物品唯一性执行
- 每种物品仅限一个,全服范围生效
- 支持 任何原版物品
- 可通过
config.yml 或命令完全配置
- 在所有世界中均有效
合成控制
- 仅在 不存在唯一实例 时,玩家才可以合成该物品
- 第一次合成 即锁定该物品为唯一物品
- 所有后续的合成尝试都会被自动阻止
全局物品追踪
OneItem 扫描以下内容:
- 玩家背包
- 末影箱
- 容器(箱子、 barrels、熔炉等)
- 潜影盒(包括嵌套存储)
- 已加载区块中的掉落物
任何 不是合法唯一物品 的重复项都会被立即移除。
智能恢复系统
如果唯一物品丢失(被删除、消失、清空等):
- 它将恢复到:
- 最后已知持有者(如果在线),或者
- 最后已知的容器,或者
- 一个安全的位置
离线安全规则
如果唯一物品最后已知位于 离线玩家 的背包中:
- 插件假定它仍然存在
- 不会进行恢复或生成重复项
- 防止玩家重新加入时出现虚假重复
不可破坏模式(可选)
为唯一物品提供可配置的防护:
受控转移
为防止滥用或复制:
- 唯一物品 无法被丢弃
- 物品只能通过 容器 进行转移
这确保了所有权的安全且有意义的转移。
管理员解决工具
如果在一台已有重复物品的服务器上安装 OneItem:
管理员可以选择如何解决冲突:
- 随机现有持有者
- 随机在线玩家
- 指定玩家(手动分配)
其他所有副本将被自动移除。
命令
主命令:/oneitem
别名:/oi, /onei
权限:oneitem.admin(默认:OP)
核心命令
| 命令 |
描述 |
/oneitem help |
显示帮助菜单 |
/oneitem list |
列出所有被追踪的唯一物品 |
/oneitem add <ITEM> |
将某物品标记为唯一物品 |
/oneitem remove <ITEM> |
停止追踪某物品 |
/oneitem info <ITEM> |
显示详细状态 |
/oneitem scan |
强制进行全局扫描 |
重复项解决
| 命令 |
描述 |
/oneitem randomExisting <ITEM> |
随机保留一个现有的副本 |
/oneitem randomOnline <ITEM> |
分配给随机在线玩家 |
/oneitem give <ITEM> <player> |
将唯一物品给予某玩家 |
配置
配置文件会自动生成。
check-interval-seconds: 180
indestructible-items: true
tracked-items:
- "MACE"
message-prefix: "&6[OneItem]&r "
debug: false
OneItem
A strict enforcement plugin that guarantees true item uniqueness on your server.
Only one item. No duplicates. No exploits.
Overview
OneItem is a lightweight but powerful Minecraft server plugin that enforces a simple yet absolute rule:
For each configured item type, only ONE instance may exist on the entire server.
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 — from wooden swords to end-game artifacts.
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.
Core Concept
- Each tracked item type (e.g.
MACE) may have only one legitimate instance
- The first crafted or assigned item becomes the unique item
- Any additional copies are automatically deleted
- Crafting is disabled as long as the unique item exists
- If the unique item is lost, OneItem restores it intelligently
This makes OneItem ideal for:
- Survival servers with legendary items
- RPG / lore-based servers
- Event rewards
- Hardcore or challenge servers
- Economy or balance-focused gameplay
Features
Item Uniqueness Enforcement
- One item per type, server-wide
- Supports any vanilla item
- Fully configurable via
config.yml or commands
- Works across all worlds
Crafting Control
- Players may craft the item only if no unique instance exists
- The first craft claims the item
- All future crafting attempts are blocked automatically
Global Item Tracking
OneItem scans:
- Player inventories
- Ender chests
- Containers (chests, barrels, furnaces, etc.)
- Shulker boxes (including nested storage)
- Dropped items in loaded chunks
Any duplicate that is not the legitimate unique item is immediately removed.
Intelligent Recovery System
If the unique item is lost (deleted, despawned, cleared, etc.):
- It is restored to:
- The last known player (if online), or
- The last known container, or
- A safe fallback location
Offline Safety Rule
If the unique item was last known to be inside the inventory of an offline player:
- The plugin assumes it still exists
- No restoration or duplication occurs
- Prevents false duplicates when the player rejoins
Indestructible Mode (Optional)
Configurable protection for unique items:
- No durability loss
- Immune to fire, lava, and heat
- Prevents accidental destruction
Controlled Transfers
To prevent abuse or duplication:
- Unique items cannot be dropped
- Items can only be transferred via containers
- Chests
- Barrels
- Shulker boxes
- Furnaces, etc.
This ensures safe and intentional ownership transfer.
Admin Resolution Tools
If OneItem is installed on an existing server with duplicates:
Admins can choose how to resolve it:
- Random existing owner
- Random online player
- Specific player (manual assignment)
All other copies are removed automatically.
Commands
Main command: /oneitem
Aliases: /oi, /onei
Permission: oneitem.admin (default: OP)
Core Commands
| Command |
Description |
/oneitem help |
Show help menu |
/oneitem list |
List all tracked unique items |
/oneitem add <ITEM> |
Mark an item as unique |
/oneitem remove <ITEM> |
Stop tracking an item |
/oneitem info <ITEM> |
Show detailed status |
/oneitem scan |
Force a global scan |
Duplicate Resolution
| Command |
Description |
/oneitem randomExisting <ITEM> |
Keep one existing copy at random |
/oneitem randomOnline <ITEM> |
Assign to a random online player |
/oneitem give <ITEM> <player> |
Give the unique item to a player |
Configuration
The configuration file is generated automatically.
check-interval-seconds: 180
indestructible-items: true
tracked-items:
- "MACE"
message-prefix: "&6[OneItem]&r "
debug: false
评论 0
登录后参与评分
还没有评论,来抢沙发吧