Config commands

/tardisconfig

Arguments	Description	Usage
options	List the TARDIS config options and values in chat. Where [config section] is one of modules, storage, creation, police_box, travel, preferences, dynmap, desktop, circuits, allow, growth, arch, siege, junk, abandon, archive, rechargers, autonomous_areas, display, conversions.	/tardisconfig options [config section]
reload	Reload the TARDIS config from disk. Where [config name] is one of achievements, adaptive, artron, blaster, blocks, chameleon_guis, condensables, custom_consoles, flat_world, handles, items, kits, monsters, planets, recipes, rooms, shop, signs, tag, vortex_manipulator.	/tardisconfig reload [config name]
include	Set whether the specified world is included in time travel destinations.	/tardisconfig include [world]
exclude	Set whether the specified world is excluded from time travel destinations.	/tardisconfig exclude [world]

Setting config options

Most TARDIS plugin config options can be set ingame or via the console, and take effect immediately.

There are three types of config options:

1. Boolean values e.g. true or false
2. String values e.g. the names of things, like the TARDIS key
3. Integer values e.g. numbers, like the cost of a room

To use the /tardisconfig command to set config options, you use the syntax:

/tardisconfig [config option] [value]

For example, to set the TARDIS to never land on water you would type:

/tardisconfig land_on_water false

Config options:

The following values will be set in config.yml:

Config	Type	Default
debug	boolean	false
Shows or hides extra messages in the server log
modules:
weeping_angels	boolean	false
Enables/disables the TARDIS Weeping Angels module
vortex_manipulator	boolean	false
Enables/disables the TARDIS Vortex Manipulator module
dynmap	boolean	false
Enables/disables the TARDIS Dynmap module
chemistry	boolean	false
Enables/disables the TARDIS Chemistry module
shop	boolean	false
Enables/disables the TARDIS Shop module
sonic_blaster	boolean	false
Enables/disables the TARDIS Sonic Blaster module
blueprints	boolean	false
Enables/disables the TARDIS blueprint permissions module
storage:
database	string	sqlite
Sets the database type the plugin uses. Valid values are sqlite and mysql
mysql:
Only applicable if database is set to mysql, otherwise this section can be ignored
host	string	localhost
Sets the host of the mysql database, where: localhost = the ip address or hostname of the MySQL server (if the MySQL server is on the same server as the Spigot server, you can usually use localhost
port	number	3306
Sets the mysql server port, where: 3306 = the port on which the MySQL server is running (usually 3306)
database	string	TARDIS
Sets the database type the plugin uses. Valid values are sqlite and mysql
user	string	bukkit
Sets the user that connects to the mysql database
password	string	mysecurepassword
Sets the password to connect to the mysql database
prefix	string
Sets the prefix added to the table names used in the mysql database. Spigot servers will generally only use one database, so to distinguish the TARDIS tables from other plugins this should probably be set to something like tardis_
use_SSL	boolean	false
Sets whether to use an SSL connection to the MySQL database
creation:
create_worlds	boolean	false
It is NOT recommended setting this to true! Sets whether TARDISes are created in their own separate worlds.
create_worlds_with_perms	boolean	false
Sets whether TARDISes are created in their own separate worlds for players with the appropriate permission — tardis.create_world.
default_world	boolean	true
Sets whether TARDISes are created in a shared world. Also required to be true to enable the Junk TARDIS and the abilty to abandon TARDISes.
default_world_name	string	TARDIS_TimeVortex
Sets the name of the default world. This is only used if default_world is true.
border_radius	number	256
Sets the distance of the WorldBorder barrier (only used if the plugin is installed on the server).
inventory_group	number	0
If the Multiverse-Inventories plugin is enabled on the server, you can set the group that TARDIS worlds are added to when they are created.
add_perms	boolean	true
Sets whether a TARDIS world is assigned permissions when the server uses a permissions plugin that has per-world configuration — see Add permissions.
use_clay	string	WOOL
Sets whether the coloured wool in TARDIS console and room schematics is switched to stained terracotta or concrete instead. Valid options are WOOL, TERRACOTTA, and CONCRETE.
count	number	0
Sets the maximum number of times a player can build and destroy a TARDIS. If set to 0 there is NO maximum.
tips_limit	number	400
Sets the number of T.I.P.S slots to use. Must be one of 400, 800, 1200 or 1600.
area	string	none
If set to a pre-defined TARDIS area, it will set that area as the only place on the server that TARDISes can be created in.
enable_legacy	boolean	true
Sets whether the legacy console schematics are available to build TARDIS interiors with.
check_for_home	boolean	true
Sets whether the TARDIS creation location is already set to another player's home location.
seed_block:
crafting	boolean	true
Sets whether players can craft TARDIS seed blocks.
legacy	boolean	true
Sets whether server difficulty affects the 'lamp' crafting material. A value of true means the crafting material is always a Redstone Torch.
easy	string	REDSTONE_TORCH
normal	string	SOUL_LANTERN
hard	string	DRAGON_BREATH
Sets the 'lamp' craft material depending on the server difficulty.
police_box:
default_preset	string	FACTORY
Sets the default preset that appears when the TARDIS is first created. See the Chameleon Presets page for values that can be set.
name_tardis	boolean	false
Sets whether to put the player’s name on the Police Box sign.
use_nick	boolean	false
Sets whether to use the player’s nick name on the Police Box sign.
view_interior	boolean	false
Sets whether player’s can view the TARDIS interior when opening hte exterior TARDIS door.
view_interior_uses_console_size	boolean	false
Sets whether the the interior view distance uses the interior console size or a deafult 16 blocks
materialise	boolean	true
Sets whether the TARDIS runs the materialising animation when it takes off and lands.
sign_colour	string	WHITE
Sets the colour of the text on a TARDIS sign. Must be a valid ChatColor value, see https://hub.spigotmc.org/javadocs/spigot/org/bukkit/ChatColor.html
rebuild_cooldown	number	10000
Sets the minimum time (in server ticks) required between TARDIS rebuilds.
load_shells	boolean	false
Sets whether player’s can load Chameleon preset shells into the Shell room.
keep_chunk_force_loaded	boolean	true
Sets whether to keep the current location chunk of player’s Police Boxes force loaded.
travel:
include_default_world	boolean	false
Sets whether the default world is included in time travel destinations.
tp_radius	number	500
Sets the maximum distance (in blocks) you can randomly time travel in the TARDIS. Note The actual values is about 4 times this (due to the multiplier repeater).
max_distance	number	29999983
Sets the maximum distance (in blocks) that can be used with the /tardistravel command. If the (vanilla) World Border distance is smaller this will be used instead.
chameleon	boolean	true
Sets whether the TARDIS police box can change its appearance to match its surroundings.
give_key	boolean	false
Sets whether the TARDIS key is given when changing worlds (and using a multi-world inventory plugin).
the_end	boolean	false
Sets whether the TARDIS is allowed to travel to The End worlds.
allow_end_after_visit	boolean	false
If enabled, players may only fly to The End in the TARDIS if they've already been there once without it (i.e. End Portal) Note: End travel must be enabled (the_end: true) for this to take effect.
nether	boolean	false
Sets whether the TARDIS is allowed to travel to Nether worlds.
allow_nether_after_visit	boolean	false
If enabled, players may only fly to the Nether in the TARDIS if they've already been there once without it (i.e. Nether Portal). Note: Nether travel must be enabled (nether: true) for this to take effect.
land_on_water	boolean	true
Sets whether the TARDIS will land on water in the Overworld.
timeout	number	5
timeout_height	number	135
Sets the maximum time in seconds a random location task can take. If the task times out then the Police Box location is set at the timeout_height value. This prevents the plugin crashing when using skyblock type worlds.
random_attempts	number	30
Sets the maximum number of attempts to find a random location. This prevents the plugin crashing under certain circumstances.
exile	boolean	false
Sets whether the TARDIS exile feature is enabled.
per_world_perms	boolean	false
Sets whether players require the tardis.travel.[world] permission to travel to a world.
terminal_step	number	1
Sets the 4 step values that the TARDIS Destination Terminal GUI uses, where the steps are 10 * step and 25 * step etc.
terminal:
redefine	boolean	false
the_end	string	world
Sets whether the TARDIS is allowed to travel to The End worlds.
nether	string	world
Sets whether the TARDIS is allowed to travel to Nether worlds.
manual_flight_delay	number	60
Sets the server tick delay between having to click the repeaters in manual flight mode.
grace_period	number	10
Sets the number of times players can use easy controls when the server is set to hard difficulty mode.
random_circuit:
x	number	5000
y	number	5000
Maximum +/- number of blocks the random location search will look between in x and z directions, so default will be -5000 to 5000 in both x and z directions. If the WorldBorder plugin is installed or a vaniila world border is in use, then those settings will be used instead.
no_destination_malfunctions	boolean	true
Sets whether the TARDIS will malfunction if no valid random destination can be found with the current console settings.
preferences:
notify_update	boolean	true
Sets whether to check for and notify opped players if there is a TARDIS plugin update.
language	string	en
Sets the language used for TARDIS message localisation. The plugin will look for a file named with this setting and the file extension .yml. Should be set to an international language code.
key	string	GOLD_NUGGET
Sets the TARDIS key item. You can use any valid Bukkit Material ENUM. A list can be found here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
any_key	boolean	false
Sets whether any item can be used as the TARDIS key.
walk_in_tardis	boolean	true
Sets whether players can walk into the Police Box to enter the TARDIS. If set to false, clicking the door with the TARDIS key teleports you to the interior.
open_door_policy	boolean	false
Sets whether anyone can enter the TARDIS. If set to false (the default) only the Time Lord and their companions can enter the TARDIS.
use_worldguard	boolean	true
Sets whether the TARDIS interior becomes a protected WorldGuard region belonging to the player who created the TARDIS
respect_worldguard	string	build
Sets whether time travelling respects protected WorldGuard regions. Valid values are none — no checking is performed, and any WorldGuard state flag, generally this will probably be build or entry.
respect_grief_prevention	boolean	true
Sets whether time travelling respects protected GriefPrevention claims.
respect_towny	string	nation
Sets whether time travelling respects protected Towny regions. Valid values are none — no checking is performed, wilderness — players can only land in wilderness, town — players can also land in a town they are a resident of, nation — players can land in any town that is in the same nation as their own town.
respect_worldborder	boolean	true
respect_factions	boolean	true
Sets whether time travelling respects protected regions (if players do not have rights to build in an area, they will be denied access).
sfx_volume	number	10
Sets the default volume of the TARDIS Resource Pack sounds. Using 10 is the same volume as the default sounds, lower values make the sounds quieter.
difficulty	string	hard
Sets how hard it is for players to use the plugin. This usually affects the TARDIS crafting recipes, whether they can use certain commands and whether TARDIS functions are controlled by circuits being installed. Valid values are easy, medium and hard
strike_lightning	boolean	true
Sets whether a TARDIS recharge point will strike lightning when recharging a TARDIS.
freeze_cooldown	number	60
Sets the cool down period (in seconds) between uses of the Sonic Screwdriver’s player freeze function.
hads_damage	number	10
Sets the number of hits the Police Box will take before engaging HADS.
hads_distance	number	10
Sets the distnace in blocks the Police Box will travel when HADS is engaged.
malfunction	number	3
Sets the percentage chance the TARDIS will malfunction when travelling.
malfunction_nether	number	3
malfunction_end	number	3
Sets the percentage chance a malfunction will deposit the TARDIS in the The End or the Nether.
use_default_condensables	boolean	true
Sets whether to use the plugin settings for condenser values. If you want to set your own values, set this to false and edit condensables.yml
no_creative_condense	boolean	false
Sets whether players can condense items in CREATIVE game mode.
no_enchanted_condense	boolean	false
Sets whether players can condense enchanted items.
heal_speed	number	200
Sets the heal speed in the Zero room. The default value of 200 means the player will gain half a heart every 200 ticks (10 seconds).
default_key	string	eleventh
Sets the default key texture.
default_sonic	string	eleventh
Sets the default sonic screwdriver texture.
render_entities	boolean	true
Sets whether mobs will be shown in the Rendering room.
nerf_pistons:
enabled	boolean	false
Sets whether the plugin will attempt to prevent protected TARDIS blocks from being moved by pistons.
only_tardis_worlds	boolean	true
Sets whether all worlds are checked for pistons moving TARDIS blocks, or only TARDIS worlds
spawn_random_monsters	boolean	true
Sets whether monsters will randomly spawn in the TARDIS if door is left open.
spawn_limit	number	10
Sets the maximum number of monsters that can randomly spawn inside a TARDIS.
vortex_fall	string	kill
Sets whether players are killed or teleported when they fall into the vortex in the TARDIS_TimeVortex world. Valid values are kill and teleport.
no_coords	boolean	false
Sets whether players will see the coordinates message when choosing a random destination.
chat_width	number	55
Sets the maximum character width of a TARDIS message in the chat window.
dynmap:
Enables/disables the TARDIS Dynmap module
update_period	number	30
updates_per_tick	number	10
desktop:
check_blocks_before_upgrade	boolean	false
Sets whether to compare the amount of block changes before allowing an upgrade.
block_change_percent	number	25
Sets the maximum percentage of block change compared to the original schematic.
circuits:
damage	boolean	false
Sets whether circuits get damaged after each use. Setting this to false (the default) means circuits have unlimited uses.
uses:
<circuit>	number	20
Sets the maximum number of uses a circuit has before it is vapourised. Setting this to 0 gives unlimited uses for that circuit.
allow:
mob_farming	boolean	true
Sets whether players can farm mobs when entering the TARDIS.
spawn_eggs	boolean	true
Sets whether the player receives mob spawn eggs when TARDIS mob farming (and there is no farm room grown).
emergency_npc	boolean	true
Sets whether the Emergency Program One feature is enabled.
external_gravity	boolean	false
Sets whether the Gravity Wells can be set up outside of the TARDIS.
achievements	boolean	true
Sets whether players can gain TARDIS achievements.
autonomous	boolean	true
Sets whether players can use the autonomous function.
hads	boolean	true
Sets whether the TARDIS can escape hostile actions.
tp_switch	boolean	true
Sets whether players can set and switch resource packs when entering and exiting the TARDIS.
all_blocks	boolean	false
Sets whether the chameleon circuit is allowed to use precious blocks such as GOLD and DIAMOND. This also affects whether players are allowed to change the TARDIS Key to any item — if set to false, then keys are restricted to the items listed under keys: in blocks.yml.
sfx	boolean	true
Sets whether sound effects are played in the TARDIS interior — this overrides user preferences if turned off.
wg_flag_set	boolean	true
Sets whether players can set the build flag (allow, deny) in their TARDIS region.
zero_room	boolean	false
Sets whether players can grow a Zero room. If this is set to true using the /tardisconfig zero_room true command, the plugin wil attempt to create the TARDIS_Zero_Room world if it doesn’t yet exist.
power_down	boolean	true
Sets whether players can power down their TARDIS.
power_down_on_quit	boolean	false
Sets whether a player’s TARDIS automatically powers down when the player leaves the server.
player_difficulty	boolean	true
Sets whether players can use the /tardisprefs difficulty [easy | hard] command to change their personal difficulty setting. See this ticket for the reasoning behind it all.
invisibility	boolean	true
Sets whether players can use the invisibility Chameleon preset. See Invisibility for more info.
guardians	boolean	false
Sets whether players can farm guardians when entering the TARDIS, and whether guardians will randomly spawn in the pool room if the door is left open.
village_travel	boolean	false
Sets whether players can use the /tardistravel [structure|village] command to time travel to a village or other Minecraft structure.
3d_doors	boolean	false
Sets whether TARDIS owners can see their door when the exterior is set to the INVISIBLE preset. They must be wearing 3D Glasses and looking at the block that the door would normally be placed on.
repair	boolean	true
Sets whether players can repair a damaged TARDIS interior.
weather_set	boolean	false
Sets whether players can use the /tardisweather command or the TARDIS Weather GUI.
force_field	number	8
If set to greater than 0, determines whether players can activate the TARDIS force field and sets the range of the force field effect. Set to 0 to disable.
admin_bypass	boolean	false
Sets whether players the permission tardis.admin can bypass TARDIS travel location and plugin protection checks.
perception_filter	boolean	true
Sets whether players can use the perception filter.
growth:
gravity_max_distance	number	15
gravity_max_velocity	number	5
Sets sets the maximum distance and velocity a gravity well can be set to.
rooms_require_blocks	boolean	false
Sets whether growing a room requires the player to condense the materials required to grow the room in the TARDIS condenser.
rooms_condenser_percent	number	100
Sets the percentage of the actual blocks that a player needs to condense if rooms_require_blocks: true
return_room_seed	boolean	true
Sets whether the room seed block is returned to the player when they jettison the room.
room_speed	number	4
Sets the speed (in blocks per second) at which rooms are grown. Maximum speed is 20 which is one block per tick.
delay_factor	number	1
Sets the delay between growing multiple rooms.
ars_limit	number	1
Sets the maximum number of rooms that can be reconfigured at a time.
arch:
enabled	boolean	true
Sets whether the plugin will attempt to prevent protected TARDIS blocks from being moved by pistons.
min_time	number	20
switch_inventory	boolean	true
clear_inv_on_death	boolean	false
siege:
enabled	boolean	true
Sets whether the plugin will attempt to prevent protected TARDIS blocks from being moved by pistons.
breeding	number	0
If this is set higher than 0, this is the percentage chance that twins will be born when animals breed
growth	number	0
butcher	boolean	false
Sets whether any hostile mobs inside the TARDIS will be butchered when Siege mode is engaged
creeper	boolean	false
Sets whether (when the TARDIS runs out of energy) the Artron creeper will be sacrificed to give the TARDIS an energy boost
healing	boolean	false
Sets whether players inside the TARDIS receive a healing pick-me-up
texture	boolean	false
Sets whether the desktop theme is changed when Siege mode is engaged
junk:
enabled	boolean	true
Sets whether the plugin will attempt to prevent protected TARDIS blocks from being moved by pistons.
return	number	-1
Sets the time in seconds that the Junk TARDIS will automatically return to its ‘home’ location. If this is less than 0 and the Junk TARDIS will not automatically return home.
particles	boolean	true
Sets whether the Junk TARDIS displays a particle effect when travelling
abandon:
enabled	boolean	true
Sets whether the plugin will attempt to prevent protected TARDIS blocks from being moved by pistons.
reduce_count	boolean	true
archive:
enabled	boolean	true
Sets whether the plugin will attempt to prevent protected TARDIS blocks from being moved by pistons.
limit	number	3
display:
all	string	&6X&7%X% &6Y&7%Y% &6Z&7%Z% &6F&7%FACING% (%FACING_XZ%) %TARGET_BLOCK%

Artron config values

The following values will be set in artron.yml:

Config	Type	Default
player	number	25
Sets the amount of time lord energy a player absorbs from the time vortex each time they time travel.
random	number	75
travel	number	100
comehere	number	400
hide	number	500
autonomous	number	100
Sets the amount of energy the different forms of time travel consume. The options are: random locations, any /tardistravel, /tardis comehere, /tardis hide commands, and autonomous homing.
nether_min	number	4250
the_end_min	number	5500
Sets the minimum amount of energy the TARDIS Artron Energy Capacitor must have before players can time travel to the Nether or The End.
recharge_distance	number	20
Sets the maximum distance in blocks, a Police Box can be from a recharge beacon in order to start recharging.
lightning_recharge	number	300
Sets the amount of energy TARDISes receive if they are within the recharge_distance of a natural lightning strike.
creeper_recharge	number	150
Sets the amount of energy players receive if they kill a charged creeper.
full_charge	number	5000
Sets the amount of energy a fully charged TARDIS Artron Energy Capacitor holds.
full_charge_item	string	NETHER_STAR
Sets the item that fully charges the Energy Capacitor when you right-click the Artron button with it.
siege_transfer	number	10
Sets the minimum amount of Time Lord energy needed to transfer to the Siege block. This is a percentage of full_charge. Default is 10% (500).
siege_deplete	number	100
Sets the amount of energy Siege mode uses every cycle. Default is 100
siege_creeper	number	150
Sets the amount of energy gained when the Artron Creeper is sacrificed. The default is 150. Only relevant if the main config option siege.creeper is set to true.
siege_ticks	number	1500
Sets the amount of time in server ticks that the energy depletion / siege mode healing cycle takes. The default is 1500 (or every 1.25 minutes)
standby	number	5
Sets how much energy is used per cycle when the TARDIS is in standby power mode.
standby_time	number	6000
Sets how often energy is removed when the TARDIS is in standby mode. If standby_time is set to 0, then no energy is removed.
jettison	number	75
Sets the percentage of energy the TARDIS gets back when a room is jettisoned.
jettison_seed	string	TNT
Sets the block required to manually jettison a room.
renderer	number	250
Sets the cost to use the Renderer room.
zero	number	250
Sets the cost to transmat to the TARDIS Zero room.
upgrades:
ancient	number	5000
ars	number	5000
bigger	number	7500
budget	number	5000
cave	number	5000
copper	number	20000
coral	number	8000
delta	number	7500
deluxe	number	10000
division	number	7500
eleventh	number	10000
ender	number	5000
factory	number	7500
fugitive	number	7500
hospital	number	5000
master	number	10000
mechanical	number	7500
original	number	5000
plank	number	5000
pyramid	number	5000
redstone	number	7500
rotor	number	5000
steampunk	number	5000
thirteenth	number	8000
tom	number	5000
twelfth	number	7500
war	number	5000
weathered	number	5000
custom	number	10000
legacy_deluxe	number	10000
legacy_redstone	number	8000
legacy_bigger	number	7500
legacy_eleventh	number	10000
Sets the energy cost to upgrade / crossgrade to a different console when using the Desktop Theme changer.
archive:
tall	number	10000
small	number	5000
medium	number	7500
Sets the energy cost to use different archive console sizes when using the Desktop Theme changer.
template:
medium	number	2500
Sets the energy cost to use different archive console sizes when using the Desktop Theme changer.
small	number	1666
tall	number	3333
just_wall_floor	number	50
If a player is just changing the walls and floor, then just_wall_floor sets the percentage the cost is reduced.
artron_furnace:
cook_time	number	0.5
Sets the cook time for items smelted with Artron Storage Cells — 0.5 is half the normal time, 2.0 would be twice normal speed (longer), 1.0 = normal cook time (same as coal)
burn_time	number	0.5
Sets the length of time an Artron Storage Cell will burn for — as above fractions (0.5) will give shorter life to the cells, > 1 will extend the burn time, 1.0 = normal burn time (same as coal)
burn_limit	number	100000
Sets the maximum amount of burn time a fully charged Artron Storage Cell can have.
particle	boolean	true
Sets whether the Artron Furnace block displays particles.
sonic_generator:
standard	number	10
bio	number	10
diamond	number	10
emerald	number	10
redstone	number	10
painter	number	10
ignite	number	10
arrow	number	10
knockback	number	10
brush	number	10
Sets the energy costs for the sonic generator as a percentage of the full_charge option.
shell	number	500
Sets the cost to use the Shell room constructor.
custard_cream	number	25
Sets the cost to dispense a custard cream.
backdoor	number	100
Sets the cost to use the TARDIS back door.

Reloading the config

If you have made changes to the config file by manually editing it, you should use the reload command to reload the changes. Type:

/tardisconfig reload

note

Do not use the server /reload command or the manual changes you have made will be overwritten when the TARDIS config is saved when it is disabled.