YeDeconix

叶倾仙 发表于 2025-6-25 02:33:46

本帖最后由叶倾仙于 2025-6-25 02:59 编辑

YeDeconix 物品分解与出售系统版本: v1.1.0
适用Minecraft版本: 1.12.2
作者: 叶子
联系方式: QQ 2128158509
最后更新: 2025年6月20日

插件概述
YeDeconix 是一款功能强大的物品分解与出售插件，提供以下核心功能：

本插件使用bStats收集匿名使用数据，用于改进插件开发。收集的数据包括：

- 插件版本
- 服务器版本
- Java版本

使用及默认您同意本插件收集相关内容！
您可以在config.yml中禁用此功能!

[*]自定义 GUI 界面 - 创建美观的交互界面
[*]物品分解系统 - 将物品分解为各种奖励
[*]物品出售系统 - 将物品出售换取游戏货币
[*]动态物品列表 - 实时显示玩家可分解/出售的物品
[*]MythicMobs 支持 - 兼容 MythicMobs 自定义物品
[*]Vault 经济集成 - 无缝对接服务器经济系统
[*]多语言消息配置 - 完全自定义所有提示消息
<blockquote>
服务器要求:
<ul><li>Minecraft 服务器 1.12.2-1.20.1</li><li><a href="https://dev.bukkit.org/projects/vault">Vault</a> (用于经济功能)</li><li><a href="https://www.spigotmc.org/resources/mythicmobs.5702/">MythicMobs</a> (可选，用于神话物品支持)</li><li><a href="https://www.spigotmc.org/resources/playerpoints.80745/">PlayerPoints</a> (可选，用于玩家点券功能)</li></ul>

安装指南基本安装步骤
[*]下载插件 JAR 文件
[*]将文件放入服务器的 plugins 目录
[*]重启服务器
[*]插件会自动生成配置文件目录：plugins/YeDeconix/

文件结构
plugins/YeDeconix/
├── config.yml # 主配置文件
├── messages.yml # 消息配置文件
├── decompose.yml # 分解物品配置
├── sellables.yml # 可出售物品配置
├── prices.yml # 物品价格参考
├── guis/ # GUI 配置目录
│ ├── decompose.yml # 分解界面
│ └── sell.yml # 出售界面
└── README.md # 本教程文件

初次配置
[*]修改 config.yml 设置插件前缀
[*]编辑 messages.yml 自定义提示消息
[*]配置 decompose.yml 添加可分解物品
[*]设置 sellables.yml 添加可出售物品
[*]使用 /yfj reload 重载配置
提示: 修改配置文件后记得重载！

命令使用
命令描述权限示例
/yfj显示帮助信息所有玩家/yfj
/yfj list列出所有可用界面所有玩家/yfj list
/yfj gui <界面名>打开指定界面所有玩家/yfj gui decompose
/yfj reload热重载配置（仅重载已修改文件）yedeconix.reload/yfj reload
/yfj reload full完全重载所有配置yedeconix.reload/yfj reload full
别名: 本插件命令也可使用 /yezi

配置文件详解config.yml

# 主配置文件version: 1.2
# 配置文件版本（请勿修改）
settings:prefix: "&8[&a叶分解&8] "
# 插件前缀（支持颜色代码）
debug: false # 调试模式（true时输出详细日志）

messages.yml
<div class="bbCodeBlock-content">
<pre class="bbCodeCodelanguage-yaml" dir="ltr" data-xf-init="code-block" data-lang="yaml" tabindex="0"><code class=" language-yaml"># 消息配置文件
version: 1.1# 配置文件版本（请勿修改）

# 基本消息
reload-success: "&a配置已重载！"
reload-hot: "&a配置已热重载 (跳过未修改文件)！"
batch-success: "&a成功分解了 &e{count} &a件物品！"
sell-success: "&a成功出售物品获得 &e{amount} &a金币！"
no-permission: "&c你没有权限执行此操作！"
inventory-full: "&c[叶子的小提示]&4&l背包已满，部分物品掉落在地面！"
no-match: "&c该物品无法分解或出售！"
reward-money: "&a获得金钱: &e{amount}"
reward-item: "&a获得物品: &e{item}"
reward-mythic: "&a获得神话物品: &e{item}"
reward-command: "&a已执行命令: &e{command}"
no-permission-reward: "&c你需要权限 &e{permission} &c来领取此奖励！"
reward-points: "&a获得点券: &e{points}"

# 分解物品列表配置
decomposable-list:
max-display-lines: 7# 最大显示行数
item-format: "&a▸ {name} &7(数量: &e{amount}&7)"# 物品格式
overflow-msg: "&8[&c!&8] &7还有 &c{count} &7项未显示..."# 溢出提示

# 出售物品列表配置
sellable-list:
max-display-lines: 5# 最大显示行数
item-format: "&a▸ {name} &7(单价: &e{price}&7)"# 物品格式
overflow-msg: "&8[&c!&8] &7还有 &c{count} &7项可出售..."# 溢出提示</code></pre>
 </div>decompose.yml
<div class="bbCodeBlock-content">
 <pre class="bbCodeCodelanguage-yaml" dir="ltr" data-xf-init="code-block" data-lang="yaml" tabindex="0"><code class=" language-yaml"># 分解物品配置
items:
超级神武:# 物品ID（自定义）
name: "&d超级神武"# 物品显示名称（支持颜色代码）
lore: # 物品Lore（支持多行）
 - "&a超级叶子！！"
permission: yedeconize.admin# 可选权限
rewards: # 奖励列表
 0: # 奖励1
 type: ITEM # 奖励类型：ITEM/COMMAND/MONEY/MYTHIC_ITEM
 value: "IRON_INGOT:2"# 奖励值（格式：物品:数量）
 permission: yedeconize.reward# 可选奖励权限
 1: # 奖励2
 type: MONEY
 value: "100" # 金钱数量

超级点券物品:
name: "&a点券礼包"
lore:
 - "&7内含大量点券"
rewards:
 0:
 type: POINTS# 点券
 value: "100"# 每次分解获得100点券
尚方宝剑:
name: "&d尚方宝剑"
lore: []# 空Lore
rewards:
 0:
 type: ITEM
 value: "GOLD_INGOT:3"</code></pre>
 </div> sellables.yml
<div class="bbCodeBlock-content">
 <pre class="bbCodeCodelanguage-yaml" dir="ltr" data-xf-init="code-block" data-lang="yaml" tabindex="0"><code class=" language-yaml"># 可出售物品配置
items:
钻石:
name: "&b钻石"
lore: []
rewards:
 0:
 type: MONEY
 value: "100"# 出售单价
 1:
 type: ITEM
 value: "COAL:1"# 额外奖励

金锭:
name: "&6金锭"
lore:
 - "&7高价值金属"
rewards:
 0:
 type: MONEY
 value: "50"</code></pre>
 </div>

GUI 配置所有 GUI 配置文件位于 plugins/YeDeconix/guis/ 目录decompose.yml (分解界面)
<div class="bbCodeBlock-content">
 <pre class="bbCodeCodelanguage-yaml" dir="ltr" data-xf-init="code-block" data-lang="yaml" tabindex="0"><code class=" language-yaml"># 分解GUI配置
title: "&8[&6分解系统&8]"# 界面标题
size: 54# 界面大小（9的倍数）

buttons:
49:# 槽位编号（0-53）
material: WOOL# 材质
data: 0# 数据值（颜色等）
name: "&c一键分解"# 按钮名称
lore:# 按钮描述
 - "&7点击分解所有物品"
gongneng:# 按钮功能
 - "&a玩家 <player> 开始分解！"# 发送消息
 - ""# 执行分解
 - "ENTITY_PLAYER_LEVELUP"# 播放音效

47:
material: KNOWLEDGE_BOOK
name: "&6可分解物品列表"
lore:
 - "&e当前可分解物品："
 - "{decomposable_items}"# 动态物品列表
 - "&7&o点击此处刷新列表"
gongneng:
 - ""# 刷新物品列表

45:
material: GOLD_INGOT
name: "&e前往出售界面"
lore:
 - "&7点击切换到出售界面"
gongneng:
 - "sell"# 打开其他界面</code></pre>
 </div>
sell.yml (出售界面)
<div class="bbCodeBlock-content">
 <pre class="bbCodeCodelanguage-yaml" dir="ltr" data-xf-init="code-block" data-lang="yaml" tabindex="0"><code class=" language-yaml"># 出售GUI配置
title: "&8[&6出售系统&8]"
size: 27

buttons:
13:
material: GOLD_INGOT
data: 0
name: "&a一键出售"
lore:
 - "&7点击出售所有可出售物品"
 - "&e当前可出售物品："
 - "{sellable_items}"# 动态出售列表
gongneng:
 - "&a正在出售物品..."
 - ""# 执行出售
 - "ENTITY_PLAYER_LEVELUP"

11:
material: BARRIER
name: "&c关闭"
gongneng:
 - ""# 关闭界面

15:
material: COMPASS
name: "&b返回分解界面"
lore:
 - "&7点击返回分解界面"
gongneng:
 - "decompose"# 返回分解界面</code></pre>
 </div>

分解系统使用步骤<ul type="1" class="litype_1"><li>打开分解界面：
/yfj gui decompose</li><li>放入物品：
将背包中可分解的物品拖入界面非按钮区域</li><li>一键分解：
点击"一键分解"按钮执行分解</li><li>获取奖励：
系统自动发放配置的奖励</li></ul>奖励类型
类型描述配置示例
物品奖励发放普通物品type: ITEM
value: "DIAMOND:3"
金钱奖励增加玩家金钱type: MONEY
value: "100"
命令奖励执行服务器命令type: COMMAND
value: "give %player% diamond 5"
神话物品发放MythicMobs物品type: MYTHIC_ITEM
value: "LegendarySword"
点券奖励增加玩家点券

type: POINTS
value: "100"



匹配规则物品匹配基于：

[*]物品显示名称（精确匹配，包括颜色代码）
[*]物品Lore（完全包含配置中的所有Lore行）
[*]物品材质（可选，未在配置中要求）
 注意：物品名称和Lore必须与配置完全一致

出售系统使用步骤
[*]打开出售界面：
从分解界面点击"前往出售界面"或使用命令：
/yfj gui sell
[*]放入物品：
将背包中可出售的物品拖入界面
[*]一键出售：
点击"一键出售"按钮执行出售
[*]获取金钱：
系统根据配置发放金钱奖励
价格计算：物品价格 = 所有MONEY类型奖励值的总和
示例配置：
<div class="bbCodeBlock-title"></div>
 <div class="bbCodeBlock-content"><pre class="bbCodeCodelanguage-yaml" dir="ltr" data-xf-init="code-block" data-lang="yaml" tabindex="0"><code class=" language-yaml">钻石:
rewards:
0:
 type: MONEY
 value: "100" # 基础价格
1:
 type: MONEY
 value: "50"# 额外加成

</code>最终单价：150金币
</pre></div><div class="bbCodeBlock-content"> </div>
出售流程

[*]系统检查物品是否符合出售条件
[*]计算物品总价值
[*]通过Vault添加金钱到玩家账户
[*]移除已出售物品
[*]显示出售结果消息

高级功能按钮功能列表
功能类型格式描述示例
消息<消息>发送聊天消息&a你好！
广播<消息>全服广播&e玩家上线了！
标题<主标题>%<副标题>显示标题&6公告%&f欢迎
音效<音效> [音量]播放音效ENTITY_PLAYER_LEVELUP 1.0
分解执行分解
出售执行出售
关闭关闭界面
打开GUI<GUI名称>打开其他界面sell
刷新刷新物品列表
执行命令<命令>控制台执行命令give <player> diamond
OP命令<命令>以OP身份执行give <player> diamond

变量支持在消息和命令中使用以下变量：

变量描述示例
%player%玩家名Yelenas
%player_name%玩家名Yelenas
%uuid%玩家UUIDd3b3b3b3-...
%world%世界名world
%x% %y% %z%玩家坐标123 64 -542
%health%当前生命值20.0
%max_health%最大生命值20.0
%item%物品名称钻石
%amount%物品数量5

动态内容在按钮Lore中使用特殊标记显示实时信息：

标记描述示例
{decomposable_items}可分解物品列表显示玩家背包中可分解物品
{sellable_items}可出售物品列表显示玩家背包中可出售物品
权限管理
权限节点描述默认
yedeconix.reload重载插件权限OP
yedeconize.admin管理员权限无
yedeconize.reward所有礼包权限无

权限配置示例 YAML：
 超级神武:name: "&d超级神武"permission: yedeconize.admin# 需要此权限才能分解rewards: 0: type: ITEM value: "DIAMOND:5" permission: yedeconize.reward# 需要此权限才能获得奖励

权限检查流程
[*]检查物品分解权限（如果有配置）
[*]检查每个奖励的领取权限（如果有配置）
[*]如果权限不足，显示配置的权限错误消息

常见问题Q1: 物品无法分解/出售可能原因：

[*]物品名称/Lore与配置不匹配
[*]玩家缺少权限
[*]配置文件未重载
[*]物品未正确配置
解决方法：

[*]检查物品名称和Lore是否完全匹配（包括颜色代码）
[*]确认玩家有足够权限
[*]使用 /yfj reload 重载配置
[*]检查物品配置是否正确
Q2: 经济系统不工作可能原因：

[*]未安装Vault
[*]未安装经济插件
[*]经济插件未启用
[*]Vault未正确挂钩经济系统
解决方法：

[*]安装Vault和经济插件（如EssentialsX）
[*]确保经济插件正常运行
[*]重启服务器
[*]检查服务器日志确认Vault是否成功挂钩
Q3: GUI界面显示异常可能原因：

[*]槽位超出范围
[*]材质名称错误
[*]配置文件格式错误
[*]特殊字符未转义
解决方法：

[*]检查槽位是否在0-(size-1)范围内
[*]确认材质名称正确（使用英文ID）
[*]使用YAML验证工具检查格式
[*]确保特殊字符如&被正确转义
Q4: 神话物品不工作可能原因：

[*]未安装MythicMobs
[*]MythicMobs版本不兼容
[*]物品ID错误
[*]插件加载顺序问题
解决方法：

[*]安装MythicMobs 4.x或5.x
[*]确认物品ID在MythicMobs中正确
[*]检查插件日志获取错误信息
[*]确保YeDeconix在MythicMobs之后加载
Q5: 配置文件修改不生效可能原因：

[*]未重载配置
[*]配置文件语法错误
[*]文件权限问题
[*]配置文件路径错误
解决方法：

[*]使用 /yfj reload 重载配置
[*]检查YAML语法（缩进、冒号等）
[*]确保文件有读写权限
[*]确认文件在正确目录
Q6: 动态物品列表不更新可能原因：

[*]未添加刷新按钮
[*]刷新功能未正确配置
[*]玩家背包无变化
[*]配置错误
解决方法：

[*]在GUI中添加功能
[*]确保按钮配置正确
[*]改变背包物品后重试
[*]检查消息配置是否正确

技术支持
如有任何问题，请联系：

[*]作者: 叶子
[*]QQ: 2128158509
[*]更新时间: 2025年6月20日

提示: 修改配置文件后记得重载！/yfj reload

饭团团 发表于 2025-6-25 03:56:32

非常好的发布时间
半夜还不睡觉并且闲着没事来审核的版主如此评价到[贴吧_茶杯]

页: [1]

Minecraft(我的世界)苦力怕论坛纯文本页

注意：这种页面无法下载附件也无法查看图片

YeDeconix

Minecraft(我的世界)苦力怕论坛 纯文本页

注意：这种页面无法下载附件也无法查看图片

YeDeconix

Minecraft(我的世界)苦力怕论坛纯文本页