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 cleantrails.jsonfile 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 hidewhile 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
| Command | What it does |
|---|---|
/trails | Shows 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 clear | Turns off all of your active trails. |
/trail hide | Hides your trails from your own screen (other players can still see them). |
/trail list | Shows 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
| Command | What 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 reload | Reloads your config and trails.json without restarting the server. |
Permissions
Add these to your Permissions.config.xml for the groups you want:
| Permission | Who should have it |
|---|---|
trail | All players (allows /trail). |
trails | All 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.limit | Lets a player equip more than the MaxActiveTrailsPerPlayer limit. |
trail.bypass.price | Lets a player use paid trails without buying them. |
trail.player.force | Staff/Console: allows managing or unlocking trails for other players. |
trail.reload | Staff/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). IfEffectGuidis filled in, it is used instead ofEffectId.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.1is just above the ground).Price: Cost to buy this trail with/trail buy(whenEconomyModeis enabled;0= free).
Available Conditions
You can combine multiple conditions with commas (for example: InWater,InVehicle.140.106):
Always— Always active while movingGrounded/NotGrounded— On the ground vs. in the airJump— While jumpingRunning/Walking/Crouch/Prone/Climbing— Based on player movement/stanceInWater/Swimming— When in water or swimmingBleeding/BrokenBones— When injuredZombieFollowing— While chased by zombiesTalking— While using voice chatSafezone/PvP— Inside safezones vs. outside safezonesEquippedGun.*orEquippedGun.363.297— Holding any gun, or specific item IDsInVehicle.*orInVehicle.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
economypvputilitygeneral (misc)
★New(0 ratings)
$3.00Save up to 10% in a Bundle↓Current Versionv1.0.0
Last Updated11/16/2026
Latest Changes
v1.0.0
Initial Release