LittleTiles
[!INFO] Git Commit:
8cfc14b| Updated: 2026-10-02
LittleTiles(微砖)是一个装饰性小方块模组:它把普通方块的贴图"画"进方块内部,按 1/16 像素的精度切割成任意大小的微砖。玩家可以用 7 件工具把一个方块拆成斜角、拐角、柱子、门、椅子、梯子、床等上千个独立小方块,代价是它们共享同一个 TileEntity。
modid 为 littletiles,与分类名一致。源码中以主类常量为准:
src/main/java/com/creativemd/littletiles/LittleTiles.java:70—public static final String modid = "littletiles";src/main/java/com/creativemd/littletiles/LittleTiles.java:55-59—@Mod(modid = LittleTiles.modid, version = LittleTiles.version, name = "LittleTiles", dependencies = "after:angelica;required-after:modularui2")
目标环境为 Minecraft 1.7.10 / Forge 10.13.4.1614(gradle.properties:24 与 :27),仓库为 GTNewHorizons/LittleTiles,纯 Java(256 个 .java、0 个 .scala/.kt)。源码树中不含 Forge 配置文件——本版本没有 littletiles.cfg,工具设置全部存放在物品 NBT 与 GUI 中。
注册内容总览
| 类别 | 数量 | 说明 |
|---|---|---|
| 方块 | 2 | Little Tile(微砖容器)、Dyeable(11 子方块) |
| 物品 | 10 | 7 件工具 + 图案/结构/碰撞 3 件功能物品 |
| TileEntity | 1 | TileEntityLittleTiles |
| 微砖实现 | 3 | LittleTileBlock / LittleTileTileEntity / LittleTileBlockColored |
| 内置结构 | 5 | 固定、椅子、门、梯子、床 |
| 放置模式 | 4 | Normal / Fill / Overwrite / Stencil |
| 形状模式 | 12 | Box、Slope、Pillar 及各类角 |
| 网格档位 | 5 | 1 / 2 / 4 / 8 / 16 像素 |
| 快捷键 | 7 | 全部默认未绑定 |
| 合成配方 | 6 | 全部为原版 shaped recipe |
| 网络封包 | 6 | 通道名见 第三方模组集成 |
| 指令 | 1 | /ltdumpmesh(client 侧调试) |
| GUI | 12 | 5 SubGui + 5 SubContainer + 1 ModularUI 面板 + 1 控件 |
| 软依赖 | 4 | Angelica、Waila、NEI、BogoSorter |
| 硬依赖 | 1 | ModularUI 2 |
方块与 TileEntity 的 2 → 1 对应:Dyeable 是纯装饰材质方块,不挂 TileEntity;只有 Little Tile 需要保存微砖列表。
核心机制
1/16 像素网格
网格与按键设置 决定微砖的最小边长,5 档从 1 像素到整格。最细档下一个方块可容纳 16³ = 4096 个微砖;Little Rubber Mallet 的拆分上限 512(LittleTiles.maxNewTiles)即由此而来。
形状与放置模式正交
形状模式(12 种外形)与放置模式(4 种重叠行为)是两个独立枚举,都存在 Little Chisel 的 NBT 上,在凿子面板中切换。源码注释强调形状「在两次命中都确定后才变成具体 cutout」。
工具链
7 件工具各司其职:凿子放置、锤快速覆盖、锯切两半、扳手合并、橡皮锤炸成最小单位、颜料管染色、虚无形杖关碰撞。完整配方见合成配方总表。
10 件物品中有 4 件没有合成配方(凿子、图纸、Multi-Tile-Structure、虚无形杖),源码中也不存在发放它们的逻辑。
方块列表
- Little Tile - 微砖载体方块,1 个 TileEntity,内部可存 4096 个微砖,无硬度设置
- Dyeable - 11 种 metadata 变体的纯装饰材质方块,无 TileEntity
物品列表
- Little Chisel - 主工具,放置微砖 + ModularUI 设置面板(无合成配方)
- Little Hammer - 早期放置工具,3 铁锭 + 2 黄染料
- Little Saw - 把微砖切成两半,2 铁锭 + 1 黄染料
- Little Wrench - 合并相邻微砖,1 铁锭 + 2 黄染料
- Little Rubber Mallet - 炸成最小微砖,5 羊毛 + 2 黄染料
- Little Color Tube - 给微砖染色/吸色,8 任意染料 + 1 铁锭
- Little Container - 材料供应器,8 铁锭 + 1 锤
- Little Recipe - 图案录制工具(无合成配方)
- Multi-Tile-Structure - 结构载体物品(无合成配方)
- Staff of Intangibility - 逐微砖开关碰撞(无合成配方)
TileEntity 列表
- 微砖类型与 TileEntity -
TileEntityLittleTiles与 3 个已注册微砖实现、1/16 格几何模型
结构列表
- 微砖结构 - 5 种内置结构(固定/椅子/门/梯子/床),按 NBT
id反射重建
设置列表
本版本没有 Forge 配置文件,全部设置存放在物品 NBT 上。
配方列表
- 合成配方总表 - 6 条原版 shaped recipe,含 4 件无配方物品的说明
GUI 列表
- 凿子面板 - 250×300 ModularUI 2 面板,4 个同步值,承载全部工具设置
- 副 GUI 体系 - 5 SubGui + 5 SubContainer 的 CreativeCore 界面,含 LittleDoor 的微砖预览
第三方模组集成
- 第三方模组集成 - Waila / NEI / Angelica / BogoSorter / ModularUI 2、2 个拾取 Mixin、6 个封包与
/ltdumpmesh
已确证的死代码
以下内容未被注册,不计入上面的总览:
| 内容 | 证据 |
|---|---|
LittleTileStructureBlock |
LittleTiles.java:129 的注册调用整行被注释;全仓 grep -rn 'LittleTileStructureBlock' src/ 仅 1 命中(即该注释自身) |
LittleRecipe → MultiTiles 发放分支 |
ItemRecipe.java:64-78 整段注释 |
LittleTilesTransformer |
类体为空 {},全仓无其它引用 |
LittleTilesPatchingLoader |
IFMLLoadingPlugin 实现但全仓仅 1 命中(自身声明),未在任何 mcmod.info 或 FML 配置中挂载 |
item.LTScrewdriver.name |
en_US.lang / zh_CN.lang 中有「Little Screwdriver / 小螺丝刀」,但全仓无对应类、无注册、无 NBT 键引用 |