Pathinator

Pathinator allows you to easily create custom paths using the block you're standing on.

For example, if you are standing on a block of OAK_PLANKS and you issue a command to create a path of 50 blocks, Pathinator will replace all the blocks in the direction you are facing with OAK_PLANKS out to a distance of 50 blocks. If you also specified with lights Pathinator will add a light (configurable, defaults to TORCH) every N^* blocks to the side of the path.

NOTE: version 1.4.0 adds support for SILK_TOUCH, FORTUNE, and UNBREAKING enchantments on tools. Prior versions added blocks to inventory as if SILK_TOUCH was applied to all tools, and UNBREAKING was always ignored when applying damage.

Usage

Basic

path:basic <distance> [with lights] (aliased as pb) where <distance> is the number of blocks to place, and [with lights] is an optional boolean true|false whether to place a light every N^* number of blocks.

For example: path:basic 25 true to create a path 25 blocks long with lights, or path:basic 25 where [with lights] defaults to false for no lights.

Tracks

path:tracks <distance> [with power] [with lights] (aliased as pt) where <distance> is the number of blocks to place, and [with power] is an optional boolean true|false whether to place a powered rail every N^* number of blocks. [with lights] is another optional boolean whether to place a light every N^* number of blocks.

^* N is configurable in /plugins/Pathinator/config.yml

Custom

path:custom <distance> <width> <height> [path material] [clearance material] (aliased as pc) where <distance> <width> and <height> are required and [path material] and [clearance material] are optional. If no [path material] is specified Pathinator will detect the pattern of blocks the player is currently standing on for the path. For example: if you create a path 3 blocks wide Pathinator will detect the block under the player and one block to the left and right and keep that same pattern for the entire distance requested.

Additionally, you can specify what material to use to fill the 'air' space above the path (clearance material). This allows you to easily create 3 dimensional structures out of any material!

Follow

path:follow <start|stop> [radius] [path material] (aliased as pf) where [radius] is a number between 0 and 5, and [path material] is any solid block. NOTE you must run path:follow stop to tell Pathinator to stop creating a path wherever you walk.

For example, path:follow start will start following using the default radius and whatever block you are currently standing on. path:follow start 2 minecraft:oak_planks will create a wide path with OAK_PLANKS.

The follow command only works in Creative mode at this time.

Dig

path:dig <up|down|ahead|vup|vdown> [distance] (aliased as pd) where <distance> is the number of blocks away from you to dig. path:dig does not place any blocks, it only removes them (and adds to your inventory when in survival). up|down will dig a stair step pattern either up or down with the default clearance height (set in config.yml). vup|vdown (vertical up | vertical down) will dig straight up or down starting from one block in front of where the player is standing.

For example, path:dig down 20 will dig a stair step pattern extending 20 blocks, starting from the block in front of the player. (1 block forward, and 1 block down) path:dig vup 20 will dig straight up for 20 blocks starting from the block in front of the player.

Examples

/path:basic

/path:tracks

/path:custom

/path:follow

Survival vs Creative

In Survival mode, you must have enough material in your inventory to place blocks for the distance requested. Additionally, the following options can be configured:

• Tool Damage: each relevant tool in your inventory will take 1 damage for each block you replace (including the clearance space above if carving through a mountain). For example, if you have a shovel and a pickaxe and you create a path 10 blocks long through 6 blocks of dirt and 4 blocks of stone, your shovel will take 6 damage and your pickaxe will take 4 damage. If you have more than one tool of the same type, Pathinator will take the damage from the tool with the least remaining durability.
• Require Tool: in order to clear (mine) blocks you must have an appropriate tool in your inventory. (e.g. a shovel to clear dirt, a pickaxe to clear stone, etc...)
• Keep Material: any material cleared (mined) will be added to the player's inventory.

In Creative mode, you can place as many blocks of any type as you want, with no inventory restrictions or damage to tools.

Configuration

Once loaded on the server, edit /plugins/Pathinator/config.yml to adjust the default values.

clearance:
  height: 3
  material: AIR

lighting:
  interval: 12
  stack: [TORCH]

survival:
  enabled: true|false
  requireTool: true|false
  toolDamage: true|false
  keepMaterial: true|false

tracks:
  powerInterval: 34

Future Updates

• Add option to create a path with rail tracks path:tracks ... (v1.1.0)
• Add option to customize aspects of the path (height, width, material, etc...) path:custom ... (v1.2.0)
• Add option to follow the natural terrain instead of laying it all on the same Y value.
• Add permissions management with LuckPerms

Support

If you encounter any issues or have any questions, please open an issue on GitHub.