GalaxyWars

# GalaxyWars 🌌 **The Ultimate Kinetic Combat & Physics Engine for Minecraft (Paper 1.19.4+)**    **GalaxyWars** transforms Minecraft combat by introducing vector-based physics and telekinetic abilities. Move beyond simple sword swinging—launch enemies into the air, pull targets into striking range, and leap across the map with fluid, responsive controls. Designed for RPG servers, Minigames, and Sci-Fi enthusiasts. --- ### 🚧 🚀 A Note on the Future **GalaxyWars is just getting started.** While this v1.0 release establishes our core engine, it is only the foundation. Our roadmap includes massive expansions aimed at bringing the authentic feel of the **world's most popular space opera franchise** to your server. Future updates are already in development to introduce: * **Iconic Weaponry:** Fully functional plasma swords (with ignition mechanics) and blaster combat. * **Expanded Abilities:** Advanced powers like Choke, Lightning, Sword Throw, and Mind Tricks. * **Deep Gameplay:** Faction systems (Light vs Dark), open-world roleplay modes, and intricate leveling trees. * **Total Customization:** Tools for server owners to tailor every aspect of the galaxy to their needs. *Stay tuned. The galaxy is expanding.* --- ## ⚡ Features (v1.0 "The Awakening") ### 🔮 The Powers Unlock the ability to manipulate gravity and physics using a stamina-based Energy system. * **Power Push:** Unleash a shockwave that launches multiple enemies in a cone in front of you. * **Power Pull:** Yank distant targets directly to your feet to close the gap or start a combo. * **Power Jump:** A vertical velocity boost to scale buildings or escape danger. ### 🎮 Fluid Control Scheme Forget clumsy GUI menus in the middle of a fight. GalaxyWars uses a "Loadout" system designed for fast-paced combat. * **Cast Ability:** Press **[F]** (Swap Hands Key). * **Cycle Ability:** Hold **[Sneak]** + Press **[F]**. * *Works seamlessly with an empty hand or while holding a weapon.* ### 🔋 Reactive HUD * **Minimalist UI:** The Energy Bar only appears when you are using powers or regenerating, keeping your screen clean for immersion. * **Feedback:** Visual particles and sound effects for every ability. --- ## 📦 Installation 1. Ensure your server is running **Paper 1.19.4** or higher (or a fork like Purpur). 2. Download the `GalaxyWars.jar`. 3. Place it in your `plugins/` folder. 4. Restart the server. --- ## 🕹️ How to Play ### Getting Started On your first join, you will automatically unlock the starter abilities (Push, Pull & Jump). ### The Controls | Action | Keybind | Description | | :--- | :--- | :--- | | **Cast Active Power** | `F` (Swap Hands) | Uses energy to cast the selected power. | | **Switch Power** | `Shift` (Sneak) + `F` | Cycles through your unlocked powers. | --- ## 🔗 Links & Source GalaxyWars is open-source and free. * [GitHub Source Code](https://github.com/MrLucaDev/GalaxyWars) (Report bugs & contribute!) --- ## ⚖️ License This project is licensed under the **GNU General Public License v3.0**. You are free to use, modify, and distribute this software, provided that any modifications are also open-sourced under the same license. _Disclaimer: This project is a fan creation inspired by sci-fi classics. It is not affiliated with or endorsed by Lucasfilm Ltd. or Disney._