GoofyGoober's Quality of Life (GGQOL) 26.2
GGQOL 是一款适用于生存服务器的 Paper/Folia 插件。它消除了常见原版任务中的等待时间、重复点击和物品拆解过程。每个功能均可通过 config.yml 进行控制。
大多数库存功能可以读取潜影盒和储物袋的内容。储物袋搜索设有深度限制,以防止嵌套储物袋无限循环运行。
本自述文件涵盖适用于运行 Java 25 的 Paper 和 Folia 服务器的 GGQOL 26.2。
前置要求
- 适用于 Minecraft 26.2 的 Paper、Folia 或兼容的 Paper/Folia 分支
- Java 25 或更高版本
- PacketEvents(用于支持储物袋滚动功能)
- Minecraft 26.2
该插件不包含任何命令或权限。安装插件和 PacketEvents jar 包后,启动服务器一次以生成 config.yml。
功能列表
| 功能 |
默认值 |
主要设置项 |
| 即时熔炉、烟熏炉和高炉 |
开启 |
instant-furnace、instant-smoker、instant-blast-furnace |
| 即时酿造台和营火 |
开启 |
instant-brewing-stand、instant-campfire |
| 自动重种 |
开启 |
auto-plant |
| 骨粉催熟至满生长 |
开启 |
bonemeal-max-grow |
| 动物相关改动 |
开启 |
instant-animals |
| 村民交易与治愈改动 |
开启 |
villagers-reset-trade-cooldown、villagers-instant-cure |
| 批量合成 |
开启 |
bulk-crafting |
| 批量村民交易 |
开启 |
villagers-bulk-trading |
| 移除铁砧经验上限 |
开启 |
anvil-unlimited-repair-cost |
| 护甲鞘翅 |
开启 |
armored-elytra |
| 工具与护甲破损保护 |
开启 |
prevent-tool-break、prevent-armor-break |
| 背包不死图腾 |
开启 |
inventory-totem |
| 精准采集方块回收 |
开启 |
silk-touch-recover-blocks |
| 海龟蛋快速放置 |
开启 |
sea-pickles-fast-place |
| 储物袋滚动 |
开启 |
bundle-scroll |
| 泥巴扩散 |
开启 |
mud-spread |
| 水下混凝土粉末 |
开启 |
concrete-powder-in-water |
| 活塞农田保护 |
开启 |
piston-protect-farmland |
| 活塞与飞行机器收获掉落物 |
始终开启 |
无设置项 |
即时熔炼与加工
熔炉、 smoker 和高炉会使用当前可用的燃料,对所有符合条件的输入进行烹饪。在修改库存之前,插件会检查匹配的 Bukkit 烹饪配方、当前输出栈、烹饪进度、燃烧时间以及输出栈上限。
fuel-cost-multiplier 会在消耗燃料前乘以烹饪时间成本。使用默认值 2.0 时,一个配方消耗的燃料时间是正常时间的两倍。插件会优先消耗现有的燃烧时间,然后从燃料槽中消耗燃料物品。
safe-fuel-mode 控制对未知燃料的处理方式。开启时,插件仅使用从真实熔炉燃烧事件中获取的燃烧时间数据。关闭时,它可以推测 Bukkit 尚未报告的常见燃料的燃烧时间。
瞬间熔炉、smoker 和高炉处理过程会将配方的经验值记录在方块上。当玩家移除已烹饪的输出物(包括由插件批量完成的输出)时,玩家会正常获得存储的经验值。
酿造台和营火利用服务器事件将酿造或烹饪时间设置为 1 tick。
| 设置项 |
默认值 |
备注 |
instant-furnace |
true |
启用瞬间熔炉配方 |
instant-smoker |
true |
启用瞬间 smoker 配方 |
instant-blast-furnace |
true |
启用瞬间高炉配方 |
instant-brewing-stand |
true |
将酿造时间设置为 1 tick |
instant-campfire |
true |
将营火烹饪时间设置为 1 tick |
fuel-cost-multiplier |
2.0 |
乘以使用的燃料时间 |
safe-fuel-mode |
true |
避免使用推测的燃烧时间 |
自动补种
当破坏支持的成熟作物时,插件会移除一个种子或作物物品,储存收获物,并重新种植该作物。它优先使用掉落物。如果掉落物不包含所需的种子,则会根据配置检查玩家背包、潜影盒和束口袋。
补种任务每 tick 重试一次,最多尝试 replant-tries 次。这有助于应对因其他插件或服务器延迟导致方块被占用一 tick 的情况。
支持的标准作物:
- 小麦
- 胡萝卜
- 土豆
- 甜菜根
- 下界疣
- 火炬花作物
- 箭猪果作物
- 西瓜藤
- 南瓜藤
甘蔗和仙人掌作为柱状结构处理。如果破坏的方块是多块柱状结构的基座且基座可以重新种植,则整个柱状结构会被移除,并重新种植一个方块。附着在仙人掌柱上方的仙人掌花会随仙人掌一起被移除。甘蔗仅在紧邻水源或被水浸没方块的有效土壤上重新种植。仙人掌仅在侧面通透的沙或红沙上重新种植。
收获掉落物首先放入玩家背包。如果背包已满,自动种植功能可以先将剩余物品存入束口袋和潜影盒,然后再丢弃其余部分。
| 设置项 |
默认值 |
备注 |
auto-plant |
true |
启用作物和柱状结构补种 |
auto-plant-allow-creative |
false |
允许在创造模式下使用该功能 |
auto-plant-use-shulkers |
true |
读取种子并将掉落物存入潜影盒 |
auto-plant-use-bundles |
true |
读取种子并将掉落物存入束口袋 |
auto-plant-bundle-max-depth |
4 |
束口袋嵌套深度 |
replant-tries |
120 |
补种尝试次数,每 tick 一次 |
骨粉最大生长
如果目标可以生长,使用一次骨粉即可将其推至最大状态。该插件仅在发生实际变化时消耗骨粉。
支持的作物包括:基于年龄的作物、火炬花作物、猪笼草作物、西瓜茎、南瓜茎、甘蔗、仙人掌、竹子、竹苗以及树苗。树苗可以长成树木,当以 2x2 的方式放置树苗时,它们也能长成 2x2 的大型树木。
发射器也可以用来使用骨粉。如果发射器使用了骨粉但没有任何东西可以生长,骨粉物品将从发射器中掉落,而不是被消耗。
在某些情况下,你也可以对作物所附着的方块施加骨粉效果。例如,对支撑方块施加骨粉可以找到附着在该方块上的基于年龄的植物、洞穴藤蔓或方向性作物。该插件会跳过容器、工作台、红石控制装置、床、门、告示牌、锅、铁砧、酿造台、熔炉以及其他应保持正常右键点击行为的方块。
| 设置项 |
默认值 |
备注 |
bonemeal-max-grow |
true |
启用单次使用即达最大生长状态 |
bonemeal-bamboo-cap |
16 |
竹子最大高度 |
bonemeal-sugar-cane-cap |
3 |
甘蔗最大高度 |
bonemeal-cactus-cap |
3 |
仙人掌最大高度 |
动物相关改动
instant-animals 是动物改动的总开关。
当 animals-instant-tame 开启时,右键点击未驯服的生物会立即将玩家设为其主人并播放爱心粒子效果。此代码不要求特定的驯服物品。
当 animals-instant-grow 开启时,繁殖产生的幼崽会立即长大。由投掷鸡蛋生成的鸡也会立即长大。
当 animals-reset-breed-cooldown 开启时,父母在成功繁殖后可以再次进行繁殖。
动物喂食每次动作可以使用多个食物物品。如果开启 animals-feed-uses-multiplier,食物消耗量为 ceil(fuel-cost-multiplier),且范围限制在 1 到 64 之间。使用默认的 2.0 倍率时,繁殖所需的食物为 2 个物品。额外的食物可以来自潜影盒和包裹(Bundle)。
| 设置项 |
默认值 |
备注 |
instant-animals |
true |
总开关 |
animals-instant-tame |
true |
右键即可驯服可驯服生物 |
animals-instant-grow |
true |
幼崽立即变成成年体 |
animals-reset-breed-cooldown |
true |
父母在繁殖后可再次繁殖 |
animals-feed-uses-multiplier |
true |
食物消耗量遵循 fuel-cost-multiplier |
animals-feed-use-shulkers |
true |
从潜影盒中读取额外食物 |
animals-feed-use-bundles |
true |
从包裹中读取额外食物 |
animals-feed-bundle-max-depth |
4 |
包裹嵌套深度 |
村民相关改动
打开或交互村民会清除该玩家的主要和次要负面声望。这将移除因坏八卦带来的惩罚。
当启用交易重置时,在打开交易菜单或与村民交互时,村民配方使用次数、需求、最大使用次数以及正面特殊价格都会重置。这可以防止交易被锁定。
已经处于转化过程中的僵尸村民在加载时会立即完成(1 tick)。如果玩家对虚弱状态的僵尸村民使用金苹果,插件会标记该玩家并强制转化时间为 1 tick(在原版开始转化后)。治愈后,会给该玩家施加 20 点主要正面声望和 25 点次要正面声望的治愈声望值。
当放置一个职业方块时,范围内最近的成年无业村民会将该方块作为潜在的职业站点。默认范围为 1 格。职业分配将在下一个 tick 调度执行。
受代码覆盖的职业方块包括: barrel( barrels)、blast furnace(高炉)、brewing stand(酿造台)、cartography table(制图台)、cauldron(熔炉)、composter(堆肥桶)、fletching table(制箭台)、grindstone(砂轮)、lectern(讲台)、loom(织布机)、smithing table(锻造台)、smoker(烟熏炉)和 stonecutter(切石机)。
| 设置项 |
默认值 |
备注 |
villagers-reset-trade-cooldown |
true |
重置交易使用次数、需求、最大使用次数和正面特殊价格 |
villagers-instant-cure |
true |
强制僵尸村民转化时间为 1 tick |
villagers-instant-workbench-update |
true |
将附近的无业村民分配到新的职业站点 |
villagers-instant-workbench-range |
1 |
职业方块周围的搜索范围 |
批量制作
批量制作利用工作台“全部制作”点击功能,适用于 2x2 玩家合成网格或 3x3 合成表。仅当合成矩阵中至少有一个完整堆叠的物品、显示的配方与矩阵匹配且配方为形状固定或形状无关时才会执行。
插件会根据合成矩阵、玩家背包、潜影盒和 bundles 计算可以制作的物品数量。然后消耗输入材料并给出结果。剩余的容器物品(如配方中的桶)会返还给玩家,如果背包已满则掉落在玩家脚下。
| 设置项 |
默认值 |
备注 |
bulk-crafting |
true |
启用配方书的全部制作批量合成 |
bulk-crafting-use-shulkers |
true |
从潜影盒读取输入材料 |
bulk-crafting-use-bundles |
true |
从 bundles 读取输入材料 |
bulk-crafting-bundle-max-depth |
4 |
bundle 嵌套深度 |
批量村民交易
当玩家在 villagers-bulk-trading-double-click-ticks 时间内两次选择相同的村民交易时,将触发批量交易。默认值为 10 ticks(即半秒)。
插件会检查选定的交易、商人输入槽位、玩家背包、潜影盒和 bundles。它会根据输入材料和剩余的交易使用次数尽可能多地执行交易,然后给予结果物品。批量交易也会应用村民经验值和等级进度。
无论是普通交易还是批量交易,玩家获得的交易经验值都以 1 点经验球的形式掉落。这使得奖励与交易数量成比例,并且允许经验值与修补魔咒配合使用。
如果 villagers-bulk-trading-drop-over-64 为 true,玩家保留一个满堆叠的结果物品,其余部分掉落在玩家脚下。这样可以防止一次批量交易填满整个背包。
| 设置项 |
默认值 |
备注 |
villagers-bulk-trading |
true |
启用双击选择批量交易 |
villagers-bulk-trading-use-shulkers |
true |
从潜影盒读取输入材料 |
villagers-bulk-trading-use-bundles |
true |
从 bundles 读取输入材料 |
villagers-bulk-trading-bundle-max-depth |
4 |
bundle 嵌套深度 |
villagers-bulk-trading-drop-over-64 |
true |
保留一个堆叠,掉落其余部分 |
villagers-bulk-trading-double-click-ticks |
10 |
双击选择窗口时间 |
铁砧改动
当 anvil-unlimited-repair-cost 开启时,插件会从配置中设置铁砧的最大修复成本。默认值为 2147483647,这移除了原版实用的上限。
铁砧合成结果物品会在结果栏中获得一个临时的描述行:Cost: N levels(消耗:N 级)。当玩家取出结果时,该行会被移除。
| 设置项 |
默认值 |
备注 |
anvil-unlimited-repair-cost |
true |
提高铁砧最大修复成本 |
anvil-max-repair-cost |
2147483647 |
插件允许的最大等级成本 |
护甲鞘翅
将鞘翅和下铠胸甲放入铁砧中。合成结果为拥有该胸甲的护甲值、护甲韧性和击退抗性属性的鞘翅,这些属性将应用于胸部装备槽。
结果保留鞘翅的物品类型和纹理。它会合并两个物品的附魔,当两者拥有相同附魔时保留较高等级。铁砧成本设定为 39 级和一个输入物品数量。
生成的物品被标记为护甲鞘翅。作为物品实体,它抵抗岩浆、火焰、火块伤害和高温地面伤害,并取消燃烧效果。
| 设置项 |
默认值 |
备注 |
armored-elytra |
true |
启用鞘翅加下铠胸甲的铁砧合成结果 |
工具耐久度会停止在 1。如果受保护的工具耐久度为 1,则取消方块破坏、方块伤害、近战攻击和弓箭射击。玩家会听到物品损坏的声音,但伴有短暂的冷却时间。
当工具或护甲因耐久度伤害而即将损坏时,伤害事件将被取消,并将物品耐久度设置为 1。
耐久度为 1 的护甲不会永久提供免费的防护。如果玩家在穿着接近破损的护甲时受到伤害,插件会短暂移除该护甲,应用受到的伤害,然后恢复护甲。此时会播放警告声音。
鞘翅不由工具保护检查处理。护甲保护适用于材质名称以 _HELMET、_CHESTPLATE、_LEGGINGS 或 _BOOTS 结尾的物品。
| 设置项 |
默认值 |
备注 |
prevent-tool-break |
true |
保护可损坏的非护甲工具和武器 |
prevent-armor-break |
true |
保护护甲部件 |
背包不死图腾
如果伤害会导致玩家死亡,插件可以从存储中消耗一个不死图腾,而不是要求玩家手持。搜索顺序优先为玩家背包,然后是收纳袋,最后是潜影盒,具体取决于配置。如果启用了末影箱搜索,也会在末影箱中进行相同的搜索。
当 inventory-totem-skip-if-held 为 true 时,如果玩家手中已经持有图腾,插件将不执行任何操作。这种情况由原版处理。
插件自行应用正常的救援模式:生命值设为 1,清除激活的药水效果,添加再生、吸收和防火效果,重置坠落距离,设置无伤计时器,并播放图腾效果、声音和粒子。
| 设置项 |
默认值 |
备注 |
inventory-totem |
true |
启用背包图腾使用 |
inventory-totem-use-shulkers |
true |
搜索潜影盒 |
inventory-totem-use-bundles |
true |
搜索收纳袋 |
inventory-totem-check-ender-chest |
true |
搜索玩家的末影箱 |
inventory-totem-skip-if-held |
true |
让原版处理手持图腾的情况 |
inventory-totem-bundle-max-depth |
4 |
收纳袋嵌套深度 |
精准采集方块恢复
当玩家使用精准采集破坏方块时,插件会尝试将方块物品及其包含的内容物给予玩家,而不是让内容物散落在地面上。如果玩家的背包已满,剩余的物品会在方块附近掉落。
容器内的物品会从 Bukkit 容器中收集。末影箱会被忽略。潜影盒在掉落时会保持其内部物品在潜影盒物品内,而不会提取出内容物。
刷怪笼和试炼刷怪笼有特殊的处理逻辑。它们可以掉落刷怪笼方块、对应存储实体类型的刷怪蛋,或者两者都掉落。刷怪蛋的数量是可配置的。
黑名单中的方块不会被回收。
| 设置项 |
默认值 |
备注 |
silk-touch-recover-blocks |
true |
启用精准采集回收功能 |
silk-touch-recover-allow-creative |
false |
允许在创造模式下回收 |
silk-touch-spawner-drop-spawner |
true |
掉落刷怪笼或试炼刷怪笼方块 |
silk-touch-spawner-drop-egg |
true |
已知实体类型时掉落刷怪蛋 |
silk-touch-spawner-egg-amount |
1 |
掉落的刷怪蛋数量,限制在 0 到 64 之间 |
silk-touch-recover-blacklist |
见配置文件 |
永远不会被回收的方块 |
海泡菜快速放置
右键点击海泡菜可以将一个海泡菜方块填满至 4 个。插件还可以放置在海洋、气泡柱、海草、高海草、海带、海带植株以及可通行的水下空间(waterlogged spaces)中。
它会检查玩家在背包、潜影盒和包中的海泡菜数量,然后尽可能多地添加。如果在延迟放置步骤运行前目标位置发生变化,移除的海泡菜将会退款。
| 设置项 |
默认值 |
备注 |
sea-pickles-fast-place |
true |
启用海泡菜快速填充 |
sea-pickles-fast-place-use-shulkers |
true |
从潜影盒中读取海泡菜 |
sea-pickles-fast-place-use-bundles |
true |
从包中读取海泡菜 |
sea-pickles-fast-place-bundle-max-depth |
4 |
包的嵌套深度 |
包滚动使用 PacketEvents 监听客户端包物品选择数据包。当包内至少有 bundle-scroll-min-stacks 堆物品时,当玩家从最后一个可见包槽位切换到第一个槽位,或从第一个可见槽位切换到最后一个槽位时,插件会旋转存储物品的顺序。
默认的可见窗口为 8 个物品。配合 bundle-scroll-step: 1,每次切换会将包内物品旋转 8 个。bundle-scroll-cooldown-ticks 用于防止因重复的数据包导致旋转过快。
包滚动在其他库存界面打开时也能工作,包括箱子、熔炉、烟熏炉、高炉和其他容器屏幕。
| 设置项 |
默认值 |
备注 |
bundle-scroll |
true |
启用包内物品旋转 |
bundle-scroll-min-stacks |
13 |
旋转前的最小包内物品堆数 |
bundle-scroll-window-size |
8 |
可见的包内物品窗口大小 |
bundle-scroll-step |
1 |
每次切换移动的页数 |
bundle-scroll-cooldown-ticks |
1 |
旋转冷却时间 |
泥巴扩散
当水瓶将泥土变为泥块时,插件会等待一个游戏刻(tick),让原版 Minecraft 生成第一个泥块。如果被点击的方块现在变成了泥块,插件将从该方块开始扩散。
扩散仅检查同一 Y 层级的四个水平方向侧面。只有 DIRT(泥土)会被更改为 MUD(泥块)。已有的泥块会继续传播路径。作业每步处理 mud-spread-blocks-per-step 配置的节点数,并在步骤之间等待 mud-spread-step-interval-ticks 设定的时间间隔。
| 设置项 |
默认值 |
备注 |
mud-spread |
true |
启用使用水瓶后的泥块扩散功能 |
mud-spread-range |
64 |
从第一个泥块出发的最大侧向步数 |
mud-spread-blocks-per-step |
16 |
每步处理的队列节点数 |
mud-spread-step-interval-ticks |
10 |
扩散步骤之间的延迟 |
水中的混凝土粉末
当掉落物实体处于完整的水源方块中时,掉落的混凝土粉末物品实体将转换为混凝土物品实体。插件还会检查物品下方的方块。流动水不计入有效水源。
插件每 2 个游戏刻轮询一次匹配的物品实体,最多持续 60 个游戏刻。这给物品提供了在掉落之后落入水中的时间。
如果掉落的潜影盒或绑定的物品堆(bundle)位于水源中,其中的混凝土粉末可以就地转换。根据两个存储切换选项和绑定的嵌套深度设置,潜影盒中可以包含绑定物品堆,而绑定物品堆中可以包含嵌套的绑定物品堆或潜影盒。
所有 16 种混凝土颜色均已映射支持。
| 设置项 |
默认值 |
备注 |
concrete-powder-in-water |
true |
启用物品实体转换功能 |
concrete-powder-in-water-use-shulkers |
true |
转换掉落潜影盒内的粉末 |
concrete-powder-in-water-use-bundles |
true |
转换掉落绑定物品堆内的粉末 |
concrete-powder-in-water-bundle-max-depth |
4 |
绑定物品堆的嵌套深度 |
活塞耕地保护
此功能允许活塞头在耕地上移动而不将其变为泥土。在正常的 Minecraft 中,这会破坏许多自动作物农场的设计,因为活塞头可能会清除作物行下方的耕地。
启用此功能后,靠近水源的耕地在活塞经过时会受到保护。水源检查使用配置的半径,并认可普通水或已注水的方块。
适用于那些活塞会破坏或移动作物,但耕地必须在下一轮种植周期中保持原位不变的农场。
| 设置项 |
默认值 |
备注 |
piston-protect-farmland |
true |
防止活塞经过时将耕地变为泥土 |
piston-protect-farmland-water-radius |
4 |
水源搜索半径,限制在 1 到 16 之间 |
活塞与飞行机器收获掉落物优化
此行为没有配置选项。当甘蔗或竹子被活塞、粘性活塞或由 slime block(黏液块)/ honey block(蜂蜜块)组成的飞行机器的可动面破坏时,此行为生效。
插件跟踪受影响的整株植物列,并阻止原版掉落物散乱分布。来自该列的掉落物会在能够合并时组合成一个物品堆,然后以零速度放置在植物基座或父方块的底部中心位置。如果总数超过材料堆叠上限,则使用所需的最少数量完整物品实体来显示。
这减少了散落的物品实体,并使大型自动农场更容易由漏斗和收集系统管理。手动破坏甘蔗或竹子时,仍继续使用正常的玩家收获行为。
完整配置参考
settings:
instant-furnace: true
instant-smoker: true
instant-blast-furnace: true
instant-brewing-stand: true
instant-campfire: true
fuel-cost-multiplier: 2.0
safe-fuel-mode: true
instant-animals: true
animals-instant-tame: true
animals-instant-grow: true
animals-reset-breed-cooldown: true
animals-feed-uses-multiplier: true
animals-feed-use-shulkers: true
animals-feed-use-bundles: true
animals-feed-bundle-max-depth: 4
auto-plant: true
auto-plant-allow-creative: false
auto-plant-use-shulkers: true
auto-plant-use-bundles: true
auto-plant-bundle-max-depth: 4
replant-tries: 120
bonemeal-max-grow: true
bonemeal-bamboo-cap: 16
bonemeal-sugar-cane-cap: 3
bonemeal-cactus-cap: 3
villagers-reset-trade-cooldown: true
villagers-instant-cure: true
villagers-instant-workbench-update: true
villagers-instant-workbench-range: 1
bulk-crafting: true
bulk-crafting-use-shulkers: true
bulk-crafting-use-bundles: true
bulk-crafting-bundle-max-depth: 4
villagers-bulk-trading: true
villagers-bulk-trading-use-shulkers: true
villagers-bulk-trading-use-bundles: true
villagers-bulk-trading-bundle-max-depth: 4
villagers-bulk-trading-drop-over-64: true
villagers-bulk-trading-double-click-ticks: 10
sea-pickles-fast-place: true
sea-pickles-fast-place-use-shulkers: true
sea-pickles-fast-place-use-bundles: true
sea-pickles-fast-place-bundle-max-depth: 4
anvil-unlimited-repair-cost: true
anvil-max-repair-cost: 2147483647
armored-elytra: true
prevent-tool-break: true
prevent-armor-break: true
inventory-totem: true
inventory-totem-use-shulkers: true
inventory-totem-use-bundles: true
inventory-totem-check-ender-chest: true
inventory-totem-skip-if-held: true
inventory-totem-bundle-max-depth: 4
silk-touch-recover-blocks: true
silk-touch-recover-allow-creative: false
silk-touch-spawner-drop-spawner: true
silk-touch-spawner-drop-egg: true
silk-touch-spawner-egg-amount: 1
silk-touch-recover-blacklist:
- BEDROCK
- END_PORTAL_FRAME
- END_PORTAL
- NETHER_PORTAL
- STRUCTURE_BLOCK
- JIGSAW
- BARRIER
- LIGHT
bundle-scroll: true
bundle-scroll-min-stacks: 13
bundle-scroll-window-size: 8
bundle-scroll-step: 1
bundle-scroll-cooldown-ticks: 1
mud-spread: true
mud-spread-range: 64
mud-spread-blocks-per-step: 16
mud-spread-step-interval-ticks: 10
concrete-powder-in-water: true
concrete-powder-in-water-use-shulkers: true
concrete-powder-in-water-use-bundles: true
concrete-powder-in-water-bundle-max-depth: 4
piston-protect-farmland: true
piston-protect-farmland-water-radius: 4
GoofyGoober's Quality of Life (GGQOL) 26.2
GGQOL is a Paper/Folia plugin for survival servers. It removes wait time, repeated clicks, and item unpacking from common vanilla tasks. Each feature is controlled from config.yml.
Most inventory features can read from shulker boxes and bundles. Bundle searches have a depth limit so nested bundles do not run forever.
This README covers GGQOL 26.2 for Paper and Folia servers running Java 25.
Requirements
- Paper, Folia, or a compatible Paper/Folia fork for Minecraft 26.2
- Java 25 or newer
- PacketEvents, required for bundle scrolling
- Minecraft 26.2
There are no commands and no permissions. Install the plugin and the PacketEvents jar, then start the server once to generate config.yml.
Feature list
| Feature |
Default |
Main setting |
| Instant furnaces, smokers, and blast furnaces |
on |
instant-furnace, instant-smoker, instant-blast-furnace |
| Instant brewing stands and campfires |
on |
instant-brewing-stand, instant-campfire |
| Auto replant |
on |
auto-plant |
| Bone meal max grow |
on |
bonemeal-max-grow |
| Animal changes |
on |
instant-animals |
| Villager trade and cure changes |
on |
villagers-reset-trade-cooldown, villagers-instant-cure |
| Bulk crafting |
on |
bulk-crafting |
| Bulk villager trading |
on |
villagers-bulk-trading |
| Anvil XP cap removal |
on |
anvil-unlimited-repair-cost |
| Armored elytra |
on |
armored-elytra |
| Tool and armor break protection |
on |
prevent-tool-break, prevent-armor-break |
| Inventory totems |
on |
inventory-totem |
| Silk Touch block recovery |
on |
silk-touch-recover-blocks |
| Sea pickle fast place |
on |
sea-pickles-fast-place |
| Bundle scroll |
on |
bundle-scroll |
| Mud spread |
on |
mud-spread |
| Concrete powder in water |
on |
concrete-powder-in-water |
| Piston farmland protection |
on |
piston-protect-farmland |
| Piston and flying-machine harvest drops |
always on |
No setting |
Instant smelting and processing
Furnaces, smokers, and blast furnaces cook all valid input they can finish with the fuel available. The plugin checks the matching Bukkit cooking recipe, the current output stack, cook progress, burn time, and output stack limit before it changes the inventory.
fuel-cost-multiplier multiplies the cook time cost before fuel is consumed. With the default value of 2.0, a recipe uses twice the normal fuel time. The plugin spends existing burn time first, then consumes fuel items from the fuel slot.
safe-fuel-mode controls unknown fuels. When it is on, the plugin only uses burn times learned from real furnace burn events. When it is off, it can guess common burn times for fuels that Bukkit has not reported yet.
Instant furnace, smoker, and blast-furnace processing records the recipe XP in the block. Players receive the stored XP normally when they remove the cooked output, including output completed in bulk by the plugin.
Brewing stands and campfires use their server events to set brew or cook time to 1 tick.
| Setting |
Default |
Notes |
instant-furnace |
true |
Enables instant furnace recipes |
instant-smoker |
true |
Enables instant smoker recipes |
instant-blast-furnace |
true |
Enables instant blast furnace recipes |
instant-brewing-stand |
true |
Sets brewing time to 1 tick |
instant-campfire |
true |
Sets campfire cook time to 1 tick |
fuel-cost-multiplier |
2.0 |
Multiplies fuel time used |
safe-fuel-mode |
true |
Avoids guessed burn times |
Auto replant
When a supported fully grown crop is broken, the plugin removes one seed or crop item, stores the harvest, and replants the crop. It uses the drops first. If the drops do not include the needed seed, it checks the player inventory, shulker boxes, and bundles based on config.
The replant task retries once per tick up to replant-tries. This helps when another plugin or server timing delay leaves the block occupied for a tick.
Supported normal crops:
- Wheat
- Carrots
- Potatoes
- Beetroot
- Nether Wart
- Torchflower crop
- Pitcher crop
- Melon stems
- Pumpkin stems
Sugar cane and cactus are handled as columns. If the broken block is the base of a multi-block column and the base can be replanted, the full column is removed and one block is replanted. Cactus flowers attached above the cactus column are removed with the cactus. Sugar cane is only replanted on valid soil next to water or a waterlogged block. Cactus is only replanted on sand or red sand with clear sides.
Harvest drops go to the player inventory first. If the inventory is full, auto plant can store leftovers in bundles and shulker boxes before dropping the rest.
| Setting |
Default |
Notes |
auto-plant |
true |
Enables crop and column replanting |
auto-plant-allow-creative |
false |
Allows the feature in creative mode |
auto-plant-use-shulkers |
true |
Reads seeds and stores drops in shulker boxes |
auto-plant-use-bundles |
true |
Reads seeds and stores drops in bundles |
auto-plant-bundle-max-depth |
4 |
Bundle nesting depth |
replant-tries |
120 |
Replant attempts, one per tick |
Bone meal max grow
One bone meal use pushes a target to its max state if it can grow. The plugin only consumes bone meal when something changes.
Supported cases include age-based crops, torchflower crops, pitcher crops, melon stems, pumpkin stems, sugar cane, cactus, bamboo, bamboo saplings, and saplings. Saplings can grow into trees, including 2x2 trees when the saplings are placed that way.
Bone meal also works from dispensers. If a dispenser uses bone meal and nothing can grow, the bone meal item is dropped from the dispenser instead of being consumed.
You can also bone meal the block a crop is attached to in some cases. For example, bone meal on a support block can find an age-based plant, cave vine, or directional crop attached to that block. The plugin skips containers, workstations, redstone controls, beds, doors, signs, cauldrons, anvil blocks, brewing stands, furnaces, and other blocks that should keep their normal right-click behavior.
| Setting |
Default |
Notes |
bonemeal-max-grow |
true |
Enables one-use max grow |
bonemeal-bamboo-cap |
16 |
Max bamboo height |
bonemeal-sugar-cane-cap |
3 |
Max sugar cane height |
bonemeal-cactus-cap |
3 |
Max cactus height |
Animal changes
instant-animals is the master switch for animal changes.
When animals-instant-tame is on, right-clicking an untamed tameable mob sets the player as its owner and plays heart particles. The code does not require a specific taming item.
When animals-instant-grow is on, babies from breeding grow up right away. Chickens spawned from thrown eggs also grow up right away.
When animals-reset-breed-cooldown is on, the parents can breed again after a successful breed event.
Animal feeding can use more than one food item per feed action. If animals-feed-uses-multiplier is on, the food cost is ceil(fuel-cost-multiplier), clamped from 1 to 64. With the default multiplier of 2.0, breeding food costs 2 items. The extra food can come from shulker boxes and bundles.
| Setting |
Default |
Notes |
instant-animals |
true |
Master switch |
animals-instant-tame |
true |
Right-click tames tameable mobs |
animals-instant-grow |
true |
Babies become adults |
animals-reset-breed-cooldown |
true |
Parents can breed again after breeding |
animals-feed-uses-multiplier |
true |
Food cost follows fuel-cost-multiplier |
animals-feed-use-shulkers |
true |
Reads extra food from shulker boxes |
animals-feed-use-bundles |
true |
Reads extra food from bundles |
animals-feed-bundle-max-depth |
4 |
Bundle nesting depth |
Villager changes
Opening or interacting with a villager clears major and minor negative reputation for that player. This removes punishment from bad gossip.
When trade reset is enabled, villager recipe uses, demand, max uses, and positive special price are reset when the trade menu opens or the villager is interacted with. This keeps trades from locking.
Zombie villagers that are already converting finish at 1 tick when loaded. If a player uses a golden apple on a weakened zombie villager, the plugin marks the player and forces conversion time to 1 tick after vanilla starts the conversion. After cure, it applies cure reputation values of 20 major positive and 25 minor positive for that player.
When a villager job site block is placed, the nearest adult unemployed villager in range gets that block as a potential job site. The default range is 1 block. Job assignment is scheduled for the next tick.
Job site blocks covered by the code are barrel, blast furnace, brewing stand, cartography table, cauldron, composter, fletching table, grindstone, lectern, loom, smithing table, smoker, and stonecutter.
| Setting |
Default |
Notes |
villagers-reset-trade-cooldown |
true |
Resets trade uses, demand, max uses, and positive special price |
villagers-instant-cure |
true |
Forces zombie villager conversion time to 1 tick |
villagers-instant-workbench-update |
true |
Assigns nearby unemployed villagers to new job sites |
villagers-instant-workbench-range |
1 |
Search range around the job site block |
Bulk crafting
Bulk crafting uses the recipe book "make all" click in a 2x2 player crafting grid or 3x3 crafting table. It only runs when the crafting matrix has at least one full stack, the shown recipe matches the matrix, and the recipe is shaped or shapeless.
The plugin counts how many crafts can be made from the crafting matrix, player inventory, shulker boxes, and bundles. It then consumes the inputs and gives the result. Leftover container items, such as buckets from a recipe, are returned to the player or dropped at the player's feet if the inventory is full.
| Setting |
Default |
Notes |
bulk-crafting |
true |
Enables recipe book make-all bulk craft |
bulk-crafting-use-shulkers |
true |
Reads inputs from shulker boxes |
bulk-crafting-use-bundles |
true |
Reads inputs from bundles |
bulk-crafting-bundle-max-depth |
4 |
Bundle nesting depth |
Bulk villager trading
Bulk trading runs when the player selects the same villager trade twice within villagers-bulk-trading-double-click-ticks. The default is 10 ticks, which is half a second.
The plugin checks the selected trade, the merchant input slots, the player inventory, shulker boxes, and bundles. It runs as many trades as the inputs and remaining trade uses allow, then gives the result items. Villager XP and level progress are applied for the bulk trades.
Player trade XP is emitted as one-point orb units for both normal and bulk trades. This keeps the reward proportional to the number of trades and allows the XP to work with Mending.
If villagers-bulk-trading-drop-over-64 is true, the player keeps one max stack of the result and the rest is dropped at the player's feet. This keeps bulk trades from filling the whole inventory with one trade result.
| Setting |
Default |
Notes |
villagers-bulk-trading |
true |
Enables double-select bulk trading |
villagers-bulk-trading-use-shulkers |
true |
Reads inputs from shulker boxes |
villagers-bulk-trading-use-bundles |
true |
Reads inputs from bundles |
villagers-bulk-trading-bundle-max-depth |
4 |
Bundle nesting depth |
villagers-bulk-trading-drop-over-64 |
true |
Keeps one stack, drops the rest |
villagers-bulk-trading-double-click-ticks |
10 |
Double-select window |
Anvil changes
When anvil-unlimited-repair-cost is on, the plugin sets the anvil maximum repair cost from config. The default is 2147483647, which removes the practical vanilla cap.
The anvil result item gets a temporary lore line in the result slot: Cost: N levels. That line is removed when the player takes the result.
| Setting |
Default |
Notes |
anvil-unlimited-repair-cost |
true |
Raises the anvil max repair cost |
anvil-max-repair-cost |
2147483647 |
Max level cost allowed by the plugin |
Armored elytra
Place an elytra and a netherite chestplate in an anvil. The result is an elytra with the chestplate's armor, armor toughness, and knockback resistance attributes applied to the chest slot.
The result keeps the elytra item type and texture. It merges enchantments from both items, keeping the higher level when both items have the same enchantment. The anvil cost is set to 39 levels and one input item count.
The resulting item is tagged as an armored elytra. As an item entity, it resists lava, fire, fire tick, and hot floor damage, and combustion is canceled.
| Setting |
Default |
Notes |
armored-elytra |
true |
Enables elytra plus netherite chestplate anvil result |
Tools are stopped at 1 durability. If a protected tool is at 1 durability, block breaking, block damage, melee attacks, and bow shooting are canceled. The player hears the item break sound with a short cooldown.
When a tool or armor piece would break from durability damage, the damage event is canceled and the item is set to 1 durability.
Armor at 1 durability does not give free protection forever. If a player takes damage while wearing near-broken armor, the plugin briefly removes the armor, applies the incoming damage, then restores the armor. The warning sound plays.
Elytra are not handled by the tool protection check. Armor protection applies to items whose material names end in _HELMET, _CHESTPLATE, _LEGGINGS, or _BOOTS.
| Setting |
Default |
Notes |
prevent-tool-break |
true |
Protects damageable non-armor tools and weapons |
prevent-armor-break |
true |
Protects armor pieces |
Inventory Totem of Undying
If damage would kill a player, the plugin can consume a Totem of Undying from storage instead of requiring it in the hand. The search order is player inventory first, then bundles, then shulker boxes, based on config. If ender chest search is enabled, the same search also runs there.
When inventory-totem-skip-if-held is true, the plugin does nothing if the player is already holding a totem. Vanilla handles that case.
The plugin applies the normal rescue pattern itself: health is set to 1, active potion effects are cleared, regeneration, absorption, and fire resistance are added, fall distance is reset, no-damage ticks are set, and the totem effect, sound, and particles play.
| Setting |
Default |
Notes |
inventory-totem |
true |
Enables inventory totem use |
inventory-totem-use-shulkers |
true |
Searches shulker boxes |
inventory-totem-use-bundles |
true |
Searches bundles |
inventory-totem-check-ender-chest |
true |
Searches the player's ender chest |
inventory-totem-skip-if-held |
true |
Lets vanilla handle held totems |
inventory-totem-bundle-max-depth |
4 |
Bundle nesting depth |
Silk Touch block recovery
When a player breaks a block with Silk Touch, the plugin tries to give the block item and any stored contents to the player instead of letting contents scatter on the ground. Leftovers drop near the block if the player's inventory is full.
Container contents are collected from Bukkit containers. Ender chests are ignored. Shulker boxes keep their contents inside the dropped shulker item instead of having their contents extracted.
Spawners and trial spawners have special handling. They can drop the spawner block, a spawn egg for the stored entity type, or both. The spawn egg amount is configurable.
The blacklist blocks are not recovered.
| Setting |
Default |
Notes |
silk-touch-recover-blocks |
true |
Enables Silk Touch recovery |
silk-touch-recover-allow-creative |
false |
Allows recovery in creative mode |
silk-touch-spawner-drop-spawner |
true |
Drops spawner or trial spawner block |
silk-touch-spawner-drop-egg |
true |
Drops spawn egg when a type is known |
silk-touch-spawner-egg-amount |
1 |
Spawn eggs to drop, clamped from 0 to 64 |
silk-touch-recover-blacklist |
see config |
Blocks that are never recovered |
Sea pickle fast place
Right-clicking with sea pickles can fill a sea pickle block up to 4 pickles. The plugin can also place into water, bubble columns, seagrass, tall seagrass, kelp, kelp plants, and passable waterlogged spaces.
It checks how many sea pickles the player has in inventory, shulker boxes, and bundles, then adds as many as fit. If the target changes before the delayed placement step runs, removed pickles are refunded.
| Setting |
Default |
Notes |
sea-pickles-fast-place |
true |
Enables fast sea pickle filling |
sea-pickles-fast-place-use-shulkers |
true |
Reads sea pickles from shulker boxes |
sea-pickles-fast-place-use-bundles |
true |
Reads sea pickles from bundles |
sea-pickles-fast-place-bundle-max-depth |
4 |
Bundle nesting depth |
Bundle scroll uses PacketEvents to listen for the client bundle item selection packet. When a bundle has at least bundle-scroll-min-stacks item stacks, the plugin rotates the stored item order when the player wraps from the last visible bundle slot to the first, or from the first visible slot to the last.
The default visible window is 8 items. With bundle-scroll-step: 1, each wrap rotates the bundle by 8 items. bundle-scroll-cooldown-ticks stops repeated packet spam from rotating too fast.
Bundle scrolling also works while another inventory is open, including chests, furnaces, smokers, blast furnaces, and other container screens.
| Setting |
Default |
Notes |
bundle-scroll |
true |
Enables bundle item rotation |
bundle-scroll-min-stacks |
13 |
Minimum bundle stack count before rotation |
bundle-scroll-window-size |
8 |
Visible bundle item window |
bundle-scroll-step |
1 |
Pages moved per wrap |
bundle-scroll-cooldown-ticks |
1 |
Rotation cooldown |
Mud spread
When a water bottle turns dirt into mud, the plugin waits one tick for vanilla to make the first mud block. If the clicked block is now mud, the plugin spreads from that block.
Spread only checks the four horizontal sides at the same Y level. Only DIRT is changed to MUD. Existing mud continues the spread path. The job processes mud-spread-blocks-per-step nodes each step and waits mud-spread-step-interval-ticks between steps.
| Setting |
Default |
Notes |
mud-spread |
true |
Enables mud spread after water bottle use |
mud-spread-range |
64 |
Max side steps from the first mud block |
mud-spread-blocks-per-step |
16 |
Queue nodes processed per step |
mud-spread-step-interval-ticks |
10 |
Delay between spread steps |
Concrete powder in water
Dropped concrete powder item entities convert into concrete item entities when they are in a full water source block. The block below the item is also checked. Flowing water does not count.
The plugin polls matching item entities every 2 ticks for up to 60 ticks. This gives the item time to fall into water after being dropped.
If a dropped shulker box or bundle is sitting in source water, concrete powder inside it can be converted in place. Shulker boxes can contain bundles, and bundles can contain nested bundles or shulker boxes, based on the two storage toggles and the bundle depth setting.
All 16 concrete colors are mapped.
| Setting |
Default |
Notes |
concrete-powder-in-water |
true |
Enables item entity conversion |
concrete-powder-in-water-use-shulkers |
true |
Converts powder inside dropped shulker boxes |
concrete-powder-in-water-use-bundles |
true |
Converts powder inside dropped bundles |
concrete-powder-in-water-bundle-max-depth |
4 |
Bundle nesting depth |
Piston farmland protection
This lets piston heads move across farmland without turning it into dirt. In normal Minecraft, that breaks many automatic crop farm designs because the piston head can wipe the farmland under the crop row.
When this feature is on, farmland near water is protected while pistons move over it. The water check uses the configured radius and accepts normal water or waterlogged blocks.
Use this for farms where pistons break or move crops, but the farmland must stay in place for the next planting cycle.
| Setting |
Default |
Notes |
piston-protect-farmland |
true |
Keeps farmland from turning into dirt when pistons move over it |
piston-protect-farmland-water-radius |
4 |
Water search radius, clamped from 1 to 16 |
Piston and flying-machine harvest drops
This behavior has no config setting. It applies when sugar cane or bamboo is broken by a piston, sticky piston, or a movable face on a slime-block or honey-block flying machine.
The plugin tracks the full affected plant column and stops the separate vanilla drops from scattering. Drops from that column are combined into one item stack when they fit, then placed with no velocity at the bottom-center of the plant's base, or parent, block. Totals larger than the material's stack limit use the minimum number of full item entities required.
This reduces loose item entities and keeps large automatic farms easier for hoppers and collection systems to manage. Breaking sugar cane or bamboo by hand continues to use the normal player-harvest behavior.
Full config reference
settings:
instant-furnace: true
instant-smoker: true
instant-blast-furnace: true
instant-brewing-stand: true
instant-campfire: true
fuel-cost-multiplier: 2.0
safe-fuel-mode: true
instant-animals: true
animals-instant-tame: true
animals-instant-grow: true
animals-reset-breed-cooldown: true
animals-feed-uses-multiplier: true
animals-feed-use-shulkers: true
animals-feed-use-bundles: true
animals-feed-bundle-max-depth: 4
auto-plant: true
auto-plant-allow-creative: false
auto-plant-use-shulkers: true
auto-plant-use-bundles: true
auto-plant-bundle-max-depth: 4
replant-tries: 120
bonemeal-max-grow: true
bonemeal-bamboo-cap: 16
bonemeal-sugar-cane-cap: 3
bonemeal-cactus-cap: 3
villagers-reset-trade-cooldown: true
villagers-instant-cure: true
villagers-instant-workbench-update: true
villagers-instant-workbench-range: 1
bulk-crafting: true
bulk-crafting-use-shulkers: true
bulk-crafting-use-bundles: true
bulk-crafting-bundle-max-depth: 4
villagers-bulk-trading: true
villagers-bulk-trading-use-shulkers: true
villagers-bulk-trading-use-bundles: true
villagers-bulk-trading-bundle-max-depth: 4
villagers-bulk-trading-drop-over-64: true
villagers-bulk-trading-double-click-ticks: 10
sea-pickles-fast-place: true
sea-pickles-fast-place-use-shulkers: true
sea-pickles-fast-place-use-bundles: true
sea-pickles-fast-place-bundle-max-depth: 4
anvil-unlimited-repair-cost: true
anvil-max-repair-cost: 2147483647
armored-elytra: true
prevent-tool-break: true
prevent-armor-break: true
inventory-totem: true
inventory-totem-use-shulkers: true
inventory-totem-use-bundles: true
inventory-totem-check-ender-chest: true
inventory-totem-skip-if-held: true
inventory-totem-bundle-max-depth: 4
silk-touch-recover-blocks: true
silk-touch-recover-allow-creative: false
silk-touch-spawner-drop-spawner: true
silk-touch-spawner-drop-egg: true
silk-touch-spawner-egg-amount: 1
silk-touch-recover-blacklist:
- BEDROCK
- END_PORTAL_FRAME
- END_PORTAL
- NETHER_PORTAL
- STRUCTURE_BLOCK
- JIGSAW
- BARRIER
- LIGHT
bundle-scroll: true
bundle-scroll-min-stacks: 13
bundle-scroll-window-size: 8
bundle-scroll-step: 1
bundle-scroll-cooldown-ticks: 1
mud-spread: true
mud-spread-range: 64
mud-spread-blocks-per-step: 16
mud-spread-step-interval-ticks: 10
concrete-powder-in-water: true
concrete-powder-in-water-use-shulkers: true
concrete-powder-in-water-use-bundles: true
concrete-powder-in-water-bundle-max-depth: 4
piston-protect-farmland: true
piston-protect-farmland-water-radius: 4
评论 0
登录后参与评分
还没有评论,来抢沙发吧