原创 二次开发 CrackShotLuckx — CrackShot 管理员枪械快捷获取面板 1.0.0

面板操作​

操作	效果
左键武器	给予目标 1 把（数量可配置）
Shift+左键武器	批量给予（默认 64）
右键武器	弹出数量面板（1 / 5 / 10 / 32 / 64 + 自定义输入）
左键 搜索书	聊天栏输入关键词模糊搜索（显示名 / 武器键 / Lore）；超时会提示并自动返回面板
左键 分类	弹出分类选择面板，列出各大类及武器数量，点选即筛选
左键 目标	在线玩家列表 / 聊天栏输入玩家名

管理员能力​

• 直接给予命令：/csl give <玩家> <武器> [数量] —— 控制台 / RCON 可用， 适合活动奖励、副本通关发枪、批量补发；
• 一键撤销：/csl undo [次数] —— 通过 CrackShot 自身的武器识别接口按武器节点精准回收， 不是按名字瞎猜；回收不全会明确告知「只回收了 N/M 把」；
• 审计日志：8 个占位符（操作者 / 数量 / 武器键 / 显示名 / 目标 / 世界 / 坐标 / 溢出数）， 背包满导致物品掉地时自动在行尾追加定位信息；
• 数据源筛选：文件白名单 / 黑名单、按武器键排除、整分类排除、隐藏武器开关；
• 单武器授权：csl.admin.give.<武器键>，可把某把枪单独授权给某个组；
• 配置自动迁移：插件升级后自动把新增配置键补进你的 config.yml， 保留你已有的取值与全部注释，补键前生成 .bak 备份。
• 工程细节
  • 全配置化：界面标题、槽位布局、图标材质、全部玩家可见文案都在 config.yml；
  • 文本颜色：支持传统 & 代码、&#RRGGBB、<#RRGGBB>、{#RRGGBB>}渐变{#RRGGBB<}、 <gradient:#A:#B>…</gradient>

---

​

命令与权限​

命令	说明	权限
/csl 或 /csl give	打开自己的获取面板	csl.admin.use
/csl give <玩家名>	为指定玩家打开面板	csl.admin.use + csl.admin.others
/csl give <玩家名> <武器> [数量]	直接给予，不打开面板（控制台/RCON 可用）	csl.admin.give + csl.admin.others
/csl undo [次数]	撤销最近的给予并回收物品	csl.admin.undo
/csl reload	重载配置与武器数据	csl.admin.reload

武器参数支持：武器键精确 → 键忽略大小写 → 显示名（去色）→ 唯一包含匹配； 命中多把时会提示「找到 N 把匹配…请使用完整武器键重试」，不会猜。 Tab 补全：第 2 参补在线玩家名，第 3 参补武器键，第 4 参补数量选项。​

---

​

安装​

1. 服务器需已安装 CrackShot（本插件不包含）；
2. 把 CrackShotLuckx-1.0.0.jar 丢进 plugins/；
3. 重启服务器（或 /reload confirm）；
4. 打开 plugins/CrackShotLuckx/config.yml 按需调整（分类显示名、图标、数量选项等）；
5. 游戏内 /csl 打开面板，或 /csl reload 重载配置。

兼容性提示：本插件通过反射读取 CrackShot 的武器配置， CrackShot 大版本更新后若字段变动可能读不到——届时可只改配置、不必等插件更新。​