TSLscale
PluginMIT

TSLscale

Lightweight customization allows players to personalize their body shape.

70
Downloads
1
Followers
9 months ago
Updated
📦
1
Versions

📖About 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. downloadTSLscale.jardocument
  2. Put the file into the serverpluginsFolders
  3. Restart the server or use/reloadOrder
  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

# 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

# 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:

# 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 inplugins/TSLscale/Generate in the directoryconfig.ymlConfiguration file:

# 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[TSL Meow]&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 havetslscale.usePermissions
  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! 🎮✨