{"id":27306264,"url":"https://github.com/4k1d3v/bedboost","last_synced_at":"2026-04-15T15:32:36.742Z","repository":{"id":287255042,"uuid":"964134616","full_name":"4K1D3V/BedBoost","owner":"4K1D3V","description":"BedBoost is a lightweight Minecraft plugin for Spigot 1.21.1 that enhances the bed mechanics by granting players configurable potion effects, particle animations, sounds, and titles when they wake up after skipping the night.","archived":false,"fork":false,"pushed_at":"2025-04-10T18:43:51.000Z","size":17,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-25T07:27:04.351Z","etag":null,"topics":["java","maven","minecraft","minecraft-plugin","paper-plugin","papermc","spigot-api","spigot-plugin","spigotmc"],"latest_commit_sha":null,"homepage":"https://ks.akii.pro","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/4K1D3V.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-10T18:35:15.000Z","updated_at":"2025-04-10T18:46:44.000Z","dependencies_parsed_at":"2025-04-12T03:59:20.819Z","dependency_job_id":"c08c15c4-b569-4fb7-9567-5475bc306c23","html_url":"https://github.com/4K1D3V/BedBoost","commit_stats":null,"previous_names":["4k1d3v/bedboost"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/4K1D3V/BedBoost","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4K1D3V%2FBedBoost","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4K1D3V%2FBedBoost/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4K1D3V%2FBedBoost/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4K1D3V%2FBedBoost/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/4K1D3V","download_url":"https://codeload.github.com/4K1D3V/BedBoost/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4K1D3V%2FBedBoost/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278343086,"owners_count":25971399,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","maven","minecraft","minecraft-plugin","paper-plugin","papermc","spigot-api","spigot-plugin","spigotmc"],"created_at":"2025-04-12T03:59:16.510Z","updated_at":"2025-10-04T16:51:12.198Z","avatar_url":"https://github.com/4K1D3V.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BedBoost\r\n\r\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/4K1D3V/bedboost?color=green)\r\n![GitHub issues](https://img.shields.io/github/issues/4K1D3V/bedboost)\r\n![GitHub license](https://img.shields.io/github/license/4K1D3V/bedboost)\r\n\r\n**BedBoost** is a lightweight Minecraft plugin for Spigot 1.21.1 that enhances the bed mechanics by granting players configurable potion effects, particle animations, sounds, and titles when they wake up after skipping the night. Designed with performance and scalability in mind, it’s perfect for both small servers and large-scale networks.\r\n\r\n## Features\r\n\r\n- **Configurable Potion Effects**: Apply multiple effects (e.g., Speed, Jump Boost) with customizable duration and amplifier.\r\n- **Dynamic Particle Animations**: Displays a rising spiral of configurable particles (e.g., `HAPPY_VILLAGER`) with adjustable offsets and count.\r\n- **Sound Effects**: Plays a sound (e.g., `BLOCK_NOTE_BLOCK_CHIME`) when waking up.\r\n- **Adventure Titles**: Shows a stylish \"Good Morning!\" title and subtitle using the Adventure API.\r\n- **Permission Support**: Restrict boosts to players with the `bedboost.effect` permission.\r\n- **Performance Optimizations**:\r\n    - Asynchronous config loading and particle scheduling.\r\n    - Precomputed particle offsets for efficient animations.\r\n    - Batch event processing for multi-player scenarios.\r\n- **Event Debouncing**: Prevents rapid boosting with a cooldown system.\r\n\r\n## Installation\r\n\r\n1. **Download**: Grab the latest `.jar` from the [Releases](https://github.com/4K1D3V/BedBoost/releases) page.\r\n2. **Place in Plugins Folder**: Drop `BedBoost.jar` into your Spigot server’s `plugins` folder.\r\n3. **Restart Server**: Start or restart your server to load the plugin.\r\n4. **Configure**: Edit `plugins/BedBoost/config.yml` to customize settings (see [Configuration](#configuration)).\r\n\r\n### Requirements\r\n- **Spigot**: Version 1.21.1\r\n- **Java**: 17 or higher\r\n- **Dependencies**:\r\n    - [Adventure Platform Bukkit](https://mvnrepository.com/artifact/net.kyori/adventure-platform-bukkit) (bundled or installed separately)\r\n\r\n## Configuration\r\n\r\nThe plugin generates a `config.yml` file in `plugins/BedBoost/` on first run. Here’s the default configuration:\r\n\r\n```yaml\r\neffects:\r\n  speed:\r\n    duration-ticks: 200    # 10 seconds\r\n    amplifier: 0          # Speed I\r\n  jump:\r\n    duration-ticks: 100   # 5 seconds\r\n    amplifier: 1          # Jump Boost II\r\nparticle:\r\n  type: \"HAPPY_VILLAGER\"  # Particle type (e.g., HAPPY_VILLAGER, DUST)\r\n  count: 3               # Particles per tick\r\n  offset-x: 0.5          # Horizontal spread\r\n  offset-y: 1.5          # Vertical height\r\n  offset-z: 0.5          # Depth spread\r\nsound: \"BLOCK_NOTE_BLOCK_CHIME\"  # Sound played on wake-up\r\n```\r\n\r\n### Options\r\n- **`effects`**: Add any valid potion effect (e.g., `regeneration`, `strength`).\r\n- **`particle.type`**: Use any Spigot particle name (see [Particle Enum](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html)).\r\n- **`sound`**: Use any Spigot sound name (see [Sound Enum](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html)).\r\n\r\n## Permissions\r\n\r\n- **`bedboost.effect`**\r\n    - **Description**: Allows players to receive the wake-up boost.\r\n    - **Default**: `true` (all players have it by default unless restricted).\r\n\r\nExample with LuckPerms:\r\n```\r\n/lp group default permission set bedboost.effect true\r\n```\r\n\r\n## Usage\r\n\r\n1. Place a bed in the Overworld.\r\n2. Sleep to skip the night.\r\n3. Wake up to enjoy:\r\n    - Configured potion effects (e.g., Speed, Jump Boost).\r\n    - A spiral particle animation.\r\n    - A wake-up sound.\r\n    - A \"Good Morning!\" title.\r\n\r\n## Building from Source\r\n\r\n### Prerequisites\r\n- **Maven**: For dependency management.\r\n- **JDK**: 17 or higher.\r\n\r\n### Steps\r\n1. Clone the repository:\r\n   ```bash\r\n   git clone https://github.com/4K1D3V/BedBoost.git\r\n   cd bedboost\r\n   ```\r\n2. Build the plugin:\r\n   ```bash\r\n   mvn clean package\r\n   ```\r\n3. Find the `.jar` in `target/BedBoost-1.0.0.jar`.\r\n\r\n### Dependencies\r\n- `spigot-api:1.21.1-R0.1-SNAPSHOT` (provided)\r\n- `adventure-platform-bukkit:4.3.2` (compile)\r\n\r\n## Performance\r\n\r\n- **Async Operations**: Config loading and particle scheduling run off the main thread.\r\n- **Particle Pooling**: Precomputed offsets reduce runtime calculations.\r\n- **Batch Processing**: Multiple players waking up are handled efficiently in batches.\r\n- **Thread Safety**: Uses `ConcurrentHashMap` and `ConcurrentLinkedQueue` for multi-threaded environments.\r\n\r\n## Contributing\r\n\r\nContributions are welcome! Here’s how to get started:\r\n\r\n1. Fork the repository.\r\n2. Create a feature branch (`git checkout -b feature/awesome-idea`).\r\n3. Commit your changes (`git commit -m \"Add awesome idea\"`).\r\n4. Push to your branch (`git push origin feature/awesome-idea`).\r\n5. Open a Pull Request.\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n## Credits\r\n\r\n- **Author**: [KiteGG](https://github.com/4K1D3V)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F4k1d3v%2Fbedboost","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F4k1d3v%2Fbedboost","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F4k1d3v%2Fbedboost/lists"}