Place Items On Ground [Rebuilt] - Place Items On Ground 物品放置插件

Place Items On Ground 插件已回归，并带来了更强大的功能！本插件与旧版本完全不兼容。它允许你将手中持有的任何物品放置在地面上，并支持在方块的所有六个面上进行放置。请注意，本插件通过隐形盔甲架实现功能，因此玩家可能会创建大量实体，但你可以通过多种方式限制数量。

💡重要须知

• 本插件与已停用的旧版本完全不兼容。
• 插件使用隐形盔甲架来放置物品，大量使用可能会产生较多实体。
• 已针对 WorldGuard、GriefPrevention 等领地插件进行兼容性优化，在领地内放置或移除物品通常没有问题。
• 活塞无法推动其附近或顶部有已放置物品的方块。

✨功能改进

相较于原版插件，本版本进行了大量优化

• 支持在方块的所有六个面（上、下、四周）放置物品。
• 可自定义聊天消息。
• 修复了大量错误。
• 提供了更多权限和自定义选项。
• 更详细地规定了哪些物品可以放置在哪些位置。
• 更强大、更灵活的配置文件。
• 更清晰的命令结构。
• 改进的存储系统。
• 更高效、灵活的代码。
• 更明确的错误和权限提示信息。

🔧使用方法

放置物品

• 执行指令 /placeitems toggle 来开启放置模式。
• 手持物品，潜行并对准任意方块右键点击。
• 成功后，手中的一个物品（若为堆叠物品则消耗一个）将被放置在地面上。

拾取物品

有两种方式可以拾取已放置的物品

• 方法一：破坏物品下方的支撑方块，物品会掉落。
• 方法二：直接右键点击已放置的物品。对于方块类物品很容易点击，对于小型物品，可能需要点击其放置位置稍前方一点。

🎮放置数量限制

玩家可放置的物品数量可以通过三种方式限制

• 全局默认限制：在配置文件中为所有玩家设置默认上限。
• 玩家个体限制：使用 /placeitems set <玩家名> <数量> 指令为特定玩家设置上限（使用 u 代表无限制）。
• 权限限制：使用权限插件授予玩家 placeitems.cap.# 权限（将 # 替换为具体数字）或 placeitems.cap.u（无限制）。

注意：权限限制的优先级高于通过指令设置的玩家个体限制。

⭐命令列表

所有功能都通过 /placeitems 命令及其参数实现。

基础命令

• /placeitems help - 显示命令帮助列表。
• /placeitems toggle - 切换玩家潜行放置物品的能力。
• /placeitems rightclicktoggle - 切换玩家通过右键点击拾取物品的能力。
• /placeitems siderotation <0-7> - 设置在方块侧面放置物品时的旋转角度。
• /placeitems set <玩家名> <数量> - 设置玩家可放置物品的数量上限（用 u 表示无限制）。
• /placeitems clear <半径> - 安全移除指定半径（1-250格）内所有已放置的物品。
• /placeitems reload - 重载插件配置文件。
• /placeitems restorecap <玩家名> - 将玩家的放置上限重置为默认值。
• /placeitems configname - 获取手中物品在配置文件中使用的名称。

危险命令（慎用）

• /placeitems purge <半径> - 用于修复因BUG导致无法放置物品的问题。

- **警告**：此命令会移除指定半径（1-250格）内**所有盔甲架**（包括非本插件创建的），并清除该区域内所有已记录的位置数据。请优先尝试使用 `clear` 命令。

• /placeitems playerdata <参数> <玩家名> (<参数>) (<参数>) - 允许直接操作玩家的数据文件。

- **警告**：操作不当可能导致意外结果！

⭐权限列表

以下权限定义来自 `plugin.yml`

• placeitems.help - 允许使用 /placeitems help。默认：true
• placeitems.toggle - 允许使用 /placeitems toggle。默认：true
• placeitems.rightclicktoggle - 允许使用 /placeitems rightclicktoggle。默认：true
• placeitems.siderotation - 允许使用 /placeitems siderotation。默认：true
• placeitems.place.top - 允许在方块顶部放置物品。默认：true
• placeitems.place.sides - 允许在方块侧面放置物品。默认：true
• placeitems.place.bottom - 允许在方块底部放置物品。默认：true
• placeitems.place - 允许在方块所有面放置物品。默认：true
• placeitems.take - 允许从地面拾取物品。默认：true
• placeitems.cap - 权限上限的基础权限。默认：true
• placeitems.set - 允许使用 /placeitems set 为其他玩家设置上限。默认：op
• placeitems.clear - 允许使用 /placeitems clear 清理物品（半径≤250）。默认：op
• placeitems.reload - 允许使用 /placeitems reload 重载配置。默认：op
• placeitems.configname - 允许使用 /placeitems configname 获取物品配置名。默认：op
• placeitems.purge - 允许使用 /placeitems purge 清理物品（半径≤250）。默认：op
• placeitems.playerdata - 允许使用 /placeitems playerdata 操作玩家数据文件。默认：op
• placeitems.worldblacklistbypass - 允许绕过世界黑名单。默认：op

❓多语言支持（v1.0.6+）

安装语言文件的步骤如下

• 从下方链接下载所需的语言文件。
• 将语言文件放入插件数据文件夹中（与英文文件 plugin_msgs_en.yml 同一目录，不要删除英文文件）。
• 修改配置文件 config.yml 中的第一行 languageFile，将其值改为下载的语言文件名。
• 重启服务器。

**可用语言**

• 中文（感谢 qsefthuopq 的翻译）

想要贡献翻译？ 请将翻译好的文件发送给作者，将会被列在此处！

🔧配置文件示例

以下是 config.yml 的核心部分概览：

常规设置

• languageFile: "plugin_msgs_en.yml" - 设置语言文件。
• defaultPlaceCap: 10 - 玩家默认放置上限（-1为无限制）。
• allowTopPlacing, allowSidePlacing, allowBottomPlacing - 分别控制是否允许在顶部、侧面、底部放置。
• worldBlacklist: - 禁止放置物品的世界列表（例如：world1, world2）。

黑名单系统

插件提供了细致的黑名单，用于控制哪些物品不能放置，以及哪些方块不能作为放置目标。列表根据物品类型（blacklistedItemsAll, blacklistedItemsTop 等）和方块类型（blacklistedPlaceItemsAll 等）进行划分，并区分了现代版本（1.13+）和旧版（legacy 前缀）的材料名。

**如何修改列表**

在对应列表中添加物品，使用 , 物品名 的格式（不加引号），并确保所有项目在同一行。物品名可参考 Spigot Material 列表。服务器不存在的物品名将被自动忽略。

特殊案例与实用列表

• itemLikeBlocks 和 blockLikeItems：处理那些在盔甲架上显示行为异常（如物品直立或嵌入地面）的特定方块和物品。
• includeBlocksThatCanMoveOrDisappear：若设为 true，将禁止在沙子、沙砾、TNT等会移动或消失的方块上放置物品。
• slabs, stairs：提供了游戏中所有台阶和楼梯的列表，方便你将其加入黑名单。

实验性功能与统计

• plotSquaredClear：与 PlotSquared 插件的清理功能联动。
• strictCompatibilityMode：严格兼容模式，启用后仅允许放置没有自定义显示名称或描述的物品/方块，用于解决与某些自定义物品插件的冲突。
• bStats: true - 启用匿名统计以帮助开发者了解插件使用情况，建议保持开启。

请勿修改 configVersion 值。