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:

# 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.