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

物品列表

TileEntity 列表

结构列表

  • 微砖结构 - 5 种内置结构(固定/椅子/门/梯子/床),按 NBT id 反射重建

设置列表

本版本没有 Forge 配置文件,全部设置存放在物品 NBT 上。

配方列表

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 键引用