NaN

NaN - Minecraft Math Destruction Experiment / 数学崩溃实验

> ⚠️ WARNING / 严重警告：This mod will completely break your Minecraft. Not intended for normal gameplay. / 这个模组会让你的 Minecraft 彻底疯掉。不适用于正常游玩。

---

What is this? / 这是什么

NaN is an experimental Fabric mod that overwrites core mathematical functions in `MathHelper` using minimal Mixin code, twisting Minecraft's world into an indescribable Cthulhu dimension.

NaN 是一个实验性 Fabric 模组，用极少的 Mixin 代码覆盖 `MathHelper` 中的核心数学函数，将 Minecraft 的世界扭曲成一个不可名状的克苏鲁维度。

7 `@Overwrite` annotations. Total annihilation. / 7个 `@Overwrite`，毁灭一切。

---

Effects / 效果展示

| System / 系统 | Symptom / 症状 | |------------------------|-----------------------------------------------------------------| | Player Movement / 玩家移动 | W walks backward, S walks forward / 按W后退，按S前进 | | Sun & Moon / 日月轨迹 | Sun rises from the north / 太阳从北方升起 | | Selection Box / 选择框 | Crosshair aims forward, box offset to the right / 准星指前方，选择框歪到右边 | | Terrain / 地形 | Random-height spiked pillars, honeycomb chaos / 随机高度针板柱，Y轴蜂窝乱码 | | Caves / 洞穴 | Random internal cheese-like holes / 内部结构随机奶酪化 | | Animations / 动画 | All smooth transitions jitter like Parkinson's / 所有平滑过渡帕金森抽搐 | | Camera / 视角 | Micro-tremors when moving / 移动时画面微颤 | | Textures / 纹理 | UV coordinates jitter / UV坐标抖动 | | Block Detection / 方块判定 | Sometimes normal, sometimes insane / 随机时正常时疯 | | Numeric Sign / 数值正负 | Randomly flips positive/negative / 随机取反 | | Loading Screen / 加载界面 | Progress bar jumps erratically / 进度条跳大神 |

---

Bonus Feature / 附加功能

`/pos` Command / 传送命令

Teleport yourself into the void of mathematical impossibility.

把你自己送进数学的不可能深渊。

| Command / 命令 | Effect / 效果 | |--------------------|--------------------------------------------------------------------------------------------| | `/pos nan nan nan` | Become one with NaN. Coordinates cease to exist. / 化身NaN，坐标不复存在 | | `/pos inf inf inf` | Ascend to infinity. The game will try to calculate the incalculable. / 飞升至无穷，游戏将尝试计算不可计算之物 | | `/pos <x> <y> <z>` | Teleport to any coordinate. No limits. No safety. / 传送到任意坐标，没有限制，没有安全 |

In a world where math is already broken, this command is the final nail in the coffin. / 在一个数学已经崩溃的世界里，这个命令是棺材上的最后一颗钉子。

How it works / 技术原理

Uses Mixin to overwrite methods in `net.minecraft.util.math.MathHelper`:

通过 Mixin 覆盖 `net.minecraft.util.math.MathHelper` 中的方法：

| Method / 方法 | Modification / 改动 | Impact / 影响 | |--------------|----------------------------------------------|-----------------------------------------| | `cos` | Returns `sin(value)` / 返回sin值 | All angles shift by 90° / 所有角度偏移90度 | | `lerp` | Delta + random ±5% / delta加随机抖动 | All smooth animations jitter / 所有平滑动画抽搐 | | `perlinFade` | Returns `Math.random()` / 返回纯随机 | Terrain Y-axis pure random / 地形Y轴纯随机 | | `lerp2` | Result + random ±0.15 / 结果加随机偏移 | Terrain surface lumpy / 地形表面疙瘩化 | | `lerp3` | Result + random ±0.15 / 结果加随机偏移 | Cave structure randomized / 洞穴结构随机化 | | `clamp` | Randomly returns min/max/random / 随机返回边界或随机值 | Block detection chaotic / 方块判定时疯时正常 | | `abs` | Randomly flips sign / 随机取反 | Positive/negative values chaos / 正负乱跳 |

---

Why "NaN"? / 为什么叫 NaN

NaN stands for Not a Number in computing — produced when a mathematical operation has no definable result. This mod turns Minecraft's mathematical foundation into NaN.

NaN 在计算机中代表 Not a Number（不是数字）——当一个数学运算的结果无法被定义时就会产生 NaN。这个模组让 Minecraft 的数学基础变成了 NaN。

---

Installation / 安装

1. Install Fabric Loader 0.15.0+ / 安装 Fabric Loader 2. Install Fabric API / 安装 Fabric API 3. Place this mod in your `mods` folder / 将本模组放入 `mods` 文件夹 4. Launch the game / 启动游戏 5. Create a new world / 新建世界 6. Embrace the madness / 拥抱疯狂

---

Compatibility / 兼容性

- Minecraft 1.20.1 - Requires Fabric API / 需要 Fabric API - Incompatible with other mods that modify `MathHelper` (if any exist) / 与其他修改 `MathHelper` 的模组不兼容 - DO NOT use on any world you care about / 不要在任何你在乎的存档中使用

---

⚠️ Known Issues / 已知问题

Stability / 稳定性

Stability: It's in God's hands. / 看老天爷脸色。

The world may generate successfully, or it may crash with a beautifully chaotic crash report. Certain seeds and biomes are more prone to explosions than others. You have been warned.

世界可能成功生成，也可能随时给你生成一份错误报告当纪念品。某些种子和生物群系比其他地方更容易爆炸。别怪我没提醒你。

Performance / 效率

Patience is mandatory. / 慢慢等吧。

World creation takes at least 5 minutes. The loading progress bar will jump erratically between 3% and 100% like an electrocardiogram on caffeine. If a Mojang developer saw that log, they would cry.

创建世界至少需要5分钟起步。加载进度条会在3%到100%之间来回横跳，像喝了咖啡的心电图。Mojang 开发人员看了日志都要哭。

Don't trust the progress bar. It lies. / 别信进度条。它嘴里没一句实话。

---

Use cases / 用途

- 🎬 Record absurd gameplay videos / 拍摄离谱的游戏视频 - 🔬 Study Minecraft's underlying math architecture / 研究 Minecraft 底层数学架构 - 🌌 Experience Lovecraftian cosmic horror / 体验洛夫克拉夫特式宇宙恐怖 - 🏆 Prove "minimal code, maximal chaos" / 证明"最少代码，最大后果"

---

Inspiration / 灵感来源

This mod was directly inspired by B站UP主 灵夜风和 and their amazing video that shows the beautiful chaos of breaking Minecraft's math.

本模组的灵感直接来源于 B站UP主 灵夜风和 的精彩视频，展现了打破 Minecraft 数学逻辑的美丽混沌。

- 灵感视频 / Inspiration video: 灵感视频 / Inspiration video: - 灵感视频 / Inspiration video: %%MD1%%

> 正如灵夜风和在他的置顶评论中所言，改变 Minecraft 的数学逻辑并非易事。直接修改所有底层方法会导致爆栈或数组越界，最终只能精准地改动几个关键函数，并小心翼翼地保证数值浮动范围一致。这种在崩溃边缘试探的艺术，正是本模组试图延续的精神。

Special thanks also to 普通の史蒂夫, whose work inspired 灵夜风和's video and, in turn, this mod.

同样感谢 普通の史蒂夫，他的作品启发了灵夜风和的视频，并间接促成了这个模组。

---

License / 许可证

MIT License — Do whatever you want. Don't blame me. / 想干嘛干嘛，出事别找我。

---

Credits / 致谢

- 普通の史蒂夫 — The inspiration behind this whole disaster / 这场灾难的灵感来源 - 普通の史蒂夫 — The spark that lit the first fire / 点燃第一把火的火花 - Mojang — Made Minecraft, the perfect sandbox to break / 造了 Minecraft，这个完美的破坏沙盒 - Fabric Team — Made Mixin, the scalpel we use to dissect the game / 造了 Mixin 这把解剖游戏的手术刀 - All the crash reports along the way — You taught us the limits / 一路上的每一个崩溃报告 — 是你们教会了我们边界在哪

---

*"One line of code, and the world collapses. The fewest lines, the maximum destruction in Minecraft modding history." / "一行代码，万物崩塌。这是 Minecraft 混元历史上代码量最少、破坏范围最大的 Mod。"*