# LightVision ### *See in the dark. On your terms.* > Lightweight night vision management plugin — toggle, control, block and automate, all from a single `config.yml`. ---

[![bStats](https://bstats.org/signatures/bukkit/LightVision.svg)](https://bstats.org/plugin/bukkit/LightVision%20by%20LucasTHCR/32440) --- ## ✨ Features | Feature | Description | |---|---| | **Self-Toggle Command** | Players turn their own night vision on/off with `/lv`. No permissions plugin required. | | **Staff Control** | Turn night vision on/off for any online player with `/lv [on/off]`. | | **Block & Unblock** | Lock a specific player out of night vision entirely with `/lv block`, and lift it again with `/lv unblock`. Works even for offline players. | | **Bypass Permission** | Give trusted staff `lv.bypass.block` so they can't be blocked by other admins. | | **World Blacklist** | Automatically disable and block night vision in specific worlds (Nether, event maps, etc.). | | **Darkness Trigger** | Night vision switches on automatically once the light level drops below a threshold — perfect for caves. | | **Soft Fade Transition** | A brief blindness flash when night vision turns off or gets blocked, so the switch to darkness doesn't feel jarring. | | **Remember State** | Player state survives rejoins and server restarts. | | **MiniMessage Support** | Every message supports hex colors, gradients and `` — chat, actionbar or title, your choice. | | **Actionbar Mode** | Show feedback in the actionbar instead of chat, if you prefer a cleaner look. | | **Title Feedback** | Optional on-screen titles for toggling, blocking and unblocking. | | **Persistent Data** | Player states and block lists are saved to `data.yml` and restored on startup. | | **bStats Metrics** | Anonymous usage statistics — [view stats](https://bstats.org/plugin/bukkit/LightVision%20by%20LucasTHCR/32440). | | `/lv reload` | Reload the config without restarting the server. | --- ## 🖥️ Server Software | | Paper | Spigot | Purpur | |---|---|---|---| | Toggle & staff commands | ✅ | ✅ | ✅ | | Hex & gradient messages | ✅ | ✅ | ✅ | | Titles & actionbar | ✅ | ✅ | ✅ | | Darkness trigger | ✅ | ✅ | ✅ | > **Recommended:** Paper or Purpur for full feature support. → [papermc.io/downloads](https://papermc.io/downloads) --- ## 📦 Dependencies None. LightVision runs entirely standalone — no LuckPerms, no PlaceholderAPI, no other plugins required. --- ## 🎨 Color Support | Format | Example | Works in | |---|---|---| | Hex | `<#FF5733>text` | Everywhere | | Gradient | `text` | Everywhere | | Rainbow | `text` | Everywhere | | Bold + color | `text` | Everywhere | --- ## ⚙️ Configuration Everything is controlled from `config.yml`: ```yaml settings: # Keep a player's on/off state across restarts and rejoins remember-state: true # Show feedback in the actionbar instead of chat actionbar-mode: false # Show an on-screen title for block/unblock events show-titles: true fade: enabled: true duration-ticks: 20 darkness-trigger: enabled: false light-level: 4 check-interval-ticks: 40 world-blacklist: - "world_nether" messages: "on": "Night vision on. Enjoy the view!" "off": "Night vision off. Welcome back to the dark." blocked-self: "You've been blocked from using night vision. Take it up with staff." # ...and every other message in the plugin, fully customizable ``` --- ## 🔑 Commands & Permissions | Command | Permission | Default | |---|---|---| | `/lv` | `lv.use` | Everyone | | `/lv [on/off]` | `lv.admin` | OP | | `/lv block ` | `lv.admin` | OP | | `/lv unblock ` | `lv.admin` | OP | | `/lv reload` | `lv.admin` | OP | | — | `lv.bypass.block` | OP | --- ## 👥 Credits | | | |---|---| | **LucasTHCR** | Author — full plugin design, config system, darkness trigger, fade transitions, MiniMessage support, bStats integration | Discord: [dc.gg/paperstream](https://dc.gg/paperstream)

LightVision

1.0-RELEASE