Searching

插件

· 作者 ewsk233

一个高性能且高度可定制的战利品容器插件,支持自定义战利品池、稀有度、刷新系统、动画等功能。

0 本站下载 0 关注 更新于 2 个月前

最新 1.5.4 · 26.1.2 · Folia / Paper

一键开服(送7天)

搜索

Searching 是一个战利品箱配置插件。

经过多次重写和优化,版本 1.5.4 是目前最稳定且性能最佳的发布版本。

Searching 目前没有付费版,完全免费。

以下内容均基于 Searching 1.5.4。

插件 Wiki: Wiki


为什么选择 Searching?

1. 性能

Searching 在运行时将战利品箱类型、战利品表、战利品池、物品、等级、刷新策略及其他配置数据预加载到内存中。

它采用了诸如基于坐标的缓存、基于过期的刷新、增量 GUI 同步和批量统计写入等优化手段,使其能够胜任拥有大量战利品箱的服务端。

内部压力测试结果:

  • 对 10,000 个未过期的战利品箱进行刷新检查时,仅执行了 0 次实际刷新操作,耗时约 28ms
  • 当有 100 名玩家同时保持战利品界面打开状态时,增量 GUI 同步耗时约 16ms

玩家交互无需反复读取 YAML 文件或扫描所有存储的数据。闲置的战利品箱几乎不产生持续的运算开销,而交互过程仅处理实际需要的状态变更。

这些结果基于插件核心逻辑的压力测试。实际性能可能因服务器硬件、数据库性能、物品插件及全息图插件而异。


2. 设计精良的战利品池结构

Searching 采用以下分层奖励结构:

战利品箱类型 → 战利品表 → 战利品池 → 物品

它还支持嵌套战利品池。

服务端所有者可以为不同的战利品箱类型分配不同的战利品表,然后通过战利品池和嵌套子池组合普通奖励、稀有奖励、高等级奖励、特殊奖励等内容。

例如:

一个基础战利品池可能有较小的概率进入稀有池,而稀有池又可能有较小的概率进入顶级池。

物品支持可配置属性,包括:

  • 数量范围
  • 等级
  • 搜索时间
  • 经验值
  • 加权概率

这使得创建简单的资源箱以及具有稀有掉落和多层级奖励结构的复杂战利品箱成为可能。

分层设计也使得配置更易于复用和维护。相同的稀有或高等级池可以在多种战利品箱类型之间共享。

在后续调整奖励概率、添加新物品或将不同区域的奖励分离时,您无需复制大量配置。


3. 便捷的内置 UI 编辑器

Searching 提供了可视化的游戏内 UI 编辑器,允许服务端所有者直接在服务器内管理配置,而无需频繁手动编辑配置文件。

编辑器可以管理:

  • 战利品箱类型
  • 奖励物品
  • 战利品表
  • 战利品池
  • 物品等级
  • 刷新策略
  • 全息图模板

编辑器支持创建、修改、删除和分页浏览,并在保存更改时执行配置验证。

对于日常服务端管理,这使得调整奖励、平衡概率以及添加新的战利品箱类型更加直观,尤其是在同时测试和修改配置时。


命令

命令 权限 适用对象 描述
/searching reload searching.command 玩家 / 控制台 重新加载插件配置
/searching node type [type] searching.command 玩家 / 控制台 列出所有战利品箱类型,或查看/选择指定类型
/searching node create <type> [x] [y] [z] searching.command 玩家 / 控制台 创建一个战利品箱。如果省略坐标,则使用玩家视线范围内 6 格内的目标方块
/searching node remove <type> [x] [y] [z] searching.command 玩家 移除一个战利品箱。如果省略坐标,则使用玩家视线范围内 6 格内的目标方块
/searching node list <world> [type] searching.command 玩家 打开指定世界的战利品箱管理面板,可按类型过滤
/searching node clear <world> [type] searching.command 玩家 移除指定世界中的所有战利品箱,可按类型过滤
/searching node open <world> <x> <y> <z> searching.command 玩家 直接打开指定坐标处的战利品箱
/searching editor [section] searching.command 玩家 打开内置 UI 编辑器。您可以直接进入 nodes(节点)、items(物品)、pools(池)、tiers(等级)或 refresh(刷新)页面

占位符

占位符 描述 示例
%searching_daily_open_chest_<loot_chest_type>% 玩家今日打开指定战利品箱子类型的次数 %searching_daily_open_chest_MineLootChest%
%searching_daily_total_open_chest% 玩家今日打开的箱子总数 %searching_daily_total_open_chest%
%searching_daily_search_<tier>% 玩家今日搜刮到的指定品质物品数量 %searching_daily_search_Rare%
%searching_total_open_chest_<loot_chest_type>% 玩家累计打开指定战利品箱子类型的总次数 %searching_total_open_chest_BossRewardChest%
%searching_total_total_open_chest% 玩家累计打开的箱子总数 %searching_total_total_open_chest%
%searching_total_search_<tier>% 玩家累计搜刮到的指定品质物品总数 %searching_total_search_Mythic%
%searching_level% 玩家当前的 Searching 等级 %searching_level%
%searching_exp% 玩家当前的 Searching 总经验值 %searching_exp%
%searching_exp_total% 升至下一级所需的总经验值 %searching_exp_total%
%searching_exp_need% 升至下一级还需要的经验值 %searching_exp_need%

插件配置示例

点击展开配置文件

config.yml

progress:
  level-expression: "1 + (exp / 100) ^ 0.5"

stats:
  storage:
    type: sqlite
    sqlite-file: searching.db
    host: 127.0.0.1
    port: 3306
    database: searching
    user: root
    password: ""

search-animation:
  enabled: true
  start-sound: UI_BUTTON_CLICK
  hidden-item:
    item: BLACK_STAINED_GLASS_PANE
    name: "&7未搜索"
    lore:
      - "&8未搜索"
    custom-model-data: -1
  frames:
    - item: YELLOW_STAINED_GLASS_PANE
      name: "&e搜索中."
      lore:
        - "&e33%"
    - item: ORANGE_STAINED_GLASS_PANE
      name: "&6搜索中.."
      lore:
        - "&e66%"
    - item: RED_STAINED_GLASS_PANE
      name: "&c搜索中..."
      lore:
        - "&e99%"

node_types.yml

MineLootChest:
  displayName: "&7矿洞宝箱"
  table: MineLoot
  refreshPolicy: default_cooldown
  slots: 27
  hologramId: default

AirdropSupplyChest:
  displayName: "&b空投补给箱"
  table: SupplyAirdrop
  refreshPolicy: default_cooldown
  slots: 36
  hologramId: default

BossRewardChest:
  displayName: "&dBoss奖励箱"
  table: BossRewards
  refreshPolicy: default_cooldown
  slots: 27
  hologramId: default

items.yml

Cobblestone:
  item: "minecraft:cobblestone"
  tier: Common
  amount: 8-16
  value: 2
  reveal-ticks: 0
  exp: 0.5
  name: "&7圆石"

Coal:
  item: "minecraft:coal"
  tier: Common
  amount: 4-10
  value: 4
  reveal-ticks: 0
  exp: 1.0
  name: "&8煤炭"

IronIngot:
  item: "minecraft:iron_ingot"
  tier: Common
  amount: 2-5
  value: 8
  reveal-ticks: 0
  exp: 2.0
  name: "&f铁锭"

refresh.yml

refreshPolicies:
  default_cooldown:
    type: cooldown
    cooldownSeconds: 60
    scope: node

hologram:
  enabled: true
  provider: DecentHolograms
  defaultId: default
  holograms:
    default:
      offset:
        x: 0.0
        y: 1.6
        z: 0.0
      lines:
        - "&e{type}"
        - "&7{state}"
        - "&b{time}"

tables.yml

tables:
  LootChest:
    root-pool: BasicItemPool
    rolls: 2-4

  MineLoot:
    root-pool: MineItemPool
    rolls: 3-5

  SupplyAirdrop:
    root-pool: AirdropItemPool
    rolls: 4-6

  BossRewards:
    root-pool: BossRewardPool
    rolls: 2-3

pools:
  BasicItemPool:
    entries:
      - item: Cobblestone
      - item: Coal
      - item: IronIngot
      - item: Bread
      - item: ExperienceBottle
      - pool: RareItemPool
        weight: 3

  RareItemPool:
    entries:
      - item: GoldIngot
      - item: Diamond
      - item: Emerald
      - pool: HighTierItemPool
        weight: 1

  HighTierItemPool:
    entries:
      - item: EnchantedBook
      - item: GoldenApple
      - pool: MythicItemPool
        weight: 1

  MythicItemPool:
    entries:
      - item: NetheriteScrap
      - item: NetherStar

  MineItemPool:
    entries:
      - item: Cobblestone
      - item: Coal
      - item: IronIngot
      - item: GoldIngot
      - item: Diamond
      - item: Emerald

  AirdropItemPool:
    entries:
      - item: Bread
        weight: 20
      - item: ExperienceBottle
        weight: 20
      - item: GoldIngot
      - item: Diamond
      - item: EnchantedBook
      - item: GoldenApple

  BossRewardPool:
    entries:
      - item: Diamond
        weight: 8
      - item: Emerald
        weight: 8
      - item: EnchantedBook
        weight: 4
      - item: GoldenApple
        weight: 4
      - item: NetheriteScrap
      - item: NetherStar

tiers.yml

Common:
  weight: 80
  ticks: 20
  exp: 1.0
  name: "&f普通"
  search-sound: "ENTITY_ITEM_PICKUP"

Rare:
  weight: 18
  ticks: 40
  exp: 4.0
  name: "&b稀有"
  search-sound: "ENTITY_PLAYER_LEVELUP"

Epic:
  weight: 2
  ticks: 80
  exp: 10.0
  name: "&6史诗"
  search-sound: "UI_TOAST_CHALLENGE_COMPLETE"

Mythic:
  weight: 1
  ticks: 120
  exp: 25.0
  name: "&d神话"
  search-sound: "ENTITY_ENDER_DRAGON_GROWL"

Bug 报告与社区

如果您遇到任何错误、配置问题、疑问或其他与 Searching 相关的问题,欢迎通过 QQ 联系作者。

作者 QQ: 2962271068

官方 QQ 群:724504184

对于中国大陆以外的用户,您可以通过 Discord 邀请链接加入我的 Discord 服务器。

Searching

Searching 是一个用于设置搜刮箱的插件。

它经历了多次重构,目前的 1.5.4 版本是稳定性与性能最高的版本。

目前的 Searching 没有付费版本,完全免费。

以下内容均基于 1.5.4 版本进行介绍。

插件 Wiki: Wiki


为什么选择 Searching?

1. 性能优势

Searching 在运行时会将搜刮箱类型、奖励池、物品、品质、刷新策略等配置预加载到内存缓存中,并采用坐标缓存定位、到期刷新、界面差量同步和统计批量写入设计,适合在服务器中布置大量搜刮箱。

内部压力测试中:

  • 10000 个未到期搜刮箱进行刷新检查时,实际处理数量为 0,测试耗时约 28ms
  • 100 个玩家同时持有搜刮界面时,界面差量同步耗时约 16ms

玩家交互时无需频繁读取 YAML 或扫描全量数据,空闲箱子几乎不产生持续计算压力,交互过程中也只处理必要的状态变化。

以上为插件核心逻辑压力测试数据,实际表现仍会受服务器硬件、数据库、物品插件和悬浮字插件影响。


2. 合理的奖池配置结构设计

Searching 的奖励系统采用:

搜刮箱类型 → 奖励表 → 奖励池 → 物品

的分层设计,并支持嵌套奖池。

服主可以为不同搜刮箱绑定不同奖励表,再通过奖励池和子奖池组合普通奖励、稀有奖励、高级奖励、特殊奖励等内容,实现类似:

基础奖励中小概率进入稀有池,稀有池中再小概率进入顶级池

这样的层级掉落效果。

物品支持:

  • 数量范围
  • 品质
  • 搜索时间
  • 经验
  • 权重概率

等配置。

既能制作简单的资源箱,也能制作带有稀有掉落和高级奖励层级的复杂搜刮箱。

这样的结构便于复用和维护,同一套稀有池或高级池可以被多个搜刮箱复用。后期调整奖励概率、增加新物品或拆分不同区域奖励时,不需要重复配置大量箱子内容。


3. 方便的内置 UI 编辑器

Searching 提供游戏内可视化 UI 编辑器,服主无需频繁打开配置文件,就可以直接在服务器内管理:

  • 搜刮箱类型
  • 奖励物品
  • 奖励表
  • 奖励池
  • 物品品质
  • 刷新策略
  • 悬浮字模板

编辑器支持新增、修改、删除和分页浏览,并在保存时进行配置检查。

对于日常运营来说,调整奖励内容、平衡概率、添加新搜刮箱类型都会更加直观,也更适合边测试边修改。


插件命令

命令 权限 适用对象 描述
/searching reload searching.command 玩家 / 控制台 重载插件配置
/searching node type [类型] searching.command 玩家 / 控制台 查看所有搜刮箱类型,或查看 / 选择指定类型
/searching node create <类型> [x] [y] [z] searching.command 玩家 / 控制台 创建搜刮箱;不填坐标时使用视线 6 格内的目标方块
/searching node remove <类型> [x] [y] [z] searching.command 玩家 移除搜刮箱;不填坐标时使用视线 6 格内的目标方块
/searching node list <世界> [类型] searching.command 玩家 打开指定世界的搜刮箱管理面板,可按类型筛选
/searching node clear <世界> [类型] searching.command 玩家 清空指定世界的搜刮箱,可按类型筛选
/searching node open <世界> <x> <y> <z> searching.command 玩家 直接打开指定坐标的搜刮箱
/searching editor [section] searching.command 玩家 打开内置 UI 编辑器;可直接进入 nodes、items、pools、tiers、refresh 页面

占位符

占位符 描述 示例
%searching_daily_open_chest_<搜刮箱类型>% 玩家今日打开指定类型搜刮箱次数 %searching_daily_open_chest_矿洞搜索箱%
%searching_daily_total_open_chest% 玩家今日打开所有搜刮箱总次数 %searching_daily_total_open_chest%
%searching_daily_search_<品质>% 玩家今日搜刮到指定品质物品次数 %searching_daily_search_稀有%
%searching_total_open_chest_<搜刮箱类型>% 玩家累计打开指定类型搜刮箱次数 %searching_total_open_chest_Boss奖励箱%
%searching_total_total_open_chest% 玩家累计打开所有搜刮箱总次数 %searching_total_total_open_chest%
%searching_total_search_<品质>% 玩家累计搜刮到指定品质物品次数 %searching_total_search_神话%
%searching_level% 玩家当前搜刮等级 %searching_level%
%searching_exp% 玩家当前累计搜刮经验 %searching_exp%
%searching_exp_total% 玩家升到下一级所需总经验 %searching_exp_total%
%searching_exp_need% 玩家距离下一级还需要的经验 %searching_exp_need%

插件示例配置文件

点击展开配置文件

config.yml

progress:
  level-expression: "1 + (exp / 100) ^ 0.5"

stats:
  storage:
    type: sqlite
    sqlite-file: searching.db
    host: 127.0.0.1
    port: 3306
    database: searching
    user: root
    password: ""

```yaml
search-animation:
  enabled: true
  start-sound: UI_BUTTON_CLICK
  hidden-item:
    item: BLACK_STAINED_GLASS_PANE
    name: "&7未搜索"
    lore:
      - "&8未搜索"
    custom-model-data: -1
  frames:
    - item: YELLOW_STAINED_GLASS_PANE
      name: "&e搜索中."
      lore:
        - "&e33%"
    - item: ORANGE_STAINED_GLASS_PANE
      name: "&6搜索中.."
      lore:
        - "&e66%"
    - item: RED_STAINED_GLASS_PANE
      name: "&c搜索中..."
      lore:
        - "&e99%"

node_types.yml

矿洞搜索箱:
  displayName: "&7矿洞搜索箱"
  table: 矿洞宝箱
  refreshPolicy: default_cooldown
  slots: 27
  hologramId: default

空投补给箱:
  displayName: "&b空投补给箱"
  table: 补给空投
  refreshPolicy: default_cooldown
  slots: 36
  hologramId: default

Boss奖励箱:
  displayName: "&dBoss奖励箱"
  table: Boss奖励
  refreshPolicy: default_cooldown
  slots: 27
  hologramId: default

items.yml

圆石:
  item: "minecraft:cobblestone"
  tier: 普通
  amount: 8-16
  value: 2
  reveal-ticks: 0
  exp: 0.5
  name: "&7圆石"

煤炭:
  item: "minecraft:coal"
  tier: 普通
  amount: 4-10
  value: 4
  reveal-ticks: 0
  exp: 1.0
  name: "&8煤炭"

铁锭:
  item: "minecraft:iron_ingot"
  tier: 普通
  amount: 2-5
  value: 8
  reveal-ticks: 0
  exp: 2.0
  name: "&f铁锭"

refresh.yml

refreshPolicies:
  default_cooldown:
    type: cooldown
    cooldownSeconds: 60
    scope: node

hologram:
  enabled: true
  provider: DecentHolograms
  defaultId: default
  holograms:
    default:
      offset:
        x: 0.0
        y: 1.6
        z: 0.0
      lines:
        - "&e{type}"
        - "&7{state}"
        - "&b{time}"

tables.yml

tables:
  搜索箱:
    root-pool: 基础物品池
    rolls: 2-4

  矿洞宝箱:
    root-pool: 矿洞物品池
    rolls: 3-5

  补给空投:
    root-pool: 空投物品池
    rolls: 4-6

  Boss奖励:
    root-pool: Boss奖励池
    rolls: 2-3

pools:
  基础物品池:
    entries:
      - item: 圆石
      - item: 煤炭
      - item: 铁锭
      - item: 面包
      - item: 经验瓶
      - pool: 稀有物品池
        weight: 3

  稀有物品池:
    entries:
      - item: 金锭
      - item: 钻石
      - item: 绿宝石
      - pool: 高级物品池
        weight: 1

  高级物品池:
    entries:
      - item: 附魔书
      - item: 金苹果
      - pool: 神话物品池
        weight: 1

  神话物品池:
    entries:
      - item: 下界合金碎片
      - item: 下界之星

  矿洞物品池:
    entries:
      - item: 圆石
      - item: 煤炭
      - item: 铁锭
      - item: 金锭
      - item: 钻石
      - item: 绿宝石

  空投物品池:
    entries:
      - item: 面包
        weight: 20
      - item: 经验瓶
        weight: 20
      - item: 金锭
      - item: 钻石
      - item: 附魔书
      - item: 金苹果

  Boss奖励池:
    entries:
      - item: 钻石
        weight: 8
      - item: 绿宝石
        weight: 8
      - item: 附魔书
        weight: 4
      - item: 金苹果
        weight: 4
      - item: 下界合金碎片
      - item: 下界之星

tiers.yml

普通:
  weight: 80
  ticks: 20
  exp: 1.0
  name: "&f普通"
  search-sound: "ENTITY_ITEM_PICKUP"

稀有:
  weight: 18
  ticks: 40
  exp: 4.0
  name: "&b稀有"
  search-sound: "ENTITY_PLAYER_LEVELUP"

史诗: weight: 2 ticks: 80 exp: 10.0 name: "&6史诗" search-sound: "UI_TOAST_CHALLENGE_COMPLETE"

神话: weight: 1 ticks: 120 exp: 25.0 name: "&d神话" search-sound: "ENTITY_ENDER_DRAGON_GROWL"


</details>

---

## 问题反馈与交流

如果遇到 **BUG、不懂的地方或其他 Searching 相关问题**,都可以添加作者 QQ 咨询。

**作者 QQ:2962271068**

作者的 QQ 交流群:**[724504184](https://qm.qq.com/q/TYNZooAxus)**

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源