README.md

Pathetic

Pathetic is a simple and intuitive backwards-compatible up-to-date pathfinding API for Spigot, Paper and forks. See more info here: https://www.spigotmc.org/threads/how-pathetic.578998/#post-4644823

How to import

Maven

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>
 
	<dependency>
	    <groupId>com.github.patheloper.pathetic</groupId>
	    <artifactId>pathetic-mapping</artifactId>
	    <version>VERSION</version>
	</dependency>

Gradle

	allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}
    
	dependencies {
	        implementation 'com.github.patheloper.pathetic:pathetic-mapping:VERSION'
	}

Example API Usage

public class PathExample extends JavaPlugin {

  @Override
  public void onEnable() {
    PatheticMapper.initialize(this);
    goFindSomePath(randomLocation(), randomLocation());
  }

  @Override
  public void onDisable() {
    PatheticMapper.shutdown();
  }

  private void goFindSomePath(PathPosition start, PathPosition end) {
    Pathfinder pathfinder = PatheticMapper.newPathfinder();
    pathfinder
        .findPath(start, end, List.of(new PassablePathFilter()))
        .thenAccept(
            pathfinderResult ->
                pathfinderResult
                    .getPath()
                    .forEach(
                        location ->
                            player.sendBlockChange(
                                location, Material.YELLOW_STAINED_GLASS.createBlockData())));
  }

  private PathPosition randomLocation() {
    ThreadLocalRandom instance = ThreadLocalRandom.current();
    return new PathPosition(
        instance.nextInt(0, 100), instance.nextInt(0, 100), instance.nextInt(0, 100));
  }
}

See the pathetic-example module for a more in-depth example plugin.

Docs:

Access the Javadocs here Access our Docs here