跳到正文

PotatoBuildWorld(Atmospheric)

作者:Malingshu0515

PotatoBW:适用于 1.21.1 NeoForge 的模组,将每个密闭空间视为独立气体容器,加入氧气、气压以及窒息/氧气中毒机制。

收藏

截图

介绍

介绍由机器翻译自 CurseForge 原页面,仅供参考。

# PotatoBW — 详细概述(第一至三部分)

## I. 项目定位

**PotatoBW** 是一款面向玩法的轻量级模组,适用于 **Minecraft 1.21.1 / NeoForge 21.1.235**(模组 ID 为 `potato_bw`,版本为 `0.15.0`)。它的核心理念可以用一句话概括:

> **每个封闭空间都是一个独立的气体容器——拥有自己的氧气量、总气体量和压力,并会因呼吸、火焰和熔炉而持续消耗。**

它不是装饰或工具类模组,而是一款**由服务器权威计算的“密闭空间气体模拟器”**:玩家用方块封闭起来的任何房间、洞穴、潜水钟或飞艇舱室,都会被实时检测,并成为参与模拟的“气体容器”。这里的氧气是**虚拟属性**——只是在 SavedData 中保存的一个 `double`;模组不会注册氧气流体或方块。

—

## II. 概览

| 项目 | 数值 |
|—|—|
| 版本 | `0.15.0`(唯一数据源:`gradle.properties` 中的 `mod_version`) |
| 平台 | Minecraft `1.21.1` · NeoForge `21.1.235` · Java `21` |
| 构建 | Gradle Wrapper `9.2.1` + `net.neoforged.gradle.userdev 7.1.38`,离线构建(缓存位于 `E:\gradle-home`) |
| 构建产物 | [potato_bw-0.15.0.jar](build/libs/potato_bw-0.15.0.jar) — **196,888 B / 141 个条目**,正式版 jar 不包含 `com/potatobw/test/**` |
| 代码规模 | **42 个 .java 文件 / 5,616 行 / 12 个包**;最大的文件:`OxygenGameTests` 1,611 行、`OxygenManager` 987 行、`SpaceRecord` 323 行 |
| 已注册内容 | 4 个方块、4 个物品、2 个生物效果、1 个音效、4 个数据包标签、4 种伤害类型 |
| 验证结果 | 离线构建 ✅ · GameTest **53/53**(日志:`All 53 required tests passed :)`)· 使用真实 Sable 2.0.6 对相同源码测试,结果同为 53/53 |
| 许可证 | 保留所有权利 |

—

## III. 核心玩法机制

### 1. 密闭空间检测——几何泛洪填充

从玩家所在方块开始进行**六向连通的泛洪填充**;只有能阻止扩散的方块才算作“密封”:

“`text
isSealing(state):
    if state.isAir()                          -> false
    if leaves (LeavesBlock / #minecraft:leaves) -> false   # leaves leak
    return state.isCollisionShapeFullBlock()  # must be a full 1×1×1 collision box
“`

因此,**栅栏、砖墙、头颅、活板门、门、玻璃板、台阶、楼梯、地毯和箱子**都会漏气。另有两种情况会直接导致密封失败:

– 任意格子**与天空相通**(`MOTION_BLOCKING` 高度图)→ 视为漏气;
– **未加载的区块**或**世界高度边界**→ 视为漏气。

**空间标识 = 包围盒**:泛洪填充结果中的 `(minX,minY,minZ)-(maxX,maxY,maxZ)` 字符串就是空间键,因此持久化非常简单。代价是,任何形状变化都会被视为一个新空间。

### 2. 气体与压力模型(v0.9.0 语义)

“`text
Volume V(L)        = 1000 L × all passable cells in the space   # 1 block = 1 m³
Reference Vref(L)  = largest volume since sealing               # used for display %
Total gas Gas(L)   and oxygen O2(L) tracked separately
Pressure P(atm)    = Gas / V                                    # 1 atm = 101.325 kPa
Display O2 (%)     = clamp(O2 / Vref × 100, 0, 100)
“`

关键“语义决策”:

– **容量按可通行方块计算**(空气、水、火把、栅栏、门等都按每格 1000 L 计),所以装满水的房间容量并非零,而是 `27,000 L / 243 L (0.9%)`;
– **氧气总量守恒**:挖掉方块会扩大空间,但**不会凭空产生氧气**,所以原本有 1 格、氧气浓度为 21% 的空间挖成 2 格后,氧气浓度变为 10.5%;
– **填入方块会提高气压,但不会提高显示的 O₂%**(分母采用 Vref),避免出现“往房间里塞方块来刷氧气百分比”的情况;
– **消耗只会减少氧气,不会减少总气体量**(呼吸时约为 O₂ ↔ CO₂),因此气压主要受空间体积变化影响,而显示的氧气浓度会随消耗下降。

### 3. 维度大气与高度大气

| 维度 | 气压倍率 | 氧气体积分数 | 纯空气读数 |
|—|—|—|—|
| 主世界 | `1.0` | `21%` | 21% |
| 下界 | `1.6` | `27%` | 27% |
| 末地 | `0.8` | `19.5%` | 19.5% |

主世界还会叠加一层**高度大气**([HeightAtmosphere.java](src/main/java/com/potatobw/oxygen/HeightAtmosphere.java)):

– `y < -64` → 真空(0 atm / 0%);
– `-64 ≤ y ≤ 192` → 使用旧版近似模型 `P = exp(-0.004×(y−sea))`,氧气浓度为 21%;
– `y > 192` → 使用真实高度模型(1 格 = 10 米):`P = exp(-((y−sea)×10)/8500)`,氧气浓度 = 21% × P(y=200 时约为 **17.9%**)。

配合数据包 [overworld.json](src/main/resources/data/minecraft/dimension_type/overworld.json) 将主世界设置为 `min_y=-128`、`height=2160`,**最高可建造高度为 Y=2031**(1.21.1 引擎的 `DimensionType.MAX_Y` 硬性上限;无法到达 2048;只覆盖高度字段,所有生成规则仍为原版设置)。

### 4. 氧气消耗(每刻)

| 来源 | 消耗量 |
|—|—|
| 玩家静止 / 移动 / 剧烈活动 | `0.005` / `0.01` / `0.05` L |
| 其他生物 | `碰撞箱体积 / 玩家体积 × 状态消耗率 × 1.2` |
| 每个火把 / 灯笼 | `0.005` L |
| 每个火焰方块(`#minecraft:fire`) | `0.1` L |
| 点燃的熔炉 / 高炉 | `0.15` / `0.3` L |

**不会消耗氧气,也不会受到低氧影响的对象**:亡灵(`#minecraft:undead`)、傀儡(`potato_bw:oxygenless_mobs`,默认包括铁傀儡/雪傀儡)、盔甲架/画/物品展示框等非 Mob 实体,以及水下呼吸生物。

### 5. 低氧与高氧的双向影响

这是本项目最有“玩法感”的部分——**氧气太少会致命,太多也一样**:

| 显示的 O₂ 浓度 | 效果 |
|—|—|
| `< 15%` | 失明 + 虚弱 II,每秒受到 4 点窒息伤害(`potato_bw:hypoxia`,无视护甲,不造成击退),心跳声,**所有火把/灯笼都会被替换成“闷燃”方块**,**熔炉停止运作** |
| `< 6%` | 每刻受到 **20 点** `potato_bw:critical_hypoxia` 伤害,**可杀死创造模式玩家**,无视无限护甲 / Manaita 式死亡保护 |
| `22.5–23.5%` | 跳跃提升 I + 速度 I |
| `25–30%` | 饥饿 I |
| `30–40%` | 氧中毒(镜头摇晃 + 周期性视野变化,不用 shader,兼容 shader 包) |
| `> 40%` | 氧中毒(每增加 5% 提高 1 级,最高 19 级),造成 1 点伤害的间隔为 `25 >> amplifier` 刻,**可能致命**,生命条会叠加红色显示 |

火焰也会根据氧气浓度变化:低于 `14.5%` 时熄灭(灵魂火除外),高于 `50%` 时会以爆炸威力 2 爆炸。

### 6. 气压生理反应(v0.14.0,适用于所有生物)

每个 `LivingEntity` 都有一个“体内气压”,每 5 刻最多向目标气压平衡 `0.05 atm`,每 20 刻结算一次:

| 现象 | 条件 | 效果 |
|—|—|—|
| 气压伤 | Δ > 0.6 atm | 每秒造成 `(|Δ|−0.6)×6` 点 `potato_bw:pressure` 伤害 |
| 挤压伤(水压/高气压) | > 3 atm 且不具备水下呼吸能力 | 每秒造成 `(P−3)×1.5` 点伤害 |
| 氮醉 | > 2 atm 且不具备水下呼吸能力 | 恶心 + 缓慢(最高 III 级) |
| 低气压缺氧 | < 0.6 / 0.35 / 0.25 atm | 虚弱 → 缓慢 → 额外伤害 |

静水压:水为 `0.0968 atm/格`,熔岩为 `0.242 atm/格`(最高 20 atm)。

PotatoBW 是一个面向 Minecraft 1.21.1 / NeoForge 21.1.235 的玩法向轻量模组(mod id potato_bw,版本 0.15.0)。核心设定:

每一个密闭空间都是一个独立的气体容器——有自己的氧气量、总气体量和气压,并会随着呼吸、燃烧、炉子运转持续被消耗。

它不是装饰/工具类模组,而是一套服务端权威的“封闭空间气体模拟器”:玩家用方块亲手封出来的房间、洞穴、潜水钟、飞艇舱室,都会被实时识别为一个个“气体容器”并参与模拟。氧气在本项目中是虚拟属性(SavedData 里的一个 double),不注册任何氧气流体或方块。


 

常见问题

PotatoBuildWorld(Atmospheric) 支持哪些 Minecraft 版本?

PotatoBuildWorld(Atmospheric) 支持 Minecraft Java 版 1.21.1,可用的加载器:NeoForge。下载时注意选择和你游戏版本一致的文件。

PotatoBuildWorld(Atmospheric) 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。

评论

登录后评论和评分

Malingshu0515 的其他作品

查看全部 →