VeinSpread

插件

· 作者 MoonFlower

将普通方块变成像菌丝或幽匿那样活生生、不断生长的脉络。完全可配置。

0 本站下载 0 关注 更新于 2 周前

最新 1.2.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

? VeinSpread

by Moon Flower

基于菌丝的方块蔓延效果——类似菌丝体、幽匿或藤蔓。 一款轻量级的 Paper/Spigot 插件,适用于 Minecraft 1.21+。完全可通过 config.yml 或游戏内命令进行配置。


✨ 特性

  • 蔓延的是“脉络”,而非圆形。 感染以蜿蜒的线条和分支生长——如同菌丝体、幽匿脉络或树根。
  • 催化剂驱动。 放置一个催化剂方块,脉络便会从它开始蔓延。破坏它后,生长停止,但已经生成的方块会保留在世界中。
  • 完全可控。 步进速度、脉络长度、分支频率、方向“惯性”、垂直分支、尖端限制——所有参数均可配置。
  • 可替换方块列表。 你决定脉络允许“吞噬”哪些方块。使用 /vein blocks 查看当前列表。
  • 时间条件。 脉络只能在夜间、白天或全天生长。
  • 游戏内管理。 支持自动补全的 /vein 命令:无需重启服务器即可更改百分比、方块和速度。更改会立即保存到配置文件中。
  • 持久化生长。 活跃的脉络会保存至 veins.json,并在服务器重启后无缝恢复。
  • 本地化支持。 玩家消息默认同时支持英文和俄文。

? 目标用户

  • SMP 服务器 希望在不添加模组或新维度的情况下增添“活的世界”氛围。
  • 剧情向生存服 ——将脉络作为“感染”、“诅咒”或“古代腐化”。
  • 建造者与装饰者 ——用幽匿或菌丝体制作精美的有机图案。
  • 管理员 需要一种可定制的替代方案,拥有比幽匿催化剂更灵活逻辑。

? 安装

  1. 确保你拥有 Paper 1.21+(或 Spigot 1.21+)以及 Java 21。
  2. 从 Modrinth 或 GitHub 的 Releases 页面下载 VeinSpread-1.1.1.jar。
  3. 将 .jar 文件放入服务器的 plugins/ 文件夹中。
  4. 重启服务器。
  5. 打开 plugins/VeinSpread/config.yml —— 或者直接在游戏中的 /vein 命令进行配置。

⚙️ 快速开始

最小示例:菌丝体 将 石头 和 泥土 转化为 菌丝体, 每 3 秒生长一次,脉络长度为 12 格,分支几率为 25%。

vein:
  catalyst-block: "MYCELIUM"
  result-block: "MYCELIUM"
  replaceable-blocks:
    - "STONE"
    - "DIRT"
    - "GRASS_BLOCK"
  interval-ticks: 60
  tip-energy: 12
  branch-chance: 0.25
  persistence: 0.75
  max-branch-depth: 3
  vertical-branch-chance: 0.1
  max-tips-per-catalyst: 8

time-conditions:
  enabled: false

在石头上放置一块菌丝体——然后后退。几秒钟后,你会看到脉络在石头上蔓延。


? 配置

vein 部分

参数 类型 默认值 描述
catalyst-block Material SCULK_CATALYST 放置时触发生长的方块
result-block Material SCULK “被吞噬”的方块转化成的结果方块
replaceable-blocks list stone, cobblestone, dirt, grass_block, deepslate 脉络允许替换的方块列表
interval-ticks int 100 步进之间的间隔(20 ticks = 1 秒)
tip-energy int 12 单个尖端可进行的步数
branch-chance 0.0–1.0 0.2 每一步发生分支的几率
max-branch-depth int 3 最大分支深度
persistence 0.0–1.0 0.7 惯性:1.0 — 直线,0.0 — 混乱
vertical-branch-chance 0.0–1.0 0.1 向上/向下分支的几率
max-tips-per-catalyst int 8 防卡顿保护

time-conditions 部分

参数 类型 默认值 描述
enabled bool false 启用游戏内时间条件
start-time long 13000 窗口开始时间(ticks,0–24000)
end-time long 23000 窗口结束时间(支持跨越 0 点)

? 命令

所有命令都需要 veinspread.admin 权限(默认为 op)。

命令 描述
/vein reload 重载配置文件
/vein info 显示当前设置
/vein list 列出活跃的催化剂和尖端
/vein blocks 列出所有可替换方块
/vein set <parameter> <value> 动态更改设置
/vein addblock <Material> 将方块添加到列表中
/vein removeblock <Material> 从列表中移除方块
/vein help 显示帮助信息

示例

/vein set branch-chance 30%
/vein set persistence 0.85
/vein set interval 60
/vein set tip-energy 20
/vein set vertical 5%
/vein set max-branch-depth 4
/vein set maxtips 12
/vein set catalyst-block MYCELIUM
/vein set result-block MYCELIUM
/vein addblock RED_SAND
/vein removeblock DIRT
/vein set time true
/vein set start-time 13000
/vein set end-time 23000

百分比接受 30%、0.3 或 30 三种格式——解析器能识别这三种形式。


? 权限

权限 描述 默认值
veinspread.admin 访问 /vein 命令 op

? 用例

生存模式“腐化”

vein:
  catalyst-block: "SCULK_CATALYST"
  result-block: "SCULK"
  replaceable-blocks: ["STONE", "DEEPSLATE", "COBBLESTONE", "GRAVEL"]
  interval-ticks: 120
  tip-energy: 25
  branch-chance: 0.15
  persistence: 0.85
  max-branch-depth: 2
  vertical-branch-chance: 0.05
  max-tips-per-catalyst: 4

```yaml
time-conditions:
  enabled: true
  start-time: 13000
  end-time: 23000

在夜晚,腐化会爬过石头;而在白天,它则会冻结。非常适合打造“被诅咒的生物群系”。

“活体森林”

vein:
  catalyst-block: "OAK_LOG"
  result-block: "MOSS_BLOCK"
  replaceable-blocks: ["DIRT", "GRASS_BLOCK", "STONE", "COBBLESTONE"]
  interval-ticks: 80
  tip-energy: 15
  branch-chance: 0.35
  persistence: 0.6
  vertical-branch-chance: 0.2
  max-tips-per-catalyst: 12

?️ 从源码构建

git clone https://github.com/Moon-F1ower/VeinSpread.git
cd VeinSpread
mvn clean package

编译生成的 .jar 文件将出现在 target/VeinSpread-x.y.z.jar 中。
要求:Maven 3.9+、JDK 21。


❓ 常见问题

我可以在 Spigot 上使用它而不是 Paper 吗?
可以,但推荐使用 Paper —— 该插件已在 Paper 上经过测试,且 1.21 API 在 Paper 上更稳定。

它与 WorldGuard 兼容吗?
目前还不支持 —— 插件通过 Block.setType() 放置方块,而不会触发 BlockSpreadEvent。WorldGuard 无法检测到这些变化。此功能已在开发计划中。

重启服务器后脉络(veins)会被保存吗?
是的!活跃的脉络每 5 分钟以及服务器关闭时都会保存到 veins.json 文件中。当服务器再次启动时,它们将无缝恢复生长。

我可以拥有具有不同设置的多组催化剂吗?
在当前版本中——不行,整个服务器只有一个配置文件。按 Material 分类的配置文件(Profiles)已在开发计划中。

是否支持细脉络(如幽匿脉络、地衣)?
不支持,仅支持完整方块的替换。此功能已在开发计划中。

为什么脉络没有生长?

  1. 催化剂必须已被放置(不能仅在物品栏中)。
  2. replaceable-blocks 中的方块需通过精确的 Material 匹配。
  3. 如果启用了 time-conditions —— 请确认当前时间是否符合条件。
  4. 区块必须已加载(附近有玩家在线)。

?️ 开发计划

  • 将活跃脉络保存到磁盘(YAML/JSON)(已在 v1.1.0 完成)
  • 游戏内本地化(英文/俄文)(已在 v1.1.0 完成)
  • 支持细方块(SCULK_VEIN、GLOW_LICHEN、VINE)
  • 不同的催化剂配置文件(Map<Material, Profile>)
  • 光照与生物群系条件
  • 触发 BlockSpreadEvent 以兼容 WorldGuard / GriefPrevention
  • bStats 统计支持
  • BlockFadeEvent —— 无催化剂情况下的“衰变”脉络

? 许可与源码

本项目采用 MIT 许可证授权 —— 详见 LICENSE。
源代码可在 GitHub 获取:github.com/Moon-F1ower/VeinSpread


? 反馈

发现 bug 或有建议?请在 GitHub 上提交 Issue:github.com/Moon-F1ower/VeinSpread/issues

如果您在自己的服务器上使用了该插件——我很乐意看到 Modrinth 评论区的截图 ?

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源