Target Tracker — Waypoint plugin, best for quests

Target Tracker — Waypoint plugin, best for quests -----

Track points for your players

Download Now
279.6 KB .jar

Dependency: PacketEvents API
Showcase:

Default configs:

Code (Text):

TargetTracker
├─ config.yml
└─ points
└─ example.yml

config.yml:

Code (YAML):

message:
usage : '&cUsage : / %label% <player> <point ID> [trigger]'
player-not-exist : '&cPlayer %player% is not online or don''t exist'
point-not-found : '&cCan''t find point : %point%'
track-started : '&aStart %point% track for %player%'
track-start-failed : '&cStart failed， %player% has an active %point% tracking task'
track-stopped : '&aStopped %point% tracking for %player%, trigger status: %trigger%'
track-stopped-failed : '&cStop failed, %player% don''t have active %point% tracking task'
reload : '&aReloaded config and points'
reload-failed : '&cReload failed, see console for errors'
start-same-point : 'Can''t start tracking for the same point : %point%'
all-tracks-stopped : '&cStopped all trackings for %player%'
all-tracks-stopped-failed : '&c %player% don''t have any active tracking task'

example.yml:

Code (YAML):

point1:
target:
scale : 2 #target display scale
location : world,100,100,100 #target location
display :
- '&6?'
- '&aSecret point'
mark:
scale : 1
distance : 5 #tracking mark display's distance to player
display :
- '✥'
- ' %distance% blocks'
trigger-distance : 4
fade-speed : 10
stop-triggers :
- 'quit'
- 'death'
- 'attack'
- 'damaged'
- 'world_change'
- 'teleport'
actions:
- 'command : say a'
- 'op : say b'
- 'console : say c'
- 'message : &4Target achieved!'
- 'title : &4Target;&6achieved!;20;20;20'
- 'actionbar : &4Target achieved!'
- 'sound : entity.player.death;1;0'
- 'lightning : target;100;100;100'
- 'firework : player; #123456,#654321,#111111;BALL;#123456,#000000;0' #summoning fireworks
- 'start : point2' #start tracking for another point
point2:
target:
scale : 2
location : world,200,100,200
display :
- '&6?'
- '&aAnother secret point'
mark:
scale : 1
distance : 5
display :
- '✥'
- ' %distance% blocks'
trigger-distance : 4
fade-speed : 10
actions:
- 'command : say b'

Points are divided into target and mark sections, representing the target location and the guiding marker point for navigation.
scale: A shared property that represents the scaling size of the text.
display: A shared property representing the content displayed. It is recommended not to include too many lines. Supports `%player%` and `%distance%` variables, which represent the player's name and distance, respectively, as well as PlaceholderAPI (PAPI) variables.
target:
- location: The target location of the point.
mark:
- distance: The distance between the marker point and the player. It is recommended to avoid distances that are too close or too far.
trigger-distance: The distance at which the point starts to fade. Upon disappearing, actions will be executed.
fade-speed: The speed at which the point fades (transparency decreases). Transparency starts at 255 and decreases by this value each tick until it reaches 25 (at which point the game defines it as fully transparent), triggering the action. To execute immediately, set a very high value.
- Stop Trigger Introduction:
  You can configure tracking to stop when certain events are triggered.
  - quit: Stops tracking when the player quits. By default, tracking resumes when the player rejoins the game.
  - death: Stops tracking upon death.
  - attack: Stops tracking when the player performs an attack.
  - damaged: Stops tracking when the player takes damage.
  - world_change: Stops tracking when the player changes worlds. By default, tracking resumes if the player returns to the original world.
  - teleport: Stops tracking when the player teleports.
- Action Introduction:
  Some actions require multiple parameters, separated by semicolons (`;`). All actions support `%distance%`, `%player%`, and PAPI variables.
  - command: Executes a command as the player.
  - console: Executes a command as the console.
  - op: Executes a command with operator permissions. Use cautiously.
  - message: Sends a message to the player.
  - title: Sends a title message to the player. Requires five parameters:
    1. Main title
    2. Subtitle
    3. Fade-in time (in ticks)
    4. Duration (in ticks)
    5. Fade-out time (in ticks)
    (*20 ticks = 1 second*)
  - actionbar: Sends an action bar message to the player.
  - sound: Plays a sound. You can use vanilla sound formats or formats like `ENTITY_PLAYER_DEATH`. The second parameter is volume, and the third is pitch.
  - lightning: Summons lightning for visual effects. The first parameter specifies the location, which can be `player`, `target`, or in the format `world_name,x,y,z`. Here, `player` refers to the player's position, and `target` refers to the target location.
  - firework: Spawns a firework. Parameters include location, color, type, fade color, and flight height (power). The location format is the same as above.
  - start: Starts tracking another point. Cannot start tracking itself.
Command Introduction:
- /starttrack <player> <pointID>: Starts tracking a point.
- /stoptrack <player>: Stops all tracking for the player.
- /stoptrack <player> <pointID> [triggerAction]: Stops tracking a specific point. The third parameter can be `true` or `false` (default: `false`).
- /targettracker reload: Reloads the plugin's configuration and point files.
PlaceholderAPI placeholders Introduction:
- %targettracker_isactive_<id>%: Whether the point with the specified ID is active.
- %targettracker_active/all_amount%: Total number of points currently being tracked or the total number of points.
- %targettracker_active/all_nearest/furthest_distance%: Distance of the nearest or furthest point being tracked (or among all points) from the player.
- %targettracker_active/all_nearest/furthest_markdisplay%: Description of the marker point of the nearest or furthest point being tracked (or among all points).
- %targettracker_active/all_nearest/furthest_targetdisplay%: Description of the target point of the nearest or furthest point being tracked (or among all points).
- %targettracker_active/all_nearest/furthest_id%: ID of the nearest or furthest point being tracked (or among all points).
- %targettracker_point_<id>_distance%: Distance of the specified point from the player.
- %targettracker_point_<id>_markdisplay%: Description of the marker point of the specified point.
- %targettracker_point_<id>_targetdisplay%: Description of the target point of the specified point.

View on SpigotMC

Resource Information

Author:

----------

Total Downloads: 66

First Release: Jan 24, 2025

Last Update: Feb 5, 2025

Category: ---------------

All-Time Rating:

1 ratings

Version -----

Released: --------------------

Downloads: ------

Version Rating:

----------------------

-- ratings