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

• Customizable Footprint Schemes – Choose from single-block trails (diamond, gold, ice, etc.) or animated cycle trails (ore blocks, ✨ wool).
• Interactive GUI – Open a clean inventory menu (/fp) and click to select your footprint. Fully configurable title, border, click prompts, lore, and "currently using" indicator.
• Configurable Block Restoration – Footprint blocks automatically restore to their original state after a delay (supports decimals like 0.5 seconds).
• Instant Break Restoration – Breaking a footprint block instantly restores the original block with no drops.
• Damage Prevention – Footprint blocks (e.g. magma, cactus) never damage players.
• Smart Ground Detection – Footprints are only placed on full, solid blocks (no ladders, chests, fences, glass panes, etc.).
• Work Block Protection – Option to prevent footprints from appearing on work blocks (crafting tables, beacons, furnaces, etc.) via allow-work-blocks config.
• Frequency & Global Limits – Control how many footprints a player can place per second and the maximum active footprints server‑wide to maintain performance.
• Per‑World Disable – Blacklist worlds where footprints should not appear.
• Multi‑Version Compatibility – Supports Minecraft 1.8.8 through 1.20.6. 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

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)

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

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

---

Changelog Highlights (1.0 – 1.5)

• 1.0 – Initial release with single/cycle schemes, GUI, block restoration, per‑world disable, multi‑version support.
• 1.1 – Fixed footprints on non‑full blocks (ladders, chests, fences, etc.).
• 1.2 – Footprint blocks no longer deal damage to players.
• 1.3 – Added configurable "You are using this footprint" indicator in GUI.
• 1.4 – 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.