Twilight Forest（暮色森林）

[!INFO] Git Commit: dc9bcac（tag 2.7.43）| Updated: 2026-10-02

Twilight Forest（暮色森林）是 Minecraft 1.7.10 / Forge 的完整大型附属 mod，由 AtomicBlom / Benimatic 与 GTNewHorizons 维护。它新增一个独立维度，通过 传送门（Portal） 进入，内含 4 座高塔 （TFFeature 中名字带 Tower 的特性：lichTower 6、iceTower 7、darkTower 14、 mushroomTower 20）、多层迷宫、地下洞穴与中立生物群。核心玩法是逐层推进的探险流程： 采集材料 → 击败塔主 → 获得塔之遗物 → 解锁下一座塔。

社区常说的「9 座塔」属于游戏内玩法口径（把 Naga 庭院、九头蛇巢穴、雪怪洞穴、 牛头人迷宫、巨人工厂等塔主据点一并计入）。源码里能直接核实的「塔」只有上述 4 座 TFFeature；塔主实体则是 8 个（见下）。此处保留可核实的数字。

版本与 modid

属性 值
modid TwilightForest（混合大小写，TwilightForestMod.java:75）
模组名 The Twilight Forest
Minecraft 1.7.10
Forge 10.13.4.1614
代码规模 801 个 Java 文件、131 923 行

modid 是 TwilightForest 而非全小写 twilightforest。资源路径用 twilightforest:（小写）， 但注册名域是 TwilightForest:。两者不一致，查物品时注意区分：

/give @p TwilightForest:scepterTwilight    ← 注册名

所有注册名（方块与物品）使用 camelCase，如 TFPortal、scepterTwilight、oreMeter， 不是 snake_case。

源码规模

类型 数量
Java 源文件 801
Java 代码行 131 923
PNG 资源 1 201
mcmeta + sounds.json 21 + 1 = 22（1.7.10 无 JSON 物品模型）
注册方块 126（setBlockName 唯一名 126，registerMyBlock 调用 125）
注册物品 120
注册实体 75（TFCreatures.registerTFCreature 56 + EntityRegistry.registerModEntity 19；另有 1 个被注释掉，见下）
注册 TileEntity 25

注册真源

内容 文件
方块 block/TFBlocks.java 的 registerBlocks()（第 146-453 行）
物品 item/TFItems.java 的 registerItems()
实体 TwilightForestMod.java 的 registerCreatures()（第 435 行起）
TileEntity TwilightForestMod.java 的 registerTileEntities()（第 923 行起）

方块注册名由 setBlockName("TFPortal") 决定，再经 registerMyBlock(...)（TFBlocks.java:455-472） 调用 GameRegistry.registerBlock(block, pickup, block.getUnlocalizedName())， 最终形成 TwilightForest:<setBlockName>。

registerBlocks() 内有 126 条 setBlockName 赋值，126 个名字全部互不相同 —— 没有重复字段。registerMyBlock 只有 125 次调用，比名字少 1，是因为 TFWoodSlab / TFWoodSlabDouble 这一对由同一次带 singleSlab/doubleSlab 参数的重载（TFBlocks.java:455）一次性注册两个方块。

Boss 实体

暮色森林有 4 座高塔（lichTower / iceTower / darkTower / mushroomTower）， 其所在结构另有 4 个塔主据点，合计 8 个塔主实体。完整实体列表见实体维度。

掉落规律

8 个塔主实体中有 6 个掉落 TwilightForest:trophy：Naga、Minoshroom、Alpha Yeti、 Snow Queen、Hydra、Twilight Lich。只有 Ur Ghast 与 Knight Phantom 不掉 trophy （entity/boss/EntityTFUrGhast.java、EntityTFKnightPhantom.java 全文件 0 处 trophy 引用）。

各塔主的 trophy 掉落代码：

塔主 源码（meta 决定奖杯种类）
Naga entity/boss/EntityTFNaga.java:890（meta = 1）
Twilight Lich entity/boss/EntityTFLich.java:152、:188（meta = 2）
Snow Queen entity/boss/EntityTFSnowQueen.java:367（meta = 4）
Minoshroom entity/boss/EntityTFMinoshroom.java:58（meta = 5）
Alpha Yeti entity/boss/EntityTFYetiAlpha.java:275（meta = 7）
Hydra entity/boss/EntityTFHydra.java:1057（dropItem(TFItems.trophy, 1)，未指定 meta）

trophy 对应 Trophy Pedestal（奖杯基座） 方块。

推进系统

暮色森林有一个强制进度游戏规则：

项 值
规则名 tfEnforcedProgression（TwilightForestMod.java:82）
常量 TwilightForestMod.ENFORCED_PROGRESSION_RULE
校验点 TFTeleporter.java:42（进入传送门时检查）
网络包 TFGenericPacketHandler.ENFORCED_PROGRESSION_STATUS = 7（第 31 行）

进度物品为 3 把暮色权杖，全部由 Twilight Lich 掉落（EntityTFLich）： TwilightForest:scepterTwilight、scepterLifeDrain、scepterZombie。

方块列表

木质建材（40 个 = 8 木 × 5 件套）

木材只有 8 种（BlockTFWood.names，block/BlockTFWood.java:20-21： twilight_oak / canopy / mangrove / darkwood / time / trans / mine / sort； BlockTFChest.WoodType 枚举同为 8 种，外加一个不对应木材的 NULL 哨兵）。 每种木材注册 5 个方块，没有任何一种是 6 个：

建材 注册名后缀 方块类 每木数量
Stairs TFWoodStairs<Wood> BlockTFWoodStairs 8
Door TFDoor<Wood> BlockTFDoor 8
TrapDoor TFTrapDoor<Wood> BlockTFTrapDoor 8
Chest TFChest<Wood> BlockTFChest 8
Chest（陷阱版） TFChestTrap<Wood> BlockTFChest 8
合计 40

另有原木 / 木板（TFLog、TFPlank）与半砖（TFWoodSlab、TFWoodSlabDouble） 是跨木材的 meta 变体，不带木材后缀，不计入上面的 8×5。

城堡与极光建材（9 个，不是木材）

家族 方块数 注册名
Castle 5 CastleBrick、CastleMagic、CastleDoor、CastleDoorVanished、CastleUnlock（TFBlocks.java:277-285）
Aurora 4 TFAuroraBrick、AuroraPillar、AuroraSlab、AuroraDoubleSlab（TFBlocks.java:240、:249-251）

其它功能方块（77 个）

40（木质）+ 9（城堡 / 极光）+ 77 = 126，与注册方块总数一致。 其中含以下重点条目：

物品列表

120 个注册物品，按用途分组（完整表见源码 item/TFItems.java）：

进度与地图（9）

以下 5 个有独立条目：

仅有注册表、无独立条目（4）： oreMagnet（矿物磁铁）、crumbleHorn、peacockFan、moonwormQueen

三把权杖的共同点：全部由 Twilight Lich 掉落。

注册名 说明
scepterTwilight 暮色权杖
scepterLifeDrain 吸取生命权杖
scepterZombie 僵尸权杖
oreMeter 矿物探测仪
magicMap / mazeMap / oreMap 3 种地图
emptyMagicMap / emptyMazeMap / emptyOreMap 地图的空白形态
magicMapFocus / mazeMapFocus 地图聚焦镜
feather 暮色羽毛（渲染名 tfFeather）
towerKey 高塔钥匙

装备套装（6 套）

ironwood*、steeleaf*、fiery*、knightly*、yeti*、arctic* 各 4–7 件。

特殊物品

charmOfLife1/2、charmOfKeeping1/2/3（护符）、cubeOfAnnihilation（湮灭之方）、 cubeTalisman、lampeOfCinders、moonwormQueen、borerEssence、carminite、 experiment115、armorShards、knightMetal、shardCluster。

⚠️ 声明但未注册的物品

TFItems.java:46 声明了字段 wandPacification，但它的创建代码（第 204-205 行）与 注册代码（第 355 行，注释为 "Wand of Pacification [NYI]"）双双被注释掉：

// wandPacification = new
// ItemTF().setIconIndex(6).setUnlocalizedName("wandPacification").setMaxStackSize(1).setFull3D();
...
// registerTFItem(wandPacification, "Wand of Pacification [NYI]");

因此 TwilightForest:wandPacification 不是可获得的物品（NYI = Not Yet Implemented）。 统计注册物品数时若直接数字段声明会多算 1。

结构列表

暮色森林的塔与地牢都是世界生成结构，不是玩家建造的多方块。 结构组件源码位于 structures/ 目录。

世界生成特性总表

4 座高塔

其它结构

结构 特性 ID 源码目录 塔主
蛇庭院 5 structures/courtyard/（18 个文件） Naga
九头蛇巢穴 12 ComponentTFHydraLair.java Hydra
雪怪洞穴 17 ComponentTFYetiCave.java Alpha Yeti
巨人工厂 18 structures/trollcave/ Troll
牛头人迷宫（Labyrinth） 13 structures/minotaurmaze/（28 个文件） Minotaur（非塔主，迷宫终点）
树篱迷宫 Hedge Maze 4 ComponentTFHedgeMaze.java（StructureTFMajorFeatureStart.java:141-142） —
树洞丘陵 1/2/3 ComponentTFHollowHill.java —
巨型树 16 structures/hollowtree/ —
骑士要塞 15 structures/stronghold/ Knight Phantom
试炼林 9 ComponentTFQuestGrove.java —
最终城堡 19 structures/finalcastle/ —

原表另有一行「树人迷宫 13 / structures/TFMaze.java」——该行没有源码依据，属幻影行： 特性 ID 13 就是 labyrinth（“Labyrinth”），即上面的牛头人迷宫，二者不是两个结构。 structures/TFMaze.java 只是牛头人迷宫用的迷宫布局抽象基类（public class TFMaze， 第 23 行），不是独立结构，也没有自己的特性 ID。

同理，ComponentTFHillMaze（丘陵迷宫）虽在 StructureTFMajorFeatureStart.java:69 用 func_143031_a 注册，但唯一的 new ComponentTFHillMaze(...) 出现在 ComponentTFHollowHill.java:69 且整行被注释掉 —— 属注册了但永不放置的死代码， 不能算作可生成结构。

配置项

TwilightForestMod.java:88-111 共定义 20 个静态配置/集成字段，其中 11 个是玩家可改的选项：

配置 作用
creatureCompatibility 启用原版生物兼容
silentCicadas 静音蝉鸣
allowPortalsInOtherDimensions 允许在其他维度开传送门
adminOnlyPortals 仅管理员可开传送门
twilightForestSeed 自定义世界种子
disablePortalCreation 禁用传送门创建
disableUncrafting 禁用分解台
oldMapGen 使用旧版地图生成
portalCreationItemString 传送门创建物品
portalMaxSize 传送门最大尺寸
timeCoreExcludedBlocks 时核排除方块集合

另有维度/生物群系 ID 常量：backupdimensionID = -777（:88）、dimensionProviderID（:89）、 maxBiomeIDs = 256（:111，注释标为 vanilla 默认值）。

可选整合

检测到即启用（TwilightForestMod.java:105-110，6 个开关）： GTNHLib（isGTNHLoaded）、Skinport（isSkinportLoaded）、Baubles（areBaublesLoaded）、 NotEnoughItems（isNeiLoaded，字段名不是 isNeiNEI）、 Tinkers Construct（enableTiCIntegration）、 Et Futurum（enableEfRIntegration）—— 后者提供 Husk / Shulker 兼容 （TFFeature.java:39-40 导入 ganymedes01.etfuturum.entities.EntityHusk / EntityShulker， :116-120 往 lichTower 加 Shulker；另受 shulkerSpawnInLichTower 开关控制）。

相关条目

  • 实体与 Boss 详见实体维度
  • 塔与地牢的建材与机关详见结构维度 <!-- AUTO-INDEX:START -->

完整索引（自动生成）

本节由 tools/sync_catpage_index.py 从磁盘实际文件生成，共 298 个条目。 上面各节是人工撰写的概览；任何未在上面出现的条目都在这里。 重新生成：删掉本节两个 <!-- AUTO-INDEX --> 标记之间的内容后重跑脚本。

block/（94）

上文已链出 10 个；以下 84 个为新增补齐：

条目 条目 条目 条目
Block of Arctic Fur Aurora Block（极光方块） Aurora Slab Aurora Pillar（极光柱）
Aurora Slab（极光半砖） Burnt Thorns（荆棘灰烬） Canopy Wood Set（苍穹树木制品组） Block of Carminite
Castle Brick Castle Door Castle Door Castle Rune Brick
CastleUnlock Cicada（蝉） Cinder Furnace（余烬熔炉 [NYI]） Cinder Furnace（余烬熔炉 [NYI]）
CinderLog Darkwood Leaves（黑树树叶） Darkwood Wood Set（黑树木制品组） Deadrock
Block of Fiery Metal Smoking Block / Fire Jet Firefly（萤火虫） Fluffy Cloud（蓬松的云）
Force Field Giant Cobblestone（巨型圆石） Giant Leaves（巨型树叶） Giant Log（巨型原木）
Giant Obsidian（巨型黑曜石） Hedge Huge Mushgloom（巨型暮色森林蘑菇） Huge Lily Pad（巨型荷叶）
Huge Stalk（巨大的茎） Huge Water Lily（巨型荷花） Block of Ironwood Block of Knightmetal（骑士金属块）
Leaves Leaves Wood Leaves
Wood Mangrove Wood Set（红树木制品组） Mining Wood Set（矿工树木制品组） Moonworm（月光蠕虫）
Nagastone Etched Nagastone Mossy Etched Nagastone Ruined Etched Nagastone
Nagastone Head Nagastone Pillar Mossy Nagastone Pillar Ruined Nagastone Pillar
Nagastone Stairs (Left) Mossy Nagastone Stairs (Left) Mossy Nagastone Stairs (Right) Nagastone Stairs (Right)
Weathered Nagastone Stairs (Left) Weathered Nagastone Stairs (Right) Planks Plant
Roots Sapling Stronghold Shield Slide Trap
Sorting Wood Set（分类树木制品组） Spiral Stone Bricks Block of Steeleaf Experiment 115
Twilight Forest Trophy（暮色森林战利品） Thorn Rose（荆棘玫瑰） Thorns Time Wood Set（时光树木制品组）
Translucent Block Transformation Wood Set（变化树木制品组） Trollber（巨魔浆果） Trollsteinn（巨魔石）
Trollvidr（巨魔藤蔓） Twilight Oak Wood Set（暮色橡树木制品组） Uberous Soil（培养土） Underbrick
Unripe Trollber（未成熟的巨魔浆果） Wispy Cloud（飘渺的云） Slab Slab

entity/（79）

上文已链出 9 个；以下 70 个为新增补齐：

条目 条目 条目 条目
Adherent（追随者） Armored Giant（装甲巨人） Bighorn Sheep（大角山羊） Block&Chain Goblin（链球地精）
Boggard（博加德）—— 未注册，实体不存在于游戏内 Chain Block（链球） Charm Effect（护符特效实体） Cube of Annihilation（湮灭之方投射物）
Death Tome（死亡之书） Falling Ice（坠落冰块） Fire Beetle（喷火甲虫） Firefly（萤火虫）
Forest Bunny（兔子） Forest Raven（森林乌鸦） Forest Squirrel（林中松鼠） Giant Miner（巨人矿工）
Harbinger Cube（先驱魔方） Hedge Spider（树篱蜘蛛） Helmet Crab（头盔蟹） Hostile Wolf（敌意狼）
HydraHead（九头蛇头颅） Hydra Mortar（九头蛇迫击炮） Ice Bomb（寒冰炸弹投射物） Ice Crystal（冰晶）
Ice Snowball（寒冰雪球） King Spider（蛛王） Lich Bolt（巫妖魔弹） Lich Bomb（巫妖炸弹）
Lich Minion（巫妖随从） Lower Goblin Knight（低阶地精骑士） Loyal Zombie（忠诚的僵尸） Maze Slime（迷宫史莱姆）
Mini Ghast（迷你幽灵） Minotaur（牛头人） Mist Wolf（迷雾狼） tfmoonwormshot（月光蠕虫弹）
Mosquito Swarm（成群的蚊子） tfnaturebolt（自然法弹） Penguin（企鹅） Pinch Beetle（枯萎甲虫）
Questing Ram（谜题羊） Redcap（红帽地精） Redcap Sapper（红帽工兵） Redscale Broodling（寄生虫）
Roving Cube（悬浮立方体 [NYI]） Seeker Arrow（追踪箭） Skeleton Druid（骷髅德鲁伊） Slide Block（滑块）
Slime Beetle（史莱姆甲虫） Slime Blob（史莱姆团） SnowGuardian（雪之守卫） Stable Ice Core（稳定冰核）
Swarm Spider（群聚蜘蛛） Thrown Axe（飞斧） Thrown Pick（飞镐） Tiny Bird（微小鸟）
Tome Bolt（魔弹） Tower Ghast（高塔幽灵） Tower Golem（高塔铁傀儡） Tower Termite（高塔蠹虫）
Troll（巨魔） Twilight Kobold（暮色狗头人） Twilight Wand Bolt（暮色魔弹） Twilight Wraith（幽灵）
Unstable Ice Core（不稳定冰核） Upper Goblin Knight（上半身哥布林骑士） Wild Boar（野猪） Wild Deer（野鹿）
WinterWolf（寒冬狼） Yeti（雪怪）

item/（120）

上文已链出 5 个；以下 115 个为新增补齐：

条目 条目 条目 条目
Alpha Yeti Fur（雪人首领毛皮） Arctic Boots（极地靴子） Arctic Fur（极地毛皮） Arctic Hood（极地兜帽）
Arctic Leggings（极地护腿） Arctic Jacket（极地夹克） Armor Shard（装甲碎片） Borer Essence（螟虫精华）
Carminite（砷铅铁） Block and Chain（链球） Charm of Keeping I（保管符咒Ⅰ） Charm of Keeping II（保管符咒Ⅱ）
Charm of Keeping III（保管符咒Ⅲ） Charm of Life I（魔力生命Ⅰ） Charm of Life II（魔力生命Ⅱ） Critter
Crumble Horn（粉碎号角） Cube of Annihilation（毁灭魔方） Talisman of the Cube（魔方护符） Canopy Tree Door
Darkwood Door Mangrove Door Minewood Door Sortingwood Door
Timewood Door Transwood Door Twilight Oak Door Blank Magic Map（空白的魔法地图）
Blank Maze Map（空白的迷宮地图） Blank Maze/Ore Map（空白的迷宮/矿石地图） Ender Bow（末影弓） Experiment 115（高塔蛋糕）
Fiery Blood（炽热的血液） Fiery Boots（炽热的靴子） Fiery Helm（炽热的头盔） Fiery Ingot（炽热的铁锭）
Fiery Legs（炽热的护腿） Fiery Pick（炽热的铁镐） Fiery Plate（炽热的胸甲） Fiery Sword（炽热的铁剑）
Fiery Tears（炽热的泪） Giant’s Pickaxe（巨人的镐） Giant’s Sword（巨人的剑） Glass Sword（玻璃剑）
Hydra Chop（九头蛇肉排） Ice Bomb（寒冰炸弹） Ice Bow（寒冰弓） Ice Sword（寒冰剑）
Ironwood Axe（铁木斧） Ironwood Boots（铁木靴子） Ironwood Helm（铁木头盔） Ironwood Hoe（铁木锄）
Ironwood Ingot（铁木锭） Ironwood Legs（铁木护腿） Ironwood Pick（铁木镐） Ironwood Plate（铁木胸甲）
Raw Ironwood Materials（未加工的铁木原料） Ironwood Shovel（铁木铲） Ironwood Sword（铁木剑） Knightmetal Ingot（骑士金属锭）
Knightly Axe（骑士斧） Knightly Boots（骑士靴） Knightly Helm（骑士头盔） Knightly Greaves（骑士护腿）
Knightly Pick（骑士镐） Knightly Plate（骑士胸甲） Knightly Sword（骑士剑） Knightmetal Loop（骑士金属环）
Lamp of Cinders（灰烬烧灯） Naga Scale Leggings（娜迦护腿） Liveroot（活根） Magic Beans（魔豆）
Magic Map（魔法地图） Magic Map Focus（魔法地图核心） Maze Map（迷宫地图） Maze Map Focus（迷宮地图核心）
Maze Wafer（迷宮薄饼） Mazebreaker（迷宮破坏者） Raw Meef（生牛头人肉） Meef Steak（牛头人肉排）
Meef Stroganoff（牛头人沙拉酱肉） Adherent / Harbinger Fragment（黏着碎片 / 先驱碎片） Minotaur Axe（米诺陶战斧） Moonworm Queen（月光蠕虫女王）
Naga Scale（娜迦鳞片） Ore Magnet（矿石磁铁） Maze/Ore Map（迷宫/矿石地图） Peacock Feather Fan（孔雀羽毛扇）
Phantom Helm（幻影头盔） Phantom Plate（幻影胸甲） Naga Scale Tunic（娜迦胸甲） Seeker Bow（追踪弓）
Armor Shard Cluster（装甲碎片堆） Steeleaf Axe（钢叶斧） Steeleaf Boots（钢叶靴子） Steeleaf Helm（钢叶头盔）
Steeleaf Hoe（钢叶锄） Steeleaf（钢叶） Steeleaf Legs（钢叶护腿） Steeleaf Pick（钢叶镐）
Steeleaf Plate（钢叶胸甲） Steeleaf Shovel（钢叶铲） Steeleaf Sword（钢叶剑） Raven’s Feather（乌鸦羽毛）
Spawn（生成） Torchberries（火炬浆果） Transformation Powder（转换粉） Tri-bow（三发弓）
Trophy Venison Steak（鹿肉排） Raw Venison（生鹿肉） Yeti Boots（雪人靴子）
Yeti Horned Helm（雪人角盔） Yeti Leggings（雪人护腿） Yeti Jacket（雪人夹克）

structure/（5）

全部 5 个条目已在上文列出。

<!-- AUTO-INDEX:END -->