💬 Support & Contact

Do you have questions, feedback, or want to report bugs?
Join my Discord and chat directly with the author:
👉 Join Discord server: https://discord.gg/TJgzq9aCxN

✨ What is FootstepsFX?

FootstepsFX brings your server to life:

Players leave a configurable particle trail behind them as they run. Each player can customize the effect as they wish – from smoke and flames to hearts or musical notes.

🎮 Features

• Toggle on/off per player
• Effect type per player (e.g., flame, smoke, love hearts, …)
• Intensity (number of particles per step)
• Performance optimization: particles only when entering a new block
• Effect lock per player: lock or unlock individual effects (/traillock effect, /trailunlock effect)
• Global lock/unlock of all effects via * or all
• Effect management for other players: admins can lock/unlock effects for other players
• Tab completion for all commands: dynamic suggestions for effects, players, options (effect, player, *, all)
• Help command: /trailhelp displays all available commands and their descriptions
• Reload function: /trailreload reloads saved data (e.g., after file changes)
• Effect validation: invalid effect names are detected and handled with a warnin

🛠 Commands & permissions

1. /trail on – Activates the trail (Permission: trail.use)
2. /trail off – Deactivates the trail (Permission: trail.use)
3. /trail effekt <effekt> – Sets the effect type (Permission: trail.use)
4. /trail intensity <1–100> – Sets the particle amount (Permission: trail.use)
5. /trail list [page] – Shows all available effects (Permission: trail.use)
6. /trail help - Displays all available trail commands (Permission: trail.use)
7. /trail lock effect <effekt/all/*> - Locks all / a specific effect for yourself (Permission: trail.lock)
8. /trail unlock effect <effekt/all/*> - Unlocks all / a specific effect for yourself (Permission: trail.unlock)
9. /trail lock player <player> effect <effect/all/*> - Locks all / an effect for another player (Permission: trail.lock)
10. /trail unlock player <player> effect <effect/all/*> - Unlocks all / an effect for another player (Permission: trail.lock)
11. /trail reload - Reloads all saved trail data (Permission: trail.reload)

⚙️ Configuration & storage

Java (persistent – permanently stored)

All player settings are automatically stored in plugins/FootstepsFX/footstepsfx_playerdata.json.

Format (JSON structure):

{ "uuid-of-player": { "enabled": true, "effectType": "flame", "intensity": 8 “lockedEffect”: [], “unlockedEffects”: [] } }

The file is loaded at startup and saved when changed/stopped.

📸 Showcase 

📂 Installation

1. Download FootstepsFX-<pluginversion>-<minecraftversion>.jar.
2. Place it in your server's plugins folder.
3. Restart the server.

📜 Terms of Use – FootstepsFX

✅ You may

• Use FootstepsFX free of charge on private and public servers.
• Modify or extend the code as long as the credits remain intact.
• Include the plugin in server packs if “wolfwriter” is named as the author.

❌ You may not

• Sell FootstepsFX or distribute it for money.
• Pretend to be the author of the plugin.
• Upload manipulated versions as “official.”

⚠️ Disclaimer

• FootstepsFX is provided without warranty.
• Use at your own risk.
• No liability for data loss or server problems.

ℹ️ License

License: GNU General Public License version 3 (GPLv3)