init

.gitattributes

@@ -0,0 +1 @@
+*.zip filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,3 @@
+public
+themes/hugo-book/**
+resources/_gen

.gitmodules

@@ -0,0 +1,9 @@
+[submodule "themes/PaperMod"]
+	path = themes/PaperMod
+	url = https://github.com/adityatelange/hugo-PaperMod.git
+[submodule "themes/hugo-admonitions"]
+	path = themes/hugo-admonitions
+	url = https://github.com/KKKZOZ/hugo-admonitions
+[submodule "themes/hugo-book"]
+	path = themes/hugo-book
+	url = https://github.com/alex-shpak/hugo-book.git

archetypes/default.md

@@ -0,0 +1,5 @@
+---
+date: '{{ .Date }}'
+draft: true
+title: '{{ replace .File.ContentBaseName "-" " " | title }}'
+---

content/_index.md

@@ -0,0 +1,15 @@
+---
+title: 'SFCraft 文档中心'
+type: docs
+---
+
+# SFCraft 文档中心
+
+欢迎来到 **SFCraft** 服务器群的文档站。这里按服务器分栏，收录各服务器的加入方式、玩法特性与常见问题。
+
+## 从这里开始
+
+- **[通用指南]({{< relref "/guide" >}})** —— 如何加入服务器、TSLink 联机、IP 直连与 FAQ。第一次来请先看这里。
+
+> [!TIP]
+> 左侧边栏按服务器分栏，点开任意栏目即可浏览该服务器的全部页面。右上角可以搜索。

content/changelog/2026-08-04.md

@@ -0,0 +1,41 @@
+---
+title: '2026-08-04 更新日志'
+weight: 1
+---
+
+# 2026-08-04 更新日志
+
+适用于 **SFCraft Vanilla**。本次更新引入两个新玩法（地图画、鞘翅冲门），并修复两个问题。
+
+## ✨ 新特性
+
+### 地图画 —— 把网络图片贴进服务器
+
+详见 [地图画]({{< relref "/vanilla/items/map-art" >}})。
+
+- 在**铁砧**里把一张地图（空地图也行）重命名为图片 URL（支持 `png` / `jpg` / `jpeg` / `gif` / `bmp`），服务端下载渲染后产出「种子」地图画，收取少量经验；
+- 把种子画放入**墙上的物品框**，会以该框为左下角、按原图宽高比自动铺满整面墙（最大 4×4），每格都是 128×128 高清切片；
+- 墙面铺不下、或框朝上 / 朝下时会拒绝放入并提示；
+- 上墙的地图画**受损掉落时会连框消失**（防拆散设计，单格切片无法二次展开），挂画前请选好位置；
+- 管理员可用 `/mapfor <url>` 直接获得成品。
+
+### 鞘翅冲门 —— 高速滑翔秒进传送门
+
+详见 [机制改动 · 鞘翅冲门]({{< relref "/vanilla/mechanics" >}})。
+
+- 用鞘翅滑翔、以**不低于 25 米/秒**的速度冲进下界传送门时，跳过原版的 4 秒传送等待，**下一瞬间直接跨维度**——与创造模式进门体验一致；
+- 速度不达标或未滑翔时不影响原版逻辑。
+
+## 🐛 修复
+
+### `/reco` 传送目标端口错误
+
+修复了 [`/reco`]({{< relref "/vanilla/commands/reco" >}}) / 房间重连时把玩家传送到**错误地址**的问题：之前重连数据包误用了当前服务器的端口作为目标端口，现在正确地使用目标房间自己的端口。
+
+### 下蹲事件重复触发 / 潜行施肥误触发
+
+修复了客户端在**保持下蹲行走**时反复触发潜行判定的问题：
+
+- 潜行判定现在只在**按下 / 松开 Shift 的瞬间**（边沿）上报，之前按住任意键走路都会连发；
+- [潜行施肥]({{< relref "/vanilla/mechanics" >}})不再被误触发；
+- 顺带修复了玩家断线后冷却记录滞留的小问题。

content/changelog/2026-08-08.md

@@ -0,0 +1,22 @@
+---
+title: '2026-08-08 更新日志'
+weight: 1
+---
+
+# 2026-08-08 更新日志
+
+适用于 **SFCraft Vanilla**。
+
+✨ 新功能
+
+• 创造游乐园时间控制：新增 /playgrd time 子命令（set / add / query / day / noon / night / midnight）。游乐园现在拥有专属的维度类型与世界时钟，调整时间只影响游乐园本身，不会波及主世界或其他维度。
+
+🔧 改进
+
+• 投影上传兼容新版 Litematica：自动识别 .litematic 文件的格式版本，支持当前最新版 Litematica（v4+，按区域记录数据版本）导出的文件， 无需再手动转旧版格式。
+
+🐛 修复
+
+• 修复部分投影转换后在建筑末尾多出空气方块的问题（旧版转换会把方块数据尾部的冗余字节误读成额外方块）。
+• 修复「代偿图腾」物品名颜色显示为白色的问题，现在与原版不死图腾一致显示为金色（UNCOMMON）。
+• 修复方块状态属性在转换结果中排序不确定的问题，保证同一建筑每次转换结果一致。

content/changelog/_index.md

@@ -0,0 +1,11 @@
+---
+title: '更新日志'
+weight: 10
+bookCollapseSection: false
+---
+
+# 更新日志
+
+记录 SFCraft 各服务器的特性更新与修复。最新的在最上面。
+
+- [2026-08-04 — 地图画、鞘翅冲门与行为修复]({{< relref "2026-08-04" >}})

content/guide/_index.md

@@ -0,0 +1,13 @@
+---
+title: '通用指南'
+weight: 1
+bookCollapseSection: false
+---
+
+# 通用指南
+
+面向所有服务器的通用说明。
+
+- **[如何加入服务器]({{< relref "join" >}})** —— 服务器列表、TSLink P2P 联机、IP 直连，以及连接常见问题（无效会话 / 通讯加密等）的解决办法。
+
+

content/guide/join/index.md

@@ -0,0 +1,137 @@
+---
+date: '2026-07-08T16:26:15+08:00'
+title: '如何加入服务器'
+weight: 1
+---
+
+> [!IMPORTANT]
+> 除非特殊说明，所有的服务器都默认启用正版验证。你需要有一个 Minecraft: Java 版的游戏账号（非网易）才能加入游戏。
+
+目前开放的服务器列表：
+
+- SFCraft 原版（Vanilla）
+
+白名单，正版验证，Carpet，1.21.8。 OP: iceBear67
+
+从 2024.7 开服至今的生电服务器，不需要格外安装模组即可加入游戏。离线模式的玩家可以单独申请免正版入服资格。
+
+- 你好，新蒸程 v1.7.1
+
+机械动力，正版验证，航空学，1.21.1。OP: iceBear67
+
+需要下载整合包作为客户端。下载后，从启动器中导入整合包进行安装，然后启动安装好的整合包。
+
+[整合包下载](./resources/%E4%BD%A0%E5%A5%BD%2C%E6%96%B0%E8%92%B8%E7%A8%8Bv1.7.1.zip)
+
+> [!WARNING]
+> 此整合包需要额外添加 Mod 才可进入服务器（Voxy, Voxy-Server-Side, ...）： 
+>
+> [整合包补丁下载 (2026.7.31)](./resources/%E6%96%B0%E8%92%B8%E7%A8%8B%E8%A1%A5%E4%B8%81Mod%E5%8C%85%2020260731.zip)
+
+如果这里下载很慢，你可以在群文件中搜索 "新蒸程" 并寻找由管理员发布的，日期最新的压缩包进行下载。
+
+- 活动服务器系列
+
+以自定义我的世界地图为主的小游戏服务器，通常版本和内容随时间更改。具体举办的活动往往需要关注 QQ 群内的通知（通常是精华消息或者 `@全体成员`，一般在晚上七八点左右开始招募）
+
+
+# 加入服务器的办法
+
+- TSLink
+
+[TSLink](https://github.com/saltedfishclub/tslink) 是一个 P2P 联机软件，启动后就可以在客户端的 「多人游戏」 中发现服务器。
+
+TSLink 不需要“安装”，也不会在电脑上残留数据，可以放心使用。
+
+使用办法：
+
+1. 下载 TSLink: (下载链接) [Windows (如果不知道选什么选这个)](./resources/tslink_windows_amd64.exe) | [Linux](./resources/tslink_linux_amd64) | [MacOS (arm)](./resources/tslink_darwin_arm)
+
+如果浏览器下载速度慢，可以去 QQ 群群文件里搜索 "tslink" 并选择最新的版本下载。
+
+双击启动后会有一个日志窗口，它是 TSLink 程序本体，你可以把它挂在后台。
+
+2. 启动 TSLink 和 MC
+
+TSLink 正常运行时，点击多人游戏菜单往下滑到「局域网联机」那部分就可以看到服务器了。如果看不到，可以等一会多点几下刷新试试看，也有可能是网络问题。如果是网络问题导致 TSLink 加载缓慢，可以截图 TSLink 软件的界面到群里寻求帮助。
+
+![](./tslink.png)
+
+3. 双击你想游玩的服务器即可加入游戏。
+
+> [!INFO]
+>
+> 如果你和你的朋友在同一网络，那么只需要有一个人启动 TSLink 即可，其他人可以通过你启动的 TSLink 连接到服务器。
+
+TSLink 需要探测网络环境并建立点对点（P2P）连接，所以游戏一开始可能会感到卡顿，这种情况在初始化结束后会迅速改善。如果不能，可以考虑让电脑使用手机热点上网来提升 P2P 成功率。
+
+> [!INFO]
+> 目前上面列举出的所有服务器均为「广东移动」网络。由于中国大陆跨省跨网服务降级的问题，如果您即不在广东宽带也不是移动即使 P2P 打洞成功也有可能会被运营商故意丢包，导致游戏卡顿。如果是这样，请考虑使用后文中提到的「IP直连」的办法。
+
+- IP 直连
+
+> [!IMPORTANT]
+> 此办法仅限于上一种办法（TSLink）无法正常使用的，网络环境较差的（含海外）玩家使用。   
+> 对江苏一带或者北方的玩家也有奇效  
+
+目前有如下几个 IP 可以直接连接服务器，但它们的稳定性没有任何保障：
+
+🇨🇳 广东，广州：
+
+ - 你好，新蒸程: `mc.lxns.net` | 偶尔会延迟爆炸
+
+🇨🇳 江苏，宿迁：
+
+南方用户延迟可能会偏高，建议南方用户优先考虑 TSLink
+
+ - SFCraft 原版: `vanilla.mc.sfclub.cc`
+ - 你好，新蒸程: `newsteam.mc.sfclub.cc`
+ - Minecraft Party 2: `party.mc.sfclub.cc`
+
+下方的海外线路通常只适用于海外用户，国内用户请优先考虑宿迁线路。
+
+🇯🇵 日本，东京：
+ - Minecraft Party 2: `jp-tyo-1.sfclub.cc` | 适合联通和海外用户，延迟会偏高。
+
+🇭🇰 香港：
+ - (葵青) Minecraft Party 2: `cn-hkg-1.sfclub.cc` | 适合移动和海外用户，延迟会偏高。
+
+如果在连接过程中有遇到任何问题，请在群内寻求帮助（注意说明你所使用的地区，运营商和网络环境。如：`广东移动WIFI`）
+
+
+# FAQ
+
+此小节记录一些连接服务器时常见问题的解决办法。
+
+## Are they down / Invalid session / 无效会话 / 卡在通讯加密中
+
+这些错误通常是因为你（或者服务器）没法连接到 Mojang 的正版验证服务器。对于这种问题，有以下解决方案：
+
+1. 使用我方提供的加速服务
+
+> [!WARNING]
+> 尽管我们不储存也不记录你的正版验证请求，你也应知晓这样做有被加速服务的运营者盗用你的身份的可能。你应该仅使用信任的加速服务以规避这样的风险。
+
+目前我们提供了两个加速服务可供使用，将以下代码粘贴到启动器 "JVM 参数" 一栏中：
+
+SFCraft 运营:
+```
+-Dminecraft.api.session.host=https://mc.sfclub.cc/mojang/session -Dminecraft.api.services.host=https://mc.sfclub.cc/mojang/services
+```
+
+热心群友 racel 提供：
+```
+-Dminecraft.api.session.host=https://mc.r4cel.de/mojang/session -Dminecraft.api.services.host=https://mc.r4cel.de/mojang/services
+```
+
+这两个代码是等效的，只用选择其中一个就行。通常来说，除非你是移动用户，不然建议选择第二个，因为第二个有比较好的线路优化。
+
+![HMCL 操作示例](hmcl_set_jvm_arg.png)
+
+2. 没招了
+
+如果是 Mojang 的验证服务器自己坏了，目前没有任何解决办法。（未来有）
+
+# End
+
+最后祝您游戏愉快，有任何问题都可以在群内提问寻求帮助。

content/guide/join/resources/SFC_Mayday.zip

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:775e5d358bfcf81d53ebcdb9691470ede1f504e2fde5b58b166b3864ed88d7bd
+size 10553112

content/guide/join/resources/你好,新蒸程v1.7.1.zip

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f269f9544059bf7fcc2e5f0d18d40917b6625e9bf5bfce631e537b0f95029aac
+size 319068607

content/guide/join/resources/新蒸程补丁Mod包 20260731.zip

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:549c797c501cda60bef02a5523d73143125256d88564afb844c212bb6324bc68
+size 13042868

content/party/_index.md

@@ -0,0 +1,17 @@
+---
+title: '活动服务器系列'
+weight: 4
+---
+
+# 活动服务器系列
+
+以自定义我的世界地图为主的小游戏服务器，版本和内容随活动随时更改。
+
+## 参与方式
+
+具体举办的活动往往需要关注 QQ 群内的通知，通常是精华消息或 `@全体成员`，一般在**晚上七八点左右**开始招募。
+
+连接方式（TSLink / IP 直连）请参考 [如何加入服务器]({{< relref "/guide/join" >}})。其中 **Minecraft Party 2** 提供了多条 IP 直连线路（宿迁 / 东京 / 香港），海外或跨网用户可择优选择。
+
+> [!NOTE]
+> 本栏目内容正在完善中，历届活动介绍与玩法规则将陆续补充。

content/vanilla/_index.md

@@ -0,0 +1,19 @@
+---
+title: 'SFCraft Vanilla'
+weight: 2
+bookCollapseSection: false
+---
+
+# SFCraft Vanilla
+
+**白名单 · 正版验证 · Carpet · 1.21.8**，OP：iceBear67。
+
+从 2024 年 7 月开服至今的生电服务器，加入方式详见 [如何加入服务器]({{< relref "/guide/join" >}})。
+
+> [!TIP]  
+> 尽管本服务器并不需要模组以加入服务器，但由于本服务器通过客户端材质包添加了大量内容，我们建议所有玩家安装以下两个模组以获得最佳体验 (合成表支持等特性)：  
+>
+> Polymer: https://modrinth.com/mod/polymer  
+> Just Enough Items (JEI): https://modrinth.com/mod/jei
+
+按左侧边栏分类浏览：**物品与方块**、**附魔与效果**、**生物与坐骑**、**聊天增强**、**机制改动**、**指令**、**无障碍**。

content/vanilla/chat.md

@@ -0,0 +1,23 @@
+---
+title: '聊天增强'
+weight: 4
+---
+
+# 聊天增强
+
+聊天框里的一些便捷功能，打字时顺手就能用。
+
+## @点名
+
+在聊天消息里写 `@玩家名`，对方会收到**提示音效**和「某某正在叫你」的悬浮通知。喊人不怕对方没看到。
+
+## 发送坐标
+
+在消息里打 `.xyz`，会自动替换成你的**当前坐标**（显示为青色可点击链接）；同时你自己会获得 **15 秒发光效果**，方便队友顺着坐标找到你。
+
+## 展示物品
+
+在消息里打 `.item`，会自动替换成你**主手物品的显示名称**，方便在聊天里给别人看你手上拿的是什么。
+
+> [!NOTE]
+> `@点名` 与 `发送坐标` 分别受 `chat.at` / `chat.xyz` 权限控制，通常默认对玩家开放。

content/vanilla/commands/_index.md

@@ -0,0 +1,12 @@
+---
+title: '指令'
+weight: 6
+bookCollapseSection: true
+---
+
+# 指令
+
+- [`/back` 返回死亡点]({{< relref "back" >}}) —— 传送回上一次死亡的位置
+- [`/gps` 坐标导航]({{< relref "gps" >}}) —— 视线前方的发光光标指引你前往坐标
+- [`/playgrd` 游乐场]({{< relref "playgrd" >}}) —— 进入独立的创造维度，可用 WorldEdit
+- [`/reco` 干净重连]({{< relref "reco" >}}) —— 重新连接回主世界

content/vanilla/commands/back.md

@@ -0,0 +1,16 @@
+---
+title: '/back 返回死亡点'
+weight: 1
+---
+
+# `/back` — 返回死亡地点
+
+死亡后用它传送回你**上一次死亡的位置**，快速赶回去捡回掉落的物品。死亡时聊天里会提示你可以用 `/back`。
+
+## 使用条件
+
+- 死亡地点**附近 200 格内至少要有另一名玩家在场**（拥有旁观权限的玩家除外）。
+
+## 权限
+
+需要 `COMMAND_BACK` 权限，通常默认对玩家开放。

content/vanilla/commands/gps.md

@@ -0,0 +1,28 @@
+---
+title: '/gps 坐标导航'
+weight: 2
+---
+
+# `/gps` — 坐标导航
+
+在你的视线前方悬浮一只**只有你能看到的发光小史莱姆**作为导航光标，指引你前往指定坐标。找结构、回家、赶路都很实用。
+
+## 用法
+
+- `/gps <x> <y> <z>` —— 开始导航（支持 `~` 相对坐标）。
+- `/gps stop` —— 手动取消导航。
+
+## 怎么跟着它走
+
+- **对准机制**：当你的视线方向与目标方向的偏差在容差角内时，光标**粘在准星上**（画面里纹丝不动）；一旦偏离超过容差，光标会**跳到真实目标方向**，提示你把准星转回光标上来校正航向。
+- **远近两段**：
+  - 距目标水平距离**较远**时（巡航段），光标锁定在你眼睛所在的水平面、只随左右转向（yaw）偏移、忽略俯仰——所以**用鞘翅高速飞行、低头看地面时光标不会乱跑**。
+  - **接近目标**时，恢复含俯仰的全向指示，便于对准上下方的目标。
+- **自动结束**：到达目标半径内、切换维度、下线、死亡重生都会正确处理（重生后会重新给你下发光标）。
+
+> [!NOTE]
+> 一名玩家同时只有一个导航目标，重复 `/gps` 会**替换**掉上一个目标。
+
+## 权限
+
+任意玩家可用，无权限等级要求。

content/vanilla/commands/playgrd/index.md

@@ -0,0 +1,28 @@
+---
+title: '/playgrd 游乐场'
+weight: 3
+---
+
+# `/playgrd` — 进入游乐场
+
+传送到一个独立的「游乐场」维度，此维度中玩家数据与其他维度不共享。
+
+游乐场维度对玩家开放 WorldEdit 的大部分命令以及对部分玩家开放蓝图上传功能。关于更多信息，请查阅进入游乐场后玩家收到的系统消息。
+
+![screenshot](images/playgrd.png)
+
+你可以使用 `/reco` 命令重新连接回服务器。
+
+## 命令
+
+在游乐场中，提供了一些特殊命令：
+
+1. `/pt <玩家>` 传送到某个玩家的位置。
+2. `/gm <creative|survival|spectator>` 修改你的游戏模式
+3. `/player XX.bot` carpet 的 player 命令，但所操控的玩家名字必须以 `.bot` 结尾。
+
+## 上传原理图
+
+有权限的玩家（Craft314、Flickdonzi、iceBear67, Maonekone）可以用 `/upload schematic` 生成一个**一次性上传链接**，通过浏览器把 `.schematic` / `.litematic` 文件上传到 WorldEdit 目录。
+
+如果你想要上传原理图的权限，请跟 iceBear67 申请。

content/vanilla/commands/reco.md

@@ -0,0 +1,8 @@
+---
+title: '/reco 干净重连'
+weight: 4
+---
+
+# `/reco` — 干净重连
+
+离开当前子服 / 游乐场，重新连接回**主世界**。

content/vanilla/enchantments/_index.md

@@ -0,0 +1,10 @@
+---
+title: '附魔与效果'
+weight: 2
+bookCollapseSection: true
+---
+
+# 附魔与效果
+
+- [斩首]({{< relref "beheading" >}}) —— 击杀生物概率掉落头颅的剑类附魔
+- [统帅]({{< relref "commander" >}}) —— 敌怪首领为周围怪物提供增益并统率跟随

content/vanilla/enchantments/beheading.md

@@ -0,0 +1,23 @@
+---
+title: '斩首'
+weight: 1
+---
+
+# 斩首
+
+一个剑类附魔，击杀生物时有概率掉落其**头颅**。
+
+## 玩法
+
+主手武器带此附魔击杀生物时，按概率掉头：
+
+- **支持原版有头颅的生物**：僵尸、骷髅、凋灵骷髅、苦力怕、猪灵、猪灵蛮兵、僵尸猪灵、末影龙 → 掉对应头颅。
+- **玩家 → 带其皮肤的玩家头**。
+- 掉落概率随**附魔等级**提升（最高 3 级）；玩家头颅为固定概率，不随等级变化。
+
+## 获取
+
+此附魔最高 3 级，适用于剑类物品。可以：
+
+- 在**附魔台**上获得；
+- 从**图书管理员村民**处购买附魔书（斩首已加入原版可交易附魔池，会出现在图书管理员的附魔书交易里）。

content/vanilla/enchantments/commander.md

@@ -0,0 +1,19 @@
+---
+title: '统帅'
+weight: 2
+---
+
+# 统帅
+
+少数自然刷新的敌怪会成为「首领」，为周围怪物提供增益并统率它们协同作战。
+
+## 玩法
+
+- 自然刷新的敌怪有**小概率**携带「统帅」效果，携带者身上发出**紫色光芒**（发光 + 浅紫队伍色）。
+- 首领会为半径内至多几只**和它攻击同一目标、且自身没有统帅效果**的怪物提供 2 种增益（从力量 / 抗性 / 迅捷中选 2 种）。
+- 首领与受益者之间有**紫色粒子纽带**；受益者离得太远会被寻路拉回来。
+- 首领**切换攻击目标**时，整队会同步跟随新目标。
+- 首领**死亡或失去效果**时，增益立即撤销、发光消除、队伍解散。
+## 获取
+
+非物品。自然刷怪时随机附加，无法主动制造。

content/vanilla/items/_index.md

@@ -0,0 +1,15 @@
+---
+title: '物品与方块'
+weight: 1
+bookCollapseSection: true
+---
+
+# 物品与方块
+
+SFCraft Vanilla 提供的自定义物品与方块。其中不少高级道具都以 [紫水晶炼药锅]({{< relref "amethyst-cauldron" >}}) 为合成核心。
+
+ - [炸弹]({{< relref "bombs" >}}) 在对付怪物上可以给你提供强力的火力支援，只不过要当心炸到自己。
+ - [珍珠信物]({{< relref "pearl-token" >}}) 允许你传送到其他玩家那里去。
+ - [午餐盒]({{< relref "lunch-box" >}}) 可以帮你管理背包里的食物。
+ - [代偿图腾]({{< relref "standing-firm-totem" >}}) 以经验为代价抵消死亡
+ - ...

content/vanilla/items/amethyst-cauldron/index.md

@@ -0,0 +1,42 @@
+---
+title: '紫水晶炼药锅 (Amethyst Cauldron)'
+weight: 1
+---
+
+# 紫水晶炼药锅
+
+![photo](images/ame_cauldron.png)
+
+使用紫水晶熔铸的炼药锅，是本服务器中许多特殊物品的合成方块。
+
+紫水晶炼药锅是光照等级为 10 的炼药锅，且周围有萤火虫粒子效果。
+
+# 合成
+
+要合成紫水晶炼药锅，需要先合成其胚体。
+
+![recipe](images/ame_cauldron_recipe.png)
+
+合成胚体后，在熔炉中煅烧即可得到紫水晶炼药锅。
+
+![recipe2](images/ame_cauldron_recipe_2.png)
+
+# 使用
+
+紫水晶炼药锅接受原料，催化剂及可能需要的环境条件。根据物品的不同，需要不同的三种条件。
+
+**加热**: 当紫水晶炼药锅下有其中一种方块时，该方块视作被加热：
+   - 火焰
+   - 灵魂火
+   - 岩浆块
+   - 岩浆。（流动的也可以）
+
+**注水**: 在合成时，此炼药锅需要被水填满。
+
+环境条件充足时，向锅中丢入物品即可添加原料，空手即可去除。当锅内物品凑齐条件后反应自动开始，锅上浮现对应粒子。
+
+反应结束后产物从锅上方弹出。如果合成失败，锅上会有冒烟提示。
+
+# 采集
+
+只有精准采集才可以完整的带走紫水晶炼药锅。否则，会掉落铁锭和紫水晶。

content/vanilla/items/bombs/index.md

@@ -0,0 +1,60 @@
+---
+title: '炸弹 (Bomb)'
+weight: 3
+---
+
+# 炸弹
+
+![bombs](images/bombs.png)
+
+炸弹是一种杀伤力极强的投掷物，并且有多个变种。炸弹在抛出后 80GT 爆炸。图中从左到右依次为：炸弹、黑曜石炸弹、烈焰炸弹。
+
+# 获取
+
+炸弹可以通过红石与烈焰弹合成制取。
+
+![normal](images/bomb_recipe_normal.png)
+
+此外，还可以从以下途径获取到炸弹：
+ - 地牢箱子。概率为 30%
+ - 苦力怕掉落。概率为 10%
+ - 与武器匠大师交易。通常为 4 火焰弹 + 1-8 绿宝石 -> 4 炸弹。
+
+# 使用
+
+所有的炸弹共享一样的投掷物参数。炸弹在抛出后在抛物线上留下一段烟雾轨迹，落地后仍会朝速度反方向喷射烟雾。炸弹爆炸并不会破坏地形。
+
+炸弹在抛出后 80GT 爆炸。根据不同的变种，炸弹落地/爆炸时有不同的效果。通常，所有炸弹的爆炸威力均为 3F,这足以秒杀一个没有做好防护的全下界合金套的玩家。
+
+> [!TIP]
+> 炸弹可以通过搭配击退附魔的武器覆盖更多敌人。
+
+# 变种
+
+以下是炸弹的不同变种及其合成方式。
+
+## 黑曜石炸弹
+
+一个黑曜石炸弹使用一个炸弹和八分之一个哭泣黑曜石合成。一次只能合成8个黑曜石炸弹。
+
+![obsidian_recipe](images/bomb_recipe_obsidian.png)
+
+此外，地牢箱子中以 15% 的概率刷新 1~2 个黑曜石炸弹。
+
+黑曜石炸弹在落地后会形成半径 2.5 格的包围圈。在该包围圈内的所有生物将会获得 缓慢III 减益，这使得他非常适合用于牵制怪物并且将他们一同绞杀。
+
+![被困住的苦力怕](images/bomb_obsidian.png)
+
+黑曜石炸弹在爆炸后不会有特殊效果。
+
+## 烈焰炸弹
+
+一个烈焰炸弹使用一个烈焰粉和一个炸弹合成。
+
+![flame_recipe](images/bomb_recipe_flame.png)
+
+烈焰炸弹在落地时没有特殊效果。然而，在爆炸后会点燃半径 3 格内的所有生物，并且火焰持续 100 ticks.
+
+![被燃烧并炸死的苦力怕](images/bomb_flame.png)
+
+在爆炸后，烈焰炸弹还会在 2~3 格内随机生成火焰方块。当爆炸点位于水下时不生成，并且不会替代除空气之外的方块。

content/vanilla/items/gravity-crystal/index.md

@@ -0,0 +1,37 @@
+---
+title: '重力水晶 (Gravity Crystal)'
+weight: 2
+---
+
+# 重力水晶
+
+重力水晶是一种会改变周围生物速度的方块，通常为朝着运动方向加速。
+
+![crystal](images/gravity_crystal.png)
+
+> [!WARNING]  
+>
+> 尽管重力水晶总是加速经过他的所有实体，走近重力水晶也可能会得到反作用，因为玩家行走的速度方向较为难以预测。
+
+# 合成
+
+重力水晶通过 [紫水晶炼药锅]({{< relref "amethyst-cauldron" >}}) 合成获取。
+配方如下（不需要水）：
+
+![recipe](images/gravity_crystal_recipe.png)
+
+重力水晶不需要精准采集附魔工具来采集，使用钻石级别或以上的稿挖掘即可。
+
+# 使用
+
+重力水晶每 2GT 会尝试干涉一次半径 8 格内的所有生物。默认情况下，重力水晶没有加速效果，需要提供紫水晶后才会加速。
+
+| 紫水晶数 | 加速比 |
+| - | - |
+| 0 | 1x |
+| 1 | 1.15x |
+| 2 | 1.2x |
+| 3 | 1.25x |
+| 4 | 1.3x |
+
+尽管单个重力水晶最多只能提供 +30% 的加成，但是通过堆叠多个重力水晶，可以达到最大 8m/s 的速度。在玩家超过该速度后，重力水晶将不再干预玩家的速度。

content/vanilla/items/lunch-box/index.md

@@ -0,0 +1,23 @@
+---
+title: '午餐盒 (Lunch Box)'
+weight: 6
+---
+
+# 午餐盒
+
+午餐盒可以储存食物，并且在你尝试吃下午餐盒时吃下午餐盒中的一个食物。
+
+![recipe](images/lunchbox_recipe.png)
+
+> [!WARNING]  
+> 目前，合成午餐盒并不会保留收纳袋中原有的物品。
+
+## 使用
+
+通过蹲下时使用午餐盒，可以打开午餐盒的界面。午餐盒中只能放入食物，其他物品将会被拒绝。
+
+![gui](images/lunchbox_gui.png)
+
+在午餐盒有食物且玩家没有蹲下时，午餐盒可以直接被食用：
+
+![eating](images/lunchbox_eating.png)

content/vanilla/items/map-art/index.md

@@ -0,0 +1,39 @@
+---
+title: '地图画'
+weight: 8
+---
+
+# 地图画
+
+![mapart](images/mapart_preview.png)
+
+地图画允许你将网络上的图片粘贴到服务器中。
+
+## 制作地图画
+
+1. 准备一张**地图**（空地图也行），放进**铁砧**；
+2. 把它重命名为一个图片地址，例如 `https://example.com/pic.png`（支持 `png` / `jpg` / `jpeg` / `gif` / `bmp`）；
+
+> [!TIP]  
+> 你可能需要等一会才能看到地图画出现在铁砧的结果槽位中。
+
+3. 稍等片刻，服务端下载并渲染完成后，结果槽会直接产出「种子」地图画——它是一整张图的 128×128 预览；
+4. 取出时收取少量经验（默认 1 级）。制作途中关掉铁砧也没关系，完成后画会直接发进你的背包。
+
+> [!WARNING]  
+> 只支持 http/https 公网图片地址。图片太大、下载超时或服务器繁忙时制作会失败并提示原因，请换个小一点的图或稍后再试。
+
+所有报错信息都会直接发到聊天栏中，因此请注意聊天栏里出现的新的错误信息。在一个地址请求失败后一分钟内，服务器不会再尝试为该地址生成新的地图画。
+
+![recipe](images/mapart_anvil_recipe.png)
+
+## 上墙展开
+
+把「种子」地图画放进墙上的物品框，它会以这个框为左下角按原图宽高比自动铺成一面多格墙画——每格替换成该区域的 128×128 高清切片。
+
+- 铺多大的格子由图片比例决定，最大 4×4：例如 3:2 的图铺 3×2 格，4:3 的图铺 4×3 格。
+- **墙面空间不够**（右侧 / 上方没有连续的空墙面）、或者物品框朝上 / 朝下摆放时，会直接拒绝放入并提示你。
+- 展开前记得先确认这面墙的位置就是你想挂的位置。
+
+> [!WARNING]  
+> 上墙的地图画框一旦受损掉落，画会连框一起消失、不掉落任何物品。

content/vanilla/items/pearl-token/index.md

@@ -0,0 +1,36 @@
+---
+title: '珍珠信物 (Pearl Token)'
+weight: 4
+---
+
+# 珍珠信物
+
+![bound](images/bound_pearl_token.png)
+
+珍珠信物是一种将信物主人位置传送到使用者的特殊物品。它还可以用于合成「将使用者传送至信物主人」的反向珍珠信物。
+
+## 获取
+
+在合成界面，以紫水晶+末影珍珠进行无序合成：
+
+![recipe](images/pearl_token_recipe.png)
+
+## 使用
+
+右键使用即可触发珍珠信物的效果。合成后的珍珠信物需要先进行绑定，第一次使用时会记录使用者作为该信物的主人。
+
+第二次使用时，会将使用者传送到信物主人处并消耗该珍珠信物。传送时，目标需在线。
+
+# 反向珍珠信物
+
+反向珍珠信物是对珍珠信物的改良。它逆转了信物传送的方向，并且允许在冷却条件下使用多次。
+
+![image](images/reverse_pearl_token.png)
+
+反向珍珠信物的冷却时间是 300 秒。
+
+## 获取
+
+要合成反向珍珠信物，你需要以一个已经绑定了的珍珠信物作为原料并在紫水晶炼药锅中合成。合成配方如图所示：
+
+![recipe](images/reverse_pearl_token_recipe.png)

content/vanilla/items/standing-firm-totem/index.md

@@ -0,0 +1,26 @@
+---
+title: '代偿图腾 (Standing Firm Totem)'
+weight: 7
+---
+
+# 代偿图腾
+
+![玩家死亡后触发屹立不倒图腾，注意图腾并没有被消耗](images/standing_firm_activate.png)
+
+一种通过经验抵消死亡的不死图腾变种。每次抵消将会直接扣除玩家一半的经验值（并非等级），然后进入 30s 的冷却时间。在冷却期间无法抵消玩家死亡。
+
+## 合成
+
+屹立不倒图腾需要使用紫水晶炼药锅、绿宝石、不死图腾、附魔之瓶。注意：不需要水。
+
+![recipe](images/standing_firm_recipe.png)
+
+## 用法
+
+与不死图腾一样，任意手持屹立不倒图腾时死亡则触发图腾效果，条件如下：
+
+- 经验等级 > 10 (160点)
+- 没有调入虚空
+- 冷却结束
+
+如果有任意一条不符合，那么代偿图腾不会工作，你会直接死亡。

content/vanilla/mechanics.md

@@ -0,0 +1,31 @@
+---
+title: '机制改动'
+weight: 5
+---
+
+# 机制改动
+
+SFCraft 对原版机制做的一些改动。
+
+## 潜行施肥
+
+**潜行**（Shift）时，你周围 5×3×5 范围内的作物 / 树苗有概率被「施肥」——伴随**堆肥粒子**与音效，有 **30% 概率**触发骨粉般的催熟效果。蹲着在田里走一圈，就能顺手催熟一片。
+
+## 夜晚加速
+
+当**足够多的玩家同时睡觉**时：
+
+- 夜晚跳过的速度**大幅加快**；
+- 同时**正在运行的熔炉以 3 倍速冶炼**——趁睡觉顺便把矿烧了。
+
+另外，**非下雨的白天无法睡觉**。
+
+## 蜜蜂免挤压伤害
+
+蜜蜂不会再因为被实体挤压而受伤——养蜂场里挤一堆蜜蜂也不会把它们挤死。
+
+## 鞘翅冲门
+
+用**鞘翅滑翔、以不低于 25 米/秒的速度**冲进下界传送门时，会跳过原版的传送门等待（生存模式默认要在门里站 4 秒），**下一瞬间直接跨维度**——和创造模式进门的体验一致。
+
+速度不够、或者没有滑翔时，仍按原版（游戏规则）逻辑等待。高速跑图、鞘翅通勤时不用再在门里干等了。

content/vanilla/mobs/_index.md

@@ -0,0 +1,9 @@
+---
+title: '生物与坐骑'
+weight: 3
+bookCollapseSection: true
+---
+
+# 生物与坐骑
+
+- [劫掠兽 / 疣猪兽坐骑]({{< relref "mounts" >}}) —— 驯服并骑乘，劫掠兽还能冲刺撞击

content/vanilla/mobs/mounts.md

@@ -0,0 +1,42 @@
+---
+title: '劫掠兽 / 疣猪兽坐骑'
+weight: 1
+---
+
+# 劫掠兽 / 疣猪兽坐骑
+
+> Ravager / Hoglin Mount
+
+你可以驯服**劫掠兽**和**疣猪兽**作为坐骑，劫掠兽还能冲刺撞击敌人并造成 6 点伤害。
+
+## 玩法
+
+### 驯服
+
+对满足条件的劫掠兽 / 疣猪兽**喂食**（默认金苹果）有概率驯服。前置条件：
+
+- 目标处于**虚弱**状态；
+- **附近没有掠夺者**；
+- **不在袭击进行中**。
+
+喂食会消耗食物，成功 / 失败都有粒子与音效反馈。
+
+### 归属
+
+驯服后**只有主人**能与它交互；驯服后的坐骑**不再攻击任何玩家**。
+
+### 上鞍与骑乘
+
+- 主人手持**鞍**右键即可上鞍；
+- 之后**空手右键**骑乘（默认需要先上鞍）。骑乘时坐骑会清除仇恨。
+
+### 劫掠兽冲刺
+
+骑乘劫掠兽时，手持**胡萝卜钓竿**可以冲刺——短时间内强制全速前进并提速，冲刺中撞到的生物会受到一次性撞击伤害。冲刺有冷却，并消耗钓竿耐久。
+
+> [!TIP]
+> 驯服前先让目标携带**虚弱** DEBUFF、并清掉附近的掠夺者，成功率才算数。
+
+## 获取
+
+没有对应物品，直接**驯服世界中的原版劫掠兽 / 疣猪兽**即可。

hugo.yaml

@@ -0,0 +1,19 @@
+baseURL: https://sfclub.cc/~sfcraft
+locale: zh-CN
+defaultContentLanguage: zh
+title: SFCraft 文档
+theme: hugo-book
+
+params:
+  BookTheme: auto          # 明/暗跟随系统
+  BookSection: '*'         # 每个顶层 section 渲染为侧边栏一个栏目
+  BookToC: true
+  BookSearch: true
+
+markup:
+  goldmark:
+    renderer:
+      unsafe: true         # hugo-book 与 hugo-admonitions 均需要
+  tableOfContents:
+    startLevel: 1
+    endLevel: 3