/trails                 - Opens your personal trail selection GUI.
/trails off             - Disables your currently active trail.
/trails toggle          - Toggles your current trail ON/OFF (re-activates last used trail).
/trails list            - Shows a list of all trails you have access to.
/trails version         - Displays the plugin version and author.

# --- Admin Commands (Requires 'rltrails.admin' or specific permissions) ---
/trails reload          - Reloads the plugin's configuration files.
/trails set <player> <trail_id|off> - Sets a specific trail for a player, or turns it off.
/trails admin           - Opens the Admin GUI for managing player trails.
/trails forceopen <player> - Forces the trail selection GUI to open for another player.
/trails info <trail_id> - Displays detailed information about a specific trail.
 

rltrails.admin:               # Grants access to all admin commands (default: op)
  - rltrails.command.reload
  - rltrails.command.set
  - rltrails.command.admin
  - rltrails.command.forceopen
  - rltrails.command.info

rltrails.command.open:        # Allows players to open the GUI (default: true)
rltrails.command.off:         # Allows players to turn off their trail (default: true)
rltrails.command.toggle:      # Allows players to use /trails toggle (default: true)
rltrails.command.list:        # Allows players to use /trails list (default: true)
rltrails.command.version:     # Allows viewing plugin version (default: true)

rltrails.trail.*:             # Grants access to ALL trails (default: op)

# Individual trail permissions (defined in config.yml, example below):
rltrails.trail.flame
rltrails.trail.rgb
rltrails.trail.angel_wings
rltrails.trail.creeper_path
# ... and so on for every trail you define!
 

rgb_trail:
  display-name: "&cR&6G&eB &bTrail"
  type: TRAIL
  particle:
    name: REDSTONE # For colored dust, use REDSTONE (DUST in newer MC versions)
    data:
      color: "RGB" # Special keyword for rainbow effect!
      size: 1.1
  permission: "rltrails.trail.rgb"
  gui-item: { material: RED_WOOL, lore: ["&7A vibrant, color-changing trail.", "", "{status}"] }
 

angel_wings:
  display-name: "&f&lAngel Wings"
  type: WINGS
  particle: { name: REDSTONE, data: { color: "#FFFFE0", size: 1.0 } } # Light Yellow particles
  permission: "rltrails.trail.angel_wings"
  options:
    width: 1.2    # How wide the wings spread
    speed: 0.8    # How fast the wings flap
    density: 5    # Number of particles per wing section
  gui-item: { material: FEATHER, lore: ["&7Graceful wings of light follow you.", "", "{status}"] }
 

creeper_path:
  display-name: "&a&lCreeper's Path"
  type: FOOTPRINT
  particle: BLOCK_CRACK # For block-based particles, use BLOCK_CRACK or BLOCK_DUST
  data: { block-material: CREEPER_HEAD } # Specify the block here!
  permission: "rltrails.trail.creeper_path"
  gui-item: { material: CREEPER_HEAD, lore: ["&7That's a very nice trail you have there...", "", "{status}"] }
 

RlTrails.getInstance().getApi()

// Get the API instance
RlTrailsAPI api = RlTrails.getInstance().getApi();

// Set 'flame' trail for a player
api.setTrail(myPlayer, "flame");

// Check if a player has an active trail
Optional<Trail> currentTrail = api.getActiveTrail(myPlayer);
currentTrail.ifPresent(trail -> {
    Bukkit.getLogger().info(myPlayer.getName() + " has " + trail.getDisplayName() + " active!");
});

// Clear a player's trail
api.clearTrail(myPlayer);