Advanced Gathering - 高级采集插件

AdvancedGathering 是一款集成了连锁砍树与连锁挖矿功能的高级采集插件，未来还计划加入作物收割特性。它高度可配置，可根据服务器需求在视觉效果与极致性能之间灵活调整。

💡核心特性

• 连锁采集：结合了连锁砍树与连锁挖矿功能。
• 高度可配置：提供丰富选项，可精细调整性能与效果。
• 条件系统：支持基于 PlaceholderAPI 的表达式，可无缝集成其他插件功能。
• 游戏内编辑：几乎所有设置都可通过游戏内命令实时调整。
• 多阶段处理：连锁砍树包含扫描、安全检查、破坏三个阶段，每个阶段均可配置。

> 注意：插件为近期重写版本，可能存在漏洞。发现后请及时反馈以便快速修复。

✨依赖与要求

• 必需依赖：SmileCore
• 间接依赖：SmileCore 依赖于 ProtocolLib 和 PlaceholderAPI。请确保已安装对应前置插件及其扩展。
• 默认状态：连锁砍树功能默认关闭，玩家需自行使用命令开启。

🔧如何使用

玩家可通过以下命令为自己开启或关闭功能

/ag toggle timber      # 切换连锁砍树
/ag toggle oreminer    # 切换连锁挖矿

管理员可使用以下命令在游戏内编辑配置

/ag edit trees         # 编辑树木配置
/ag edit ores          # 编辑矿石配置
/ag edit custom        # 编辑自定义方块配置

权限节点

advancedgathering.commands.edit.trees
advancedgathering.commands.edit.ores
advancedgathering.commands.edit.custom
advancedgathering.commands.toggle.timber
advancedgathering.commands.toggle.oreminer

树木相关的具体权限可在游戏内查看和修改。

🎮配置与表达式系统

插件核心功能通过强大的条件表达式系统驱动。表达式支持算术与布尔运算，其中 true 对应 1.0，false 对应 0.0。

表达式示例

• 基础条件判断：(%player_level% > 10) * 20 —— 玩家等级大于10时值为20.0，否则为0.0。
• 概率判断：
• 50% 几率：%randomnumber_number_10% > 0.5
• 精确 3.75% 几率：%randomnumber_number_100% > 0.0375
• 物品检查：%checkitem_matcontains:AXE,inhand:main% = "yes" —— 检查主手是否持有斧类工具。

支持的运算符号

()   - 括号优先计算 (3 * (4 + 1))
e, pi - 数学常数
+ - * / ^ % - 基本算术运算
abs, round, ceil, floor - 取整函数
rand - 生成随机数
log, sqrt, cbrt - 对数与根运算
sin, cos, tan, asin, acos, atan, sinh, cosh - 三角函数
true, false - 布尔常量
= != > < >= <= - 比较运算符
| & ! - 布尔或、与、非运算

字符串需用引号 " " 包裹。

命名表达式

你可以在 SmileCore 文件夹下的 named-conditions.json 文件中定义复杂的命名表达式，然后在配置中使用 #表达式名称# 来引用它们。

⭐预设流程示例

插件允许你组合不同的阶段模式来实现不同的采集体验：

• 流畅模式：平滑扫描 -> 平滑安全检查 -> 瞬间破坏 (掉落物飞向玩家)
• 高效模式：瞬间扫描 -> 瞬间安全检查 -> 瞬间破坏 (掉落物直接进入背包)
• 经典模式：瞬间扫描 -> 平滑安全检查 -> 平滑破坏 (掉落物正常掉落)

你可以为任何方块配置连锁采集，将其用作通用的“矿脉挖掘”工具。所有配置均可通过游戏内命令实时编辑，也支持直接修改 data.json 文件（但不推荐）。