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

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

🚀 Quick start

Installation steps

downloadTSLzone-1.0.jarPlugin Files
Put the plugin file into the serverpluginsFolders
Restart the server or useplugmanLoading plugins
The plugin will automatically generate configuration files

Basic usage process

Set the point selection - Use/tzone pos1and/tzone pos2Set two diagonal points of the area
Create a zone - Use/tzone create <region name> <damage> <tick>Create a region
Startup area - Use/tzone start <region name>Begins to cause harm to entities in the area
Manage Zones - Use various commands to manage created zones

📋 Command details

Basic commands

Main Command:/tslzoneor/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

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:

# 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

Maximum area: 500×500×500 blocks
Purpose: 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 listCheck the area size.

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

Q: The area disappears after the server restart A: Checkplugins/TSLzone/data.ymlWhether the file exists and is readable and writeable.

Q: The command has no permissions A: Make sure to have ittslzone.useortslzone.adminPermissions.

Debugging information

Enable debug mode to view detailed logs:

View server console output
Check if the plugin is loading correctly
use/tzone reloadReload 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:

Check the troubleshooting section of this document
Make sure you are using Folia 1.21+ server
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! *

TSLzone