Home/Products/Trails

Trails

Let your players stand out with customizable particle and effect trails!

Let your players stand out with customizable particle and effect trails! Give VIPs, donors, or everyday players cool effects that follow them as they run, jump, swim, or drive with built-in lag protection, optional shop support, and zero database setup required.


Why Use Trails?

  • Lag-Friendly: Built-in cooldowns and movement distance checks keep your server running smoothly even with lots of players online.
  • Easy Trail Setup (trails.json): Add or edit trails in a clean trails.json file using either Effect IDs or modern Effect GUIDs.
  • Smart Triggers: Make trails appear only when walking, sprinting, jumping, swimming, driving specific vehicles, holding specific guns, or inside safezones/PvP zones.
  • Player-Friendly Controls: Players can toggle trails on/off, stack multiple trails, or hide their own trail in first-person with /trail hide while everyone else still sees it.
  • Built-In Shop (Optional): Sell trails using Uconomy money or in-game EXP with /trail buy, or unlock them for players via crates/store rewards with /trail unlock.
  • VIP & PvP Ready:
    • Automatically removes trails if a player's VIP rank expires.
    • Hides trails automatically when staff are in Vanish, when a player is dead, or during PvP combat (optional).
    • Supports temporary/timed trails for events or trial ranks.
  • Works Out of the Box: Saves player data locally by default, with optional MySQL support if you run multiple servers.

Commands

Player Commands

CommandWhat it does
/trailsShows all trails you can use (* = currently active, also shows price if not owned yet).
/trail add <trail>Turns on a trail.
/trail remove <trail | *>Turns off a specific trail, or * to turn off all trails.
/trail toggle <trail>Quickly turns a trail on or off.
/trail clearTurns off all of your active trails.
/trail hideHides your trails from your own screen (other players can still see them).
/trail listShows your currently active trails and time left on temporary trails.
/trail buy <trail>Buys and unlocks a paid trail (when Economy is enabled).

Admin / Console Commands

CommandWhat it does
/trail add <trail> <player> [seconds]Gives a trail to a player (add seconds at the end for a temporary trail).
/trail remove <trail | *> <player>Removes a trail (or all trails with *) from a player.
/trail clear <player>Clears all trails from a player.
/trail list <player>Checks what trails a player currently has active.
/trail unlock <trail | *> <player>Permanently unlocks a paid trail (or all trails with *) for a player for free—great for crates and store packages.
/trail reloadReloads your config and trails.json without restarting the server.

Permissions

Add these to your Permissions.config.xml for the groups you want:

PermissionWho should have it
trailAll players (allows /trail).
trailsAll players (allows /trails).
trail.<name>Gives access to a specific trail (e.g., trail.fire, trail.electric).
trail.*Gives access to every trail (great for top VIP ranks or staff).
trail.bypass.limitLets a player equip more than the MaxActiveTrailsPerPlayer limit.
trail.bypass.priceLets a player use paid trails without buying them.
trail.player.forceStaff/Console: allows managing or unlocking trails for other players.
trail.reloadStaff/Console: allows /trail reload.

Configuration Guide

Adding & Editing Trails (trails.json)

Each trail in trails.json looks like this:

{
  "Name": "fire",
  "EffectId": 139,
  "EffectGuid": "",
  "Permission": "trail.fire",
  "Conditions": "Grounded",
  "CooldownMs": 150,
  "RelevantDistance": 80.0,
  "OffsetY": 0.1,
  "Reliable": false,
  "Price": 0.0
}
  • Name: The name players type in /trail add <name>.
  • EffectId / EffectGuid: The Unturned Effect ID (or GUID for workshop/modern effects). If EffectGuid is filled in, it is used instead of EffectId.
  • Permission: Permission needed to use this trail (leave empty "" to make it free for everyone).
  • Conditions: When the trail should appear (see list below).
  • CooldownMs: Minimum time (in milliseconds) between effect spawns.
  • RelevantDistance: How far away (in meters) other players can see this trail.
  • OffsetY: Height offset from the player's feet (0.1 is just above the ground).
  • Price: Cost to buy this trail with /trail buy (when EconomyMode is enabled; 0 = free).

Available Conditions

You can combine multiple conditions with commas (for example: InWater,InVehicle.140.106):

  • Always — Always active while moving
  • Grounded / NotGrounded — On the ground vs. in the air
  • Jump — While jumping
  • Running / Walking / Crouch / Prone / Climbing — Based on player movement/stance
  • InWater / Swimming — When in water or swimming
  • Bleeding / BrokenBones — When injured
  • ZombieFollowing — While chased by zombies
  • Talking — While using voice chat
  • Safezone / PvP — Inside safezones vs. outside safezones
  • EquippedGun.* or EquippedGun.363.297 — Holding any gun, or specific item IDs
  • InVehicle.* or InVehicle.140.106 — Driving any vehicle, or specific vehicle IDs
BUNDLE & SAVE 10%Save $1.60

Cosmetic Pack!

A collection of cosmetic plugins to help your players customize themselves. Good for VIP rewards.

Includes 3 Plugins:

Bundle Price:

$16.00$14.40
Trails

Trails

economypvputilitygeneral (misc)
★New(0 ratings)
$3.00Save up to 10% in a Bundle↓
Current Versionv1.0.0
Last Updated11/16/2026

Developer Support

Need help setting up this plugin? Reach out to the developer directly.

Get Support

Latest Changes

v1.0.0

Initial Release