Footprints

Footprints – Player Footprint Plugin

A lightweight, highly configurable footprint plugin for Minecraft servers. Players can leave stylish cosmetic trails behind them as they walk, with full GUI support, multi-version compatibility, and deep configuration options.

---

Features

- Optional PlaceholderAPI Support – Choose from single-block trails (diamond, gold, ice, etc.) or animated cycle trails (ore blocks, rainbow wool). - Optional PlaceholderAPI Support – Open a clean inventory menu (`/fp`) and click to select your footprint. Fully configurable title, border, click prompts, lore, and "currently using" indicator. - Optional PlaceholderAPI Support – Footprint blocks automatically restore to their original state after a delay (supports decimals like `0.5` seconds). - Optional PlaceholderAPI Support – Breaking a footprint block instantly restores the original block with no drops. - Optional PlaceholderAPI Support – Footprint blocks (e.g. magma, cactus) never damage players. - Optional PlaceholderAPI Support – Footprints are only placed on full, solid blocks (no ladders, chests, fences, glass panes, etc.). - Optional PlaceholderAPI Support – Option to prevent footprints from appearing on work blocks (crafting tables, beacons, furnaces, etc.) via `allow-work-blocks` config. - Optional PlaceholderAPI Support – Control how many footprints a player can place per second and the maximum active footprints server‑wide to maintain performance. - Optional PlaceholderAPI Support – Blacklist worlds where footprints should not appear. - Optional PlaceholderAPI Support – Supports Minecraft Optional PlaceholderAPI Support. Automatically translates legacy material names (e.g. `WOOL:14`) to modern equivalents, and vice versa. - Optional PlaceholderAPI Support – Variables: `%footprints_display%`, `%footprints_internal%`, `%footprints_lore%`.

---

Commands & Permissions

| Command | Description | Permission | |---------|-------------|------------| | `/fp` | Open the footprint selection GUI | `footprints.use` | | `/fp use <name>` | Select a footprint by internal name | `footprints.use` | | `/fp list` | List all available footprints in chat | `footprints.use` | | `/fp reload` | Reload all configuration files | `footprints.admin` |

| Permission | Default | Description | |------------|---------|-------------| | `footprints.use` | `true` (all players) | Allows using the GUI and selecting footprints | | `footprints.admin` | `op` | Allows reloading the plugin configuration |

---

Configuration

`config.yml`

```yaml disabled-worlds: - world_the_end restore-delay: 0.5 # Seconds before footprint blocks restore (supports decimals) instant-restore-on-break: true # Break to instantly restore (no drops) footprints-per-second: 4 # Max footprints per player per second (0 = unlimited) max-active-footprints: 60 # Max active footprints globally (0 = unlimited) allow-work-blocks: false # Whether work blocks (crafting tables, beacons, etc.) can become footprints selection-message: '&aYou have selected footprint: &e{footprint}' gui-title: '&6Footprint Selection' ```

`footprints.yml` (Scheme Definitions)

```yaml gui: title: '&6Footprint Selection' size: 27 border: enable: true material: STAINED_GLASS_PANE:15 name: ' ' click-prompt: '&aClick to select this footprint' selection-message: '&aYou have selected footprint: &e{footprint}' currently-using-message: '&aYou are using this footprint'

footprints: gold: name: '&6Gold Footprint' type: single block: GOLD_BLOCK lore: - '&6Generates gold blocks underfoot' - '&7Single block type' ore-cycle: name: '&eOre Cycle Footprint' type: cycle blocks: - IRON_BLOCK - GOLD_BLOCK - DIAMOND_BLOCK interval: 500 lore: - '&eCycles through iron, gold and diamond blocks' - '&7Interval: 500ms' ```

---

Installation

1. Download the latest `.jar` from the releases page. 2. Place the `.jar` in your server's `plugins/` folder. 3. (Optional) Install PlaceholderAPI for variable support. 4. Restart your server. 5. Edit `plugins/Footprints/config.yml` and `plugins/Footprints/footprints.yml` to your liking. 6. Use `/fp reload` to apply changes without restarting.

---

Compatibility

- Dependencies: 1.8.8 – 1.20.6 (tested on Paper, Spigot, and their forks) - Dependencies: 11 or higher - Dependencies: None (PlaceholderAPI is optional)

---

Changelog Highlights (1.0 – 1.5)

- 1.5 – Initial release with single/cycle schemes, GUI, block restoration, per‑world disable, multi‑version support. - 1.5 – Fixed footprints on non‑full blocks (ladders, chests, fences, etc.). - 1.5 – Footprint blocks no longer deal damage to players. - 1.5 – Added configurable "You are using this footprint" indicator in GUI. - 1.5 – Removed overlapping "click to select" prompt for the active footprint. - 1.5 – Added `allow-work-blocks` option; expanded legacy material mappings.

---

Support

For bug reports or suggestions, please visit: Report bugs

We are working on a dedicated repository.