NoFullBright

NoFullBright

NoFullBright is a small Paper/Spigot plugin that detects likely client-side "fullbright" use in configured worlds and runs a configurable command when a player exceeds the warning threshold.

Features

- Periodic server-side checks for low-light conditions where players should not be able to see clearly. - Configurable list of worlds where the checks are active. - Configurable command executed when a player is detected repeatedly in suspicious conditions (supports placeholders). - Lightweight and minimal: no commands or extra listeners by default.

How it works

Every scheduled interval (default: 200 ticks initial delay and 200 ticks between runs) the plugin scans all players in the configured worlds and evaluates each player:

- The player is considered "in the dark" if the block light level at the player's feet is less than 2 and the player's Y is below 40. - If the player does not have Night Vision or Glowing potion effects and is not holding a torch in either hand, the plugin increments a per-player internal warning counter.

Note: players are only checked when they are in Survival game mode. Players in Creative or Spectator mode are ignored by the checks. - When the warning counter reaches the configured threshold (default 5), the plugin executes the configured `report-command` (with the `%player%` and `%world%` placeholders) and resets that player's counter. - If the player moves back to a safe state, the warning counter is decremented over time until it reaches 0.

This approach attempts to reduce false positives by requiring repeated detections before taking action.

Configuration (`config.yml`)

Default `config.yml` created by the plugin:

```yaml

NoFullBright configuration

worlds: list of world names where the anti-fullbright check runs

report-command: command executed on violation. You can use %player% and %world% placeholders.

worlds: - hardcore

report-command: 'report %player% utilizzo della fullbright in %world%' ```

- `worlds` (list) — exact world names where checks will run. Modify this list to include all worlds where you want the anti-fullbright check active. - `report-command` (string) — the command executed by the server console when a player reaches the warning threshold. The plugin replaces `%player%` and `%world%` with the player's name and world name respectively. Make sure the command exists on your server (for example a moderation/reporting plugin). If the command is not available, nothing fatal will happen but no useful action will be taken.

Placeholders

- `%player%` — replaced with the player's name. - `%world%` — replaced with the world name.

Recommendations & tuning

- If your world names vary (for example `hardcore_1`, `hardcore_2`) update `worlds` accordingly. - If you want a different sensitivity, I can add configurable options for: - `light-threshold` (default 2) - `y-limit` (default 40) - `warning-count` (default 5) - `tick-interval` (scheduler delay/period)

Troubleshooting

- No action occurs on violation: ensure the command set in `report-command` actually exists and is executable by the server console (e.g., a `report` command provided by another plugin). - Too many false positives: tell me in the issues page - Plugin not shown in `/plugins`: confirm the JAR filename is correct and server logs show it loaded; check `server.log` for startup errors.

License

Use as you wish. No warranty provided.