LightVision

See in the dark. On your terms.

Lightweight night vision management plugin — toggle, control, block and automate, all from a single config.yml.

---

---

✨ 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 <player> [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 <rainbow> — 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.
/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

---

📦 Dependencies

None. LightVision runs entirely standalone — no LuckPerms, no PlaceholderAPI, no other plugins required.

---

🎨 Color Support

Format	Example	Works in
Hex	<#FF5733>text</#FF5733>	Everywhere
Gradient	<gradient:#55FF55:#00AA00>text</gradient>	Everywhere
Rainbow	<rainbow>text</rainbow>	Everywhere
Bold + color	<bold><red>text</red></bold>	Everywhere

---

⚙️ Configuration

Everything is controlled from config.yml:

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": "<gradient:#55FF55:#00AA00>Night vision on. Enjoy the view!</gradient>"
  "off": "<gradient:#FF5555:#AA0000>Night vision off. Welcome back to the dark.</gradient>"
  blocked-self: "<red>You've been blocked from using night vision. Take it up with staff.</red>"
  # ...and every other message in the plugin, fully customizable

---

🔑 Commands & Permissions

Command	Permission	Default
/lv	lv.use	Everyone
/lv <player> [on/off]	lv.admin	OP
/lv block <player>	lv.admin	OP
/lv unblock <player>	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