Config

Dig to Nether is designed to run with quite minimal configuration out of the box, but some things can be tweaked to your liking.

This page goes through every config option in more detail, allowing you to better configure DTN to your needs.

Dimension teleport check

This is how often the server will check if a creature or player is at the bottom of the world, or top of the nether. By default this runs at 3 (a bit under a quarter of a second.) 1 real life second is equal to 20 ticks, so converting is quite easy. Simply grab a calculator, multiply how many seconds you want to be in ticks by 20. (Example: 5 x 20 = 100 ticks.)

# How often to check if a creature needs to be teleported to a dimension in ticks.
# 1 second = 20 ticks.
# Default: 3
dimension_teleport_check: 3

Using Nether or default coordinates

When you enter the bottom of the world or top of the Nether, the plugin will grab the creature or player's X and Z values and calculate them to determine where they will arrive. You have two options on how this calculation will work. If use_nether_coordinates equals false, the creature will end up at the same place they dug down. (Example: If a creature entered at X: 50 and Z: 45, they will leave at X:50 and Z:45.) If set to true, 1 block in the Nether will be 8 blocks in the overworld, just like using a portal. (Example: If a creature entered at X: 50 and Z: 45, they would end up at X: 5 and Z:6.) You can use a calculator like this to help find out where you will end up if you use this setting. The behaviour of portals will not be changed regardless of what you set, this will only affect entering the bottom of the world and top of the nether.

# If true: When digging, 1 block in the overworld will equal 8 blocks in the Nether, same as a portal.
# If false: You will end up at the exact same coordinates when digging to the Nether.
# NOTE: This setting does not affect using Nether portals.
# Default: false
use_nether_coordinates: false

Placing a block under the creature when exiting The Nether

When exiting The Nether via digging up, sometimes a block won't be under the creature when they enter the overworld. This can be a problem as they will simply enter The Nether again, resulting in them having to find another hole to dig, or get stuck completely. This setting allows you to place a block of your choice, under the creature if none is present to stop them from falling.

# If true: A block will be placed under a creature when returning to the overworld if no block is under them.
# If false: A block won't be placed under the creature if air is under them. (This may result in the entity falling back down and getting stuck!)
# Default: true
replace_air_on_overworld_return: true

You can set what block will be placed under them with the setting below. Take note that the block must be from this list, which is case sensitive.

# The block that places below the creature.
# YOU MUST COPY FROM THIS LIST: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
# Default: COBBLESTONE
air_replacement: COBBLESTONE

Automatically replacing bedrock in new chunks

Since using this feature incorrectly will heavily lag and sometimes crash your server if used incorrectly, a full guide is available here.

Disable Nether portals

If you would like players to access The Nether only by digging, this setting is for you. When a Nether Portal is lit, the event that allows it to light will be canceled. Which results in an empty portal frame. This setting however wont remove existing Nether Portal's, those will have to be removed manually.

# Portals will not be created when lit.
# NOTE: This will not remove existing portals.
disable_nether_portal_creation: false