PortableChests 仿原版容器运输插件 我的世界1.20服务器插件

共计 2944 个字符，预计需要花费 8 分钟才能阅读完成。

版本说明
本插件目前仅支持运行在 1.20 及以上版本的服务器，不再兼容早期版本。

插件描述
箱子虽可在家中随意摆放，却总难找到完美位置。借助本插件，您可直接拆除并移动箱子至任意地点，无需手动转移其中物品，彻底告别繁琐的搬运流程。

适用场景：
用于插件的FAQ或功能介绍，解释其“轻量无侵入”的设计理念，适合希望保持原版体验的Minecraft服务器管理员。

功能特点

多容器支持：不仅适用于箱子，还兼容 漏斗、熔炉、木桶 等容器（完整列表请查看配置文件）。

智能物品展示：
容器物品会显示当前容纳的 物品堆叠数量（如“64×3”表示3组满叠物品）。
同时展示容器内 最多4种物品的图标（如小麦、钻石、木炭等），便于快速识别内容。

内容相同的容器是否可堆叠

自定义嵌套层数限制

可自定义的传统容器携带惩罚机制

关于潜影盒的说明
传统容器（如箱子）在携带时会施加负面效果，但潜影盒不受此限制！

惩罚机制
自定义惩罚规则
您可通过编辑配置文件调整惩罚类型及强度，支持所有原版药水效果（如缓慢、虚弱）。
配置文件中已提供**药水效果类型列表（PotionEffectType）**及示例，直接修改数值即可生效。
附魔要求
工具附魔配置
可自定义“搬运工具”必须拥有的附魔（如精准采集、效率），只有携带指定附魔的工具破坏容器时，才会掉落可搬运的完整容器。
可用附魔列表
支持原版所有附魔类型（完整列表见配置文件），例如：
minecraft:efficiency（效率）
minecraft:silk_touch（精准采集）

Default Config File

“`yaml
# 配置文件版本（请勿手动修改）
config-version: 1.3

# 可设为可搬运的容器
portable-barrels: true # 木桶
portable-blast-furnaces: true # 高炉
portable-brewing-stands: true # 酿造台
portable-chests: true # 箱子
portable-dispensers: true # 发射器
portable-droppers: true # 投掷器
portable-furnaces: true # 熔炉
portable-hoppers: true # 漏斗
portable-smokers: true # 烟熏炉

# 内容完全相同的容器是否可以堆叠？
allow-stacking: false

# 容器嵌套层数限制（0=禁用嵌套）
# 1=容器内放容器，2=容器内放容器再放容器，依此类推…
max-nesting: 0

# 潜影盒专用嵌套层数限制
shulker-max-nesting: 0

# 当达到嵌套层数限制时发送给玩家的提示
nesting-limit-message: §c已达到最大嵌套层数！

# 当玩家背包携带可搬运容器时施加的药水效果（潜影盒仅在包含可搬运容器时触发）
# 药水效果类型列表：https://jd.papermc.io/paper/1.21.4/org/bukkit/potion/PotionEffectType.html
# !! 请将链接中的 1.21.4 替换为你的服务器版本 !!
# 格式：<效果类型>: <等级>
penalties:
#– 1.21.4 版本示例 —
# SLOWNESS: 1 # 缓慢
# MINING_FATIGUE: 0 # 挖掘疲劳

# 惩罚效果持续时间（数字越大持续时间越长，单位：游戏刻）
penalty-duration: 50

# 惩罚效果更新频率（数字越小更新越快，过低可能导致卡顿！）
penalty-update: 25

# 工具所需的附魔（仅支持单个附魔）
# 附魔类型列表：https://jd.papermc.io/paper/1.21.4/org/bukkit/enchantments/Enchantment.html
# !! 请将链接中的 1.21.4 替换为你的服务器版本 !!
# 格式：<附魔类型>: <等级>
enchantment-required:
#– 1.21.4 版本示例 —
# SILK_TOUCH: 1 # 精准采集

# 是否忽略有自定义名称的物品？如果关闭，自定义名称物品也可搬运
ignore-custom-named: false

# 允许生成可搬运容器的世界
create-in-worlds:
– world # 主世界
– nether # 下界
– end # 末地

# 允许放置可搬运容器的世界
place-in-worlds:
– world
– nether
– end

# 当玩家在不可放置的世界尝试时的提示
world-cannot-place-message: §c你无法在这个世界放置可搬运容器！

# 仅限 1.21.4+ 版本
# 是否允许将可搬运容器放入捆包？
# 启用后每个捆包可容纳64个容器，且容器内可放捆包（慎用！）
allow-bundles: false

# 捆包放置限制提示
bundle-cannot-place-message: §c你无法将可搬运容器放入捆包！
“`

### 格式说明：
1. 保留 YAML 结构，`#` 后使用中文注释
2. 游戏机制术语（如”潜影盒”）采用官方中文译名
3. 版本号（1.21.4）和超链接保留英文避免混淆
4. 颜色代码（如§c）保留原始格式
5. 危险操作添加”！”和”慎用”等警示符号
6. 列表项添加中文游戏世界名称说明（主世界/下界/末地）

权限说明

# 权限节点树：cyanogenoid.portablechests.*
# ——————————
cyanogenoid.portablechests.create
description: 允许破坏容器时生成可搬运容器（保留内容）
default: true # 默认所有玩家拥有此权限

cyanogenoid.portablechests.create.anywhere
description: 允许在任何世界生成可搬运容器（无视 create-in-worlds 配置）
default: false # 默认仅OP可用

cyanogenoid.portablechests.place.anywhere
description: 允许在任何世界放置可搬运容器（无视 place-in-worlds 配置）
default: false

cyanogenoid.portablechests.penalty.skip
description: 免疫携带可搬运容器时的负面效果（如缓慢）
default: false

cyanogenoid.portablechests.enchantment.skip
description: 无视工具附魔要求（无需精准采集即可搬运）
default: false

使用案例演示
场景描述：
骷髅刷怪塔持续产出大量骨头和箭矢，如何高效整理？

操作流程：

自动化收集
在刷怪塔底部放置漏斗 → 连接箱子，自动收集战利品。
移动式仓储
用带精准采集的镐破坏箱子 → 获得可搬运的完整箱子（内含骨头/箭矢）。
分类运输
将装满箭矢的箱子通过矿车运至箭矢仓库，骨头箱子运至肥料加工站。
嵌套管理（需开启嵌套功能）
将同类箱子放入潜影盒 → 标注标签如“§a箭矢储备 §7(12箱)”。
优势：

无需手动清空箱子，保留完整物品堆叠
支持跨维度运输（如从下界刷怪塔直达主世界仓库）
管理员可通过权限控制玩家操作范围

MIT许可证

提示：两种下载方式，百度网盘&赞助链接丨支持网站可点移动云链接，缺点是有广告，优势是速度很快(,,・ω・,,)