Configuration

waystones-common.toml

general

restrictedWaystonesSet

List of waystone origins that should prevent others from editing. "player" is special in that it allows only edits by the owner of the waystone.

Default value: [PLAYER]
Valid values: UNKNOWNWILDERNESSDUNGEONVILLAGEPLAYER

defaultVisibilityWaystoneVisibility

Set to "global" to have newly placed or found waystones be global by default.

Default value: ACTIVATION
Valid values: ACTIVATIONGLOBALSHARD_ONLYORANGE_SHARESTONEMAGENTA_SHARESTONELIGHT_BLUE_SHARESTONEYELLOW_SHARESTONELIME_SHARESTONEPINK_SHARESTONEGRAY_SHARESTONELIGHT_GRAY_SHARESTONECYAN_SHARESTONEPURPLE_SHARESTONEBLUE_SHARESTONEBROWN_SHARESTONEGREEN_SHARESTONERED_SHARESTONEBLACK_SHARESTONE

allowedVisibilitiesSet

Add "global" to allow every player to create global waystones.

Default value: []
Valid values: ACTIVATIONGLOBALSHARD_ONLYORANGE_SHARESTONEMAGENTA_SHARESTONELIGHT_BLUE_SHARESTONEYELLOW_SHARESTONELIME_SHARESTONEPINK_SHARESTONEGRAY_SHARESTONELIGHT_GRAY_SHARESTONECYAN_SHARESTONEPURPLE_SHARESTONEBLUE_SHARESTONEBROWN_SHARESTONEGREEN_SHARESTONERED_SHARESTONEBLACK_SHARESTONE

warpStoneUseTimeInteger

The time in ticks that it takes to use a warp stone. This is the charge-up time when holding right-click.

Default value: 32

warpPlateUseTimeInteger

The time in ticks that it takes to use a warp plate. This is the time the player has to stand on top for.

Default value: 15

scrollUseTimeInteger

The time in ticks it takes to use a scroll. This is the charge-up time when holding right-click.

Default value: 32

inventoryButton

inventoryButtonString

Set to 'none' for no inventory button. Set to 'nearest' for an inventory button that teleports to the nearest waystone. Set to 'any' for an inventory button that opens the waystone selection menu. Set to a waystone name for an inventory button that teleports to a specifically named waystone.

Default value

inventoryButtonXInteger

The x position of the inventory button in the inventory.

Default value: 58

inventoryButtonYInteger

The y position of the inventory button in the inventory.

Default value: 60

creativeInventoryButtonXInteger

The y position of the inventory button in the creative menu.

Default value: 88

creativeInventoryButtonYInteger

The y position of the inventory button in the creative menu.

Default value: 33

worldGen

wildWaystoneStyleWorldGenStyle

Set to 'default' to only generate the normally textured waystones. Set to 'mossy' or 'sandy' to generate all as that variant. Set to 'biome' to make the style depend on the biome it is generated in.

Default value: BIOME
Valid values: DEFAULTMOSSYSANDYBLACKSTONEDEEPSLATEEND_STONEBIOME

chunksBetweenWildWaystonesInteger

Approximate chunk distance between wild waystones being generated. Set to 0 to disable generation.

Default value: 25

wildWaystonesDimensionAllowListSet

List of dimensions that wild waystones are allowed to spawn in. If left empty, all dimensions except those in wildWaystonesDimensionDenyList are used.

Default value: [minecraft:the_nether, minecraft:overworld, minecraft:the_end]

wildWaystonesDimensionDenyListSet

List of dimensions that wild waystones are not allowed to spawn in. Only used if wildWaystonesDimensionAllowList is empty.

Default value: []

nameGenerationModeNameGenerationMode

Set to 'preset_first' to first use names from the nameGenerationPresets. Set to 'preset_only' to use only those custom names. Set to 'mixed' to have some waystones use custom names, and others random names.

Default value: PRESET_FIRST
Valid values: PRESET_FIRSTRANDOM_ONLYPRESET_ONLYMIXED

nameGenerationTemplateString

The template to use when generating new names. Supported placeholders are {Biome} (english biome name) and {MrPork} (the default name generator).

Default value: {MrPork}

nameGenerationPresetsList

These names will be used for the preset name generation mode. See the nameGenerationMode option for more info.

Default value: []

spawnInVillagesVillageWaystoneGeneration

Set to "regular" to have waystones spawn in some villages. Set to "frequent" to have waystones spawn in most villages. Set to "disabled" to disable waystone generation in villages. Waystones will only spawn in vanilla or supported villages.

Default value: REGULAR
Valid values: DISABLEDREGULARFREQUENT

teleports

enableCostsBoolean

Set to false to simply disable all xp costs. See warpRequirements for more fine-grained control.

Default value: true

enableCooldownsBoolean

Set to false to simply disable all cooldowns. See warpRequirements for more fine-grained control.

Default value: true

warpRequirementsList

List of warp requirements with comma-separated parameters in parentheses. Conditions can be defined as comma-separated list in square brackets. Will be applied in order.

Default value: [[is_not_interdimensional] scaled_add_xp_cost(distance, 0.01), [is_interdimensional] add_xp_cost(27), [source_is_warp_plate] multiply_xp_cost(0), [target_is_global] multiply_xp_cost(0), min_xp_cost(0), max_xp_cost(27), [source_is_inventory_button] add_cooldown(inventory_button, 300)]

transportPetsTransportMobs

Set to "enabled" to have nearby pets teleport with you. Set to "same_dimension" to have nearby pets teleport with you only if you're not changing dimensions. Set to "disabled" to disable.

Default value: DISABLED
Valid values: ENABLEDSAME_DIMENSIONDISABLED

transportLeashedTransportMobs

Set to "enabled" to have leashed mobs teleport with you. Set to "same_dimension" to have leashed mobs teleport with you only if you're not changing dimensions. Set to "disabled" to disable.

Default value: ENABLED
Valid values: ENABLEDSAME_DIMENSIONDISABLED

entityDenyListSet

List of entities that cannot be teleported, either as pet, leashed, or on warp plates.

Default value: [minecraft:wither]

enableModifiersBoolean

Set to true to enable warp modifier items for applying status effects on teleports.

Default value: true

client

disableTextGlowBoolean

If enabled, the text overlay on waystones will no longer always render at full brightness.

Default value: false

compatibility

journeyMapBoolean

If enabled, JourneyMap waypoints will be created for each activated waystone.

Default value: true

preferJourneyMapIntegrationModBoolean

If enabled, JourneyMap waypoints will only be created if the mod 'JourneyMap Integration' is not installed

Default value: true

blueMapBoolean

If enabled, Waystones will add markers for waystones and sharestones to BlueMap.

Default value: true

dynmapBoolean

If enabled, Waystones will add markers for waystones and sharestones to Dynmap.

Default value: true

Mod Compatibility

Warp Rules

Configure teleport costs and other effects and limitations on teleportation.