Sign Logger

A server-side modification specially designed to track everything related to sign alterations in the Minecraft world. All events are recorded not only in the server console but also stored in a dedicated database. Among its features is a special inspection mode that allows instant viewing of sign edit logs at any chosen location.

Key Features

Inspection Mode

If you have operator permissions on the server, you can activate the inspection mode using the commands /sign-logger inspect true and /sign-logger inspect false. In this mode, it's impossible to place or break blocks. By left-clicking on an existing block, you'll see the sign edit logs at its coordinates. Right-clicking will let you view similar information for the area adjacent to the block face you clicked on.

The mode automatically deactivates when leaving the server or upon character death.

Sign Event Recording

The mod records four types of sign modifications, with each event documenting information about the author, location, world, and time when it occurred:

• Text Edit: This event occurs when a player changes the text on a sign to something else. It stores both the old and new text, as well as which specific side was edited. By hovering over the corresponding section in the log, you can see the text before and after editing.

• Waxed Sign: Triggered when a player applies wax to a sign, making it inaccessible for further editing.

• Dyed Sign: Happens when a player alters the text color using dye. It records the previous and new text color, along with the edited side. You can check the color change in the log simply by hovering over the entry.

• Glowing Sign: Generated when adding or removing the glowing text effect using a glow ink sac or ink sac, respectively. It takes into account which side of the sign was affected.

Console logging of changes can be toggled with the command /sign-logger settings do_console_logs true|false.

Database

Records of sign alterations are stored in a simple database. You can set a time period in days for deleting entries older than that using the command /sign-logger database purge. For precise configuration, use /sign-logger database purge_older_than_x_days <whole number>.

Automatic database cleanup occurs when the server shuts down based on the purge_logs_older_than_x_days value specified in the configuration file.

Configuration

When the server starts, the modification looks for a sign-logger.toml file in the game's configuration folder. If the file exists, settings are read from it. If the file is absent, it's automatically created at /config/sign-logger.toml. To apply changes made to the file, restart the server or execute the /sign-logger reload_config command.

The standard configuration file generated during the first mod startup or when it fails to find the settings file during server or world shutdown is shown below.

# Parameters related to database operation.
[database]
    # (Default = 30) Specifies the period in days after which entries will be deleted during cleanup.
    # Cannot be set to less than 1 or a fractional value.
    purge_logs_older_than_x_amount = 1

# Settings that can be enabled or disabled to customize the modification's behavior.
[settings]
    # (Default = true) Controls console logging of sign changes.
    do_console_logging = true

About the Author

If you encounter a bug or have suggestions for improving the mod, reach out through the dedicated system on GitHub or join the author's Discord server.