原创 付费 FlingSell-枫林出售

1. 插件做什么​

FlingSell 是一个「把物品卖钱」的高性能Minecraft物品出售插件，核心功能支持：

• 打开可视化出售 UI，将物品放入出售区，确认出售即可完成自动入账
• 一键快捷出售：出售背包内所有可出售物品，无需手动放入
• 多货币结算体系：原生支持 Vault、PlayerPoints、自定义指令货币三种类型
• 全品类物品识别：完美兼容 MythicMobs / ItemsAdder 自定义物品 + 原版所有物品
• 精细化倍率加成：按玩家权限组配置出售倍率，不同货币可配置不同倍率数值
• 快捷打开方式：按交换副手键（默认 F 键）打开出售 UI，可配置「必须潜行」触发防误触

2. 安装与依赖​

2.1 安装步骤​

1. 将 FlingSell.jar 放入服务器的 plugins/ 目录
2. 启动一次服务器，插件会自动生成所有默认配置文件与目录结构
3. 按需修改配置完成后，执行 /flsell reload（管理员权限）重载生效，无需重启服务器

2.2 软依赖说明​

插件会自动检测服务器已安装插件并完成兼容适配，无以下插件也能正常运行核心功能：

• Vault（金币/经济系统对接，最常用）
• PlayerPoints（点券/积分系统对接）
• ItemsAdder（自定义物品识别与适配）
• MythicMobs（自定义物品识别与适配）
• PlaceholderAPI（占位符扩展支持，供后续功能拓展使用）

3. 文件结构（你需要关注的）​

插件第一次启动后，会在 plugins/FlingSell/ 自动生成/拷贝所有配置文件，以下为核心关注文件：

• config.yml：插件总开关、默认货币、快捷键触发规则等核心配置
• messages.yml：插件所有游戏内提示文案，可完全自定义修改为中文
• ui-config.yml：出售界面的UI布局、按钮位置、交互规则等全量配置
• permissions.yml：插件权限建议清单，可对照 plugin.yml 配置权限组
• currencies/*.yml：货币体系定义，存放vault、playerpoints、command等货币独立配置
• multipliers/*.yml：倍率组定义，配置不同权限组的出售价格加成
• data/items.yml：运行时物品价格数据，由指令 /flsell hand set 自动写入维护

注意：物品价格数据默认统一存放在 plugins/FlingSell/data/items.yml，该文件由插件自动维护，请勿手动随意修改。

4. 指令（玩家/管理员）​

4.1 玩家常用​

• /flsell：打开出售界面（无对应权限会触发游戏内提示）
• /flsell open：打开出售界面
• /flsell sellall：出售背包内所有「可出售物品」
• /flsell check：查看手持物品的唯一Key标识与已配置价格（排障必备指令）
• /flsell hand set <价格> [货币]：给手持物品设置出售价格，可选指定结算货币
• /flsell hand remove：移除手持物品的所有出售价格配置
• /flsell help：查看插件所有指令帮助说明

4.2 管理员​

• /flsell reload：重载插件全部配置（会重载 currencies/multipliers/ui/messages 等所有配置文件）

5. 权限（简明表）​

所有权限在 plugin.yml 中定义了默认值，可通过服务器权限插件按需给玩家组分配对应权限：

• flingsell.use：使用插件基础功能（总门槛权限，无此权限无法使用任何功能）
• flingsell.command.open：允许打开出售UI
• flingsell.command.sellall：允许使用一键出售背包物品功能
• flingsell.command.check：允许检查手持物品的Key与价格
• flingsell.price.set.self：允许设置价格（默认仅OP拥有）
• flingsell.price.set.all：允许设置所有物品价格（默认仅OP拥有）
• flingsell.price.remove.self：允许移除物品价格（默认仅OP拥有）
• flingsell.price.remove.all：允许移除所有物品价格（默认仅OP拥有）
• flingsell.admin.reload：允许执行重载配置指令（默认仅OP拥有）

6. 物品识别（Key 是什么？为什么要 Key？）​

出售系统的核心需求是「一个稳定的物品唯一标识」，插件使用 Key 来唯一标识一个物品，用于绑定价格与精准识别。

物品识别优先级（从高到低，匹配即生效）：

1. MythicMobs 物品：mm::0
2. ItemsAdder 物品：ia::0
3. 原版物品：vanilla:::

补充说明：原版物品的nbtHash特性，可实现「同材质但 NBT 不同」的物品配置不同价格，例如：不同附魔的剑、带自定义名称的物品、含自定义NBT标签的物品均可区分定价。

快捷查询：手持目标物品执行 /flsell check 即可查看该物品的完整Key标识与已配置价格。

7. 价格系统（如何设置卖价）​

7.1 用指令快速上架（推荐）​

手持需要定价的物品，执行对应指令即可完成价格配置，配置完成后会自动写入 plugins/FlingSell/data/items.yml：

• /flsell hand set 10 ：表示用插件默认货币（见config.yml的default_currency）设置价格 10
• /flsell hand set 10 playerpoints ：表示把该物品在点券货币下的售价设置为 10 点券

7.2 一个物品多货币价格​

插件支持为单个物品同时配置多套不同货币的价格，满足差异化结算需求：

• 先执行 /flsell hand set 10 vault 配置金币售价
• 再执行 /flsell hand set 3 playerpoints 配置点券售价

生效规则：

• 玩家以 vault 金币结算时，该物品售价为 10
• 玩家以 playerpoints 点券结算时，该物品售价为 3
• 如果某货币未单独配置价格，则会自动回退使用该物品的 base_price

8. 货币系统（vault/playerpoints/command）​

所有货币的配置文件统一存放于：plugins/FlingSell/currencies/*.yml，每种货币对应独立的yml配置文件，可按需启用或禁用。

8.1 Vault 货币（金币）​

默认内置示例文件：currencies/vault.yml

关键字段：

• currency_id: vault
• economy_plugin: Vault
• enabled: true
• allow_fractions: true
• fraction_digits: 2

运行规则：Vault 模式优先调用 Vault API 完成金币入账，当 API 调用取不到数据时，会自动回退执行配置的 deposit_command 指令完成入账（若配置）。

8.2 PlayerPoints 货币（点券）​

默认内置示例文件：currencies/playerpoints.yml

关键字段：

• currency_id: playerpoints
• economy_plugin: PlayerPoints
• enabled: true
• allow_fractions: false（点券类货币一般为整数，建议关闭小数）

运行规则：PlayerPoints 模式优先调用 PlayerPoints API 完成点券入账，API调用失败时，会回退执行 deposit_command 指令入账（若配置）。

8.3 指令货币（自定义）​

当配置文件中的economy_plugin配置项不是 Vault 或 PlayerPoints 时，插件会自动启用「指令货币」模式：

• 需要在对应yml文件中配置deposit_command执行指令
• 支持两个核心占位符：{player}（玩家名）、{amount}（入账金额）

示例（根据自身服务器经济插件修改）：

deposit_command: "eco give {player} {amount}"

9. 倍率系统（VIP 加成怎么配）​

倍率配置文件存放路径：plugins/FlingSell/multipliers/groups.yml

核心规则：

• 一个玩家账号可同时匹配多个倍率组的权限
• 每种货币会单独计算对应的出售倍率
• 最终结算时，插件将自动取「该货币下的倍率最大值」生效
• 支持倍率继承机制：例如 vip 权限组可继承 default 组的基础配置

配置示例（节选）：

groups: default: permission: "flingsell.group.default" multipliers: vault: 1.0 playerpoints: 1.0 vip: permission: "flingsell.group.vip" multipliers: vault: 2.0 playerpoints: 1.5inheritance: vip: ["default"]

10. UI 配置（ui-config.yml）​

出售界面的所有配置项存放于：plugins/FlingSell/ui-config.yml，可自由修改UI相关所有规则，支持调整：

• UI窗口标题 title、窗口尺寸 size
• 出售区物品槽位范围：sell_slots.start / sell_slots.end
• 按钮配置：按钮所在slot、按钮物品材质、按钮名称、按钮描述文本 lore
• 安全与交互策略：prevent_item_take、allow_shift_click、click_cooldown、max_items_per_click

max_items_per_click 关键说明：

• <= 0：等同「不限制数量」，一次性将背包内所有可出售物品全部搬入出售区
• > 0：限制本次点击最多搬运的物品数量（按物品个数计算，不是按格子数）

UI 的信息面板支持占位符：

• {multiplier}：当前默认货币的生效倍率
• {sellable_items}：当前出售区内的可出售物品总数量

11. 快捷键打开（F 键）​

所有快捷键相关配置均在 config.yml 中配置：

• open_on_swap_hand: true：开启「按F键（副手交换键）打开出售UI」功能
• open_on_swap_hand_sneak_only: true：开启后，必须潜行+按F键才会打开出售UI，有效防止误触

权限要求：玩家需要同时拥有 flingsell.use 与 flingsell.command.open 两个权限，快捷键功能才能正常生效。

12. 常见问题（排查顺序）​

12.1 “物品不可出售”​

排查步骤（按优先级排序）：

1. 手持该物品执行 /flsell check 查看 Key 是否正常显示
2. 查看返回结果中是否标注price_not_set，该标识代表物品未上架定价
3. 若是 ItemsAdder/MythicMobs 自定义物品，确认对应插件已安装且该物品确实由对应插件生成

12.2 “卖了没钱”​

排查步骤（按优先级排序）：

1. 检查对应货币的yml配置文件中，enabled: true是否已开启
2. 确认 Vault/PlayerPoints 插件运行正常无报错，对应的经济API可正常调用
3. 如果使用 command 自定义货币，复制配置的 deposit_command 指令到控制台执行，测试指令有效性

12.3 “F 键打不开”​

排查步骤（按优先级排序）：

1. 检查 config.yml 中open_on_swap_hand是否配置为 true
2. 检查是否开启了潜行限制：open_on_swap_hand_sneak_only
3. 确认玩家账号拥有 flingsell.use + flingsell.command.open 权限

13. 版本记录​

• v0.1.5：修复「一键放入」单次只放 1 个的问题；新增支持在 UI 里取回未出售物品
• v0.1.4：优化「一键放入」行为，支持整组/全部物品一次搬入出售区（并可自动叠加到已有堆叠物品上）
• v0.1.3：修复原版物品堆叠数量导致 Key 变化的BUG，解决堆叠物品无法放入/出售的问题
• v0.1.2：补全指令帮助文案、优化游戏内提示信息，补充核心类注释，重写完整Wiki文档