本篇教程由作者设定使用 CC BY-NC-SA 协议。
前言
本文是对Minecraft 1.12.2版本下暮色森林模组配置文件的解读。模组版本为3.11.1021，文中呈现的配置均为默认配置。由于并非对配置文件的直接翻译，本文的中文内容和配置文件的英文原文不会一一对应，仅作为理解各配置选项功能的参考。如有谬误或不恰当的地方欢迎在评论区指出。
配置文件的使用方法
一般情况下，暮色森林模组配置文件的路径为"\.minecraft\config\twilightforest.cfg"；若在下载游戏版本时开启了版本隔离功能，则路径为"\.minecraft\versions\版本名称\config\twilightforest.cfg"。
找到该文件后，可以使用Windows系统自带的记事本打开。在修改配置文件中的选项并保存后启动游戏，经过修改的条目就会生效。
配置文件中每项内可以填入的数据类型不同，有整型(Int)、布尔型(Boolean)、双精度浮点型(Double)等，配置文件中在每项开头已标注了对应数据类型的首字母照着示例填一般不会出什么问题 乱填后果自负ㄟ( ▔, ▔ )ㄏ，如布尔型标为B。
配置文件正文
# Configuration file
general {
# Allow portals only for admins (Operators). This severely reduces the range in which the mod usually scans for valid portal conditions, and it scans near ops only.
此项为true时只允许管理员使用暮色森林传送门。开启该选项会显著减小该模组扫描有效传送门的范围，只在管理员附近扫描。
B:adminOnlyPortals=false
# Allow portals to the Twilight Forest to be made outside of the 'origin' dimension. May be considered an exploit.
此项为true时允许在设置的“初始维度”以外的维度建造暮色森林传送门。关于“初始维度”见下文“I:originDimension”。
B:allowPortalsInOtherDimensions=false
# Anti-Builder blacklist. (domain:block:meta) meta is optional.
此项为反建器不会阻止放置和破坏的方块列表，默认有基岩和Tomb Many Graves 2的坟墓方块。填写格式为“[命名空间ID]:[方块ID]:[元数据]”（元数据可不填）。
S:antibuilderBlacklist <
minecraft:bedrock
tombmanygraves:grave_block
>
# Determines if new portals should be pre-checked for safety. If enabled, portals will fail to form rather than redirect to a safe alternate destination.
此项为true时会在生成传送门时检查目的地是否安全，在目的地不安全时传送门无法形成。
# Note that enabling this also reduces the rate at which portal formation checks are performed.
启用此项也会降低传送门生成检查的执行速度。
B:checkPortalDestination=false
# Disable Twilight Forest portal creation entirely. Provided for server operators looking to restrict action to the dimension.
此项为true时彻底禁止玩家开启暮色森林传送门。
B:disablePortalCreation=false
# Disable the uncrafting function of the uncrafting table. Provided as an option when interaction with other mods produces exploitable recipes.
此项为true时禁用拆解台的拆解功能。这对多模组游戏的平衡性会有极大的改善，毕竟拆解台“NBT撕裂者”的名号可不是白叫的(=.=)
B:disableUncrafting=false
# Should TF Compatibility load? Turn off if TF's Compatibility is causing crashes or if not desired.
此项为true时启用暮色森林模组的兼容性。不需要兼容性或遇到崩溃时可以禁用该项。
B:doCompat=true
# Controls whether various effects from the mod are rendered while in first-person view. Turn this off if you find them distracting.
此项为true时开启暮色森林模组中在第一人称视角显示的特效。
B:firstPersonEffects=true
# The dimension you can always travel to the Twilight Forest from, as well as the dimension you will return to. Defaults to the overworld.
此项决定初始维度，即离开暮色森林时默认返回的维度和allowPortalsInOtherDimensions=false时唯一能开启暮色森林传送门的维度。数字位置需要填入维度ID，默认为0（主世界）。（下界为-1，末路之地为1，其他模组添加的维度请前往相应模组查询维度ID）
I:originDimension=0
# Registry String IDs of items used to create the Twilight Forest Portal. (domain:regname:meta) meta is optional.
此项为投入有效水池结构后能够开启暮色森林传送门的物品的列表。默认只有钻石。填写格式为“[命名空间ID]:[物品注册名]:[元数据]”（元数据可不填）。
S:portalCreationItems <
minecraft:diamond
>
# Set this true if you want the lightning that zaps the portal to not set things on fire. For those who don't like fun.
此项为true时开启暮色森林传送门时劈落在传送门上的闪电不会点燃方块。
B:portalLightning=false
# Sets the default value of the game rule controlling enforced progression.
此项为true时玩家在暮色森林内受保护符咒限制，解锁特定成就后才能在对应区域自由活动。
B:progressionRuleDefault=true
# Rotate trophy heads on item model. Has no performance impact at all. For those who don't like fun.
此项为true时BOSS战利品（如娜迦战利品）在物品栏中时显示的BOSS头颅模型会旋转。开启这个选项几乎不会降低性能。所以没什么关掉的必要啊╰（‵□′）╯
B:rotateTrophyHeadsGui=true
# If false, the return portal will require the activation item.
此项为true时进入暮色森林自动生成的传送门处于激活状态，若关闭则需要投入用于激活的物品（默认为钻石，若想使用其它物品见上文“S:portalCreationItems”条目）以激活返回的传送门。
B:shouldReturnPortalBeUsable=true
# Make cicadas silent for those having sound library problems, or otherwise finding them annoying.
此项为true时蝉不会发出声音。如果音效库出现问题或觉得蝉鸣太吵可以关闭该项。
B:silentCicadas=false
维度设置
########################################################################################################
# dimension
#--------------------------------------------------------------------------------------------------------#
# Settings that are not reversible without consequences.
一般情况下在生成世界后无法变更的设置。
########################################################################################################
dimension {
# What ID number to assign to the Twilight Forest dimension. Change if you are having conflicts with another mod.
暮色森林维度的维度ID，默认为7，在与其他模组的维度ID冲突时可以改成其他数字。
I:dimensionID=7
# If true, players spawning for the first time will spawn in the Twilight Forest.
此项为true时玩家会在暮色森林维度出生。
B:newPlayersSpawnInTF=false
# If true, Twilight Forest will generate as a void except for Major Structures
此项为true时暮色森林维度除主要结构外会生成为一片虚空，即穹光森林。
B:skylightForest=false
# If true, giant Twilight Oaks will also spawn in void worlds
B:skylightOaks=true
# If set, this will override the normal world seed when generating parts of the Twilight Forest Dimension.
暮色森林的地形默认使用世界种子生成，在此项中填入种子可以使暮色森林按照该种子生成，优先级高于世界种子。
S:twilightForestSeed=
地物生成权重
######################################################################################################
# worldgenweights
#--------------------------------------------------------------------------------------------------------#
# Weights for various small features
各种小型地物(Feathure)的生成权重。数值越大生成概率越高。填入的值最小为0，最大为2147483647(整型能储存的最大数值，即2^31-1)。
######################################################################################################
worldgenweights {
# Min: 0
# Max: 2147483647
德鲁伊小屋的生成权重
I:druidHutWeight=10
# Min: 0
# Max: 2147483647
倒下的空心木头的生成权重
I:fallenHollowLogWeight=10
# Min: 0
# Max: 2147483647
倒下的树干（目前在百科中没有对应条目）的生成权重
I:fallenSmallLogWeight=10
# Min: 0
# Max: 2147483647
地基遗迹的生成权重
I:foundationWeight=10
# Min: 0
# Max: 2147483647
树丛遗迹的生成权重
I:groveRuinsWeight=5
# Min: 0
# Max: 2147483647
空心树墩的生成权重
I:hollowStumpWeight=12
# Min: 0
# Max: 2147483647
黑曜石柱的生成权重
I:monolithWeight=10
# Min: 0
# Max: 2147483647
石笋的生成权重
I:stalagmiteWeight=12
# Min: 0
# Max: 2147483647
圆石阵的生成权重
I:stoneCircleWeight=10
# Min: 0
# Max: 2147483647
水井的生成权重
I:wellWeight=10
}
矿山钟乳石
######################################################################################################
# hollowhillstalactites
#--------------------------------------------------------------------------------------------------------#
# Defines custom stalactites generated in hollow hills.
自定义在亡灵矿山中生成的矿物钟乳石。按照下方规定的格式将想要的钟乳石配置按需求填入下方任一列表中即可生效。
# Format is "modid:block<:meta> size maxLength minHeight weight", where the properties are:
格式是“模组ID:方块ID:元数据 尺寸 最大长度 最低生成高度 生成权重”（“:元数据”这部分可以省略）。
# Size - the maximum length of the stalactite relative to the space between hill floor and ceiling,
尺寸：钟乳石高度与该位置矿山天花板与底面的高度差的比值的最大值。
# Max length - maximum length of a stalactite in blocks,
最大长度：钟乳石的最大长度（以方块数计）。
# Min height - minimum space between the hill floor and the stalactite to let it generate,
最低生成高度：矿山天花板与底面高度差大于该值（以方块数计）的位置才有机会生成钟乳石。
# Weight - how often it generates.
生成权重：决定生成频率。
#
# For example: "minecraft:iron_ore 0.7 8 1 24" would add a stalactite equal to the default iron ore stalactite.
一个示例，使用该示例生成的钟乳石与默认的铁矿钟乳石相同。
######################################################################################################
hollowhillstalactites {
# Blocks generating as stalactites in large hills only
定义只在大型矿山内以钟乳石柱的形式生成的方块。
S:largeHill <
>
# Blocks generating as stalactites in medium and large hills
定义在大型矿山和中型矿山内以钟乳石柱的形式生成的方块。
S:mediumHill <
>
# Blocks generating as stalactites in all hills
定义在所有矿山内以钟乳石柱的形式生成的方块。
S:smallHill <
>
# If true, default stalactites and stalactites defined by other mods will not be used.
此项为true时默认的钟乳石配置和其他模组提供的钟乳石配置不会生效，即只生成上文的自定义钟乳石。
B:useConfigOnly=false
}
}
性能设置
########################################################################################################
# performance
#--------------------------------------------------------------------------------------------------------#
# Lets you sacrifice various things to improve world performance.
通过牺牲某些东西来提高性能的设置。
########################################################################################################
performance {
# Amount of canopy coverage. Lower numbers improve chunk generation speed at the cost of a thinner forest.
树冠覆盖量。减小此项的数值会以森林更稀疏为代价提高区块的生成速度，最小可设为0。
# Min: 0.0
# Max: 1.7976931348623157E308
D:canopyCoverage=1.7000000476837158
# If the dimension has per-block skylight values. Disabling this will significantly improve world generation performance, at the cost of flat lighting everywhere.
此项决定暮色森林维度是否每个方块都有天空光照亮度，设为false会显著提高世界的生成性能。代价是没有阴影的平整光照。
# WARNING: Once chunks are loaded without skylight, that data is lost and cannot easily be regenerated. Be careful!
禁用此项后加载的区块会失去天空光照亮度数据，很难恢复成正常的区块，慎用。
B:enableSkylight=true
# Setting this true will make Twilight Glaciers generate with Packed Ice instead of regular translucent Ice, decreasing amount of light checking calculations.
此项为true时暮色冰川本该生成的冰会被替换为浮冰。不透明的浮冰会减小光照的运算量。
B:glacierPackedIce=false
# This controls the opacity of leaves, changing the amount of light blocked. Can be used to decrease complexity in some lighting checks.
此项控制树叶的不透明度，可以降低光照运算的复杂度。数值在0到255之间，数值越大越不透明。
# Min: 0
# Max: 255
I:leavesLightOpacity=1
# Chance that a chunk in the Twilight Forest will contain a twilight oak tree. Higher numbers reduce the number of trees, increasing performance.
此项控制暮色森林维度中生成高大的暮色橡树的机会，数值在0到2147483647之间，数值越大生成得越少。
# Min: 1
# Max: 2147483647
I:twilightOakChance=48
}
盾牌交互设置
########################################################################################################
# shieldinteractions
#--------------------------------------------------------------------------------------------------------#
# We recommend downloading the Shield Parry mod for parrying, but these controls remain for without.
作者推荐使用 Shield Parry 这个模组的招架功能，但只是推荐，这部分配置文件在没有 Shield Parry 模组时生效。
########################################################################################################
shieldinteractions {
# Set to true to parry non-Twilight projectiles.
此项为true时可以招架非暮色森林模组的弹射物。
B:parryNonTwilightAttacks=false
# The amount of ticks after raising a shield that makes it OK to parry an arrow.
举盾后能招架箭矢的持续时间（以游戏刻计）。下面那个Beam没看懂是啥。或许是骷髅德鲁伊的射线？
# Min: 0
# Max: 2147483647
I:shieldParryTicksArrow=40
# Min: 0
# Max: 2147483647
I:shieldParryTicksBeam=10
# The amount of ticks after raising a shield that makes it OK to parry a fireball.
举盾后能招架火球的持续时间（以游戏刻计）。
# Min: 0
# Max: 2147483647
I:shieldParryTicksFireball=40
# The amount of ticks after raising a shield that makes it OK to parry a thrown item.
举盾后能招架投掷物的持续时间（以游戏刻计）。
# Min: 0
# Max: 2147483647
I:shieldParryTicksThrowable=40
}
加载屏幕设置
########################################################################################################
# loadingscreen
#--------------------------------------------------------------------------------------------------------#
# Client only: Controls for the Loading screen
控制进出暮色森林维度时的加载屏幕。仅作用于客户端。
########################################################################################################
loadingscreen {
# How many ticks between each loading screen change. Set to 0 to not cycle at all.
此项决定加载屏幕变化的间隔时间（以游戏刻计）。默认不变化（即值被设为0）。
# Min: 0
# Max: 2147483647
I:cycleLoadingScreenFrequency=0
# Wobble the Loading icon. Has no performance impact at all. For those who don't like fun.
此项为true时加载屏幕上的物品图标会摆动。不影响性能。
B:enable=true
# Frequency of wobble and bounce.
此项控制物品图标摆动和弹跳的频率。
# Min: 0.0
# Max: 1.7976931348623157E308
D:frequency=5.0
# List of items to be used for the wobbling Loading Icon. (domain:item:meta) meta is optional.
此项为会出现在加载屏幕上摆动的物品列表。填写格式为“[命名空间ID]:[物品注册名]:[元数据]”（元数据可不填）。
S:loadingIconStacks <
twilightforest:experiment_115
twilightforest:magic_map
twilightforest:charm_of_life_2
twilightforest:charm_of_keeping_3
twilightforest:phantom_helmet
twilightforest:lamp_of_cinders
twilightforest:carminite
twilightforest:block_and_chain
twilightforest:yeti_helmet
twilightforest:hydra_chop
twilightforest:magic_beans
twilightforest:ironwood_raw
twilightforest:naga_scale
twilightforest:experiment_115:2
twilightforest:miniature_structure
twilightforest:miniature_structure:6
twilightforest:knightmetal_block
twilightforest:tower_device:10
twilightforest:twilight_sapling:5
twilightforest:twilight_sapling:6
twilightforest:twilight_sapling:7
twilightforest:twilight_sapling:8
twilightforest:twilight_sapling:9
twilightforest:borer_essence
>
下面几项具体效果尚不明确，等待进一步测试。
# Scale of whole bouncy loading icon.
# Min: 0.0
# Max: 1.7976931348623157E308
D:scale=3.0
# How much the loading icon bounces.
# Min: 0.0
# Max: 1.7976931348623157E308
D:scaleDeviation=5.25
# Pushback value to re-center the wobble of loading icon.
# Min: 0.0
# Max: 360.0
D:tiltConstant=22.5
# How far the loading icon wobbles.
# Min: 0.0
# Max: 360.0
D:tiltRange=11.25
}
}
