---

🤔 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 (<gradient>, <bold>) 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.
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 <id>	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 <player> <id>	Force-sets a size on a target player.	aliien.resize.admin.set
/resize admin clear <player>	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.

🤝 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

📄 License

This project is licensed under the MIT License. See the license file in the repository for details.