Footprint

FOOTPRINT
=========

Footprint is a client-side Fabric mod for Minecraft. It automatically
keeps a text record of where you explore, so you can look up coordinates you
visited earlier and retrace your route. It does not require a server-side
installation.

WHAT IT RECORDS
---------------

While you are in a single-player world or connected to a server, Footprint
checks your position once per minute. It records your integer block coordinates
(X, Y, Z), the dimension, and your computer's local time. For example:

X: 100, Y: 64, Z: -200 | Overworld | 6:03 PM

To keep the log useful and avoid repeated entries nearby, Footprint saves a
location only when it is more than 100 blocks away in 3D from the last saved
location in that dimension. This distance is measured between block positions.
The previous saved coordinate is read from the log, so this filtering continues
after you reconnect or restart Minecraft.

WHERE LOGS ARE SAVED
--------------------

Logs are created automatically in the "footprint" folder inside your Minecraft
instance folder. Each single-player world and server has its own text file.
World filenames start with "world-"; server filenames start with "server-" and
include the server name and address. New entries are appended to existing files.
The Overworld, Nether, and End are identified by name; other dimensions use
their dimension identifier.

COMMANDS
--------

/footprint on
    Enables automatic coordinate recording. Recording is enabled by default.
    After turning it on, the mod starts its next recording interval when you
    enter or remain in a world.

/footprint off
    Disables automatic coordinate recording. No new locations are logged until
    you use "/footprint on" again. Existing log files are left unchanged.

There are no other Footprint commands currently. To view or search your
coordinates, open the relevant text file in the instance's "footprint" folder.

WHAT IT CAN AND CANNOT DO
-------------------------

Footprint can preserve a lightweight travel history for each world or server,
including the dimension and local time of recorded locations. This can help you
remember where you explored and find coordinates again later.

Footprint currently records locations to text files only. It does not display
coordinates on a map, create in-game waypoints, guide you to a saved location,
or provide an in-game log viewer. It records periodically rather than tracking
every block you move through, and locations within 100 blocks of the last saved
location in the same dimension are skipped.