[![Latest Release](https://gitlab.com/astrelion/launch-me/-/badges/release.svg)](https://gitlab.com/astrelion/launch-me/-/releases) [![pipeline status](https://gitlab.com/astrelion/launch-me/badges/main/pipeline.svg)](https://gitlab.com/astrelion/launch-me/-/commits/main) [![bStats Servers](https://img.shields.io/bstats/servers/9918?color=00695C)](https://bstats.org/plugin/bukkit/LaunchMe/9918) [![bStats Servers](https://img.shields.io/bstats/players/9918?color=00695C)](https://bstats.org/plugin/bukkit/LaunchMe/9918) [![Modrinth Downloads](https://img.shields.io/modrinth/dt/LpJBcYZv?logo=Modrinth&color=1bd96a&label=Modrinth&logoColor=1bd96a)](https://modrinth.com/plugin/launch-me) [![CurseForge Downloads](https://img.shields.io/curseforge/dt/434266?logo=CurseForge&label=CurseForge&color=f16436)](https://www.curseforge.com/minecraft/bukkit-plugins/launch-me) [![Hangar Downloads](https://img.shields.io/hangar/dt/LaunchMe?label=Hangar&color=2f4476)](https://hangar.papermc.io/ASTRELION/LaunchMe) [![Spigot Downloads](https://img.shields.io/spiget/downloads/87512?logo=SpigotMC&color=%23F7C539&label=Spigot)](https://spigotmc.org/resources/launch-me.87512)

# Launch Me Launch Me is a Minecraft plugin that allows players (or mobs) to ride on top of any projectile they shoot or throw. LaunchMe usage

**Features**: * Ride any projectile you shoot or throw! * Survival-friendly, with configurable costs like hunger, health, or items * Support for mobs to ride their projectiles * [Highly configurable](https://gitlab.com/astrelion/launch-me/-/blob/main/src/main/resources/config.yml) * [Editable messages](https://gitlab.com/astrelion/launch-me/-/blob/main/src/main/resources/lang.yml) * [Permission support](#permissions) * [Open-source](https://gitlab.com/astrelion/launch-me) :) ## Download - [**Modrinth**](https://modrinth.com/plugin/launch-me) (recommended) - [CurseForge](https://curseforge.com/minecraft/bukkit-plugins/launch-me) - [Hangar](https://hangar.papermc.io/ASTRELION/LaunchMe) (directs to Modrinth) - [Spigot](https://spigotmc.org/resources/launch-me.87512/) (directs to Modrinth) - [GitLab releases](https://gitlab.com/astrelion/launch-me/-/releases) ## Server Admins ### Installation 1. [Download the latest version of the plugin](https://modrinth.com/plugin/launch-me) (`launch-me-x.x.x.jar`) 2. Locate your server's `plugins` folder 3. Place `launch-me-x.x.x.jar` into your plugins folder 4. Restart or reload your server Optionally, edit the configuration files located in `plugins/LaunchMe/` ### Usage 1. Give yourself op or the `launchme.toggle` permission 2. Use `/launchme toggle` in-game to toggle projectile launching for yourself 3. By default, you need fireworks in your offhand for launching to work 4. Shoot an arrow, throw a snowball, etc. to launch! ### Configuration Edit the configuration in `config.yml` that was generated in the `LaunchMe` folder. The default `config.yml` can be found [here](src/main/resources/config.yml). You may also delete your configuration and a new one will be generated on the next server restart or reload. Descriptions of each configuration value is included in the file. ### Permissions | Permission | Description | |-------------------------|---------------------------------------------------------------------------------------| | `launchme.*` | grants all permissions below | | `launchme.help` | allows the user to use `/launchme` and `/launchme help` | | `launchme.reload` | allows the user to use `/launchme reload` | | `launchme.toggle.*` | allows the user to toggle launching for themselves and others with `/launchme toggle` | | `launchme.toggle` | allows the user to toggle launching for themselves | | `launchme.toggle.other` | allows the user to toggle launching for others | | `launchme.nocooldown` | allows the user to bypass the cooldown between launches | | `launchme.nocost` | allows the user to bypass all launching costs | | `launchme.update` | any user with this permission will get update notifications when available | ### Commands | Command | Description | |-----------------------------|--------------------------------------------------| | `/launchme` or `/lm` | Base command, shows help dialog | | `/launchme help [command]` | Shows help dialog | | `/launchme reload` | Reloads `config.yml` and `lang.yml` from file | | `/launchme toggle [player]` | Toggles launching for yourself or another player | *Arguments surrounded in `[]` are optional, arguments surrounded in `<>` are required.* ### Privacy This plugin uses [bStats](https://bstats.org) to gather anonymous usage [statistics](#statistics). You can see all gathered data [here](https://bstats.org/plugin/bukkit/LaunchMe/9918) (all are standard fields for most plugins, with the exceptions of "Projectiles Launched"). You may opt out of all data collection for all plugins by editing the `/plugins/bStats/config.yml` file. ## Developers **Please disable bStats on test servers!** ### Building *Launch Me requires Gradle and uses JDK 25 at the time of writing* 1. Download or clone the project. 2. Run `./gradlew build` 3. A new `launchme-x.x.x.jar` will be built under `build/libs/` ### Contributing 1. [Fork the repository](https://gitlab.com/astrelion/launch-me/-/forks/new) 2. Make changes in your fork 3. Submit a [merge request](https://gitlab.com/astrelion/launch-me/-/merge_requests/new) ## Issues & Feature Requests The best way to report an issue would be to open a new issue [here](https://gitlab.com/astrelion/launch-me/-/issues/new). Please try to be as descriptive as possible when reporting any issues :). You may also [open an issue](https://gitlab.com/astrelion/launch-me/-/issues/new) for new features you'd like to be added. ## Statistics [

](https://bstats.org/plugin/bukkit/LaunchMe/9918) ## [License](./LICENSE) ``` Launch Me Copyright (C) 2026 ASTRELION This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . ```

LaunchMe

3.0.0

2.2.1