# Minecraft Progression and Ability Enhancement Plugin
Growth Wings is a Minecraft plugin that introduces a player progression system based on kills, dodges, and collected experience points (XP). Players improve their abilities as they play: earning kills unlocks flight and increases flight speed, downward movement increases walking speed, and collecting XP increases maximum health. Player progression is stored using Minecraft's Persistent Data Container, allowing stats to persist between sessions. The plugin also includes a command to view individual player statistics.
- Make sure your server runs Paper 1.21.11 or a compatible version.
- Install Java 21 or newer.
- Download or build the plugin JAR.
- Place the generated
plugin.jarfile into your server'spluginsfolder. - Restart the server.
- Check the server console to confirm that the plugin has loaded successfully.
- Install Maven and Java 21.
- Clone or download the project source code.
- Open a terminal in the project directory.
- Run:
mvn clean package- Find the generated JAR in the
targetdirectory. - Copy the JAR into your Paper server's
pluginsfolder and restart the server.
- Join the Minecraft server.
- Your progression statistics are initialized automatically when you join for the first time.
- Earn player kills to increase your kill count. Having at least one kill unlocks flight, and each additional kill increases your flight speed.
- Move downward to increase your dodge count. Each recorded downward movement increases your walking speed.
- Collect XP to increase your accumulated XP and maximum health.
- Use
/statsto view your current kills, dodges, and accumulated XP.
- Kills: Unlock flight after the first kill and increase flight speed with each additional kill.
- Dodges: Increase walking speed whenever downward player movement is detected.
- XP: Increase maximum health by 0.1 health points per accumulated XP point.
| Command | Description |
|---|---|
/stats |
Displays your current kills, dodges, and accumulated XP. |
- Player statistics are stored in Minecraft's Persistent Data Container.
- Progression is tracked individually for each player.
- Ability updates occur when relevant gameplay events are detected.
- Player movement, deaths, XP collection, and join events are handled automatically.
- The plugin uses the Paper API and Adventure text components.
Growth Wings – Minecraft Player Progression Plugin
Growth Wings is a Minecraft plugin that makes player progression directly connected to gameplay. Players become more capable as they earn kills, move around, and collect experience. The plugin introduces three progression statistics: kills, dodges, and XP. Each statistic contributes to a different player ability, creating a simple progression system that rewards continued activity on your server.
MAIN FEATURES
Kill-Based Flight Progression Players unlock the ability to fly after earning their first player kill. Every additional kill increases their flight speed, allowing their flight ability to improve as their kill count grows.
Dodge-Based Movement Progression The plugin tracks downward player movement as dodges. Each recorded movement increases the player's walking speed, making movement progressively faster.
XP-Based Health Progression Players gain additional maximum health as they collect experience points. Every accumulated XP point adds 0.1 to their maximum health.
Persistent Player Statistics Kills, dodges, and accumulated XP are saved in each player's Minecraft Persistent Data Container. Their progression statistics remain available when they leave and rejoin the server.
Player Statistics Command Players can use /stats to view their current kill count, dodge count, and accumulated XP.
WHAT YOU RECEIVE
- The Growth Wings Minecraft plugin.
- Compiled plugin JAR when provided with the release.
- Java source code for the plugin.
- Maven project configuration.
- Plugin configuration metadata.
- Built-in /stats command.
- Automatic player progression tracking.
INSTALLATION
- Ensure your Minecraft server is running Paper 1.21.11 or a compatible version.
- Make sure Java 21 or newer is installed.
- Download the Growth Wings plugin JAR.
- Open your Minecraft server directory.
- Place the plugin JAR inside the plugins folder.
- Restart your server.
- Check the server console to confirm that the plugin has loaded.
BUILDING FROM SOURCE
- Install Java 21 and Maven.
- Download or clone the project source code.
- Open a terminal in the project directory.
- Run the command: mvn clean package
- Locate the generated JAR inside the target directory.
- Copy the JAR into your server's plugins folder.
- Restart your server.
HOW TO USE
Once installed, Growth Wings starts tracking player progression automatically.
- Earn player kills to unlock flight and improve flight speed.
- Move downward to accumulate dodge statistics and increase walking speed.
- Collect XP to increase your maximum health.
- Type /stats in-game to view your current progression.
No manual player setup or additional configuration is required.
REQUIREMENTS
- Minecraft server running Paper 1.21.11 or compatible.
- Java 21 or newer.
- Maven for building from source.
- A server that supports Bukkit/Paper plugins.
IMPORTANT GAMEPLAY NOTES
The current dodge detection counts downward player movement events rather than detecting specific dodge actions. It does not implement a dedicated dodge mechanic.
The flight feature grants Minecraft flight permission and increases flight speed; it does not create visible wing models or cosmetic wing effects.
Walking speed and flight speed are adjusted directly through the Minecraft player attributes.
The XP progression uses accumulated XP gained through experience change events, rather than the player's current XP level.
Growth Wings provides a straightforward foundation for kill-based, movement-based, and XP-based player progression without requiring additional dependencies beyond the Paper API.
More Minecraft plugin projects by EnderDevelopment: https://github.com/EnderDevelopment