- 版权类型
- 原创
- 插件中文名称
- itemsadder图片配置生成工具
- 插件英文名称
- ItemsAdderLoadPings
- 支持的核心（服务端）
- Paper
- 语言支持
- 中文（简体）
- 前置组件
- itemsadder
- 适配版本（Java）
- 1.20
ItemsAdderLoadPings 插件使用文档
插件功能
自动生成目录结构
首次加载时自动创建所需文件夹
生成默认模板文件 ui.yml
图片资源加载
支持批量加载 .png 图片
自动生成 ItemsAdder 兼容的配置文件
模板管理系统
支持自定义模板文件
实时重载模板配置
可视化操作反馈
详细的命令操作指引
首次加载时自动创建所需文件夹
生成默认模板文件 ui.yml
图片资源加载
支持批量加载 .png 图片
自动生成 ItemsAdder 兼容的配置文件
模板管理系统
支持自定义模板文件
实时重载模板配置
可视化操作反馈
详细的命令操作指引
安装步骤
将插件文件 ItemsAdderLoadPings.jar 放入服务器的 plugins/ 目录
重启服务器 (测试版本1.20.1 其他版本自测)
检查控制台输出，插件是否加载成功
重启服务器 (测试版本1.20.1 其他版本自测)
检查控制台输出，插件是否加载成功
命令列表
命令 | 权限 | 描述 |
|---|---|---|
/loadpng <文件夹名称> <模板名称> | op | 加载指定文件夹的图片资源 |
/loadpng reload | op | 重载所有模板配置 |
/loadpng help | 所有玩家 | 显示帮助信息 |
# 加载 Test1 文件夹的图片，使用 ui 模板
/loadpng Test1 ui
# 重载模板配置
/loadpng reload
/loadpng Test1 ui
# 重载模板配置
/loadpng reload
功能详解
1. 自定义图片加载
步骤:
在 picture_package 中创建新文件夹（如 Test1）
放入 .png 格式图片（文件名建议使用英文）
执行命令加载资源：
/loadpng Test1 ui
生成结果:
自动创建资源包结构
生成适配 ItemsAdder 的配置文件 ui.yml
插件自动把图片复制到正确纹理路径
在 picture_package 中创建新文件夹（如 Test1）
放入 .png 格式图片（文件名建议使用英文）
执行命令加载资源：
/loadpng Test1 ui
生成结果:
自动创建资源包结构
生成适配 ItemsAdder 的配置文件 ui.yml
插件自动把图片复制到正确纹理路径
2. 模板管理系统
默认模板 (moban/ui.yml)
自定义模板
1.在 moban 目录新建 .yml 文件（如 custom.yml）
2.按以下格式编写内容：
2.按以下格式编写内容：
配置指南
模板字段说明
字段 | 类型 | 描述 |
|---|---|---|
namespace | String | 资源命名空间（需唯一） |
path | String | 图片相对路径（自动填充） |
suggest_in_command | Boolean | 是否在命令提示中显示 |
y_position | Integer | 界面中的Y轴偏移量 |
常见问题
Q1: 图片加载后游戏内不显示
检查 ItemsAdder 是否正确加载资源包
确认图片文件名没有特殊字符
Q2: 模板文件修改无效
使用 /loadpng reload 重载配置
检查 YAML 格式是否正确（可用校验工具）
检查 YAML 格式是否正确（可用校验工具）
Q3: 插件无法生成目录
检查服务器文件写入权限
确保磁盘有足够空间
确保磁盘有足够空间
技术支持
开发者QQ: 2865348875
定制开发: 支持功能定制、问题修复
更新通知: 定期优化功能，请关注更新日志
定制开发: 支持功能定制、问题修复
更新通知: 定期优化功能，请关注更新日志
开源协议
本插件代码仅供学习交流使用
未经许可禁止商业用途
二次开发需保留原作者信息
祝您使用愉快！遇到问题随时联系技术支持
未经许可禁止商业用途
二次开发需保留原作者信息
祝您使用愉快！遇到问题随时联系技术支持
