Editing Configuration

The Configuration file is used to alter the behavior of the Twilight Forest mod. This can be found by navigating to the Mod Options menu, finding the Twilight Forest mod in the menu and selecting the Config button. Alternatively, one can find the config file using the command <code>/config showfile twilightforest</code> followed by either client or common. The following options can be found in this file.

=Common Configurations=
Found in <code>twilightforest-common.toml</code>, these configurations can completely change the way that the Twilight Forest can be played.

==General Settings==
These are some generalized configuration settings. These settings will not drastically change the gameplay of Twilight Forest, but they can greatly help with various issues.

===Skull Candles===
The config option <code>disableSkullCandleCreation</code> will determine if the ability to make [[Skull Candle]]s by right clicking a vanilla mob's skull with a candle is allowed. Turn this on if you're having mod conflict issues for some reason.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

----

===Enchantment Effects===
The config option <code>showEnchantmentsOnItems</code> will determine if items that come enchanted when you craft them (such as [[Ironwood Armor|Ironwood]] or [[Steeleaf Armor|Steeleaf]]) should appear as enchanted way in the creative inventory. Please note that this does not affect the crafting recipes themselves, you will need a datapack to change those.
<p style="text-indent: 25px;"> By default, this is set to <code>true</code> </p>

----
===Boss Loot Chests===
The config option <code>bossesSpawnDropChests</code> will determine if the Twilight Forest's bosses will put their drops inside of a chest where they originally spawned instead of dropping the loot directly on death. Note that the Knight Phantoms are not affected by this as their drops work differently than other bosses.
<p style="text-indent: 25px;"> By default, this is set to <code>true</code> </p>

----
===Precipitation Distance===
The config option <code>cloudBlockPrecipitationDistance</code> will determine how many blocks down from a cloud block should the game logic check for handling weather related code. Lower if experiencing low tick rate. Set to 0 to turn all cloud precipitation logic off. See below: [[Configuration#Cloud_Precipitation|Cloud Precipitation]]
<p style="text-indent: 25px;"> By default, this is set to <code>32</code> </p>

==Multiplayer Settings==
These are tweaks to better adjust the Twilight Forest for multiplayer servers.

===Boss Adjustments=== <!--Needs better indentation on "MORE_LOOT"-->
The config option <code>multiplayerFightAdjuster</code> will determine how bosses should adjust to multiplayer fights. There are 4 possible values that can be put here:
<br>[[File:Steeleaf.png|link=|16px]]<code>"NONE"</code>: Doesn't change anything when multiple people participate in a boss fight. Bosses will act the same as they do in singleplayer or solo fights.
<br>[[File:Steeleaf.png|link=|16px]]<code>"MORE_LOOT"</code>: Supplies additional drops to the boss loot table based on how many players participated in the fight. These are fully controlled through the entity's loot table, using the <code>twilightforest:multiplayer_multiplier</code> loot function. Note that this function will only do things to entities that are included in the <code>twilightforest:multiplayer_inclusive_entities</code> tag.
<br>[[File:Steeleaf.png|link=|16px]]<code>"MORE_HEALTH"</code>: Increases the maximum health of each boss by 35 hearts for each player nearby when the fight starts.
<br>[[File:Steeleaf.png|link=|16px]]<code>"MORE_LOOT_AND_HEALTH"</code>: Does both of the above functions for each boss.

<p style="text-indent: 25px;"> By default, this is set to <code>"MORE_HEALTH"</code> </p>

----

===Keepsake Casket Locking===
The config option <code>casketUUIDLocking </code> will determine if Keepsake Caskets that are placed when a player dies should be inaccessible by other players than the player who died. Use this if you don't want people taking from other people's death caskets. NOTE: Server operators will still be able to open locked caskets.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

==Dimension Settings==
Settings for the Twilight Forest dimension itself can be found here. These purely affect player spawning.

===Spawning Dimension===
The config option <code>newPlayersSpawnInTF</code> will determine if newly joining players should spawn in the Twilight Forest, opposed to spawning in the Overworld.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

----
===Spawn Portal===
The config option <code>portalForNewPlayer</code> will determine if a return portal should generate for newly joining players when <code>newPlayersSpawnInTF</code> is <code>true</code>.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

==Magic Tree Settings==
Configuration settings regarding the Magic Tree Cores can be found here. All values can range between 0 and 128, where 0 completely disables the core's function.

===Timewood Clock===
The config option <code>timeCoreRange</code> will determine the radius at which the [[Timewood Clock]] works.
<p style="text-indent: 25px;"> By default, this is set to <code>16</code>, making it a 33 by 33 range. </p>

----
===Heart of Transformation===
The config option <code>transformationCoreRange</code> will determine the radius at which the [[Heart of Transformation]] works.
<p style="text-indent: 25px;"> By default, this is set to <code>16</code>, making it a 33 by 33 range. </p>

----
===Minewood Core===
The config option <code>miningCoreRange</code> will determine the radius at which the [[Minewood Core]] works.
<p style="text-indent: 25px;"> By default, this is set to <code>16</code>, making it a 33 by 33 range. </p>

----
===Sortingwood Engine===
The config option <code>sortingCoreRange</code> will determine the radius at which the [[Sortingwood Engine]] works.
<p style="text-indent: 25px;"> By default, this is set to <code>16</code>, making it a 33 by 33 range. </p>

==Uncrafting Table Settings==
All configuration settings for the [[Uncrafting Table]] can be found here.

===Uncrafting XP Cost===
The config option <code>uncraftingXpCostMultiplier</code> will determine the total XP cost of uncrafting an item and rounds up. Higher values means the recipe will cost more to uncraft, lower means less. Set to 0 to disable the cost altogether. Note that this only affects reversed crafting recipes, uncrafting recipes will still use the same cost as they normally would.
<p style="text-indent: 25px;"> By default, this is set to <code>1.0</code> </p>

----
===Repairing XP Cost===
The config option <code>repairingXpCostMultiplier</code> will the total XP cost of repairing an item and will round it up to it's nearest value. Higher values means the recipe will cost more to repair, lower means less.
<p style="text-indent: 25px;"> By default, this is set to <code>1.0</code> </p>

----
===Recipe Blacklist===
The config option <code>disableUncraftingRecipes</code> will determine the recipes that should be removed. To add a recipe, add the mod id followed by the name of the recipe, such as <code>"twilightforest:firefly_particle_spawner"</code>. If an item has multiple crafting recipes and you wish to disable them all, add the item to the <code>"twilightforest:banned_uncraftables"</code> tag. If you have a problematic ingredient, add the item to the <code>"twilightforest:banned_uncrafting_ingredients"</code> tag.
<p style="text-indent: 25px;"> By default, this is set to <code>["twilightforest:giant_log_to_oak_planks"]</code> </p>

----
===Recipe Whitelist===
The config option <code>flipRecipeList</code> will invert the above recipe list from a blacklist to a whitelist.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

----
===Mod Blacklist===
The config option <code>blacklistedUncraftingModIds</code> will determine which mods should have their items disabled from being uncrafted. Input a valid mod ID to disable all uncrafting recipes from that mod, such as "twilightforest" will disable all uncrafting recipes from this mod.
<p style="text-indent: 25px;"> By default, this is set to <code>[]</code> </p>

----
===Mod Whitelist===
The config option <code>flipIdList</code> will invert the above mod item list from a blacklist to a whitelist.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

----
===Shapeless Uncrafting===
The config option <code>enableShapelessCrafting</code> will determine if the Uncrafting Table should be allowed to uncraft shapeless recipes. The Uncrafting Table was originally intended to only take shaped recipes, but this option remains for people who wish to keep the functionality.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

----
===Recipe Switching===
The config option <code>disableIngredientSwitching</code> will determine if the uncrafting table should be allowed to switch between ingredients if a recipe uses a specific tag for crafting. This will remove the functionality for '''all recipes'''! If you want to prevent certain ingredients from showing up in the first place, use the <code>twilightforest:banned_uncrafting_ingredients</code> tag.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

----
===Disable Uncrafting Feature===
The config option <code>disableUncrafting</code> will disables the uncrafting function of the uncrafting table. Recommended as a last resort if there's too many things to change about its behavior (or you're just lazy, we don't judge). Do note that some special uncrafting recipes are not disabled as the mod relies on them for other things.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

----
===Disable Uncrafting Table===
The config option <code>disableUncraftingTable</code> will completely disable any usage of the uncrafting table, as well as prevents it from showing up in loot or crafted. Please note that table has more uses than just uncrafting, you can read about them [[Uncrafting Table|here]]! It is highly recommended to keep the table enabled as the mod has special uncrafting exclusive recipes, but the option remains for people that don't want the table to be functional at all. If you are looking to just prevent normal crafting recipes from being reversed, consider using <code>disableUncrafting</code> instead.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

==Portal Settings==
All settings and tweaks regarding the Twilight Forest Portal can be found here:

===Origin Dimension===
The config option <code>originDimension</code> will determine the dimension you can always travel to the Twilight Forest from, as well as the dimension you will return to when coming back from the Twilight Forest.
<p style="text-indent: 25px;"> By default, this is set to <code>"minecraft:overworld"</code> </p>

----
===Additional Dimension Acesss===
The config option <code>allowPortalsInOtherDimensions</code> allow portals to the Twilight Forest to be made outside of the "origin" dimension listed above. It is important to note that this config does ''not'' change your dimension from the origin when blindly teleporting out of the Twilight Forest.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

----
===Admin Portal Creation===
The config option <code>portalCreationPermission</code> will allow ''only'' players with the specified permission value or higher to create portals. This is based off of [https://minecraft.wiki/w/Permission_level Vanilla's Permission System].
<p style="text-indent: 25px;"> By default, this is set to <code>0</code> </p>

----
===Disable Portal Creation===
The config option <code>disablePortalCreation</code> will completely disable the creation of Twilight Forest portals entirely, making the dimension restricted to only server operators. 
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

----
===Portal Generation Safeguard===
The config option <code>checkPortalPlacement</code> determines if newly created portals should be pre-checked for safety from locations that aren't aligned with the player's progression. If this setting is false, portals will fail to form rather than redirect to a safe alternate destination. Note that disabling this also reduces the rate at which portal formation checks are performed.
<p style="text-indent: 25px;"> By default, this is set to <code>true</code> </p>

----
===Lightning Fire===
The config option <code>destructivePortalLightning</code>, when set to false, will disable fire from generating from the lightning strike. This is purely for those who don't like fun.
<p style="text-indent: 25px;"> By default, this is set to <code>true</code> </p>

----
===One Way Portal===
The config option <code>shouldReturnPortalBeUsable</code> determines if a return portal should require the activation item, or if it should be automatically activated, similar to the functionality of a Nether Portal.
<p style="text-indent: 25px;"> By default, this is set to <code>true</code> </p>

----
===Advancement Activation===
The config option <code>portalUnlockedByAdvancement</code> uses an advancement to allow activation of the portal. For example, using the string "minecraft:story/mine_diamond" will lock the portal behind the "Diamonds!" advancement. Invalid/Empty Advancements will leave the portal unlocked.
<p style="text-indent: 25px;"> By default, this is set to <code>""</code> </p>

----
===Maximum Portal Size===
The config option <code>maxPortalSize</code> determines the max amount of water spaces the mod will check for when creating a portal. Very high numbers may cause performance issues, while the minimum number is 4.
<p style="text-indent: 25px;"> By default, this is set to <code>64</code> </p>

==Shield Parrying==
Shield Parrying is a set of config options that allow for parrying projectiles added in the Twilight Forest. It will deflect a projectile back at the target at the same speed and velocity it had. If the mod [https://curseforge.com/minecraft/mc-mods/parry Shield Parry] is installed, all config options listed will have no effect. 

===Parry Non-Twilight Projectiles===
The config option <code>parryNonTwilightAttacks</code> determines if other projectiles from vanilla or other mods can be deflected. 
<p style="text-indent: 25px;"> By default, this is set to <code>disabled</code> </p>

----
===Parry Opportunity===
The config option <code>shieldParryTicksArrow</code> determines the amount of ticks (1/20th of a second) where it is possible to parry a projectile.
<p style="text-indent: 25px;"> By default, this is set to <code>40</code> </p>

=Client Configurations=
Found in <code>twilightforest-client.toml</code>, these are configurations that act as a performance and appearance adjustments, allowing for more customization and performance for those on a lower-end computer

===Silent Cicadas===
The config option <code>silentCicadas</code> determines if Cicadas make any noises. In the event the sound events for Cicadas are not working properly, either by corruption or missing file, or the sounds are too annoying to bear, they can be silenced.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

----
===Silent Head Cicadas===
The config option <code>silentCicadasOnHead</code> determines if Cicadas make any noises when sitting on your head. If the config option <code>silentCicadas</code> is set to true, this option will not have any effect.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

----
===First-Person Effects===
The config option <code>firstPersonEffects</code> determines whether various effects from the mod are rendered while in first-person view. If the effects are too distracting, it is recommended to turn this off.
<p style="text-indent: 25px;"> By default, this is set to <code>true</code> </p>

----
===Trophy Rotation===
The config option <code>rotateTrophyHeadsGui</code> determines trophies heads will rotate on the item model. This option has no performance impact, but can still be disabled for those who do not like fun.
<p style="text-indent: 25px;"> By default, this is set to <code>true</code> </p>

----
===Charm Animations===
The config option <code>totemCharmAnimation</code> determines if the [[Charm of Keeping]] and [[Charm of Life]] display similarly to the Totem of Undying when used.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

----
===Cloud Precipitation===
The config option <code>cloudBlockPrecipitationDistance</code> determines how far away precipitation should be rendered when going through clouds. Leave this value to -1 to be synced with the common config, or set it to 0 to disable the cloud percipitation entirely.
<p style="text-indent: 25px;"> By default, this is set to <code>-1</code> </p>

----
===Giant Skins===
The config option <code>giantSkinUUIDs</code> determines what skin(s) [[Giant]]s should have. If left blank, it will default to the player's skin.
<p style="text-indent: 25px;"> By default, this is set to <code>[]</code> </p>

----
===Aurora Shader===
The config option <code>auroraBiomes</code> determines which biomes the Aurora Shader should be applied. Remove all text and leave <code>[]</code> if you wish to disable the shader completely.
<p style="text-indent: 25px;"> By default, this is set to <code>["twilightforest:glacier"]</code> </p>

----
===Ore Meter Interface===
The config option <code>prettifyOreMeterGui</code> determines if the dashes and percentages in the [[Ore Meter]] GUI should line up properly.
<p style="text-indent: 25px;"> By default, this is set to <code>true</code> </p>

----
===Questing Ram Indicator===
The config option <code>questRamWoolIndicator</code> determines if a render should exist that shows a little check mark or x above your crosshair, depending on if fed the [[Questing Ram]] a specific color of wool.
<p style="text-indent: 25px;"> By default, this is set to <code>true</code> </p>

----
===Fortification Indication===
The config option <code>fortificationShieldIndicator</code> determines if a render should exist that shows how many fortification shields are currently active on your player, above the armor bar. Disable this option if you find it intrusive, or other mods render over or under it.
<p style="text-indent: 25px;"> By default, this is set to <code>true</code> </p>

----
===Biome Toasts===
The config option <code>disableLockedBiomeToasts</code> determines if toasts should appear when travelling into a locked biome. Not recommended if one is not familiar with the [[progression]].
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

----
===Optifine===
The config option <code>disableOptifineNagScreen</code> determines if the Optifine warning screen should be disabled, if it is installed. It is highly recommended to use a replacement for Optifine.
<p style="text-indent: 25px;"> By default, this is set to <code>false</code> </p>

=History=
<!--Add this eventually please-->

{{ModInfo}}