🔒 BlockLocker

BlockLocker 是一款 Minecraft 插件，它允许玩家通过简单地在箱子、门、熔炉、发射器、投掷器、漏斗等方块上附加告示牌来保护它们。只有告示牌上列出的人才能访问受保护的容器。它不使用数据库，所有信息都存储在附加到受保护方块的告示牌上。

✨ 特性

• 通过附加告示牌轻松保护箱子、门等。
• 无需数据库，插件只需查找附加的告示牌。
• 允许其他玩家访问您的保护。
• 允许群组访问您的保护。
  • 群组使用权限节点、计分板队伍或使用受支持的插件（如 Factions 和 Towny）定义。
• UUID 支持
  • 玩家可以更改他们的名字，而不会失去对其受保护方块的访问权限。
  • 以不可见的方式在告示牌上存储 UUID，因此 UUID 会在服务器重启之间保存。
• 支持双开门和双箱子（也包括双陷阱箱）：您只需要一个告示牌来保护两个方块。
• 向放置箱子的玩家显示消息，以便他们知道箱子可以受到保护。
• 当添加 [Timer:X] 标签时，或当在配置文件中指定了默认的门关闭时间时，自动关闭门。
• 如果所有者在 X 天内未登录，则自动让保护过期。（默认禁用。）

🧱 红石支持

• 红石装置无法打开受保护的门，除非添加了 [Redstone] 标签。
• 漏斗（矿车漏斗也一样！）无法取出或放入物品，除非添加了 [Redstone] 标签。

📢 更新通知

• 当有 BlockLocker 更新可用时，服务器所有者会收到通知。
• 更新检查器异步工作，它永远不会阻塞服务器。
• 当然，可以关闭更新检查器。

⚙️ 配置

• 添加额外的方块，例如 TNT、拉杆或音符盒。
• 您可以设置“可附加”的方块（如拉杆）可以通过将告示牌附加到拉杆所附加的方块上来保护（无需将告示牌放在拉杆本身上！）
• 所有消息都可以翻译。
• 在服务器运行时使用 /blocklocker reload 重新加载配置文件。

📚 文档（用法、配置、权限和命令）

请参阅文档选项卡。

🐛 Bug 报告

如果您发现了 Bug，请报告！您可以在论坛帖子或 Github 上报告。请提供我可以重现 Bug 的说明。

❓ 常见问题 (FAQ)

我该如何更改消息、[Private] 和 [More Users] 的配色方案？

打开 plugins/BlockLocker/translations-en.yml（如果您使用其他语言，请打开该文件），并添加/删除颜色代码。例如，private: "&9[Private]" 会生成一个蓝色的 [Private] 标签。您可以根据需要使其变得高级，例如查看这个网站，该网站会生成颜色渐变。

漏斗无法将物品放入/取出受保护的箱子。我该如何修复？

在告示牌上添加一行文字 [Redstone] 或 [Everyone]。

漏斗可以将物品放入/取出受保护的箱子。我该如何修复？

这不是由 BlockLocker 引起的，而是由于在您的 paper-global.yml 文件（在 config 文件夹中）中将 hopper.disable-move-event 设置为 true 引起的。如果设置为 true，则插件无法再对漏斗中的物品移动做出反应。因此您需要将其设置为 false，没有其他解决方法。

如何禁用告诉玩家如何保护箱子的消息？

打开 plugins/BlockLocker/translation-en.yml 文件（如果您使用其他语言，请打开该文件），并将 protection.chest_hint 设置为两个引号：""。配置文件使用 YAML 格式，这两个引号表示消息为空。

旧的 Minecraft 版本是否受支持？

不支持，但在实践中仍然有效。如果无效，只需下载 BlockLocker 的旧版本。您可以使用以下列表来选择所需的版本号：

• Minecraft 1.20: 使用 BlockLocker 1.12.1
• Minecraft 1.18 和 1.19: 使用 BlockLocker 1.12
• Minecraft 1.14.4 到 1.17: 使用 BlockLocker 1.11
• Minecraft 1.14.0 到 1.14.3: 使用 BlockLocker 1.6
• Minecraft 1.13: 使用 BlockLocker 1.5
• Minecraft 1.12: 使用 BlockLocker 1.3.4
• Minecraft 1.9 到 1.11: 使用 BlockLocker 1.3.3
• Minecraft 1.8: 使用 BlockLocker 1.2.0.0
• 更早的版本：BlockLocker 尚未存在

我从配置文件中删除了所有的门/容器/可附加物，最终得到一个空列表。但是，这似乎没有任何效果。我该怎么办？

YAML（大多数 Spigot 插件使用的配置文件格式）只有在使用带有 [ 和 ] 的特殊格式时才接受空列表。像这样：

protectableDoors: []

📜 权限节点

• blocklocker.lock - 允许玩家创建锁。
• blocklocker.unlock - 允许玩家解锁任何锁。
• blocklocker.admin - 允许玩家绕过所有锁。
• blocklocker.break - 允许玩家破坏任何锁。
• blocklocker.update - 允许玩家更新 BlockLocker。
• blocklocker.reload - 允许玩家重新加载 BlockLocker 的配置。

⌨️ 命令

• /blocklocker reload - 重新加载 BlockLocker 的配置。

📄 配置文件

#
# Configuration file for BlockLocker
#
# Here are some examples.
#
# Example 1: adding more blocks that can be protected:
# protectableBlocks:
#   - minecraft:dispenser
#   - minecraft:dropper
#   - minecraft:hopper
#
# Example 2: adding a block that can be attached to:
# attachableBlocks:
#   - minecraft:lever
#   - minecraft:stone_button
#
# Example 3: renaming the [Private] tag:
# privateTag: "[Geheim]"
#
# Example 4: setting the default close time for doors to 5 seconds:
# autoDoorCloseTime: 5
#
# Example 5: making note blocks protectable, but only by attaching a sign to
#          a nearby block:
# protectableBlocks:
#   - minecraft:note_block
# mustAttachToNearbyBlock:
#   - minecraft:note_block
#
# Example 6: show a hint to players that they can protect their chests:
# protection.chest_hint: "Place a sign with [Private] on the side of this chest to protect it."
#
# Example 7: disable the update checker:
# updateChecker.enabled: false
#
# Example 8: limit the maximum amount of signs a player can create:
# maxSignCount: 10
#
# Example 9: automatically remove protections if the owner hasn't logged in for 30 days:
# autoRemoveDays: 30

# The tag on the first line of the sign.
privateTag: "[Private]"

# The tag on the second line of the sign for adding more users.
moreUsersTag: "[More Users]"

# Which blocks can be protected?
protectableBlocks:
  - minecraft:chest
  - minecraft:trapped_chest
  - minecraft:barrel
  - minecraft:shulker_box
  - minecraft:furnace
  - minecraft:blast_furnace
  - minecraft:smoker
  - minecraft:door
  - minecraft:oak_door
  - minecraft:spruce_door
  - minecraft:birch_door
  - minecraft:jungle_door
  - minecraft:acacia_door
  - minecraft:dark_oak_door
  - minecraft:mangrove_door
  - minecraft:cherry_door
  - minecraft:bamboo_door
  - minecraft:iron_door
  - minecraft:fence_gate
  - minecraft:oak_fence_gate
  - minecraft:spruce_fence_gate
  - minecraft:birch_fence_gate
  - minecraft:jungle_fence_gate
  - minecraft:acacia_fence_gate
  - minecraft:dark_oak_fence_gate
  - minecraft:mangrove_fence_gate
  - minecraft:cherry_fence_gate
  - minecraft:bamboo_fence_gate
  - minecraft:campfire
  - minecraft:loom
  - minecraft:grindstone
  - minecraft:stonecutter
  - minecraft:cartography_table
  - minecraft:smithing_table
  - minecraft:fletching_table
  - minecraft:lectern
  - minecraft:barrel
  - minecraft:beehive
  - minecraft:bee_nest
  - minecraft:decorated_pot

# Which blocks can be attached to?
attachableBlocks:
  - minecraft:lever
  - minecraft:stone_button
  - minecraft:oak_button
  - minecraft:spruce_button
  - minecraft:birch_button
  - minecraft:jungle_button
  - minecraft:acacia_button
  - minecraft:dark_oak_button
  - minecraft:mangrove_button
  - minecraft:cherry_button
  - minecraft:bamboo_button
  - minecraft:ender_chest
  - minecraft:gate

# If a block is in this list, then you must attach the sign to a nearby block,
# instead of being able to attach it to the block itself.
#
# For example, you may want to put note blocks in this list.
# Then players can protect note blocks too, but they need to put the sign on
# the block below the note block.
mustAttachToNearbyBlock: []

# If you place a [Timer:X] tag on a door, the door will automatically close after
# X seconds.
#
# This setting can be used to set the default time in seconds.
# If you don't want this, then set it to 0.
autoDoorCloseTime: 0

# If a player hasn't logged in for X amount of days, then automatically remove
# his protections.
#
# Set to 0 to disable this feature.
autoRemoveDays: 0

# Allows you to disable the usage of colors on signs
disableSignColors: false

# Max sign count a player can create
maxSignCount: 0

# Should the BlockLocker messages be hidden?
# If set to true, it hides every message except for errors and warnings.
quiet: false

# Update checker settings.
updateChecker:
  # Whether the update checker is enabled.
  enabled: true
  # How often (in hours) the update checker should run.
  checkInterval: 24