? VeinSpread
by Moon Flower
基于菌丝的方块蔓延效果——类似菌丝体、幽匿或藤蔓。
一款轻量级的 Paper/Spigot 插件,适用于 Minecraft 1.21+。完全可通过
config.yml 或游戏内命令进行配置。
✨ 特性
- 蔓延的是“脉络”,而非圆形。 感染以蜿蜒的线条和分支生长——如同菌丝体、幽匿脉络或树根。
- 催化剂驱动。 放置一个催化剂方块,脉络便会从它开始蔓延。破坏它后,生长停止,但已经生成的方块会保留在世界中。
- 完全可控。 步进速度、脉络长度、分支频率、方向“惯性”、垂直分支、尖端限制——所有参数均可配置。
- 可替换方块列表。 你决定脉络允许“吞噬”哪些方块。使用
/vein blocks 查看当前列表。
- 时间条件。 脉络只能在夜间、白天或全天生长。
- 游戏内管理。 支持自动补全的
/vein 命令:无需重启服务器即可更改百分比、方块和速度。更改会立即保存到配置文件中。
- 持久化生长。 活跃的脉络会保存至
veins.json,并在服务器重启后无缝恢复。
- 本地化支持。 玩家消息默认同时支持英文和俄文。
? 目标用户
- SMP 服务器 希望在不添加模组或新维度的情况下增添“活的世界”氛围。
- 剧情向生存服 ——将脉络作为“感染”、“诅咒”或“古代腐化”。
- 建造者与装饰者 ——用幽匿或菌丝体制作精美的有机图案。
- 管理员 需要一种可定制的替代方案,拥有比幽匿催化剂更灵活逻辑。
? 安装
- 确保你拥有 Paper 1.21+(或 Spigot 1.21+)以及 Java 21。
- 从 Modrinth 或 GitHub 的 Releases 页面下载
VeinSpread-1.1.1.jar。
- 将
.jar 文件放入服务器的 plugins/ 文件夹中。
- 重启服务器。
- 打开
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)已在开发计划中。
是否支持细脉络(如幽匿脉络、地衣)?
不支持,仅支持完整方块的替换。此功能已在开发计划中。
为什么脉络没有生长?
- 催化剂必须已被放置(不能仅在物品栏中)。
replaceable-blocks 中的方块需通过精确的 Material 匹配。
- 如果启用了
time-conditions —— 请确认当前时间是否符合条件。
- 区块必须已加载(附近有玩家在线)。
?️ 开发计划
- 将活跃脉络保存到磁盘(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 评论区的截图 ?
? VeinSpread
by Moon Flower
Organic vein-based block spreading — like mycelium, sculk, or vines.
A lightweight Paper/Spigot plugin for Minecraft 1.21+. Fully configurable via
config.yml or in-game commands.
✨ Features
- Veins, not circles. Infection grows in winding lines with branches — like mycelium, sculk veins, or tree roots.
- Catalyst-driven. Place a catalyst block — and veins start crawling from it. Break it — growth stops, but the blocks that have already grown remain in the world.
- Full control. Step speed, vein length, branching frequency, direction "inertia", vertical branches, tip limit — everything is configurable.
- Replaceable blocks list. You decide what the vein is allowed to "eat". Use
/vein blocks to see the current list.
- Time conditions. Veins can grow only at night, only during the day, or always.
- In-game management. The
/vein command with tab-completion: change percentages, blocks, and speed without restarting the server. Changes are saved to the config immediately.
- Persistent growth. Active veins are saved to
veins.json and seamlessly resume after a server restart.
- Localization. Player messages support both English and Russian out of the box.
? Target Audience
- SMP servers looking to add a "living world" without mods or new dimensions.
- Lore-based survival — veins as an "infection", "curse", or "ancient corruption".
- Builders and decorators — beautiful organic patterns made of sculk or mycelium.
- Admins who need a customizable alternative to the sculk catalyst with flexible logic.
? Installation
- Make sure you have Paper 1.21+ (or Spigot 1.21+) and Java 21.
- Download
VeinSpread-1.1.1.jar from the releases page on Modrinth or GitHub.
- Place the
.jar into the plugins/ folder on your server.
- Restart the server.
- Open
plugins/VeinSpread/config.yml — or use /vein directly in-game.
⚙️ Quick Start
Minimal example: mycelium turns stone and dirt into mycelium,
grows every 3 seconds, veins are 12 blocks long, branching chance is 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
Place a mycelium block on stone — and step back. In a couple of seconds, you will see veins crawling across the stone.
? Configuration
vein section
| Parameter |
Type |
Default |
Description |
catalyst-block |
Material |
SCULK_CATALYST |
The block that triggers growth when placed |
result-block |
Material |
SCULK |
What the "eaten" blocks turn into |
replaceable-blocks |
list |
stone, cobblestone, dirt, grass_block, deepslate |
Blocks the vein is allowed to replace |
interval-ticks |
int |
100 |
Interval between steps (20 ticks = 1 sec) |
tip-energy |
int |
12 |
How many steps a single tip makes |
branch-chance |
0.0–1.0 |
0.2 |
Chance to branch at each step |
max-branch-depth |
int |
3 |
Maximum branching depth |
persistence |
0.0–1.0 |
0.7 |
Inertia: 1.0 — straight lines, 0.0 — chaos |
vertical-branch-chance |
0.0–1.0 |
0.1 |
Chance to branch up/down |
max-tips-per-catalyst |
int |
8 |
Lag protection |
time-conditions section
| Parameter |
Type |
Default |
Description |
enabled |
bool |
false |
Enable in-game time condition |
start-time |
long |
13000 |
Start of the window (ticks, 0–24000) |
end-time |
long |
23000 |
End of the window (supports wrap-around past 0) |
? Commands
All commands require the veinspread.admin permission (default is op).
| Command |
Description |
/vein reload |
Reload the config |
/vein info |
Show current settings |
/vein list |
List active catalysts and tips |
/vein blocks |
List all replaceable blocks |
/vein set <parameter> <value> |
Change a setting on the fly |
/vein addblock <Material> |
Add a block to the list |
/vein removeblock <Material> |
Remove a block from the list |
/vein help |
Show help |
Examples
/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
Percentages are accepted as 30%, 0.3, or 30 — the parser understands all three forms.
? Permissions
| Permission |
Description |
Default |
veinspread.admin |
Access to /vein commands |
op |
? Use Cases
Survival "Corruption"
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
time-conditions:
enabled: true
start-time: 13000
end-time: 23000
At night, the corruption crawls across the stone; during the day, it freezes. Perfect for a "cursed biome".
"Living Forest"
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
?️ Building from Source
git clone https://github.com/Moon-F1ower/VeinSpread.git
cd VeinSpread
mvn clean package
The compiled .jar will appear in target/VeinSpread-x.y.z.jar.
Requirements: Maven 3.9+, JDK 21.
❓ FAQ
Can I use it on Spigot instead of Paper?
Yes, but Paper is recommended — it was tested on Paper, and the 1.21 API is more stable there.
Does it work with WorldGuard?
Not yet — the plugin places blocks via Block.setType() without firing BlockSpreadEvent. WorldGuard won't see it. It's on the roadmap.
Are veins saved after a restart?
Yes! Active veins are saved to veins.json every 5 minutes and on server shutdown. They will seamlessly resume growing when the server starts again.
Can I have multiple catalysts with different settings?
In the current version — no, there is a single config for the server. Profiles by Material are on the roadmap.
Are thin veins (sculk veins, lichen) supported?
No, only full block replacement. It's on the roadmap.
Why aren't the veins growing?
- The catalyst is placed (not just in the inventory).
- Blocks in
replaceable-blocks match by exact Material.
- If
time-conditions is enabled — it is currently the right time.
- Chunks are loaded (a player is nearby).
?️ Roadmap
- Save active veins to disk (YAML/JSON) (Done in v1.1.0)
- In-game localization (English/Russian) (Done in v1.1.0)
- Support thin blocks (
SCULK_VEIN, GLOW_LICHEN, VINE)
- Different catalyst profiles (
Map<Material, Profile>)
- Light and biome conditions
- Fire
BlockSpreadEvent for WorldGuard / GriefPrevention compatibility
- bStats
-
BlockFadeEvent — "decaying" veins without a catalyst
? License & Source
This project is licensed under the MIT License — see LICENSE.
Source code is available on GitHub: github.com/Moon-F1ower/VeinSpread
? Feedback
Found a bug or have a suggestion? Please open an issue on GitHub: github.com/Moon-F1ower/VeinSpread/issues
If you use the plugin on your server — I'd love to see screenshots in the Modrinth comments ?
评论 0
登录后参与评分
还没有评论,来抢沙发吧