RemoteContainers
一个轻量级的 Minecraft 插件,适用于 Bukkit、Spigot 和 Paper,允许玩家注册真实的实体容器并从任何地方远程打开它们。
功能
- 使用自定义名称注册真实容器
- 从任何地方远程打开已注册的容器
- 注册前提供与保护插件兼容的物理确认机制
- 支持箱子、 barrel(桶)、潜影盒、熔炉、漏斗、铜箱等更多类型
- 重命名和删除远程链接
- 列出已注册的容器
- 管理员可访问其他玩家的链接
- 每位玩家的注册数量限制
- 可配置支持的容器类型
- 多世界支持
- 可选加载未加载的区块
- 仅在远程库存打开时保持远处容器区块加载
- 自动清理过期链接
- 当已注册的容器被破坏或销毁时自动清理
- 完整的 Tab 补全支持
- 完全可配置的消息
- 无需数据库
- 无外部依赖
命令
/rc create <name>
/rc open <name>
/rc delete <name>
/rc rename <old> <new>
/rc list
/rc info <name>
/rc help
管理员命令
/rc open <player> <name>
/rc delete <player> <name>
/rc info <player> <name>
/rc list <player>
/rc reload
别名
/rc
/remotecontainers
/remotecontainer
/rcontainer
使用方法
直接注视一个受支持的容器并运行:
/rc create storage
默认情况下,RemoteContainers 会要求你右键点击该容器一次以确认注册。
之后,你可以从任何地方远程打开它:
/rc open storage
RemoteContainers 打开的是真实方块的实际库存。它不会创建虚拟副本。
如果容器位于远处或未加载的区块中,RemoteContainers 可以加载该区块,并在远程库存打开期间保持其加载状态。当库存关闭时,区块票证将被释放。
默认支持的容器
- 箱子 (Chest)
- 陷阱箱 (Trapped Chest)
- 铜箱 (Copper Chest)
- 裸露铜箱 (Exposed Copper Chest)
- 风化铜箱 (Weathered Copper Chest)
- 氧化铜箱 (Oxidized Copper Chest)
- 所有上蜡铜箱变体
- 桶 (Barrel)
- 漏斗 (Hopper)
- 发射器 (Dispenser)
- 投掷器 (Dropper)
- 熔炉 (Furnace)
- 高炉 (Blast Furnace)
- 烟熏炉 (Smoker)
- 酿造台 (Brewing Stand)
- 合成器 (Crafter)
- 所有颜色的潜影盒 (Shulker Box)
列表可在 config.yml 中进行配置。
铜箱
RemoteContainers 在包含铜箱的 Minecraft 版本中支持铜箱。
RemoteContainers 通过名称解析容器材质,因此在旧版本中,如果这些方块不存在,配置文件中的铜箱条目会被安全忽略。
注册的铜箱如果在以下情况下,链接仍然有效:
所有铜箱的氧化和上蜡状态均被视为同一物理容器家族。
权限
remotecontainers.use
remotecontainers.create
remotecontainers.open
remotecontainers.delete
remotecontainers.rename
remotecontainers.list
remotecontainers.info
remotecontainers.others
remotecontainers.reload
remotecontainers.limit.bypass
基本权限默认对所有用户开放。
管理权限默认仅对操作员开放。
配置
重要默认值:
max-containers-per-player: 10
create-target-distance: 6
require-physical-confirmation: true
confirmation-timeout-seconds: 30
load-unloaded-chunks: true
allow-shared-links: false
open-cooldown-seconds: 1
使用:
max-containers-per-player: 0
可实现无限注册的容器。
消息可在 messages.yml 中自定义。
数据
远程容器链接存储在:
plugins/RemoteContainers/containers.yml
每条记录存储:
- 所有者 UUID
- 所有者名称
- 链接名称
- 世界 UUID 和名称
- X / Y / Z 坐标
- 注册的方块材质
- 创建时间戳
RemoteContainers 存储的是真实容器的位置,而不是其库存的副本。
兼容性
单个 JAR 文件旨在支持以下范围:
| Minecraft |
CraftBukkit |
Spigot |
Paper |
Java |
| 1.21.x |
Yes |
Yes |
Yes |
21+ |
| 26.1 / 26.1.x |
Yes |
Yes |
Yes |
25+ |
| 26.2 / 26.2.x |
Yes |
Yes |
Yes |
25+ |
运行时测试
- ✅ Spigot 1.21.1
- ✅ Paper 1.21
- ✅ Spigot 26.2
- ✅ Paper 26.2
支持范围内的其他版本设计为可用,但尚未全部进行单独的运行时测试。
支持与错误报告
如果您发现错误或有任何建议,请在 GitHub 仓库上提交 Issue。
报告错误时,请包括:
- Minecraft 版本
- 服务器软件及版本(CraftBukkit、Spigot 或 Paper)
- RemoteContainers 版本
- 重现问题的步骤
- 相关的控制台错误或堆栈跟踪
请在创建新 Issue 之前检查现有的问题。
许可证
RemoteContainers 采用 MIT License 授权。
RemoteContainers
A lightweight Minecraft plugin for Bukkit, Spigot, and Paper that lets players register real in-world containers and open them remotely from anywhere.
Features
- Register real containers with custom names
- Open registered containers remotely from anywhere
- Protection-friendly physical confirmation before registration
- Supports chests, barrels, shulker boxes, furnaces, hoppers, Copper Chests, and more
- Rename and delete remote links
- List registered containers
- Admin access to other players' links
- Per-player registration limits
- Configurable supported container types
- Multi-world support
- Optional loading of unloaded chunks
- Keeps distant container chunks loaded only while their remote inventory is open
- Automatic stale-link cleanup
- Automatic cleanup when registered containers are broken or destroyed
- Full tab completion
- Fully configurable messages
- No database required
- No external dependencies
Commands
/rc create <name>
/rc open <name>
/rc delete <name>
/rc rename <old> <new>
/rc list
/rc info <name>
/rc help
Admin commands
/rc open <player> <name>
/rc delete <player> <name>
/rc info <player> <name>
/rc list <player>
/rc reload
Aliases
/rc
/remotecontainers
/remotecontainer
/rcontainer
How to Use
Look directly at a supported container and run:
/rc create storage
By default, RemoteContainers will ask you to right-click that same container once to confirm the registration.
After that, you can open it remotely from anywhere:
/rc open storage
RemoteContainers opens the actual inventory of the real block. It does not create a virtual copy.
If the container is in a distant or unloaded chunk, RemoteContainers can load the chunk and keep it loaded only while the remote inventory is open. The chunk ticket is released again when the inventory closes.
Default Supported Containers
- Chest
- Trapped Chest
- Copper Chest
- Exposed Copper Chest
- Weathered Copper Chest
- Oxidized Copper Chest
- All waxed Copper Chest variants
- Barrel
- Hopper
- Dispenser
- Dropper
- Furnace
- Blast Furnace
- Smoker
- Brewing Stand
- Crafter
- All Shulker Box colors
The list is configurable in config.yml.
Copper Chests
Copper Chests are supported on Minecraft versions that include them.
RemoteContainers resolves container materials by name, so Copper Chest entries in the default config are safely ignored on older versions where those blocks do not exist.
A registered Copper Chest also remains linked if it:
- oxidizes naturally
- is waxed
- is scraped with an axe
- has its wax removed
All Copper Chest oxidation and wax states are treated as the same physical container family.
Permissions
remotecontainers.use
remotecontainers.create
remotecontainers.open
remotecontainers.delete
remotecontainers.rename
remotecontainers.list
remotecontainers.info
remotecontainers.others
remotecontainers.reload
remotecontainers.limit.bypass
Basic permissions default to everyone.
Administrative permissions default to operators.
Configuration
Important defaults:
max-containers-per-player: 10
create-target-distance: 6
require-physical-confirmation: true
confirmation-timeout-seconds: 30
load-unloaded-chunks: true
allow-shared-links: false
open-cooldown-seconds: 1
Use:
max-containers-per-player: 0
for unlimited registered containers.
Messages can be customized in messages.yml.
Data
Remote container links are stored in:
plugins/RemoteContainers/containers.yml
Each record stores:
- owner UUID
- owner name
- link name
- world UUID and name
- X / Y / Z coordinates
- registered block material
- creation timestamp
RemoteContainers stores the location of the real container, not a copy of its inventory.
Compatibility
One JAR is designed for the following range:
| Minecraft |
CraftBukkit |
Spigot |
Paper |
Java |
| 1.21.x |
Yes |
Yes |
Yes |
21+ |
| 26.1 / 26.1.x |
Yes |
Yes |
Yes |
25+ |
| 26.2 / 26.2.x |
Yes |
Yes |
Yes |
25+ |
Runtime Tested
- ✅ Spigot 1.21.1
- ✅ Paper 1.21
- ✅ Spigot 26.2
- ✅ Paper 26.2
Other versions in the supported range are designed to work but have not all been individually runtime-tested.
Support and Bug Reports
If you find a bug or have a suggestion, please open an issue on the GitHub repository.
When reporting a bug, please include:
- Minecraft version
- Server software and version (CraftBukkit, Spigot, or Paper)
- RemoteContainers version
- Steps to reproduce the problem
- Relevant console errors or stack traces
Please check existing issues before creating a new one.
License
RemoteContainers is licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧