ItemProgressions

插件

· 作者 TheCoolcraft11

一个可自定义的插件,用于在满足特定条件之前锁定或延迟使用特定物品

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

最新 1.1-SNAPSHOT · 1.21.11 · Paper / Purpur

一键开服(送7天)

ItemProgressions

一个 Minecraft Bukkit/Paper 插件,用于在满足条件之前“锁定”物品和维度(基于实时时间、每位玩家游戏时长或全局/服务器总游戏时长)。在被锁定时,该插件会阻止使用/放置/合成/消耗这些物品,并可以阻止进入被锁定的维度。被锁定的物品会显示一条锁定的描述行;进度系统也可以显示解锁进度。

功能

  • 在满足实时时间、每位玩家游戏时长或全局/服务器游戏时长条件之前,锁定物品和维度。
  • 阻止使用/放置/合成/消耗被锁定的物品;可通过配置选择性地允许破坏被锁定的方块。
  • 阻止进入被锁定的维度(逻辑与物品相同)。
  • 可选的进度选项卡,包含规则级进度和每个物品的进度;支持多种布局模式(无、列、正方形、自动),并通过虚拟节点确保可见性。
  • 可自定义进度的图标/名称/描述模板;也可完全禁用进度创建。

使用方法

  1. 下载 jar 文件并将其放入 plugins/ 文件夹中。
  2. 重启服务器。
  3. 编辑 config.yml(常用键):
    • locks: 规则列表;每条规则包含 items 和 unlock(类型=realtime|perPlayer|global;使用时间戳用 at,使用游戏时长用 seconds)。每条规则可选的 icon 和 name 应用于该规则的进度。
    • allowBreaking: true 允许玩家破坏被锁定的方块。
    • disableAdvancementCreation: true 跳过创建任何自定义进度。
    • advancementGridMode: 每个物品进度的布局(none, columns, square, auto)。
    • itemAdvancements.defaults: 描述模板和默认图标。占位符:%name%, %time%, %playtime%, %servertime%.

配置键详解

  • allowBreaking: 当为 true 时,玩家可以破坏被锁定的方块;其他锁定检查仍然生效。
  • disableAdvancementCreation: 当为 true 时,插件不会注册自定义进度。
  • advancementGridMode: 每个物品进度的布局;可选择 none(全部归入规则下)、columns(固定宽度列)、square(带虚拟节点的近似正方形网格)或 auto(每行根据可见性自适应填充虚拟节点的网格)。
  • itemAdvancements.tab: 自定义选项卡信息;设置 key, title, description, icon 和 background。
  • itemAdvancements.defaults: 描述模板和备用图标;占位符:%name%, %time%, %playtime%, %servertime%.
  • locks: 锁定规则列表:
    • items: 材料名称/模式(例如 "DIAMOND_*")。仅物品材料用于生成单个物品进度;纯方块材料会被跳过。
    • unlock.type: realtime, perPlayer 或 global。
    • unlock.at: realtime 锁定的 ISO-8601 时间戳。
    • unlock.seconds: perPlayer 或 global 锁定的持续时间(秒)。
    • unlock.icon: 可选的规则级进度图标(命名空间物品 ID)。如果为空,则默认为匹配的物品。
    • unlock.name: 可选的规则级进度标题。如果为空,则使用物品的翻译名称。

示例

包含实时锁定和每位玩家锁定的最小配置:

allowBreaking: false
disableAdvancementCreation: false
advancementGridMode: auto

itemAdvancements:
  tab:
    key: "itemprogressions:locked_items"
    title: "Locked Items"
    description: "Items managed by ItemProgressions"
    icon: "minecraft:barrier"
    background: "minecraft:textures/gui/advancement/backgrounds/adventure.png"
  defaults:
    realtimeDescription: "%name% can be used at %time%"
    perPlayerDescription: "%name% can be used after %playtime%"
    globalDescription: "%name% can be used after %servertime%"
    icon: "minecraft:barrier"

dimensionLocks:
  - dimension: NETHER
    unlock:
      type: realtime
      at: "2026-01-01T15:00:00+01:00"
      name: "The Nether"
      icon: "minecraft:netherrack"
      description: "The Nether unlocks on January 1st, 2026"
  - dimension: THE_END
    unlock:
      type: realtime
      at: "2027-01-01T00:00:00+01:00"
      name: "The End"
      icon: "minecraft:end_stone"
      description: "The End unlocks on January 1st, 2027"

locks:
  - items: [ "DIAMOND_*" ]
    unlock:
      type: perPlayer
      seconds: 3600
      icon: "minecraft:diamond"
      name: "Diamond Gear"

  - items: [ "NETHERITE_*" ]
    unlock:
      type: realtime
      at: "2026-01-01T00:00:00Z"
      icon: "minecraft:netherite_ingot"
      name: "Netherite Items"

权限

  • itemprogressions.bypass.<item_name>: 允许绕过特定物品的锁定(例如, itemprogressions.bypass.DIAMOND_SWORD)。
  • itemprogressions.bypass.*: 允许绕过所有锁定。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源