GT Wiki

外观

主配置 config.yml ​

文件位置：

text
plugins/GTQuiver/config.yml

默认配置 ​

yaml
settings:
  debug: false
  equipped-slots:
    - "OFF_HAND"
  consume-in-creative: false
  respect-infinity: true
  pending-shot-timeout-ticks: 200
  max-payload-bytes: 1048576
  max-uncompressed-bytes: 4194304

arrow-recovery:
  allow-non-infinity: false

attribute-bridge:
  provider: "CA"

combat:
  block-bow-melee: true

binding:
  bound-format: "&7绑定玩家: &f%player%"
  unbound-format: "&7绑定状态: &8未绑定"

quiver-lore:
  refresh-exclude-prefixes:
    - "§禁§止§刷§新"
    - "§孔§位"
  max-arrow-types: 5
  current-format: "&7当前使用: &f%arrow%"
  details-header: "&7箭矢详情:"
  detail-format: "&8- &f%arrow% &7x%amount%"
  empty-detail: "&8- &7无"
  more-detail: "&8......"
  empty-arrow-name: "无"

gui:
  title: "&8箭袋 · %name%"
  invalid-slot-material: "STAINED_GLASS_PANE"
  invalid-slot-data: 15
  invalid-slot-name: " "
  save-after-click: true

custom-arrows:
  trail-interval-ticks: 2
  max-track-ticks: 600

messages:
  prefix: "&8[&bGTQuiver&8] "

settings.debug ​

yaml
settings:
  debug: false

排查射击、属性、拾箭问题时改为 true。正常使用保持关闭。

配合命令：

text
/gtq debug [玩家]

settings.equipped-slots ​

yaml
settings:
  equipped-slots:
    - "OFF_HAND"

按填写顺序查找箭袋。支持：

写法槽位
OFF_HAND、OFFHAND副手
HOTBAR_1 - HOTBAR_9快捷栏 1 - 9
0 - 8快捷栏原始槽位
9 - 35主背包原始槽位

示例：

yaml
settings:
  equipped-slots:
    - "OFF_HAND"
    - "HOTBAR_9"
    - "17"

列表为空时使用副手。

settings.consume-in-creative ​

yaml
settings:
  consume-in-creative: false
值效果
false创造模式不扣除箭袋存量
true创造模式正常扣除

settings.respect-infinity ​

yaml
settings:
  respect-infinity: true

开启后，无限附魔只对普通原版箭生效。以下箭仍会消耗：

  • 药水箭、光灵箭。
  • 带名称或 Lore 的箭。
  • 带 CustomModelData、属性数据或其他 NBT 的箭。
  • GTQuiver 自定义箭。

设为 false 后，箭袋中的箭不受无限附魔影响。

settings.pending-shot-timeout-ticks ​

yaml
settings:
  pending-shot-timeout-ticks: 200

拉弓等待时间，单位 tick。默认约 10 秒，最低为 20。通常不用修改。

settings.max-payload-bytes ​

yaml
settings:
  max-payload-bytes: 1048576
  max-uncompressed-bytes: 4194304

限制单个箭袋可保存的数据大小。正常物品使用默认值即可。出现 payload-too-large 时先检查箭物品是否带有异常大的 Lore 或 NBT。

arrow-recovery.allow-non-infinity ​

yaml
arrow-recovery:
  allow-non-infinity: false
值效果
false射出的箭不可拾取
true实际消耗且不是无限弓射出的箭可以拾取

创造模式未消耗的箭、无限弓射出的箭始终不可回收。

开启回收后，箭袋自动收纳规则：

  • 按 equipped-slots 顺序查找箭袋。
  • 箭必须符合该箭袋的 accept。
  • 优先合并已有堆叠，再使用空槽。
  • 箭袋无法接收时进入普通背包。

attribute-bridge.provider ​

yaml
attribute-bridge:
  provider: "CA"
值效果
CA使用 CraneAttribute，默认
AP使用 AttributePlus Pro
BOTHCA、AP 同时处理
NONE不接入 CA/AP

AP 服务器需要明确改成 AP。BOTH 可能让同类属性重复结算。

combat.block-bow-melee ​

yaml
combat:
  block-bow-melee: true

true 时禁止手持弓或弩左键造成近战伤害。GTQuiver 自定义箭无论此项设置如何，都不能手持左键攻击实体。

binding ​

yaml
binding:
  bound-format: "&7绑定玩家: &f%player%"
  unbound-format: "&7绑定状态: &8未绑定"
配置说明
bound-format绑定箭袋的 Lore 格式
unbound-format非绑定箭袋的 Lore 格式

绑定格式支持：

变量内容
%player%绑定时记录的玩家名
%owner%与 %player% 相同
%uuid%绑定玩家 UUID

quivers.yml 中可以用 %binding% 决定显示位置。旧配置没有该变量时，插件会把绑定状态补到 Lore 末尾。

任一格式设为 "" 时隐藏对应状态，绑定限制仍然生效。

quiver-lore ​

yaml
quiver-lore:
  refresh-exclude-prefixes:
    - "§禁§止§刷§新"
    - "§孔§位"
  max-arrow-types: 5
  current-format: "&7当前使用: &f%arrow%"
  details-header: "&7箭矢详情:"
  detail-format: "&8- &f%arrow% &7x%amount%"
  empty-detail: "&8- &7无"
  more-detail: "&8......"
  empty-arrow-name: "无"
配置说明
refresh-exclude-prefixes包含任一标记的 Lore 行不参与箭袋摘要刷新
max-arrow-types最多显示多少种箭，范围 1 - 54
current-format当前箭格式，支持 %arrow%
details-header箭种明细标题
detail-format单个箭种格式，支持 %arrow%、%amount%
empty-detail箭袋为空时的明细
more-detail超过显示上限时的省略行
empty-arrow-name箭袋为空时的当前箭名称

同一种完整物品会合并数量。名称相同但 Lore、属性、药水、模型或 NBT 不同，仍按不同箭种显示。

默认 §孔§位 对应 GTGem 槽位标记，GTGem 的单行、紧凑和多行宝石显示都会保留。其他镶嵌插件可以给需要保护的每行 Lore 加上 §禁§止§刷§新，或把自己的标记加入列表。

旧版 config.yml 没有 refresh-exclude-prefixes 时，插件仍自动使用以上两个默认值。要关闭逐行保护，请明确填写空列表：

yaml
quiver-lore:
  refresh-exclude-prefixes: []

gui ​

yaml
gui:
  title: "&8箭袋 · %name%"
  invalid-slot-material: "STAINED_GLASS_PANE"
  invalid-slot-data: 15
  invalid-slot-name: " "
  save-after-click: true
配置说明
titleGUI 标题，支持 %name%、%id%
invalid-slot-material超出实际容量的填充物材质
invalid-slot-data旧版本材质数据值
invalid-slot-name填充物名称
save-after-click点击后及时保存，建议保持 true

标题最长按 32 字符处理，兼容旧版本服务端。

custom-arrows ​

yaml
custom-arrows:
  trail-interval-ticks: 2
  max-track-ticks: 600
配置说明
trail-interval-ticks飞行粒子刷新间隔，最低 1 tick
max-track-ticks单支箭最长粒子时间，最低 20 tick

连射量较大时可把粒子间隔调到 3 - 5 tick。

messages.prefix ​

yaml
messages:
  prefix: "&8[&bGTQuiver&8] "

messages.yml 中提示消息的统一前缀，支持 & 颜色代码。

新增自动收箭消息：

yaml
auto-store-enabled: "&a拾取箭矢自动存入箭袋已开启。"
auto-store-disabled: "&e拾取箭矢自动存入箭袋已关闭。"
player-settings-save-failed: "&c玩家设置保存失败，请查看控制台。"

绑定提示：

yaml
bound-owner-only: "&c这个箭袋已绑定给 &f%player%&c，你不能拾取或使用。"
binding-mode-invalid: "&c绑定模式只能填写 &fbound &c或 &funbound&c。"
given-bound-quiver: "&a已给予 &f%player% &a箭袋 &f%id%&a，数量 &f%amount%&a，绑定玩家 &f%owner%&a。"
given-unbound-quiver: "&a已给予 &f%player% &a非绑定箭袋 &f%id%&a，数量 &f%amount%&a。"