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 under the name <code>twilightforest.cfg</code> in the main Minecraft directory. The following options can be found in this file.

==Admin-Only Twilight Portals==
This config option alters the behavior of portal creation. When it is enabled, the portal can only be created by players that are Admins, or have administration permissions. It also affects where portals will be created. By default, the portal will search a 32 block radius from the player's current co-ordinates, but with this option enabled, it is reduced down to only a 4 block radius. Anyone can still use these portals, as this config option only changes who can create a portal.

By default, this option is '''disabled'''.

==Anti-Builder Blacklist==
This config option alters how the [[Anti-Builder]] functions. Depending on what is input, the Anti-Builder will not destroy if it is placed within its range. This config option is useful for those that utilise mods that place a block in the world, like gravestone mods.

By default, there are two entries already added: Bedrock, and Tomb Many Graves's Grave Blocks. More blocks can be added by using the mod id, followed by the block name, for example: <code>twilightforest:firefly_jar</code>. If the mod id is not present, it will assume it is a vanilla block.

==Compatibility==
This config determines whether mod compatibility is used or not. If it is enabled, other mods such as [[Tinkers' Construct Integration | Tinkers' Construct]] or [[Thaumcraft Integration | Thaumcraft]] will work together with the Twilight Forest mod.

By default, this option is '''enabled'''.

==Dimension Settings==
Dimension Settings is a collection of config options that will alter the behaviour of the Twilight Forest dimension.

===Dimension ID===
This config option changes the Dimension ID used for the Twilight Forest. In an instance where another dimension is using the already defined ID in the config, it can be changed to prevent an ID conflict. One must be warned, however, that changing the config ID will effectively reset the dimension. If you want the already existing setup of the dimension, you will need to take the contents of the old dimension file into the new one once it is created. Another note of warning, if the ID is changed to an ID that was once used for another dimension, the chunks that already exist in that dimension file will still persist, unless the file is reset.

By default, the ID is '''7'''.

''The game must be reset so that the changes can be set in place.'' 

===New Players Spawn in Twilight Forest===
This config option determines whether the player spawns in the Twilight Forest when a world is created, or a new player joins the server. If enabled, a portal will be made near where the player spawned. Note that survival in this dimension alone is possible, albeit some vanilla features such as the End or Nether cannot be accessed via the Twilight Forest.

By default, this option is '''disabled'''.

===Skylight Forest===
This config option determines how the Twilight Forest will generate. If enabled, the Twilight Forest will generate akin to a Sky Block world, with the structures still generating on elevated platforms of Stone, Dirt, and Gravel, with the occasional Ores. One must note however, that this config option is not saved per world, so if the option is changed (such as being enabled when it was created disabled), chunk generation will become distorted, with sudden cutoffs.

By default, this option is '''disabled'''.

''This config option is currently Work-in-Progress. It may be changed over time.''

===Dimension Seed===
This config option can be used to set what seed is used to generate the Twilight Forest. By default, the Twilight Forest will generate based on the seed used on what the world was set to. However, with this config option, it is possible to override the seed being used with what is set here. One must note that changing the seed on an existing world may lead to unintended consequences.

By default, this option is blank, meaning that the seed is taken from the world save.

==Disable Twilight Portals==
This config options restricts portal creation in general. If enabled, no portal to the Twilight Forest can be created, even if the player is a server admin or has cheats enabled. Though it sounds counter-intuitive to prevent creating a portal to a dimension, it can be used to prevent griefing or set it to only have a single portal in the world.

By default, this option is '''disabled'''.

==Disable Uncrafting in Uncrafting Table==
This config option determines whether the Uncrafting Table can, well, Uncraft. Due to the nature of some crafting recipes, Uncrafting can result in exploits, such as obtaining rare materials more efficiently or bypassing restrictions set on modpacks. As a result, this option can be enabled to completely disable this feature, leaving only Repairing and Recrafting left. Of course, you can still Craft with it.

By default, this option is '''disabled'''.

==Loading Screen==
Loading Screen is a collection of config options that alter the behavior of the loading screen when teleporting to or from the Twilight Forest.

===Loading Screen Switching===
This config option determines how long in ticks it will take to change between a different loading screen appearance. If set to 0, it will not cycle through the backgrounds or item/block in the corner. The higher the number is set, the more ticks it will take to cycle through the appearances (20 ticks = 1 second).

By default, this option is set to '''0''', meaning it will not cycle.

===Enable Loading Icon Animation===
This config option alters the animation of the loading icon in the corner of the screen. It is currently not observed to lower performance if enabled. However, if by chance it does, it can be disabled, leaving it static in the corner of the screen.

By default, this option is ''enabled''.

===Icon Animation Speed===
This config option determines how fast the animation is overall. It determines how fast it wobbles from side to side, and how frequent it bounces.

By default, the value is set to '''5.0'''.

''If '''Enable Loading Icon Animation''' is '''disabled''', this option will not have any effect.''
===loadingIconStacks===
This config is a list of items that will display in the corner of the screen.

By default, the following are already added: 
* Experiment 115
* Magic Map
* Charm of Life II
* Charm of Keeping III
* Phantom Helm
* Lamp of Cinders
* Carminite
* Block and Chain
* Yeti Horned Helm
* Hydra Chop
* Magic Beans
* Raw Ironwood Materials
* Naga Scale
* Thinking Experiment 115
* Miniature Portal
* Miniature Naga Courtyard
* Block of Knightmetal
* Ghast Trap
* Tree of Time Sapling
* Tree of Transformation Sapling
* Miner's Tree Sapling
* Sorting Tree Sapling
* Rainbow Oak Sapling
* Borer Essence
More blocks and items can be added by using the mod id, followed by the block name, for example: <code>twilightforest:firefly_jar</code>. If the mod id is not present, it will assume it is a vanilla block or item.

===Icon Scaling===
This config option determines the size of the icon in the corner of the screen. The icons can be made bigger or smaller, and is a useful config option for those playing on smaller screens.

By default, the value is set to '''3.0'''.

===Icon Bounciness===
This config option determines how bouncy the icon is. The higher the value is, the more "springy" the icon is. It does not determine how many times it will bounce.

By default, the value is set to '''5.25'''.

''If '''Enable Loading Icon Animation''' is '''disabled''', this option will not have any effect.''

===Icon Tilt Offset===
This config option determines where on the icon the wobble will display. Lower values push the point lower, while higher values raise the point upwards. It may also affect how intense the wobble and tilt can be.

By default, the value is set to '''22.5'''

''If '''Enable Loading Icon Animation''' is '''disabled''', this option will not have any effect.''

===Icon Wobbliness===
This config option determines how far the icon will sway from side to side. Higher values rotate the icon more on the axis.

By default, the value is set to '''11.25'''.

''If '''Enable Loading Icon Animation''' is '''disabled''', this option will not have any effect.''

==Performance Tweaks==
Performance Tweaks is a collection of config options that alter certain generation options that may improve overall performance of the Twilight Forest.

===Glaciers made of Packed Ice instead of Ice===
This config option determines what the Glacier will be made of. By enabling it, less transparency and lighting checks are required due to using opaque blocks.

By default, this option is '''disabled'''.

===Twilight Leaves opacity===
This config option determines how much light is allowed through leaves in the Twilight Forest. It can be used to decrease the amount of lighting checks required.

By default, the value is set to '''1'''.

===Twilight Oak Chance===
This config option determines the chance of a Giant Oak Tree generating. Due to the complexity of generating a Giant Oak Tree, reducing the chances can help reduce chunk loading. Higher values decrease the chance of a Giant Oak Tree from generating.

By default, this value is set to '''48'''.

==Portal Creation Item==
This config option determines what can be used to activate the Twilight Portal. It can also accept multiple activation items, in the event that the item required to enter or exit the Twilight Forest is unavailable in the dimension.

By default, a Diamond can be used to create a portal. More blocks and items can be added by using the mod id, followed by the block name, for example: <code>twilightforest:firefly_jar</code>. If the mod id is not present, it will assume it is a vanilla block or item. Metadata can also be added to the item or block by using <code>twilightforest:tower_device:2</code>. Metadata can also be set to -1 to wildcard the item.

==Portal Creation Lightning Fire==
This config option determines whether the lightning that strikes can also set fire to nearby blocks. Lightning is known to set a struck block on fire, and with a portal made of plants, it can burn away some artistic portal creations. By enabling this option, the lightning will not cause a fire.

By default, this option is '''disabled'''.

==Portals in other dimensions==
This config option determines if the portal can be created in dimensions that are not the Twilight Forest or Overworld. For an example, it can be possible to create a portal in the End to travel to the Twilight Forest. However, this option may be seen as an exploit in some circumstances, such as simplifying a survival pack where the player is trapped in a dimension with little to no resources.

By default, this option is '''disabled'''.

==Rotate Trophy Heads on Item model==
This config option determines if the Trophy Heads in the item inventory is allowed to spin. It is currently not observed to cause any performace impacts, but in the event it does, disabling it may fix it.

By default, this option is '''enabled'''.

==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://minecraft.curseforge.com/projects/parry?gameCategorySlug=mc-mods&projectID=293702 Shield Parry] is installed, all config options listed will have no effect.

===Timing Windowspan for Arrows===
This config option determines how long after raising a shield an Arrow is allowed to be parried. This option uses ticks to determine the time it can take to parry Arrows (20 ticks = 1 second).

By default, the value is set to '''40'''.

===shieldParryTicksBeam===
This config option is not clear on what can be parried, but it can be assumed it is Beams. This option uses ticks to determine the time it can take to parry Beams (20 ticks = 1 second).

By default, the value is set to '''10'''.

===Timing Windowspan for Fireballs===
This config option determines how long after raising a shield a Fireball is allowed to be parried. This option uses ticks to determine the time it can take to parry Fireballs (20 ticks = 1 second).

By default, the value is set to '''40'''.

===Timing Windowspan for Throwables===
This config option determines how long after raising a shield a Throwable is allowed to be parried. This option uses ticks to determine the time it can take to parry Throwables (20 ticks = 1 second).

By default, the value is set to '''40'''.

==Should Portals generate as a two-way portal==
This config option determines how portals function. If disabled, the portal between dimensions will be protected by a magical barrier that makes teleporting impossible. To open it up again, an activation item is required.

By default, this option is '''enabled'''.

==Silent Cicadas==
This config option 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.

By default, this option is '''disabled'''.

{{ModInfo}}