{"id":26935867,"url":"https://github.com/4k1d3v/floatingitemplugin","last_synced_at":"2026-05-10T05:46:58.319Z","repository":{"id":285689657,"uuid":"958972956","full_name":"4K1D3V/FloatingItemPlugin","owner":"4K1D3V","description":"FloatingItemPlugin is a lightweight, industrial-grade Minecraft plugin for Paper 1.21.4 that allows players to create and manage floating items with customizable animations.","archived":false,"fork":false,"pushed_at":"2025-04-02T05:48:35.000Z","size":1,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-02T06:31:21.306Z","etag":null,"topics":["hardfork","java","maven","minecraft","minecraft-plugin","paper-api","paper-plugin","papermc","spigot-plugin"],"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}},"created_at":"2025-04-02T04:08:24.000Z","updated_at":"2025-04-02T05:56:14.000Z","dependencies_parsed_at":"2025-04-02T06:41:32.216Z","dependency_job_id":null,"html_url":"https://github.com/4K1D3V/FloatingItemPlugin","commit_stats":null,"previous_names":["4k1d3v/floatingitemplugin"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4K1D3V%2FFloatingItemPlugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4K1D3V%2FFloatingItemPlugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4K1D3V%2FFloatingItemPlugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4K1D3V%2FFloatingItemPlugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/4K1D3V","download_url":"https://codeload.github.com/4K1D3V/FloatingItemPlugin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246811311,"owners_count":20837753,"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","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":["hardfork","java","maven","minecraft","minecraft-plugin","paper-api","paper-plugin","papermc","spigot-plugin"],"created_at":"2025-04-02T12:19:48.061Z","updated_at":"2026-05-10T05:46:58.289Z","avatar_url":"https://github.com/4K1D3V.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FloatingItemPlugin\n\n![GitHub](https://img.shields.io/github/license/4K1D3V/FloatingItemPlugin)\n\n**FloatingItemPlugin** is a lightweight, industrial-grade Minecraft plugin for Paper 1.21.4 that allows players to create and manage floating items with customizable animations. Built with Java 21, it leverages modern features like virtual threads and sealed interfaces for performance and maintainability.\n\n## Features\n\n- **Floating Items**: Spawn items that hover with configurable animations (Sine, Bounce, Linear).\n- **Customizable**: Adjust animation speed, height, rotation, particles, and sounds via `config.yml`.\n- **Commands**: Create, remove, list, move, and manage floating items with an intuitive command system.\n- **Interact Actions**: Define what happens when players click items (pickup, remove, teleport, or run a command).\n- **Data Persistence**: Saves floating items to `data.yml` with automatic backups.\n- **Performance**: Optimized with parallel streams for large-scale use and virtual threads for async operations.\n\n## Installation\n\n1. **Download**: Grab the latest `.jar` from the [Releases](https://github.com/4K1D3V/FloatingItemPlugin/releases) page.\n2. **Place in Server**: Drop the `.jar` file into your server's `plugins` folder.\n3. **Start Server**: Run your Paper 1.21.4 server to generate the default configuration files.\n4. **Configure**: Edit `plugins/FloatingItemPlugin/config.yml` to customize settings (see [Configuration](#configuration)).\n\n## Requirements\n\n- **Server**: Paper 1.21.4 (or compatible forks)\n- **Java**: Java 21 (required for compilation and runtime)\n\n## Commands\n\nAll commands require the `floatitem.admin` permission (default: OP only).\n\n| Command                        | Description                                  |\n|--------------------------------|----------------------------------------------|\n| `/floatitem create`            | Create a floating item with the held item    |\n| `/floatitem remove \u003cid\u003e`       | Remove a floating item by its UUID           |\n| `/floatitem list [page]`       | List all active floating items (paginated)   |\n| `/floatitem reload`            | Reload the configuration file                |\n| `/floatitem setpattern \u003cid\u003e \u003cpattern\u003e` | Set animation pattern (SINE, BOUNCE, LINEAR) |\n| `/floatitem move \u003cid\u003e \u003cx\u003e \u003cy\u003e \u003cz\u003e` | Move a floating item to new coordinates      |\n| `/floatitem removeall`         | Remove all floating items                    |\n| `/floatitem help`              | Display command help                         |\n\n### Tab Completion\n- Full tab completion support for subcommands, UUIDs, patterns, and coordinates.\n\n## Configuration\n\nThe `config.yml` file is generated in `plugins/FloatingItemPlugin/` on first run. Below are the key options:\n\n```yaml\nanimation:\n  hover-amplitude: 0.1       # Height of hover (0.0 to 1.0)\n  rotation-speed: 0.05       # Rotation speed (radians/sec, 0.0 to 1.0)\n  update-frequency: 1        # Animation update ticks (1 to 20)\n  default-pattern: \"SINE\"    # Default pattern: SINE, BOUNCE, LINEAR\nitem:\n  spawn-height: 1.5          # Height above spawn point (0.5 to 3.0)\n  allowed-types: []          # Allowed item types (empty = all allowed)\neffects:\n  particles: false           # Enable particle effects\n  particle-type: \"FLAME\"     # Particle type (Bukkit Particle names)\n  particle-count: 2          # Particles per update (1 to 50)\n  interact-particle: \"HEART\" # Particle on interact\n  interact-particle-count: 5 # Interact particle count (1 to 50)\nsounds:\n  success: \"ENTITY_EXPERIENCE_ORB_PICKUP\" # Success sound\n  error: \"BLOCK_ANVIL_LAND\"               # Error sound\n  info: \"BLOCK_NOTE_BLOCK_PLING\"          # Info sound\n  warning: \"ENTITY_VILLAGER_NO\"           # Warning sound\n  interact: \"ENTITY_ITEM_PICKUP\"          # Interact sound\n  volume: 1.0              # Sound volume (0.0 to 2.0)\n  pitch: 1.0               # Sound pitch (0.5 to 2.0)\ninteract:\n  action: \"PICKUP\"         # Action on click: NONE, PICKUP, REMOVE, TELEPORT, COMMAND\n  command: \"say %player% interacted with a floating item\" # Command if action is COMMAND\nworlds:\n  allowed-worlds: []       # Allowed worlds (empty = all allowed)\nbackup:\n  enabled: true            # Enable data backups\n  max-backups: 5           # Max number of backups (1 to 10)\n```\n\n### Data Persistence\n- Floating items are saved to `plugins/FloatingItemPlugin/data.yml`.\n- Backups are stored in `plugins/FloatingItemPlugin/backups/` if enabled.\n\n## Permissions\n\n- `floatitem.admin`: Grants access to all `/floatitem` commands (default: OP).\n\n## Building from Source\n\n1. **Clone the Repository**:\n   ```bash\n   git clone https://github.com/4K1D3V/FloatingItemPlugin.git\n   cd FloatingItemPlugin\n   ```\n2. **Build with Maven**:\n   ```bash\n   mvn clean package\n   ```\n3. **Output**: The `.jar` will be in the `target/` folder.\n\n### Prerequisites\n- Java 21 JDK\n- Maven 3.6+\n\n## Contributing\n\nContributions are welcome! Follow these steps:\n\n1. **Fork** the repository.\n2. **Create** a feature branch (`git checkout -b feature/YourFeature`).\n3. **Commit** your changes (`git commit -m \"Add YourFeature\"`).\n4. **Push** to your branch (`git push origin feature/YourFeature`).\n5. **Open** a Pull Request.\n\nPlease ensure your code follows the existing style and includes tests where applicable.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Credits\n\n- **Author**: KiteGG\n- **Built with**: Java 21, Paper API","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F4k1d3v%2Ffloatingitemplugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F4k1d3v%2Ffloatingitemplugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F4k1d3v%2Ffloatingitemplugin/lists"}