NightSkipper

# 🌙 NightSkipper — Smart Night Skip for Minecraft **NightSkipper** is a lightweight and reliable plugin that automatically skips the night when a **configured percentage of players** in a world are sleeping. Supports **EssentialsX AFK**, **vanish**, and **spectator mode**. ## 🧩 Version Compatibility | **Plugin version** | **Supported Paper** | **Java** | |--------------------|-----------------------|----------| | `1.4.0` | `1.20` – `26.2` | 25 | | `1.3.0` | `1.20` – `1.21.11` | 21 | ## ✨ Features ✅ **Flexible world configuration** — choose which worlds the night skip works in ✅ **Customizable sleep percentage** — from 0% to 100% of players required to skip night ✅ Supports **AFK and Vanish players** from EssentialsX ✅ Players in **Spectator mode** or with the `essentials.sleepingignored` permission are ignored ✅ Sleep progress displayed via **ActionBar** ✅ Custom chat and ActionBar messages using MiniMessage ✅ Anti-spam protection to prevent repeated skipping ✅ Full **multi-world** support ✅ `/nskipper reload` command to reload the config without restarting the server ## ⚙️ How It Works 1. A player goes to sleep → everyone in the world sees an ActionBar: `Sleeping: 1/4 | Needed: 1` 2. When the required fraction of players is asleep (or AFK) — countdown begins: - Message appears: **"Night is being skipped..."** - After **~3 seconds**, the night is skipped. 3. The world transitions to morning, storms and rain are cleared. ## 🧩 Permissions | Permission | Description | |-------------------------------|---------------------------------------------------------| | `nskipper.admin` | Allows using the `/nskipper reload` command | | `essentials.sleepingignored` | Player is ignored in sleep calculations (e.g., admin) | ## 🔧 Configuration The file `plugins/NightSkipper/config.yml` is automatically created on first launch: ```yml # Night skip settings enabled-worlds: - "world" # Start times for day and night (in Minecraft ticks) day-time: 0 night-time: 12516 # Percentage of players required to skip night (0.5 = 50%) sleep-percentage: 0.5 # Messages with MiniMessage support messages: no-permission: "<red>You do not have permission to use this command." reload-success: "<green>NightSkipper: config reloaded!" reload-usage: "<yellow>Usage: /nskipper reload" night-skipping: "<green>Night is being skipped..." sleep-progress: "<yellow>Sleeping: <gold>{sleeping}/{total}</gold> | Needed: <red>{needed}</red>" ```` ## 💬 Player Messages * In chat: > Night is being skipped... * In ActionBar: > Sleeping: 2/5 | Needed: 1 * Config messages can be customized with MiniMessage tags (`<green>`, `<gold>`, `<red>`, etc.) ## 🛠️ Installation 1. Download the **latest release** 2. Place the `.jar` in your server’s `plugins/` folder 3. Restart the server 4. Configure settings in `plugins/NightSkipper/config.yml` 5. Use `/nskipper reload` to apply config changes 6. Enjoy skipping the night 🌄 ## ⚡ Quick Start The plugin is preconfigured for the default world with a 50% sleep threshold. Just install the `.jar` and start using NightSkipper.