cNightVision

🌙 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 on/off · Enable or disable for a player · cnightvision.admin
/nv block · Block a player from using it · cnightvision.admin
/nv unblock · 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.