XcGatherPro
采集系统插件
信息
- 性质: 付费
- 支持核心: Arclight[Fabric/NeoForge]
- 插件前置: packetevents[Plugins][depend], ArcartX[Plugins][depend]
- 游戏版本: 1.21.1
插件介绍
XcGather 是一款采集系统插件,支持自定义采集物模型、种子种植与阶段性成长、采集工具与种子工具、采集限制(每日/总量/条件/手持物品检测)、采集冷却、刷新条件(群系/时间/天气/高度)、奖励系统等高级特性。
指令列表
| 指令 | 权限要求 | 含义 |
|---|---|---|
| /xg help | xcgather.help | 查看命令帮助 |
| /xg checkspawn | xcgather.checkspawn | 查看当前位置可生成的采集物 |
| /xg collect spawn <配置ID> <采集点ID> | xcgather.collect.spawn | 在玩家位置生成采集实体 |
| /xg collect remove <采集点ID> | xcgather.collect.remove | 移除指定采集实体 |
| /xg collect removealign | xcgather.collect.removealign | 移除准星对准的采集实体 |
| /xg seed spawn <种子ID> | xcgather.seed.spawn | 在目标方块上生成种子实体 |
| /xg seed removealign | xcgather.seed.removealign | 移除准星对准的种子实体 |
| /xg seed give <玩家> <配置名> [数量] | xcgather.seed.give | 给予玩家种子物品 |
| /xg collect_tools giveitem <工具ID> [玩家] [数量] | xcgather.collect_tools.giveitem | 给予玩家采集工具 |
| /xg seed_tools giveitem <工具ID> [玩家] [数量] | xcgather.seed_tools.giveitem | 给予玩家种子工具 |
| /xg reload | xcgather.reload | 重新加载配置文件 |
config 主配置文件说明
作用
配置文件 config.yml ,是主配置文件,它能配置数据库等配置。
yaml
# 日志
debug: false
# 数据库配置
database:
# 数据库类型: sqlite 或 mysql
type: sqlite
# MySQL数据库配置 (仅当type为mysql时生效)
mysql:
host: localhost
port: 3306
database: XcGather
username: root
password: password
# 连接参数
properties: "?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai"collect 采集物配置文件说明
作用
位于 plugins/XcGather/collect/ 目录下的配置文件,用于配置采集物的模型、采集时间、冷却、限制、奖励等。
yaml
# 支持无限拓展,并且支持在文件夹内创建新的 yml
测试:
# 装饰名
disname: "&a神奇植物"
# 使用的模型
model: "植物/test"
# 实体模型的缩放比例
scale: 1.0
# 实体尺寸 (宽度和高度)
size:
width: 1.0
height: 1.5
# 采集时信息
casting: "&7您正在采集 &f{disname} &7中"
# 采集限制
limit:
# 变量判断 支持papi变量
# 评估条件表达式 支持的比较运算符: ==, !=, >, <, >=, <=
math:
list: [ ]
tip: "您不满足! &7您无法采集 &f{disname}!"
# 每日采集该类型限制 采集成功才算
daily:
# 数量 0表示不限制
number: 0
tip: "您已经采集了 &f{number} &7个 &f{disname} &7,请等待 &f{time} &7秒后再采集"
# 采集限制 采集成功才算
restrictions:
number: 0
tip: "您已经采集了 &f{number} &7个 &f{disname} &7,达到了采集上限!"
# 检测限制
# 检测玩家采集该类型植物时 检测手持物品的lore或者name
handheld:
- type: "lore"
list:
- "&7测试"
tip: "您无法采集 &f{disname} &7,请检查您的物品lore!"
- type: "name"
list:
- "&7测试"
tip: "您无法采集 &f{disname} &7,请检查您的物品name!"
# 该采集点介绍
introduction: |-
诞生与极寒之地
测试测试测试测试
# 采集成功率 (0-1)
successrate: 1.0
# 时间节点配置
time:
# 右键采集该类型的所需时间 秒
collect: 3.0
# 采集类型冷却时间 秒
cooldown: 5.2
# 复活时间 秒(当采集完该类型多久后重新生成一个) 填 -1则不复活
respawn: 10.0
# 生成点配置
spawn:
# 点位冷却时间
# 该设置是用来避免玩家长期占据优质采集点
pointtime: 0.0
# 是否随机出生 写0为不随机,其他数值为随机生成在采集点多大范围内
deviation: 0.0
# 采集成功时奖励
reward:
# 必给奖励 没有概率
mustGet:
- '[tell]&7采集成功 这是必给奖励 '
# 奖励 有概率 概率每个都是独立概率
# [执行的动作] 内容 |概率
get:
- '[tell]&7采集成功 这是概率奖励 |0.5'
# 采集每个阶段执行的内容
# {p} 采集玩家名
# {disname} 采集植物名
# {cooltime} 冷却剩余时间(仅在cooldown动作中可用)
actions:
start:
- '[tell]&7玩家 &f{p} &7开始了采集 &f{disname}'
interrupt:
- '[tell]&7玩家 &f{p} &7中断了采集 &f{disname}'
success:
- '[tell]&7玩家 &f{p} &7成功采集了 &f{disname}'
fail:
- '[broadcast]&7玩家 &f{p} &7采集 &f{disname} &7失败'
cooldown:
- '[broadcast]&7{disname}采集冷却中,请{cooltime}稍后再试'collectspawn 采集物刷新配置文件说明
作用
位于 plugins/XcGather/collectspawn/ 目录下的配置文件,用于配置采集物的自动刷新条件。
yaml
"1":
# 植物类型名称
# 指 collect/example.yml中配置
name: "测试"
# 刷新条件设置
spawnConditions:
# 刷新时间 (秒)
time: "1600"
# 刷新概率 0-1
weight: 1.0
# 生成的世界
worlds:
- "world"
# 群系限制
biomes:
- "plains"
# 时间限制
times:
- "day"
- "noon"
- "dusk"
- "night"
- "midnight"
- "dawn"
# 天气限制 不填或者删除该配置则不受该配置限制
weathers:
- "clear"
# 高度限制配置
y-level:
min: -64
max: 320collect_tools 采集工具配置文件说明
作用
位于 plugins/XcGather/collect_tools/ 目录下的配置文件,用于配置采集工具的效果和消耗。
yaml
# 支持无限拓展,并且支持在文件夹内创建新的 yml 不重复即可
植物采集道具:
# 植物采集道具 绑定的是mm的物品库
# {id} 返回配置的名称 植物采集道具
bing: "{id}"
# 道具效果
effect:
# 类型
# collectTimeModify 缩短植物采集时间 (秒)
# collectReduceTimeByPercent 缩短植物采集时间百分比 (0 - 1)
type: "collectTimeModify"
# 时间/百分比
value: 3
# 消耗
consumption:
# 类型 [item为消耗物品/custom为消耗物品耐久值]
type: "item"
value: 1 # 每次使用消耗1个物品
# 动作
actions:
success:
- '[title],&7成功对作物使用 &a{disname} &7道具.'seed 种子配置文件说明
作用
位于 plugins/XcGather/seed/ 目录下的配置文件,用于配置种子的阶段性成长、采集和奖励。
yaml
种子测试:
# 种子物品 绑定的是mm的物品库
# 注意 是mm物品库的item配置名称 而不是 mm物品库的道具物品名称
# {id} 返回配置的名称 种子测试
# xg seed give <玩家id> <配置名称> 获得指定种子植物的种子
bing: "{id}"
# 采集时信息
casting: "&7您正在采集 &f{disname} &7中"
# 阶段性成长
stage:
# 可以无限创建配置
1:
# 阶段名称
name: "&f[&7幼年期&f]"
# 采集物名称
disname: "&a神奇种子&f[&a幼年期&f]"
# 使用的模型
model: "植物/香蕉种子"
# 实体模型的缩放比例
scale: 1.0
# 实体尺寸 (宽度和高度)
size:
width: 1.0
height: 1.5
# 采集成功率 (0.0 - 1.0)
successrate: 1.0
# 该采集点介绍
introduction: |-
诞生与极寒之地
种子1测试测试测试测试
种子2测试测试测试测试222
种子3测试测试测试测试333
# 时间节点配置
time:
# 右键采集该类型的所需时间 秒
collect: 3.0
# 冷却时间 (秒)
cooldowntime: 10.0
# 到达下一阶段所需要的时间 如果下一段时间无配置 则没有下一段 (秒)
next: 5.0
access:
# 该阶段是否可以采集 删除该配置或者true为可采集
cancollect: false
# 不可采集时的提示
tip: "&7此物处于幼年时期,不可采集"
# 采集每个阶段执行的内容
# command 玩家执行
# op 玩家以 op 执行
# console 玩家以控制台执行
# broadcast 广播信息
# tell 仅采集玩家
# {p} 采集玩家名
# {disname} 采集物名称
# {cooltime} 冷却时间
actions:
start:
- '[tell]&7玩家 &f{p} &7开始了采集 &f{disname}'
success:
- '[tell]&7玩家 &f{p} &7成功采集了 &f{disname}'
fail:
- '[tell]&7玩家 &f{p} &7采集 &f{disname} &7失败'
interrupt:
- '[tell]&7玩家 &f{p} &7采集 &f{disname} &7中断'
cooldown:
- '[tell]&7{disname}采集冷却中,请{cooltime}秒稍后再试'
2:
name: "&f[&c成年期&f]"
disname: "&a神奇种子&f[&a成年期&f]"
model: "植物/香蕉完整体"
scale: 1.0
size:
width: 1.0
height: 1.5
successrate: 1.0
introduction: |-
诞生与极寒之地
种子1测试测试测试测试
种子2测试测试测试测试222
种子3测试测试测试测试333
time:
collect: 2.0
cooldowntime: 60.0
# 到达下一阶段所需要的时间 如果下一段时间无配置 则没有下一段
next: 0.0
access:
cancollect: true
tip: " "
actions:
start:
- '[tell]&7玩家 &f{p} &7开始了采集 &f{disname}'
success:
- '[tell]&7玩家 &f{p} &7成功采集了 &f{disname}'
fail:
- '[tell]&7玩家 &f{p} &7采集 &f{disname} &7失败'
interrupt:
- '[tell]&7玩家 &f{p} &7采集 &f{disname} &7中断'
cooldown:
- '[tell]&7{disname}采集冷却中,请{cooltime}秒稍后再试'seed_tools 种子工具配置文件说明
作用
位于 plugins/XcGather/seed_tools/ 目录下的配置文件,用于配置种子工具的效果和消耗。
yaml
# 支持无限拓展,并且支持在文件夹内创建新的 yml 不重复即可
种子水壶测试道具:
# 种子水壶测试道具 绑定的是mm的物品库
# {id} 返回配置的名称 种子水壶测试道具
bing: "{id}"
# 道具效果
effect:
# 类型
# timeModify 缩短成长时间 (秒)
# reduceTimeByPercent 缩短成长时间百分比 (0 - 1)
# collectTimeModify 缩短种子植物采集时间 (秒)
# collectReduceTimeByPercent 缩短种子植物采集时间百分比 (0 - 1)
type: "timeModify"
# 时间/百分比
value: 3
# 消耗
consumption:
# 类型 [item为消耗物品/custom为消耗物品耐久值]
type: "item"
value: 1 # 每次使用消耗1个物品
# 动作
actions:
success:
- '[title],&7成功对作物使用 &a{disname} &7道具.'message 消息配置文件说明
作用
配置文件 message.yml ,用于配置插件的各种提示消息。
yaml
# 消息配置文件
check-spawn:
only-player: "&c该命令只能由玩家执行!"
current-world: "&7当前世界: &f%world%"
current-biome: "&7当前群系: &f%biome_cn% &7(%biome_en%)"
# 列表显示格式
# %name% - 采集物名称
# %chance% - 生成概率
item-format: "&f[%name%&f][&e%chance%&f]"
no-items: "&c当前位置没有符合生成条件的采集物。"
header: "&a当前位置可生成的采集物:"
seed:
mature-stage: "&a已成熟[可采集]"
tool:
item-not-enough: "&c物品数量不足,需要 {need} 个,当前 {have} 个"
durability-not-enough: "&c耐久度不足,需要 {need} 点,当前 {have} 点"游戏截图

