Prolong

Prolong – 模组介绍

📖 Description / 模组简介

Prolong is a lightweight Forge mod for Minecraft 1.20.1 that adds the /buff command, allowing you to extend the duration and increase the level of existing potion effects on the fly.
It supports all registered effects – vanilla or mod-added – via Minecraft's registry system.

Note: The mod now hard‑caps all effect levels at 255 to prevent numerical overflow.
You are still strongly encouraged to use the ex parameter to set lower, game‑balanced limits for time and level according to your needs.

Prolong 是一个为 Minecraft 1.20.1 Forge 开发的轻量级模组，添加了 /buff 指令，让你随时延长已有药水效果的持续时间和等级。
它通过游戏注册表支持所有已注册的效果，包括原版和其他模组添加的效果。

注意： 本模组现已将所有效果等级硬性封顶为 255，防止数值溢出。
但仍强烈建议你使用 ex 参数根据实际游戏平衡设置更低的时间和等级上限。

✨ Features / 功能特性

• Extend duration – Add seconds to any existing effect
• Increase level – Boost amplifier level of any active effect
• Batch & Random operations – Use /buff extend_all to extend all effects, or /buff extend_random to pick one randomly
• Multiple targets – Support selectors like @a, @p, @r and player names
• Mod compatibility – Works with any registered effect, including those from other mods
• Smart limits – Set time and level caps via the ex parameter (-1 = unlimited)
• Per‑effect tracking – Records cumulative extensions per player and effect; resets when effect expires or is removed
• Negative values supported – Shorten time or lower levels (zero causes removal)
• Bilingual feedback – All messages in English and Chinese
• No dependencies – Lightweight and standalone

• 延长持续时间 – 为任意已有效果增加秒数
• 提升效果等级 – 为任意已有效果提升等级
• 批量 & 随机操作 – 使用 /buff extend_all 延长所有效果，或用 /buff extend_random 随机选中一个
• 多目标支持 – 支持 @a、@p、@r 等选择器及玩家名
• 模组兼容 – 支持所有已注册效果，包括其他模组添加的
• 智能上限 – 通过 ex 参数设置时间和等级上限（-1 = 无限制）
• 按效果独立追踪 – 记录每个玩家每个效果的累计延长数据，效果移除或过期时自动清零
• 支持负值 – 可缩短时间或降低等级，归零时自动移除效果
• 双语反馈 – 所有提示信息支持中英文
• 无依赖 – 轻量独立，开箱即用

📜 Command Usage / 指令用法

Basic commands / 基础指令

timeLimit = cumulative total seconds limit per effect (-1 = unlimited)
levelLimit = final level cap for extend; cumulative addition cap for extend_all/random (-1 = unlimited)

timeLimit 表示每个效果本轮累计延长的总秒数上限（-1 无限制）
levelLimit：对于 extend 为最终等级上限；对于 extend_all/random 为累计增加等级上限（-1 无限制）

Parameters / 参数

Examples / 示例

Single effect / 单个效果
/buff extend @s minecraft:strength add 5 1
/buff extend @s minecraft:speed add 10 0 ex 60 0

Batch all / 批量延长全部
/buff extend_all @a 10 1 ex 120 3
(Extends all effects on all players by 10s and +1 level, cumulative time cap 120s, cumulative addition cap 3 levels)
(延长所有玩家的所有效果 10 秒并提升 1 级，累计时间上限 120 秒，累计增加等级上限 3 级)

Random / 随机延长
/buff extend_random @p 5 0
(Randomly picks one effect on the nearest player and extends it by 5 seconds)
(随机延长最近玩家身上的一个效果 5 秒)

Negative values / 负值缩短
/buff extend_all @s -5 -1
(Shorten all effects by 5s and lower level by 1; removes if time ≤0 or level <0)
(所有效果缩短 5 秒并降低 1 级，若时间 ≤0 或等级 <0 则移除)

🛡️ Permissions / 权限

All commands require OP level 2 by default.
所有指令默认需要 OP 权限等级 2。

Now with extended batch/random operations, per‑effect tracking, and a hard level cap of 255 – keeping your game stable and your effects under control!
现已支持批量/随机延长、独立效果追踪，以及硬性等级封顶 255 – 让你的游戏更稳定，效果更可控！