# 🌙 SleepPolls

Modern sleep voting for Paper servers.

--- SleepPolls 2.0 is a modern, lightweight sleep voting plugin built specifically for Paper servers. Instead of requiring every player to sleep, SleepPolls starts an interactive vote when someone enters a bed, allowing active players to decide whether the night should be skipped. Built using modern Paper APIs, Adventure Components, HikariCP, SQLite, and MariaDB. --- ## ✨ Features ### 🗳️ Interactive Sleep Polls When a player enters a bed: - A vote automatically starts - Players can vote YES or NO - Clickable vote buttons appear in chat - Vote requirements are calculated automatically - Nights skip instantly once enough votes are reached ### 📊 Live Vote Tracking - BossBar countdowns - ActionBar updates - Real-time vote counts - Remaining time display - Required vote display ### 😴 Smart Eligibility Detection SleepPolls only counts active players. Automatically excludes: - AFK players (EssentialsX) - Spectators - Dead players - Offline players ### 📈 Statistics System Track: - Total Votes - Successful Votes - Failed Votes - Polls Started - Nights Skipped ### 🏆 Leaderboards Compete with other players using: ```text /sp top ``` ### 💾 Database Support Choose between: - SQLite - MariaDB All statistics are stored persistently. ### ⚙️ Fully Configurable Configure: - Vote duration - Required vote percentage - BossBars - Sounds - Weather clearing - World blacklist - Database backend ### 🚀 Lightweight & Modern Built with: - Java 21+ - Paper API - Adventure API - HikariCP - Async database operations No ProtocolLib. No NMS. --- ## 🎮 Commands | Command | Description | |----------|-------------| | `/sp help` | Display help menu | | `/sp version` | Show plugin version | | `/sp status` | View current poll | | `/sp yes` | Vote YES | | `/sp no` | Vote NO | | `/sp stats` | View personal statistics | | `/sp top` | View leaderboard | | `/sp bossbar` | Toggle BossBar | | `/sp reload` | Reload configuration | Aliases: ```text /sp /sleeppoll ``` --- ## 🔐 Permissions | Permission | Description | |------------|-------------| | `sleeppolls.reload` | Reload configuration | | `sleeppolls.bossbar` | Toggle BossBar | --- ## ⚙️ Example Configuration ```yaml poll-duration-seconds: 20 required-percentage: 50 bossbar: enabled: true sounds: enabled: true database: type: SQLITE ``` --- ## 📊 Statistics View your statistics: ```text /sp stats ``` Track: - Total votes cast - Successful votes - Failed votes - Polls started - Nights skipped --- ## 🏆 Leaderboards See the most active sleepers: ```text /sp top ``` Perfect for SMP communities. --- ## 🌍 World Blacklist Disable sleep voting in specific worlds: ```yaml worlds: blacklist: - lobby - minigames ``` --- ## 💾 Database Backends ### SQLite ```yaml database: type: SQLITE ``` ### MariaDB ```yaml database: type: MARIADB mariadb: host: localhost port: 3306 database: sleeppolls username: root password: password pool-size: 5 ``` --- ## 🚀 Installation ### Requirements - Paper - Java 21+ - Minecraft 1.21+ Optional: - EssentialsX (AFK detection) ### Setup 1. Download SleepPolls 2.0 2. Place the jar in your plugins folder 3. Start the server 4. Configure `config.yml` 5. Run: ```text /sp reload ``` or restart the server. --- ## 🔥 Why SleepPolls? Unlike many older sleep vote plugins: ✅ Interactive Adventure Components ✅ Live BossBar tracking ✅ ActionBar countdowns ✅ SQLite & MariaDB support ✅ Persistent statistics ✅ Leaderboards ✅ AFK detection ✅ World blacklist support ✅ Modern Paper API architecture ✅ Open Source --- ## 🗺️ Roadmap - Velocity network-wide sleep voting - PlaceholderAPI support - Localization support - Customizable messages - GUI voting interface - Web statistics dashboard - Per-world vote settings --- ## ❤️ Open Source SleepPolls is fully open source. Contributions, pull requests, suggestions, and bug reports are always welcome. GitHub: https://github.com/Amethyst-Developers/Sleep-Polls --- ## 📜 License Licensed under GNU GPL v3. Copyright © 2026 Monk (Monish), Amethyst Developers and contributors.

SleepPolls

2.0.0

1.0.0