配置
Schematica 共 24 项配置，分 7 个 category。category 名与消息键常量集中在 reference/Names.java 的 Config 内部类，语言键前缀为 Schematica.config（由 LANG_PREFIX = Reference.MODID.toLowerCase() + ".config" 拼出，即小写 schematica.config）。
关键前提：本 mod 无物品
Schematica 不占用任何物品栏格子，所有功能由配置 + 键位 + 指令驱动。因此不存在「物品被禁用导致配置失效」的情况——关掉 printerEnabled 只影响投影打印，不影响保存 / 加载。
render（7 项）
| 键 | 默认 | 作用 |
|---|---|---|
alphaEnabled |
false | 启用透明贴图 |
alpha |
1.0 | 投影不透明度（1.0 不透明 / 0.5 半透明 / 0.0 全透明） |
highlight |
true | 高亮非法放置与待放置方块 |
highlightAir |
true | 高亮「本应是空气」的位置 |
blockDelta |
0.005 | 高亮深度偏移，出现 z-fighting 时调高 |
drawQuads |
true | 绘制面 |
drawLines |
true | 绘制轮廓线 |
printer（8 项）
| 键 | 默认 | 作用 |
|---|---|---|
placeDelay |
1 | 两次放置尝试的间隔（tick） |
timeout |
10 | 重试失败方块前的超时（tick） |
placeInstantly |
false | 一 tick 内放完所有可放置方块 |
destroyBlocks |
false | 打印机破坏方块（配置描述标注 creative mode only） |
destroyInstantly |
false | 一 tick 内破坏所有可破坏方块 |
placeAdjacent |
true | 仅当相邻位置有方块时才放置 |
tooltipEnabled |
true | 悬停蓝图方块时显示 tooltip |
tooltipX / tooltipY |
— | tooltip 相对偏移 |
printer.swapslots（9 项）
9 个 swapSlot 布尔项，对应快捷栏 9 格。默认值数组（ConfigurationHandler.java:46-47）：
public static final boolean[] SWAP_SLOTS_DEFAULT =
new boolean[] { false, false, false, false, false, true, true, true, true };
即 第 1–5 格禁用，第 6–9 格启用。这决定打印机可以「借用」玩家的哪些快捷栏格子取材料。玩家可逐格改写。
general（5 项）
| 键 | 默认 | 作用 |
|---|---|---|
schematicDirectory |
<数据目录>/schematics |
蓝图目录 |
extraAirBlocks |
{}（空列表） |
渲染时视为空气的额外方块（用于 GT placeholder 方块） |
sortType |
"" |
材料列表默认排序方式 |
useSchematicplusFormat |
false | 切换 schemplus 格式 |
showDebugInfo（debug 类） |
true | F3 调试屏显示额外信息 |
server（5 项）
| 键 | 默认 | 作用 |
|---|---|---|
printerEnabled |
true | 允许玩家使用投影打印 |
saveEnabled |
true | 允许保存蓝图 |
loadEnabled |
true | 允许加载蓝图 |
playerQuotaKilobytes |
8192（8 MB） | 每玩家的服务器蓝图存储配额 |
serversideSchematicsEnabled |
true | 允许服务器端保存 / 下载 / 浏览；决定 4 条指令是否注册 |
已知缺陷
-
alphaEnabled与alpha需同时调整。两项独立且默认组合为「功能关闭 + 不透明度 1.0」。玩家必须同时把alphaEnabled设为 true 并把alpha调低（常用 0.5），否则看不到半透明投影。配置项描述未提示这一点。 -
useSchematicplusFormat切换不可逆。开启后只加载 schemplus 格式，此前保存的标准格式蓝图会被静默忽略（配置项描述原文：“Only schematics in schemplus format will be loaded”）。切换前必须自行备份或重新保存全部蓝图。 -
blockDelta默认 0.005 在远距离缩放下易出 z-fighting。配置项描述已提示 “if you experience z-fighting increase this”。默认偏小，远距离观察投影时需手动调高。 -
playerQuotaKilobytes是总量而非单文件上限。ServerProxy.java:66用spaceUsed / 1024 > playerQuotaKilobytes判定，统计的是玩家整个私有目录的字节数。且删除文件后若文件系统未立即释放空间，玩家可能继续被判定为超限。 -
showDebugInfo归在debug类而非general。它控制 F3 屏上的额外信息，分类合理，但与printer/render类配置分散在不同页，配置 GUI 里需切页才能找到全部渲染相关项。 -
客户端 / 服务端配置需一致。
Schematica.java:36-45的@NetworkCheckHandler拒绝低于 1.11.0 的客户端，源码注释写明是为了 “ensure the server-client settings are respected”。但version由构建期的SchematicaVersion注入，开发构建（版本号形如0.0.0）会被误判为过旧而无法连服。