TSLzone

TSLzone - Regional Damage Plugin

TSLzone is a zone damage plug-in designed for Folia 1.21+ servers, allowing server administrators to create designated areas to continuously damage entities within the area according to the set damage value and frequency.

✨ Features

- 🎯 Hot reload - Accurately define damage areas through point selection system - ⚡ Hot reload - Optimized for Folia 1.21+ server side, supporting multi-threaded architecture - 🔧 Hot reload - Customizable damage value and damage frequency - 💾 Hot reload - All regional configurations are automatically saved, and the server will be automatically restored after restarting - 🛡️ Hot reload - Area size limits prevent server performance issues - 🎨 Hot reload - A fully customizable message system - 🔄 Hot reload - Supports configuration file hot reload without restarting the server

🚀 Quick start

Installation steps

1. download`TSLzone-1.0.jar`Plugin Files 2. Put the plugin file into the server`plugins`Folders 3. Restart the server or use`plugman`Loading plugins 4. The plugin will automatically generate configuration files

Basic usage process

1. Manage Zones - Use`/tzone pos1`and`/tzone pos2`Set two diagonal points of the area 2. Manage Zones - Use`/tzone create <region name> <damage> <tick>`Create a region 3. Manage Zones - Use`/tzone start <region name>`Begins to cause harm to entities in the area 4. Manage Zones - Use various commands to manage created zones

📋 Command details

Basic commands

- Permissions:`/tslzone`or`/tzone` - Permissions:`tslzone.use`(Basic use) /`tslzone.admin`(Management function)

Select a command

``` /tzone pos1 # Set the first point in the selection (current player position) /tzone pos2 # Set the second point in the selection (current player position) ```

Regional Management Commands

``` /tzone create <region name> <damage value> <frequency> # Create a new area /tzone start <region name> # Start damage to the specified area /tzone stop <region name> # Stop damage in the specified area /tzone remove <region name> # Delete the specified region /tzone list # List all regions and their status ```

System Commands

``` /tzone reload # Reload all configuration files /tzone help # Show help information ```

🎮 Example of usage

Create a damage area

1. First move to a corner of the area and execute: ``` /tzone pos1 ```

2. Move to the diagonal position of the area and perform: ``` /tzone pos2 ```

3. Create a zone (named "danger_zone", causing 2 damage every time, execution every 5 seconds): ``` /tzone create danger_zone 2 5 ```

4. Startup area: ``` /tzone start danger_zone ```

Now, any creature entering the area will take 2 damage every 5 seconds!

Manage existing areas

- View all areas: ``` /tzone list ```

- Temporarily stop an area: ``` /tzone stop danger_zone ```

- Restart the area: ``` /tzone start danger_zone ```

- Completely delete the area: ``` /tzone remove danger_zone ```

⚙️ Configuration file

data.yml

The area data is automatically saved in`plugins/TSLzone/data.yml`Includes: - Regional coordinate information - Damage settings - Frequency settings - Activation status

Sample configuration: ```yaml zones: danger_zone: pos1: world: world x: 100.0 Y: 64.0 from: 200.0 pos2: world: world x: 150.0 and: 80.0 from: 250.0 damage: 2.0 frequency: 5 active: true ```

messages.yml

Customize all plugin messages, support color code: ```yaml

Color codes: &0-&9, &a-&f, &l(bold), &o(italics), &n(underline), &m(strike line), &k(obfuscation), &r(reset)

zone: create: success: "&a created the region successfully &e'%s' &a!" success-info: "&e damage: &7%s &e| Frequency: &7%s seconds" ```

🔒 Permission system

| Permission Node | Description | Default | |---------|------|------| | `tslzone.use`| Basic usage permissions (pos1, pos2, list) | OP | | `tslzone.admin`| Administrator permissions (create, start, stop, remove, reload) | OP |

Permission Configuration Example (LuckPerms)

```

Give players basic permissions

/lp user <player name> permission set tslzone.use true

Give the administrator full permissions

/lp user <admin> permission set tslzone.admin true ```

🛡️ Safety and Restrictions

Area size limit

- Check timing: 500×500×500 blocks - Check timing: Prevent excessively large areas from affecting server performance - Check timing: Automatically check when zone creation

Performance optimization

- Use Folia's zone scheduler to ensure thread safety - Intelligent entity detection, only deal with organisms in the area - Exception handling mechanism to prevent plug-in from crashing

🔧 Troubleshooting

Frequently Asked Questions

Q: Failed to create the area, prompting "the area is too big" A: Make sure that the selected area does not exceed 500×500×500 blocks. Available`/tzone list`Check the area size.

Q: No harm is caused in the area A: Check whether the area is started (`/tzone list`Check the status), ensure there are biological entities in the area.

Q: The area disappears after the server restart A: Check`plugins/TSLzone/data.yml`Whether the file exists and is readable and writeable.

Q: The command has no permissions A: Make sure to have it`tslzone.use`or`tslzone.admin`Permissions.

Debugging information

Enable debug mode to view detailed logs: 1. View server console output 2. Check if the plugin is loading correctly 3. use`/tzone reload`Reload configuration

📝 Update log

V1.0.0

- ✨ Initial Version Release - ✅ Complete regional management system - ✅ Folia 1.21+ is fully compatible - ✅ Customizable message system - ✅ Data persistence support

🤝 Support and feedback

If you have problems or suggestions for improvement during use, please: 1. Check the troubleshooting section of this document 2. Make sure you are using Folia 1.21+ server 3. Contact the plugin developer to report the problem

📄 License

This plug-in is subject to the MIT license and is free to use, modify and distribute.

---

Thanks for using TSLzone! 🎉

*Make your server area management simpler and more efficient! *