AlloTrail Documentation

Everything you need to know about installing, configuring, and using the AlloTrail plugin.

Installation

Follow these steps to install AlloTrail on your Minecraft server.

Requirements

  • Paper server, version 1.21.4
  • Java 21 or higher

Installation Steps

  1. Download the plugin

    Download the AlloTrail-1.0-all.jar file from the download page.

  2. Place in plugins folder

    Copy the JAR file to your server's plugins/ directory.

  3. Start or reload your server

    Restart your server or use the /reload command if your server is already running.

    $ java -jar paper.jar
  4. Verify installation

    Check the server console for AlloTrail startup messages. You should see confirmation that the plugin has loaded successfully.

Upon first startup, AlloTrail will automatically create its configuration files in the plugins/AlloTrail/ directory. No manual configuration is required to get started.

Usage Guide

Learn how to use AlloTrail's features and commands.

Commands

/trail

Opens the main trail menu.

Permission: allotrail.use (default: true)

/addpoints <player> <points>

Adds points to a player's balance.

Permission: allotrail.addpoints (default: op)

Example: /addpoints Steve 1000

Using the GUI

Main Menu

The main menu provides three options:

  • Buy Trails (Emerald): Browse and purchase trails with points.
  • Equip Trails (Feather): Select from your unlocked trails.
  • Close (Nether Star): Close the GUI.

Buy Trails Menu

The buy menu organizes trails by rarity:

  • Epic: 200-300 points (Totem, Sonic Boom, etc.)
  • Rare: 150 points (Flame, Enchant, etc.)
  • Common: 100 points (Heart, Bubble, etc.)
  • Basic: 50 points (Smoke, Snowflake, etc.)

Click on a trail to purchase it if you have enough points.

Equip Trails Menu

This menu shows all your unlocked trails:

  • Click on a trail to equip it.
  • Click the Disable Trail (Barrier) to remove your active trail.
  • Click Back (Arrow) to return to the main menu.

Trails are visible to all players nearby. The particles spawn while you're moving, creating a visual trail behind your character.

Configuration

Learn about AlloTrail's configuration files and options.

Configuration Files

AlloTrail uses a single configuration file to store player data:

playerdata.yml

Stores player points and unlocked trails.

Location: plugins/AlloTrail/playerdata.yml

# Example playerdata.yml
123e4567-e89b-12d3-a456-426614174000:  # Player UUID
  points: 500                          # Player's point balance
  unlocked:                            # List of unlocked trails
  - SMOKE
  - SNOWFLAKE
  - HEART
  
456e7890-e12b-34d5-a678-426614174000:  # Another player
  points: 1200
  unlocked:
  - TOTEM
  - SONIC_BOOM
  - FLAME
  - SMOKE

Permissions Setup

AlloTrail uses a simple permission system that can be configured with any permissions plugin like LuckPerms.

Default Permissions

  • allotrail.use - Default: true (all players)
  • allotrail.addpoints - Default: op (operators only)

LuckPerms Examples

# Give a player access to the /trail command
/lp user Steve permission set allotrail.use true

# Give a group access to the /addpoints command
/lp group admin permission set allotrail.addpoints true

It's recommended to edit the playerdata.yml file only when the server is stopped to avoid data loss. The plugin automatically saves data when players log out and when the server shuts down.

Troubleshooting

Solutions for common issues you might encounter with AlloTrail.

The /trail command doesn't open the GUI

Cause: Missing permission or plugin not loaded correctly.

Solution:

  1. Check if the player has the allotrail.use permission.
  2. Verify the plugin is loaded with /plugins command.
  3. Check the server console for any error messages.
  4. Try restarting the server.

Trails don't appear when equipped

Cause: Trail not properly equipped or particle settings too low.

Solution:

  1. Make sure you've equipped a trail (use /trail and go to Equip Trails).
  2. Check your Minecraft particle settings (Options → Video Settings → Particles).
  3. Move around - particles only spawn while moving.
  4. Try re-equipping the trail.

Points or unlocked trails not saving

Cause: File permission issues or data corruption.

Solution:

  1. Check if the server has write permissions for the plugins/AlloTrail directory.
  2. Inspect the playerdata.yml file for any syntax errors.
  3. If the file is corrupted, stop the server, delete playerdata.yml, and restart.
  4. Check the server logs for any file-related errors.

Plugin fails to load

Cause: Incompatible server version or Java version.

Solution:

  1. Verify you're using Paper 1.21.4 (not Spigot or an older version).
  2. Check your Java version with java --version (should be Java 21+).
  3. Look for detailed error messages in the server console or logs.
  4. Try downloading the plugin file again in case it was corrupted.

Still Having Issues?

If you're still experiencing problems after trying these solutions, please contact the developer at support@allosmp.de or create an issue on the GitHub repository.