NamlessCheck

# NamlessCheck Spigot/Paper plugin to log sensitive build/combat actions: monitored block placements, fire ignitions, and End Crystal placements, with output to console, file, or both. ## V3 Updates * Added fire interaction logging for ignitions caused by `FLINT_AND_STEEL` and `FIRE_CHARGE`. * Added End Crystal placement logging from player interaction (right-click on `OBSIDIAN`/`BEDROCK`). * Kept whitelist behavior for block placements via `monitored-blocks`. ## Features * Monitored player block-place logging (whitelist-based). * Fire ignition logging (`FLINT_AND_STEEL` / `FIRE_CHARGE` interactions). * End Crystal placement logging from interaction. * Configurable block whitelist (`monitored-blocks`). * Configurable output: `CONSOLE`, `FILE`, `BOTH`. * Live config reload command (no restart required). * Bypass permission for specific players/staff. * Startup log rotation with `.gz` compression. * Multi-language support with separate files (`it_it` / `us_en`). * Async log queue to reduce main-thread I/O impact. ## Installation 1. Copy the jar into `plugins/`. 2. Start the server once to generate default files. 3. Edit `plugins/NamlessCheck/config.yml`. 4. (Optional) edit language files in `plugins/NamlessCheck/lang/`. 5. Run `/namlesscheck reload` to apply changes. ## Configuration (`config.yml`) Main keys: * `log-mode`: `FILE`, `CONSOLE`, `BOTH` * `log-file`: path relative to plugin folder (example `logs/blocks.log`) * `async-log-interval-ticks`: async flush interval (default `20`) * `archive-on-startup`: if `true`, archives the previous log on startup * `archive-directory`: destination folder for compressed archives * `language`: active language (`it_it` or `us_en`) * `monitored-blocks`: list of `Material` values to monitor for block placements Example: ``` log-mode: BOTH log-file: "logs/blocks.log" async-log-interval-ticks: 20 archive-on-startup: true archive-directory: "logs/old" language: "it_it" monitored-blocks: - CHEST - HOPPER ``` Note: `monitored-blocks` only filters `BlockPlaceEvent` logs. Fire ignite and End Crystal logs are tracked independently (unless player has `namlesscheck.bypass`). ## Languages (`lang/`) Available files: * `plugins/NamlessCheck/lang/it_it.yml` * `plugins/NamlessCheck/lang/us_en.yml` Main keys: * `messages.reload-success` * `messages.no-permission` * `messages.usage` * `logs.block-place` * `logs.fire-ignite` * `logs.end-crystal-place` You can customize messages directly in these files. ## Commands * `/namlesscheck reload` * Aliases: `/nc reload`, `/check reload` ## Permissions * `namlesscheck.reload` (default: `op`) * `namlesscheck.bypass` (default: `false`) ## Log Format Example line: ``` Steve placed CHEST in world ``` ## Log Rotation * If `archive-on-startup: true`, on startup the current log is: * compressed to `.gz` * moved to `archive-directory` * replaced with a new fresh log file ## Notes * Whitelist is handled case-insensitively. * If `log-mode` is invalid, the plugin falls back to `BOTH`. * File writer does not flush every event to reduce I/O; flush is guaranteed on close/reload. ## 🔗 Links (https://media.forgecdn.net/attachments/description/1431298/description_08eb12c5-0810-4bc4-9e04-97568852ffce.png)](https://davi-k-portfolio.netlify.app/) <div>Portfolio<br>--------------------------------------</div> (https://media.forgecdn.net/attachments/description/1431298/description_3aa4aa27-839a-44a4-bed5-f1866d92361b.png)](https://www.linkedin.com/in/davide-k-9a7a99375/) <div>LinkedIn<br>--------------------------------------<br><a href="mailto:info.davi.lav@gmail.com" target="_blank" rel="nofollow"><img src="https://www.gstatic.com/images/branding/product/1x/gmail_2020q4_48dp.png" alt="Email" width="64"></a></div> <div>Email<br>--------------------------------------</div> (https://media.forgecdn.net/attachments/description/1431298/description_4a3a93ae-5d63-4880-8a0f-95bba08ab917.png)](https://buymeacoffee.com/infodavik) <div>Buy me a beer<br>--------------------------------------</div> (https://media.forgecdn.net/attachments/description/1431298/description_6e867e66-3219-466c-b28d-98604176ae7d.webp)](https://ko-fi.com/infodavik) <div>Ko-fi</div>

# NamlessCheck

Spigot/Paper plugin to log sensitive build/combat actions: monitored block placements, fire ignitions, and End Crystal placements, with output to console, file, or both.

## V3 Updates

Added fire interaction logging for ignitions caused by `FLINT_AND_STEEL` and `FIRE_CHARGE`. Added End Crystal placement logging from player interaction (right-click on `OBSIDIAN`/`BEDROCK`). Kept whitelist behavior for block placements via `monitored-blocks`.

## Features

Monitored player block-place logging (whitelist-based). Fire ignition logging (`FLINT_AND_STEEL` / `FIRE_CHARGE` interactions). End Crystal placement logging from interaction. Configurable block whitelist (`monitored-blocks`). Configurable output: `CONSOLE`, `FILE`, `BOTH`. Live config reload command (no restart required). Bypass permission for specific players/staff. Startup log rotation with `.gz` compression. Multi-language support with separate files (`it_it` / `us_en`). Async log queue to reduce main-thread I/O impact.

## Installation

1. Copy the jar into `plugins/`. 2. Start the server once to generate default files. 3. Edit `plugins/NamlessCheck/config.yml`. 4. (Optional) edit language files in `plugins/NamlessCheck/lang/`. 5. Run `/namlesscheck reload` to apply changes.

## Configuration (`config.yml`)

`log-mode`: `FILE`, `CONSOLE`, `BOTH` `log-file`: path relative to plugin folder (example `logs/blocks.log`) `async-log-interval-ticks`: async flush interval (default `20`) `archive-on-startup`: if `true`, archives the previous log on startup `archive-directory`: destination folder for compressed archives `language`: active language (`it_it` or `us_en`) `monitored-blocks`: list of `Material` values to monitor for block placements

``` log-mode: BOTH log-file: "logs/blocks.log" async-log-interval-ticks: 20 archive-on-startup: true archive-directory: "logs/old" language: "it_it"

monitored-blocks: - CHEST - HOPPER ```

Note: `monitored-blocks` only filters `BlockPlaceEvent` logs. Fire ignite and End Crystal logs are tracked independently (unless player has `namlesscheck.bypass`).

## Languages (`lang/`)

Available files:

`plugins/NamlessCheck/lang/it_it.yml` `plugins/NamlessCheck/lang/us_en.yml`

`messages.reload-success` `messages.no-permission` `messages.usage` `logs.block-place` `logs.fire-ignite` `logs.end-crystal-place`

You can customize messages directly in these files.

## Commands

`/namlesscheck reload` Aliases: `/nc reload`, `/check reload`

## Permissions

`namlesscheck.reload` (default: `op`) `namlesscheck.bypass` (default: `false`)

## Log Format

Example line:

``` Steve placed CHEST in world ```

## Log Rotation

If `archive-on-startup: true`, on startup the current log is: compressed to `.gz` moved to `archive-directory` replaced with a new fresh log file

Whitelist is handled case-insensitively. If `log-mode` is invalid, the plugin falls back to `BOTH`. * File writer does not flush every event to reduce I/O; flush is guaranteed on close/reload.

## 🔗 Links

[!(https://media.forgecdn.net/attachments/description/1431298/description_08eb12c5-0810-4bc4-9e04-97568852ffce.png)](https://davi-k-portfolio.netlify.app/)

Portfolio --------------------------------------

[!(https://media.forgecdn.net/attachments/description/1431298/description_3aa4aa27-839a-44a4-bed5-f1866d92361b.png)](https://www.linkedin.com/in/davide-k-9a7a99375/)

LinkedIn --------------------------------------

Email --------------------------------------

[!(https://media.forgecdn.net/attachments/description/1431298/description_4a3a93ae-5d63-4880-8a0f-95bba08ab917.png)](https://buymeacoffee.com/infodavik)

Buy me a beer --------------------------------------

[!(https://media.forgecdn.net/attachments/description/1431298/description_6e867e66-3219-466c-b28d-98604176ae7d.webp)](https://ko-fi.com/infodavik)

Ko-fi