🌙 cNightVision 🌙

Lightweight • Persistent • Fully Customizable Night Vision

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

---

[![Watch Video](https://img.shields.io/badge/🎥_Watch_Video-Click_Here-red?style=for-the-badge)](https://streamable.com/fpr71g)

[![Watch Video](https://img.shields.io/badge/🎥_Watch_Video-Click_Here-red?style=for-the-badge)](https://streamable.com/286es4)

--- ## ✨ 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 ```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) ```yml 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 ```yml enabled: - 00000000-0000-0000-0000-000000000000 blocked: [] ``` ### 📄 auto.yml ```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.

cNightVision

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details