TSLscale

# TSLscale - Minecraft body size adjustment plug-in ## Introduction TSLscale is a body size adjustment plug-in designed for Minecraft servers, allowing players to dynamically adjust their character size. Whether you want to be smaller, cute, or taller, TSLscale can meet your personal needs! ## Functional Features - 🎮 **Simple and easy to use** - Adjust body shape with just one command - 🔒 **Permission Control** - Flexible permission system ensures server security - 📝 **Smart Completion** - Support Tab key automatic completion command - ⚡ **Effect instantly** - Body size adjustments take effect immediately without logging in again - 🎨 **Custom configuration** - Customize body size range and all message texts - 🔄 **Hot reload** - Supports configuration file hot reload without restarting the server ## compatibility - **Minecraft version**: 1.21+ - **Server Type**: Spigot, Paper, Folia - **Java Version**: Java 21+ ## Installation method 1. download`TSLscale.jar`document 2. Put the file into the server`plugins`Folders 3. Restart the server or use`/reload`Order 4. The plugin will automatically generate configuration files ## Command usage ### Basic commands ``` /TSLscale <value> - Adjust size to specified size /scale <value> - Command abbreviation ``` ### Functional examples ```bash # Adjust size to 0.8 times (to get smaller) /TSLscale 0.8 /tscale 0.8 # Adjust size to 1.1 times (to grow larger) /TSLscale 1.1 /tscale 1.1 # Reset body size to default size /TSLscale reset /tscale reset ``` ### Administrator commands ```bash # Reload plugin configuration (OP only available) /TSLscale reload /tscale reload ``` ## Permission system | Permission Node | Description | Default Value | |---------|------|--------| | `tslscale.use`| All players | | `tslscale.reload`| Allow reload plugin configuration | OP only | ### Permission configuration example Use permission management plugins (such as LuckPerms) to configure permissions: ```bash # Give players permission to use /lp user <player name> permission set tslscale.use true # Give administrators permission to reload /lp user <admin> permission set tslscale.reload true ``` ## Configuration File After the plugin is run for the first time, it will be in`plugins/TSLscale/`Generate in the directory`config.yml`Configuration file: ```yaml # Body size adjustment range scale_min: 0.8 # Minimum size (0.8 times) scale_max: 1.1 # Maximum size (1.1 times) # Message configuration messages: prefix: "&c&r " set: "%prefix%Your body size is adjusted to %scale%" reset: "%prefix%Your body size is restored to default" usage: "%prefix%Usage: /TSLscale <value|reset>" no-permission: "%prefix%You don't have permission" console-only: "%prefix%Only players can execute this command" ``` ### Configuration instructions - **scale_min/scale_max**: Set the allowed body size adjustment range - **messages**: Customize all plug-in messages, support color codes (&a, &c, etc.) - **%prefix%**: Message prefix placeholder - **%scale%**: Body size numerical placeholder ## Use scenarios ### Suitable use - 🎭 **Roleplay Server** - Play roles of different races or ages - 🏗️ **Building Server** - Adjust the size to enter the small space to build - 🎪 **Entertainment Server** - Increase the fun and interactive game - 📸 **Screenshots and photos** - Adjust your body shape to get better photo effects ### Body size suggestions - **0.8** - Small and cute, suitable for children's roles - **0.9** - Slightly small in size, suitable for teenagers - **1.0** - Default body type (for reset) - **1.1** - Tall and large, suitable for adult roles ## Frequently Asked Questions ### Q: Why did I change after adjusting my body shape? A: Please make sure: 1. You have`tslscale.use`Permissions 2. The input value is within the configuration range (default 0.8-1.1) 3. Server version support (requires 1.21+) ### Q: Will body size adjustment affect the balance of the game? A: Body size adjustment is mainly visual effects, which has little impact on the game mechanism. It is recommended that administrators set the adjustment range reasonably according to the server type. ### Q: Can you adjust the body size of other players? A: The current version only supports adjusting your own body shape. Subsequent versions may add the function of administrators to adjust other people's body shapes. ### Q: Will the size reset after restarting the server? A: Yes, body size adjustment will not be saved permanently, and it needs to be reset after restart. ## Technical support If you encounter problems or have functional suggestions, please contact: - **Author**: Zvbj - ** Version**: 1.0-SNAPSHOT - **Support**: TSL server ## Update log ### v1.0-SNAPSHOT - First release - Basic body size adjustment function - Permission system - Configuration file support - Tab completion function --- Thanks for using TSLscale! Hopefully this plugin will add more fun to your Minecraft experience! 🎮✨