# 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 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. **Set the point selection** - Use`/tzone pos1`and`/tzone pos2`Set two diagonal points of the area 2. **Create a zone** - Use`/tzone create `Create a region 3. **Startup area** - Use`/tzone start `Begins to cause harm to entities in the area 4. **Manage Zones** - Use various commands to manage created zones ## 📋 Command details ### Basic commands - **Main Command**:`/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 # Create a new area /tzone start # Start damage to the specified area /tzone stop # Stop damage in the specified area /tzone remove # 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 permission set tslzone.use true # Give the administrator full permissions /lp user 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 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! *

Zvbj