Item Restrict by CraftersLand - Item Restrict - 物品限制管理

ItemRestrict 是一款用于创建物品限制列表的插件，它可以限制物品的拥有、使用、放置、拾取、酿造、穿戴、丢弃、烧炼、合成或从创造模式菜单获取。它还包含一个世界扫描器，用于移除已放置的受限方块。该插件最初为模组服务器设计，用于限制危险的物品。已在 MCPC 1.6.4 和 KCauldron 1.7.10 上经过充分测试，在较新版本中应该也能良好运行。

💡重要说明

此插件专为我的 1.6.4 和 1.7.10 模组服务器打造，旨在封禁有害物品。如果你仍在运行 1.6 或 1.7 的模组服务器，它非常适用。然而，自 Minecraft 1.9 起，数字 ID 被逐步移除，到 1.13 已完全废弃。由于本插件基于物品 ID 工作，因此针对更新版本进行升级已无意义。

• 我将不再为更新的 Minecraft 版本更新此插件。
• 由于时间有限，添加新功能的可能性也较小。
• 插件源代码已开放，可供有需要的用户自行改进。

关联插件推荐：

• 若需将玩家数据（背包、末影箱、金钱、生命值、经验等）保存至 MySQL 数据库，或在服务器间同步数据，请查看我的另一款插件：MySQL Player Data Bridge。
• 若需将 Essentials 数据保存至 MySQL 数据库，或在服务器间同步 Essentials 数据，请考虑查看我的另一款插件：Essentials MySQL Storage Extension。

✨功能特性

核心功能

• 限制可应用于所有世界或特定世界。配置项 EnableOnAllWorlds: true 非常适合模组服务器，可防止玩家在自创维度中绕过限制。
• 包含可配置启用的世界扫描器，它在独立线程中扫描已加载区块以移除受限物品，不影响服务器性能。
• 限制列表基于物品 ID 保存，便于同时限制模组物品和原版物品。
• 可为每个受限物品提供自定义原因说明。
• 命令执行和与受限物品交互时，提供音效反馈。
• 所有聊天信息和前缀均可自定义，支持完整的颜色和格式代码。
• 尝试从地面拾取受限物品时，会产生粒子效果。

[-] 限制与已知问题

版本兼容性

• 在 Minecraft 1.9 及之后版本中，由于药水等物品共享相同的物品 ID 和数据值，而本插件使用物品 ID 和数值（而非 NBT 数据），因此无法再限制此类物品。
• 在 Spigot 1.12 的任何版本中，由于一个 Bug，无法从游戏中移除合成配方。请使用 CraftingBan 功能作为替代，直到问题修复。
• Bug 追踪链接：https://hub.spigotmc.org/jira/browse/SPIGOT-3308

🔧可限制的行为

• 拥有权 (Ownership)：核心限制，涵盖获取物品的多种方式。若玩家设法将其放入背包或尝试拾取，物品将被没收。
• 使用 (Usage)：阻止物品或已放置方块的使用。
• 合成 (Crafting)：可仅阻止合成，允许有绕过权限的玩家继续合成；或完全从游戏中移除合成配方。
• 烧炼 (Smelting)：可仅阻止烧炼，允许有绕过权限的玩家继续烧炼；或完全从游戏中移除烧炼配方。
• 放置 (Placement)：阻止特定方块的放置。
• 破坏方块 (Block break)：限制特定方块的破坏。
• 酿造 (Brewing)：阻止特定药水的酿造。
• 穿戴盔甲 (Wearing Armor)：阻止玩家穿戴特定盔甲。
• 创造模式 (Creative)：阻止通过创造模式菜单或鼠标中键获取特定物品。
• 拾取 (Pickup)：阻止物品的拾取。
• 丢弃 (Drop)：阻止特定物品的丢弃。
• 世界封禁 (World Banned)：使用世界扫描器移除地图上已放置的方块。

🎮安装与配置

安装步骤

• 将插件放入服务器的 plugins 文件夹。
• 启动服务器以生成 config.yml 和 RestrictedItems.yml 配置文件，然后停止服务器。
• 打开 config.yml 自定义设置，然后打开 RestrictedItems.yml 添加物品到限制列表。配置文件中包含大量关于设置和如何添加物品的详细说明。
• 启动服务器。完成，你的服务器现在已受到保护。

如何添加受限物品？

• 打开 RestrictedItems.yml 配置文件，按照其中的详细说明添加物品。
• 保存更改后，运行命令 /itemrestrict reload 以应用更改。

⭐权限系统

基础权限

• ItemRestrict.bypass：绕过所有限制。
• ItemRestrict.admin：绕过物品限制，并可使用 /itemrestrict reload 命令。默认 OP 拥有此权限。

针对特定物品的例外权限

权限结构：ItemRestrict.bypass.<itemID>.<dataValue>.<restrictionType>

限制类型 (restrictionType)：

• use | place | break | craft | smelt | brew | creative | own | wear | drop | pickup

示例：

• ItemRestrict.bypass.57.*.place
• ItemRestrict.bypass.57.*.craft
• ItemRestrict.bypass.57..
• ItemRestrict.bypass.57.10.own
• ItemRestrict.bypass.57.10.*

🔧命令列表

• /itemrestrict 或 /itemrestrict help：显示帮助页面。
• /itemrestrict reload：重载 config.yml 和 RestrictedItems.yml 配置文件。需要权限：ItemRestrict.admin

❓配置示例

config.yml 概览

General:
  # 在所有世界启用限制。(true 或 false)
  EnableOnAllWorlds: true
  # 如果 EnableOnAllWorlds: false | 仅在以下世界启用限制：
  Worlds:
    - world
    - test

# 启用世界扫描器。(true 或 false) # 每分钟运行一次，扫描 5% 的已加载区块。
WorldScannerON: false
# 世界扫描器扫描延迟（分钟）。默认 1 分钟。
WorldScannerDelay: 1

# 启用或禁用音效。
Sounds:
  # 启用或禁用执行命令时的音效。(true 或 false)
  onCommands: true
  # 启用或禁用应用限制时的音效。(true 或 false)
  onRestrictions: true

# 启用或禁用可选限制。(true 或 false)
Restrictions:
  # 酿造台限制。阻止药水酿造。
  EnableBrewingBans: false
  # 限制特定盔甲的穿戴。
  ArmorWearingBans: false
  # 创造模式封禁。
  CreativeBans: false
  # 拾取封禁。
  PickupBans: false
  # 丢弃封禁。
  DropBans: false
  # 方块破坏封禁。
  BreakBans: false

# 其他可选设置
Settings:
  # 对于拥有权限制 - 限制仅应用于玩家背包，而非所有容器。(true 或 false)
  # 如果你使用某些包含受限物品的菜单，并希望防止玩家无法使用菜单，请将此设为 true。
  OwnershipPlayerInvOnly: false

# 聊天信息。支持颜色和格式代码。
# Minecraft 颜色与格式代码：http://minecraft.gamepedia.com/Formatting_codes
chatMessages:
  # 聊天信息前缀。
  # 要禁用前缀，请设置为 ''； 例如：prefix: ''
  prefix: '&4&l[ItemRestrict] '
  # 聊天信息。
  # 占位符 %reason 将被替换为 RestrictedItems.yml 中提供的原因。
  noPermission: '&cYou do not have permission!'
  restrictedConfiscated: '&cRestricted item confiscated! Reason: &7%reason'
  # ... (其他消息字段)

RestrictedItems.yml 格式说明

# 如何添加物品到限制列表？示例如下：
# - itemID:dataValue:Description:BannedReason
#
# itemID      -> 物品 ID
# DataValue   -> 物品损害值，使用 * 覆盖所有值
# Description -> 可输入任意内容，建议输入物品名称以便识别
# BannedReson -> (可选) 提供原因，当玩家尝试获取/交互时会看到此原因。
#
# 示例：
# - 7:*:Bedrock:You can't get this item!
# - 383:50:CreeperEgg:Used to grief

配置文件内包含详细的分类列表示例，如 OwnershipBanned、UsageBanned 等，请根据注释进行配置。

⭐附注

• 本插件的灵感来源于流行的 TekkitCustomizer 插件。为了满足我们的特定需求并更新功能，我们从零开始编码了此插件，并加入了新的选项。
• 如果你喜欢这个资源并想通过捐赠表示感谢，请使用 PayPal 按钮。谢谢！
• 本插件由 CraftersLand Minecraft Community 制作。欢迎访问：www.craftersland.net