🌙 cNightVision 🌙

Lightweight • Persistent • Fully Customizable Night Vision

No dependencies • Server-side only • Safe on every server

---

---

✨ What is cNightVision?

cNightVision gives your players clean, permanent Night Vision with one command. It remembers each player's choice, survives death, milk and restarts, can switch on automatically in the dark, and comes with a settings menu, admin tools, per-world control and full Arabic + English support.

💡 No Vault. No required plugins. Drop it in and it works.

---

🚀 Features

	Feature	Details
🔘	One-command toggle	/nv turns Night Vision on or off instantly
💾	Persistent	Stays enabled after death, relog and server restart
🥛	Milk-proof	Effect is restored automatically after drinking milk
👻	Clean effect	Hide particles and the effect icon (configurable)
⏱️	Duration	Permanent, or limited time in seconds
🌑	Auto Darkness	Turns on in caves and at night, off in the light
🖱️	Settings GUI	Simple menu with /nv settings
🛡️	Admin tools	Control other players, block and unblock
🌍	Disabled worlds	Turn the plugin off in chosen worlds
🌐	Bilingual	English and Arabic, every message editable
🧩	PlaceholderAPI	Show status in TAB, scoreboards, holograms
🔒	UUID storage	Data saved by UUID, never by name
🤝	Safe	Auto mode never removes an effect it did not apply
🪶	Lightweight	Light check every 2 seconds, no heavy per-tick work

---

📦 Versions

File	Minecraft	Java	Platforms
cnightvision-1.0.0.jar	1.20.x	17+	Paper • Purpur • Spigot • Bukkit
cnightvision-2.0.0.jar	1.21.x	21+	Paper • Purpur • Spigot • Bukkit
cnightvision-2.1.0.jar	26.x	25+	Paper • Purpur • Spigot • Bukkit

⚠️ Download the file that matches your Minecraft version.

---

🛠️ Installation

1. 📥 Download the correct .jar for your version.
2. 📂 Put it in your server's plugins/ folder.
3. 🔄 Restart the server.
4. ⚙️ Edit plugins/cNightVision/config.yml if you want.
5. ✅ Run /nv reload to apply changes.

✔️ No required dependencies.

---

🎮 Commands

Main command: /nv  |  Alias: /nightvision

👤 Player commands

Command	Description	Permission
/nv	Toggle Night Vision	cnightvision.use
/nv on	Enable	cnightvision.use
/nv off	Disable	cnightvision.use
/nv status	Show your status	cnightvision.use
/nv auto	Toggle Auto Darkness mode	cnightvision.auto
/nv settings	Open the settings menu	cnightvision.settings

🛡️ Admin commands

Command	Description	Permission
/nv player <name> on/off	Enable or disable for a player	cnightvision.admin
/nv block <name>	Block a player from using it	cnightvision.admin
/nv unblock <name>	Unblock a player	cnightvision.admin
/nv reload	Reload config, language and data	cnightvision.admin

---

🔑 Permissions

Permission	Default	Description
cnightvision.use	Everyone	Use /nv
cnightvision.auto	Everyone	Use Auto Darkness
cnightvision.settings	Everyone	Open the settings menu
cnightvision.admin	OP	Admin commands, reload, change language from the menu

---

🌑 Auto Darkness

Players enable it with /nv auto. Then the plugin:

• ✅ Turns Night Vision on when the light level is low (caves) or at night
• ✅ Turns it off when the player comes back to the light
• ✅ Stays separate from manual mode, so it never turns off what you enabled yourself
• ✅ Checks every 2 seconds by default, so it stays light on the server
• ✅ Fully adjustable: light levels, interval, night counts as dark or not

Setting	Meaning
light-level	At or below this, Night Vision turns on
light-level-off	At or above this, it turns off
night-counts-as-dark	Treat night in the overworld as dark
check-interval-ticks	How often to check (40 = 2 seconds)

---

🖱️ Settings Menu

Open it with /nv settings:

Button	Action
🟢 Night Vision	Turn on or off
🕒 Auto Mode	Turn Auto Darkness on or off
📖 Language	Switch between English and Arabic (admins only)
🔴 Close	Close the menu

---

🧩 PlaceholderAPI

Optional. It hooks in automatically when PlaceholderAPI is installed.

Placeholder	Output
%cnightvision_enabled%	true or false
%cnightvision_status%	ON or OFF (translated)
%cnightvision_auto%	Is Auto mode enabled?
%cnightvision_blocked%	Is the player blocked?
%cnightvision_world_allowed%	Allowed in the current world?

---

⚙️ Configuration Files

Generated in plugins/cNightVision/:

File	Purpose
config.yml	General settings
lang_en.yml	English messages
lang_ar.yml	Arabic messages
players.yml	Enabled and blocked players (UUIDs)
auto.yml	Players using Auto mode

📄 config.yml

# Language: en or ar
language: en

# Effect duration in seconds. 0 = permanent
duration: 0

# Hide particles and icon
hide-particles: true
hide-icon: true

# Worlds where night vision is disabled
disabled-worlds:
  - example_world

# Auto darkness mode
auto-darkness:
  enabled: true
  light-level: 6
  light-level-off: 9
  night-counts-as-dark: true
  check-interval-ticks: 40

📄 lang_en.yml (sample)

enabled: "&aNight Vision enabled."
disabled: "&cNight Vision disabled."
status-on: "&7Night Vision: &aON"
status-off: "&7Night Vision: &cOFF"
no-permission: "&cYou do not have permission."
blocked: "&cYou are blocked from using Night Vision."
world-disabled: "&cNight Vision is disabled in this world."
auto-on: "&aAuto Night Vision enabled (works in the dark)."
gui-title: "&8Night Vision Settings"

📄 players.yml

enabled:
  - 00000000-0000-0000-0000-000000000000
blocked: []

📄 auto.yml

players:
  - 00000000-0000-0000-0000-000000000000

---

🛡️ Safety & Performance

• 🔒 Data saved by UUID, so name changes never break anything
• 🪶 Auto mode uses a slow timer, not a per-tick check
• 🤝 Never removes a Night Vision effect that it did not apply
• 🧹 Tasks are cancelled cleanly when the plugin stops
• 🧩 Uses only the Bukkit/Spigot API, no NMS

---

❓ FAQ

Does it need PlaceholderAPI? No, it is optional.

Does it work with other plugins? Yes, it only uses the Bukkit/Spigot API.

Can I change the language? Yes: set language: ar or en in config.yml, then /nv reload.

I updated and the messages look old. Delete lang_en.yml and lang_ar.yml so they regenerate.

Which versions work? Use the file that matches your Minecraft version (see the Versions table).

---

🗺️ Roadmap

• [ ] Automatic data backups
• [ ] SQLite / MySQL storage
• [ ] WorldGuard and LuckPerms integration
• [ ] Forced mode for admins
• [ ] More settings in the menu

---

🇸🇦 بالعربي

cNightVision بلجن رؤية ليلية خفيف وسهل الاستخدام:

• 🔘 أمر /nv للتشغيل والإيقاف
• 💾 يحفظ حالتك بعد الموت والخروج وإعادة تشغيل السيرفر
• 🥛 يرجّع الرؤية لو شربت حليب
• 🌑 وضع تلقائي: يشتغل في الكهوف والليل ويطفي في الضوء (/nv auto)
• 🖱️ قائمة إعدادات /nv settings
• 🛡️ أدوات للإدارة: تحكم بلاعب، حظر وفك حظر
• 🌍 تعطيل البلجن في عوالم محددة
• 🌐 رسائل عربية وإنجليزية قابلة للتعديل
• 🧩 دعم PlaceholderAPI (اختياري)

لتفعيل العربي: ضع language: ar في config.yml ثم اكتب /nv reload.

---

⭐ If you enjoy cNightVision, please follow the project and leave feedback!

💬 Bugs and suggestions are always welcome.