InvChest v1.5-SNAPSHOT 版本发布说明

版本亮点 ✨

本次更新是 InvChest 插件的首个完整功能版本，实现了完整的容器绑定与自动传输系统，特别新增了对16种语言的支持，让全球各地的服主和玩家都能使用自己熟悉的语言。

核心功能概述

🧩 容器绑定系统

支持容器类型：箱子、双箱、桶、陷阱箱、双陷阱箱
绑定方式：玩家瞄准容器执行 /invchest bind 或 /ic bind
智能解绑：容器被破坏时自动解绑，防止数据残留
权限管理：invchest.bind 权限用于绑定，invchest.admin 用于管理员操作

📦 物品传输系统

两种传输模式：
- all 模式：尝试转移所有物品，空间不足时掉落
- try 模式：按顺序转移，空间不足时停止
可配置间隔：默认30秒检查一次传输
传输上限：可配置单次最大传输物品数量

🛡️ 容器保护机制

访问限制：已绑定容器无法被其他玩家打开
漏斗控制：允许输入，禁止输出
破坏保护：仅绑定玩家或管理员可破坏
红石信号：陷阱箱在传输时可产生红石脉冲（可配置开关）

多语言支持 🌍

新增支持的语言

中文系：简体中文（zh_cn）、繁体中文-台湾（zh_tw）、繁体中文-香港（zh_hk）
英语系：美式英语（en_us）、英式英语（en_gb）、澳大利亚英语（en_au）
亚洲语言：日语（ja_jp）、韩语（ko_kr）
欧洲语言：俄语（ru_ru）、德语（de_de）、法语（fr_fr）、意大利语（it_it）、西班牙语（es_es）、葡萄牙语（pt_pt）
其他语言：哈萨克语（kk_kz）、蒙古语（mn_mn）、阿拉伯语（ar_sa）

语言使用方式

静态模式：在 config.yml 中设置 lang: "zh_cn"（固定使用简体中文）
自动模式：设置 lang: "auto_en_us"（玩家按客户端语言显示，控制台使用美式英语）
回退机制：如果玩家语言不支持，自动回退到配置的默认语言

技术特性

🏗️ 架构设计

模块化：分离配置管理、语言系统、数据存储、事件监听等模块
扩展性：预留API接口，方便未来扩展
兼容性：支持 Bukkit、Spigot、Paper、Purpur、Folia（标注支持）

⚡ 性能优化

异步处理：传输操作在主线程安全执行
分页传输：避免一次性处理大量物品
数据缓存：减少重复文件读写操作

🔧 配置系统

# config.yml 主要配置项
transfer-interval: 30        # 传输间隔（秒）
transfer-mode: "all"        # 传输模式：all 或 try
max-bindings: 0             # 最大绑定数（0=无限制）
redstone-output-enabled: false  # 红石信号开关
state-update-enabled: true  # 容器状态更新开关
lang: "auto_en_us"          # 语言设置
debug-mode: false           # 调试模式

安装与使用

快速开始

下载 InvChest-1.5-SNAPSHOT.jar
放入服务器的 plugins/ 目录
重启服务器
编辑 plugins/InvChest/config.yml 调整配置
玩家使用 /invchest bind 绑定视线中的容器

管理员命令

# 为自己绑定容器
/invchest bind
/ic bind

# 为其他玩家绑定（需要管理员权限）
/invchest bind <玩家名>

# 重载配置
/invchest reload

兼容性说明

✅ 已测试支持

Minecraft 版本：1.12.x 及以上
服务器核心：Bukkit、Spigot、Paper、Purpur
调度系统：兼容 Folia（当前使用主线程安全调度）

🔄 未来扩展计划

原生 Folia 区域调度器支持
Sponge 核心适配
NeoForge/Fabric 模组平台支持
更多容器类型（铜质容器等）

注意事项

⚠️ 重要提示

首次运行会自动生成语言文件到 plugins/InvChest/lang/ 目录
修改语言文件后无需重启服务器，使用 /invchest reload 即可生效
绑定数据存储在 plugins/InvChest/bind.json 中，建议定期备份

🛠️ 故障排查

容器无法绑定：检查玩家是否有 invchest.bind 权限
物品不传输：确认容器未被锁定或损坏，检查调试日志
语言不显示：确保语言文件存在于运行目录而非JAR内

开发者信息

📄 开源协议

🏗️ 构建说明

# 使用 Maven 构建
mvn clean package -DskipTests

# 使用 Xget 镜像加速（已预配置）
# 镜像地址：https://xget.xi-xu.me/

🤝 贡献指南

欢迎提交 Issue 和 Pull Request，特别是：

新的语言翻译
兼容性改进
性能优化建议

本项目中包含AI生成内容，请不要将其二次投入AI训练！

InvChest 致力于为 Minecraft 服务器提供稳定、高效、易用的容器管理解决方案。如果您遇到任何问题或有功能建议，请在项目仓库中提交反馈。

祝您游戏愉快！ 🎮

Releases: OutHimic/InvChest

1.5-SNAPSHOT