# Footprints \u2013 Player Footprint Plugin<\/p>\n
**A lightweight, highly configurable footprint plugin for Minecraft servers.**
\nPlayers can leave stylish cosmetic trails behind them as they walk, with full GUI support, multi-version compatibility, and deep configuration options.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– **Customizable Footprint Schemes** \u2013 Choose from single-block trails (diamond, gold, ice, etc.) or animated cycle trails (ore blocks, rainbow wool).
\n– **Interactive GUI** \u2013 Open a clean inventory menu (`\/fp`) and click to select your footprint. Fully configurable title, border, click prompts, lore, and “currently using” indicator.
\n– **Configurable Block Restoration** \u2013 Footprint blocks automatically restore to their original state after a delay (supports decimals like `0.5` seconds).
\n– **Instant Break Restoration** \u2013 Breaking a footprint block instantly restores the original block with no drops.
\n– **Damage Prevention** \u2013 Footprint blocks (e.g. magma, cactus) never damage players.
\n– **Smart Ground Detection** \u2013 Footprints are only placed on full, solid blocks (no ladders, chests, fences, glass panes, etc.).
\n– **Work Block Protection** \u2013 Option to prevent footprints from appearing on work blocks (crafting tables, beacons, furnaces, etc.) via `allow-work-blocks` config.
\n– **Frequency & Global Limits** \u2013 Control how many footprints a player can place per second and the maximum active footprints server\u2011wide to maintain performance.
\n– **Per\u2011World Disable** \u2013 Blacklist worlds where footprints should not appear.
\n– **Multi\u2011Version Compatibility** \u2013 Supports Minecraft **1.8.8 through 1.20.6**. Automatically translates legacy material names (e.g. `WOOL:14`) to modern equivalents, and vice versa.
\n– **Optional PlaceholderAPI Support** \u2013 Variables: `%footprints_display%`, `%footprints_internal%`, `%footprints_lore%`.<\/p>\n
—<\/p>\n
## Commands & Permissions<\/p>\n
| Command | Description | Permission | | Permission | Default | Description | —<\/p>\n ## Configuration<\/p>\n ### `config.yml` ### `footprints.yml` (Scheme Definitions) footprints: —<\/p>\n ## Installation<\/p>\n 1. Download the latest `.jar` from the releases page. —<\/p>\n ## Compatibility<\/p>\n – **Minecraft**: 1.8.8 \u2013 1.20.6 (tested on Paper, Spigot, and their forks) —<\/p>\n ## Changelog Highlights (1.0 \u2013 1.5)<\/p>\n – **1.0** \u2013 Initial release with single\/cycle schemes, GUI, block restoration, per\u2011world disable, multi\u2011version support. —<\/p>\n ## Support<\/p>\n For bug reports or suggestions, please visit: We are working on a dedicated repository.<\/p>\n","protected":false},"excerpt":{"rendered":" A lightweight, highly configurable footprint trail plugin for Minecraft servers. Players can leave cosmetic block trails as they walk, with full GUI support and cross-version compatibility.<\/p>\n","protected":false},"featured_media":71913,"template":"","meta":{"_minecraft_slug":"footprints322","_minecraft_project_id":"bxGceVAz","_minecraft_author":"xiyiji322","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":19,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"footprints322.zip","_minecraft_size_bytes":375274,"_minecraft_version_count":13,"_minecraft_updated_at":"2026-05-15T22:33:33.405143Z","_minecraft_date_created":"2026-05-07T22:00:22.734201Z","_minecraft_date_modified":"2026-05-05T23:25:20.839801Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/footprints322","_minecraft_icon_attachment_id":71913,"_minecraft_imported_at":"2026-06-04T01:57:47+00:00","_minecraft_import_hash":"0272e664636150f0588318a9032ad763","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,129],"mod_loader":[132,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,30,31,860,861,862,863,864],"class_list":["post-71912","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/fp` | Open the footprint selection GUI | `footprints.use` |
\n| `\/fp use
\n| `\/fp list` | List all available footprints in chat | `footprints.use` |
\n| `\/fp reload` | Reload all configuration files | `footprints.admin` |<\/p>\n
\n|————|———|————-|
\n| `footprints.use` | `true` (all players) | Allows using the GUI and selecting footprints |
\n| `footprints.admin` | `op` | Allows reloading the plugin configuration |<\/p>\n
\n“`yaml
\ndisabled-worlds:
\n – world_the_end
\nrestore-delay: 0.5 # Seconds before footprint blocks restore (supports decimals)
\ninstant-restore-on-break: true # Break to instantly restore (no drops)
\nfootprints-per-second: 4 # Max footprints per player per second (0 = unlimited)
\nmax-active-footprints: 60 # Max active footprints globally (0 = unlimited)
\nallow-work-blocks: false # Whether work blocks (crafting tables, beacons, etc.) can become footprints
\nselection-message: ‘&aYou have selected footprint: &e{footprint}’
\ngui-title: ‘&6Footprint Selection’
\n“`<\/p>\n
\n“`yaml
\ngui:
\n title: ‘&6Footprint Selection’
\n size: 27
\n border:
\n enable: true
\n material: STAINED_GLASS_PANE:15
\n name: ‘ ‘
\n click-prompt: ‘&aClick to select this footprint’
\n selection-message: ‘&aYou have selected footprint: &e{footprint}’
\n currently-using-message: ‘&aYou are using this footprint’<\/p>\n
\n gold:
\n name: ‘&6Gold Footprint’
\n type: single
\n block: GOLD_BLOCK
\n lore:
\n – ‘&6Generates gold blocks underfoot’
\n – ‘&7Single block type’
\n ore-cycle:
\n name: ‘&eOre Cycle Footprint’
\n type: cycle
\n blocks:
\n – IRON_BLOCK
\n – GOLD_BLOCK
\n – DIAMOND_BLOCK
\n interval: 500
\n lore:
\n – ‘&eCycles through iron, gold and diamond blocks’
\n – ‘&7Interval: 500ms’
\n“`<\/p>\n
\n2. Place the `.jar` in your server’s `plugins\/` folder.
\n3. (Optional) Install PlaceholderAPI for variable support.
\n4. Restart your server.
\n5. Edit `plugins\/Footprints\/config.yml` and `plugins\/Footprints\/footprints.yml` to your liking.
\n6. Use `\/fp reload` to apply changes without restarting.<\/p>\n
\n– **Java**: 11 or higher
\n– **Dependencies**: None (PlaceholderAPI is optional)<\/p>\n
\n– **1.1** \u2013 Fixed footprints on non\u2011full blocks (ladders, chests, fences, etc.).
\n– **1.2** \u2013 Footprint blocks no longer deal damage to players.
\n– **1.3** \u2013 Added configurable “You are using this footprint” indicator in GUI.
\n– **1.4** \u2013 Removed overlapping “click to select” prompt for the active footprint.
\n– **1.5** \u2013 Added `allow-work-blocks` option; expanded legacy material mappings.<\/p>\n
\nReport bugs<\/p>\n