Vanishing Ground
Vanishing Ground 是一款适用于 Minecraft 26.2 的 Fabric 模组,它将普通的地面变成了挑战的一部分。当玩家站在方块上时,方块会保持原位;而当最后一名玩家离开后,方块便会消失。
它专为跑酷地图、挑战地图、生存挑战以及每一步都至关重要的多人联机世界而设计。该模组默认处于关闭状态,因此安装它并不会自行改变现有世界的任何内容。
玩法示例
以下 gameplay sample 展示了模组的实际效果:
工作原理
模组会检查支撑每位玩家的方块,并使用 Minecraft 的碰撞箱(collision shapes)进行判定。台阶、楼梯、地毯、栅栏、雪层、活板门以及其他半砖类方块的处理方式与原版处理落地的逻辑相同。
只有当没有任何被追踪的玩家站在方块上时,该方块才会被移除。多名玩家可以共享同一个方块。只要最后一名玩家尚未离开,方块就会保留。
方块的移除可以是立即生效,也可以是在延迟后生效。如果在延迟期间有人重新踩回该方块,移除操作将被取消。同一位置只会排队一次。
在空中跳跃会保留最后的支撑方块,因此原地起跳不会导致地板消失。落在其他方块上仍会使之前的方块变为空置状态。
旁观者模式永远不会被追踪。默认情况下,创造模式玩家也会被忽略,因此在单人游戏或共享服务器上建造是安全的。游泳、鞘翅飞行、自由飞行和骑乘载具都不算作“站在方块上”。死亡、重生、维度切换和断开连接会清除追踪记录,但不会移除方块。
保护机制
基岩、下界传送门、末地传送门和末地折跃门无法消失。
流体以及带有方块实体(block entities)的方块(如箱子和熔炉)默认受到保护。
随模组附带的 #vanishingground:protected 标签还涵盖了命令方块、结构方块、刷怪笼、屏障、箱子等几乎不会被删除的方块。
你可以通过数据包扩展或替换这些标签:
data/vanishingground/tags/block/protected.json 用于黑名单模式
data/vanishingground/tags/block/vanishing.json 用于白名单模式
在白名单模式下,混合生存或冒险世界更安全:除非你特意将该方块加入选项,否则什么都不会消失。
配置
模组默认禁用。配置文件会在首次启动时创建,路径为 config/vanishingground.json。
{
"enabled": false,
"delayTicks": 0,
"warningTicks": 0,
"destroyFluids": false,
"destroyBlockEntities": false,
"blockSelectionMode": "BLACKLIST",
"removalMode": "VANISH",
"restoreTicks": 40,
"allowedDimensions": [],
"affectCreative": false,
"sneakProtects": false,
"vacateWhenFlyingOrMounted": false,
"immunePlayers": []
}
将 enabled 设置为 true,或使用 /vg enable 命令。
1.0.x 和 1.1.0 版本的配置文件在加载时会自动升级。命令更改会立即保存。
命令
所有命令都需要管理员权限(等级 2)。
/vg 是 /vanishingground 的简短别名。
/vg help
/vg enable
/vg disable
/vg status
/vg debug
计时设置
/vg delay <ticks>
/vg warning <ticks>
/vg restore <ticks>
delay 0 表示方块一旦空置即立即移除。delay 20 表示等待约一秒。warning 会在延迟移除前显示粒子效果和短促音效。restore 仅在移除模式为 restore 时生效。
可消失的内容
/vg fluids allow
/vg fluids protect
/vg block_entities allow
/vg block_entities protect
/vg mode blacklist
/vg mode whitelist
/vg removalmode vanish
/vg removalmode restore
blacklist(黑名单):除非被硬性保护或标记为 #vanishingground:protected,否则所有固体方块均可消失
whitelist(白名单):仅标记为 #vanishingground:vanishing 的方块可以消失
vanish(消失):方块永久消失
restore(恢复):如果该位置仍然是空气且为空,方块将在恢复延迟后重新出现
作用范围与对象
/vg dimensions add minecraft:overworld
/vg dimensions remove minecraft:overworld
/vg dimensions clear
/vg dimensions list
/vg creative ignore
/vg creative affect
/vg sneak protect
/vg sneak normal
/vg flyleave keep
/vg flyleave vanish
/vg immune add <onlinePlayer>
/vg immune remove <onlinePlayer>
/vg immune clear
/vg immune list
空的维度列表意味着所有维度。如果希望该机制仅在跑酷世界中运行,请对其进行限制。
sneak protect 会在玩家潜行离开时保留方块。flyleave keep(默认值)不会将起飞或骑乘视为“走开”。
添加或移除免疫玩家时,他们必须在线。
预设配置
/vg preset parkour
/vg preset challenge
/vg preset safe
parkour:以白名单模式启用模组,设置较短的延迟、警告提示和恢复功能
challenge:以黑名单模式启用模组,即时消失,包括影响创造模式玩家
safe:白名单、恢复、潜行保护,默认保持禁用,直到你手动开启
使用 /vg status 查看预设应用后的结果。
安装
你需要:
- Minecraft 26.3
- Fabric Loader
- Fabric API
0.159.0+26.2
- Java 25
将模组 JAR 文件放入 Fabric 安装目录下的 mods 文件夹中。
项目状态
Vanishing Ground 是一个小型项目。代码已开源,如果你想要制作挑战地图、修改规则、修复错误或将其更新到更高版本的 Minecraft,都可以随意使用。
开发
在项目根目录下执行:
./gradlew build
编译后的 JAR 文件将放置在 build/libs/ 中。
更新日志
1.3.0
- 移植至 Minecraft 26.3,使用 Fabric API
0.161.0+26.3。
- 加载器版本仍为 0.19.5。仍需 Java 25。
1.2.0
- 添加了
/vg 作为短别名以及 /vg help。
- 添加了预设:
parkour、challenge、safe。
- 默认忽略创造模式玩家。
- 添加了潜行保护、飞行/骑乘离开行为以及免疫玩家列表。
- 每个位置的待移除和恢复操作会进行去重。
- 当模组禁用时,待移除操作会被丢弃。
- 在世界编辑前检查区块加载状态。
- 支持的位置现在存储不可变的方块位置。
- 默认的受保护和消失方块标签附带初始条目。
- 来自 1.1.0 版本的配置文件会自动获得新字段。
1.1.0
- 添加了黑名单和白名单方块选择功能。
- 添加了
#vanishingground:vanishing 用于白名单模式。
- 添加了恢复模式,使消失的方块可以重新出现。
- 在延迟移除前添加警告。
- 添加了维度过滤功能。
- 添加了
/vanishingground debug 命令。
- 添加了单元测试和 GitHub Actions 构建流程。
1.0.1
- 添加了在游戏内配置 Vanishing Ground 的命令。
- 添加了 enable、disable、status、delay、fluids 和 block entity 命令。
- 命令更改会自动保存。
1.0.0
许可证
Vanishing Ground 采用 MIT 许可证授权。
源代码:
Vanishing Ground
Vanishing Ground is a Fabric mod for Minecraft 26.2 that turns ordinary ground into part of the challenge. Blocks stay in place while players stand on them and can disappear when the last player leaves.
It is made for parkour courses, challenge maps, survival challenges, and multiplayer worlds where every step matters. It stays off until you enable it, so installing it does not change an existing world by itself.
Gameplay Sample
This gameplay sample shows the mod in action:
How It Works
The mod checks which block is supporting each player and uses Minecraft collision shapes for that. Slabs, stairs, carpets, fences, snow layers, trapdoors, and other partial blocks are handled the same way vanilla handles landing.
A block is removed only when no tracked player is standing on it. Several players can share one block. It stays until the last player leaves.
Removal can happen immediately or after a delay. If anyone steps back onto the block during the delay, the removal is cancelled. The same position is only queued once.
Jumping in the air keeps the last support block, so a jump in place does not delete the floor. Landing on a different block still vacates the previous one.
Spectators are never tracked. By default, Creative players are also ignored, so building in singleplayer or on a shared server stays safe. Swimming, Elytra flight, flying, and riding a vehicle do not count as standing on a block. Death, respawn, dimension change, and disconnect clear tracking without removing a block.
Protection
Bedrock, Nether portals, End portals, and End gateways cannot vanish.
Fluids and blocks with block entities such as chests and furnaces are protected by default.
The shipped #vanishingground:protected tag also covers command blocks, structure blocks, spawners, barriers, chests, and similar blocks you almost never want deleted.
You can extend or replace the tags with a data pack:
data/vanishingground/tags/block/protected.json used in blacklist mode
data/vanishingground/tags/block/vanishing.json used in whitelist mode
Whitelist mode is the safer choice on mixed survival or adventure worlds: nothing vanishes unless you opt that block in.
Configuration
The mod is disabled by default. The config file is created on first launch at config/vanishingground.json.
{
"enabled": false,
"delayTicks": 0,
"warningTicks": 0,
"destroyFluids": false,
"destroyBlockEntities": false,
"blockSelectionMode": "BLACKLIST",
"removalMode": "VANISH",
"restoreTicks": 40,
"allowedDimensions": [],
"affectCreative": false,
"sneakProtects": false,
"vacateWhenFlyingOrMounted": false,
"immunePlayers": []
}
Set enabled to true, or use /vg enable.
Config files from 1.0.x and 1.1.0 are upgraded on load. Command changes are saved immediately.
Commands
All commands need Gamemaster permissions (level 2).
/vg is a short alias of /vanishingground.
/vg help
/vg enable
/vg disable
/vg status
/vg debug
Timing
/vg delay <ticks>
/vg warning <ticks>
/vg restore <ticks>
delay 0 removes a vacated block immediately. delay 20 waits about one second. warning shows particles and a short sound before a delayed removal. restore only applies when removal mode is restore.
What may vanish
/vg fluids allow
/vg fluids protect
/vg block_entities allow
/vg block_entities protect
/vg mode blacklist
/vg mode whitelist
/vg removalmode vanish
/vg removalmode restore
blacklist: every solid block can vanish unless it is hard-protected or tagged #vanishingground:protected
whitelist: only blocks tagged #vanishingground:vanishing can vanish
vanish: the block is gone for good
restore: the block comes back after the restore delay if the spot is still air and empty
Where and who
/vg dimensions add minecraft:overworld
/vg dimensions remove minecraft:overworld
/vg dimensions clear
/vg dimensions list
/vg creative ignore
/vg creative affect
/vg sneak protect
/vg sneak normal
/vg flyleave keep
/vg flyleave vanish
/vg immune add <onlinePlayer>
/vg immune remove <onlinePlayer>
/vg immune clear
/vg immune list
An empty dimension list means every dimension. Restrict it if the mechanic should only run in a parkour world.
sneak protect keeps the block you step off while sneaking. flyleave keep (default) does not treat takeoff or mounting as walking away.
Immune players must be online when added or removed.
Presets
/vg preset parkour
/vg preset challenge
/vg preset safe
parkour: enables the mod in whitelist mode with a short delay, a warning, and restore
challenge: enables the mod in blacklist mode with instant vanish, including Creative
safe: whitelist, restore, sneak protect, left disabled until you turn it on
Use /vg status after a preset to review the result.
Installation
You need:
- Minecraft 26.3
- Fabric Loader
- Fabric API
0.159.0+26.2
- Java 25
Put the mod JAR in the mods folder of your Fabric installation.
Project Status
Vanishing Ground is a small project. The code is available if you want to make a challenge map, change the rules, fix bugs, or update it for a newer Minecraft version.
Development
From the project root:
./gradlew build
The compiled JAR files are placed in build/libs/.
Changelog
1.3.0
- Ported to Minecraft 26.3 with Fabric API
0.161.0+26.3.
- Loader remains 0.19.5. Java 25 is still required.
1.2.0
- Added
/vg as a short alias and /vg help.
- Added presets:
parkour, challenge, safe.
- Creative players are ignored by default.
- Added sneak-protect, fly/mount leave behaviour, and an immune player list.
- Pending removals and restores are deduplicated per position.
- Pending removals are dropped when the mod is disabled.
- Chunk-loaded checks before world edits.
- Support positions now store an immutable block position.
- Default protected and vanishing block tags ship with starter entries.
- Config files from 1.1.0 gain the new fields automatically.
1.1.0
- Added blacklist and whitelist block selection.
- Added
#vanishingground:vanishing for whitelist mode.
- Added restore mode so vanished blocks can reappear.
- Added a warning before delayed removal.
- Added dimension filtering.
- Added
/vanishingground debug.
- Added unit tests and a GitHub Actions build.
1.0.1
- Added in-game commands for configuring Vanishing Ground.
- Added enable, disable, status, delay, fluids, and block entity commands.
- Command changes are saved automatically.
1.0.0
License
Vanishing Ground is licensed under the MIT License.
Source code:
评论 0
登录后参与评分
还没有评论,来抢沙发吧