# 📏 AliienResize **A premium, high-performance player scaling plugin for Minecraft Servers.** [![Paper](https://img.shields.io/badge/Paper-1.21-blue?style=flat-square)](https://papermc.io/) [![Java](https://img.shields.io/badge/Java-21-orange?style=flat-square)](https://adoptium.net/) [![Folia](https://img.shields.io/badge/Folia-Supported-success?style=flat-square)](https://github.com/PaperMC/Folia)

--- ## 🤔 What Exactly Does This Plugin Do? **AliienResize** is a dedicated cosmetic plugin that allows players to physically change their in-game size (scale) using an interactive GUI or commands. Whether you want players to become tiny like an ant or massive like a giant, this plugin handles the scale modification and prevents them from using sizes in restricted conditions (such as way too small spaces or blacklisted worlds). It also features a massive built-in economy system so you can sell specific sizes to players using almost any currency plugin you can think of, also including ways for you to implement your own custom currencies. ## ⚡ Why Choose AliienResize? You might be wondering: *"Can't I just use another plugin to simply run the `/attribute` command?"* While you technically *could*, it isn't recommended for your server performance and your players. Here is why AliienResize is the better choice: * **True Thread Safety:** Such plugins run unoptimized logic do it them usually serving a lot of purposes. AliienResize is natively and specifically made for resizing only, so it is very optimized for this specific area. * **Smart Collision Detection:** Usually if a player doubles their size while standing inside a 2-block-tall house, they will clip into the blocks, causing them to potentially get into restricted areas that you usually cannot prevent. AliienResize uses checks to prevent players from changing size if they don't have the physical space to do so safely. * **100% Folia Compatible:** This plugin runs flawlessly on Folia environments since day 1, and will never stop supporting it. * **Deep Economy Integration:** AliienResize handles a whole and very complete economy system natively for over 10 different widely used economy plugins, as well as offers suppport for you to create your own custom economies (requires PlaceholderAPI) --- ## 🚀 Overview **AliienResize** is a lightweight, professional cosmetic plugin built specifically for modern Minecraft (1.21+). Whether you want to sell sizes through your server's economy, grant them as VIP perks, or let your admins have fun, AliienResize provides a flawless, lag-free experience. ### ✨ Key Features * **Smart Collision Detection:** Mathematical bounding-box checks prevent players from clipping through ceilings or glitching into walls when growing. * **Folia & Highly Optimized:** All parts of this plugin have been highly optimized to ensure I will never be the reason your server TPS drops, as well as make sure the plugin will run fine in your Folia servers! * **Massive Economy Support:** Built-in adapter pattern supporting 10+ economy plugins, including *Vault, PlayerPoints, UltraEconomy, ExcellentEconomy, EcoBits, RoyaleEconomy, RedisEconomy, CoinsEngine, and Vanilla Experience levels.* * **Custom Economies:** Natively build your own custom currency hooks directly in the config using PlaceholderAPI. * **World Blacklists:** Automatically reverts players to their default size (1.0x) upon entering restricted worlds. * **MiniMessage Support:** Full MiniMessage (``, ``) support across all menus, items, and messages, as well as legacy codes (`&f`, `&#ffffff`). ## 📦 Requirements * **Server Software:** Paper, Purpur, Spigot, or Folia (1.21+) * **Java Version:** Java 21 or higher * **Soft-Dependencies:** Vault, PlaceholderAPI (only required for economies & placeholders) ## 🛠️ Installation 1. Download the latest release from the [Releases Tab](https://aliien.gitbook.io/aliien-docs/aliienresize-soon/getting-started). 2. Drop `AliienResize-x.x.x.jar` (and your dependencies) into your server's `plugins/` folder. 3. Restart your server to generate the configuration files. 4. Configure your sizes, prices, and settings in `plugins/AliienResize/`. 5. Run `/resize admin reload` to apply config changes in-game! ## 💻 Commands & Permissions | Command | Description | Permission | | :--- | :--- | :--- | | `/resize menu` | Opens the main size selection GUI. | `aliien.resize.menu` | | `/resize set ` | Sets your size to a specific configured ID. | `aliien.resize.set` | | `/resize clear` | Reverts your size back to default (1.0x). | `aliien.resize.clear` | | `/resize admin reload` | Reloads all configuration files and menus. | `aliien.resize.admin.reload` | | `/resize admin set ` | Force-sets a size on a target player. | `aliien.resize.admin.set` | | `/resize admin clear ` | Clears a target player's size. | `aliien.resize.admin.clear` | *Note: Use the `-f` flag on admin commands to bypass collision checks!* ## 📚 Documentation For a comprehensive guide on configuring the `sizes.yml`, setting up custom economy hooks, and using PlaceholderAPI, please visit our **[Official Wiki](https://aliien.gitbook.io/aliien-docs/aliienresize-soon/getting-started)**. ## 🤝 Open Source & Contributing AliienResize is completely **Open Source**! The reason this project is public is so you can directly contribute your own ideas, therefore PRs are more than welcome. **🔗 GitHub Repository:** [https://github.com/aliien15/AliienResize](https://github.com/aliien15/AliienResize) ## 📄 License This project is licensed under the MIT License. See the license file in the repository for details.