# TSLzone – Regional Damage Plugin<\/p>\n
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.<\/p>\n
## \u2728 Features<\/p>\n
– \ud83c\udfaf **Precise area control** – Accurately define damage areas through point selection system
\n– \u26a1 **Folia compatible** – Optimized for Folia 1.21+ server side, supporting multi-threaded architecture
\n– \ud83d\udd27 **Flexible configuration** – Customizable damage value and damage frequency
\n– \ud83d\udcbe **Data persistence** – All regional configurations are automatically saved, and the server will be automatically restored after restarting
\n– \ud83d\udee1\ufe0f **Security Limit** – Area size limits prevent server performance issues
\n– \ud83c\udfa8 **Message Customization** – A fully customizable message system
\n– \ud83d\udd04 **Hot reload** – Supports configuration file hot reload without restarting the server<\/p>\n
## \ud83d\ude80 Quick start<\/p>\n
### Installation steps<\/p>\n
1. download`TSLzone-1.0.jar`Plugin Files
\n2. Put the plugin file into the server`plugins`Folders
\n3. Restart the server or use`plugman`Loading plugins
\n4. The plugin will automatically generate configuration files<\/p>\n
### Basic usage process<\/p>\n
1. **Set the point selection** – Use`\/tzone pos1`and`\/tzone pos2`Set two diagonal points of the area ## \ud83d\udccb Command details<\/p>\n ### Basic commands ### Select a command ### Regional Management Commands ### System Commands ## \ud83c\udfae Example of usage<\/p>\n ### Create a damage area<\/p>\n 1. First move to a corner of the area and execute: 2. Move to the diagonal position of the area and perform: 3. Create a zone (named “danger_zone”, causing 2 damage every time, execution every 5 seconds): 4. Startup area: Now, any creature entering the area will take 2 damage every 5 seconds!<\/p>\n ### Manage existing areas<\/p>\n – View all areas: – Temporarily stop an area: – Restart the area: – Completely delete the area: ## \u2699\ufe0f Configuration file<\/p>\n ### data.yml Sample configuration: ### messages.yml ## \ud83d\udd12 Permission system<\/p>\n | Permission Node | Description | Default | ### Permission Configuration Example (LuckPerms) # Give the administrator full permissions ## \ud83d\udee1\ufe0f Safety and Restrictions<\/p>\n ### Area size limit ### Performance optimization ## \ud83d\udd27 Troubleshooting<\/p>\n ### Frequently Asked Questions<\/p>\n **Q: Failed to create the area, prompting “the area is too big”** **Q: No harm is caused in the area** **Q: The area disappears after the server restart** **Q: The command has no permissions** ### Debugging information ## \ud83d\udcdd Update log<\/p>\n ### V1.0.0 ## \ud83e\udd1d Support and feedback<\/p>\n If you have problems or suggestions for improvement during use, please: ## \ud83d\udcc4 License<\/p>\n This plug-in is subject to the MIT license and is free to use, modify and distribute.<\/p>\n —<\/p>\n **Thanks for using TSLzone! ** \ud83c\udf89<\/p>\n *Make your server area management simpler and more efficient! *<\/p>\n","protected":false},"excerpt":{"rendered":" A zone damage plugin compatible with Folia.<\/p>\n","protected":false},"featured_media":160411,"template":"","meta":{"_minecraft_slug":"tslzone","_minecraft_project_id":"LNpFibml","_minecraft_author":"Zvbj","_minecraft_license":"MIT","_minecraft_downloads":28,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"tslzone.zip","_minecraft_size_bytes":19580,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:12:16.714832Z","_minecraft_date_created":"2025-07-28T20:20:55.108415Z","_minecraft_date_modified":"2025-07-24T06:29:48.027796Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/tslzone","_minecraft_icon_attachment_id":160411,"_minecraft_imported_at":"2026-06-09T14:53:21+00:00","_minecraft_import_hash":"3cea33a915c877b1dcef9aa2a63e0eb7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,126,123],"mod_loader":[131],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-160410","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-technology","mod_loader-folia","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\n2. **Create a zone** – Use`\/tzone create
\n3. **Startup area** – Use`\/tzone start
\n4. **Manage Zones** – Use various commands to manage created zones<\/p>\n
\n– **Main Command**:`\/tslzone`or`\/tzone`
\n– **Permissions**:`tslzone.use`(Basic use) \/`tslzone.admin`(Management function)<\/p>\n
\n“`
\n\/tzone pos1 # Set the first point in the selection (current player position)
\n\/tzone pos2 # Set the second point in the selection (current player position)
\n“`<\/p>\n
\n“`
\n\/tzone create
\n\/tzone start
\n\/tzone stop
\n\/tzone remove
\n\/tzone list # List all regions and their status
\n“`<\/p>\n
\n“`
\n\/tzone reload # Reload all configuration files
\n\/tzone help # Show help information
\n“`<\/p>\n
\n “`
\n\/tzone pos1
\n “`<\/p>\n
\n “`
\n\/tzone pos2
\n “`<\/p>\n
\n “`
\n\/tzone create danger_zone 2 5
\n “`<\/p>\n
\n “`
\n\/tzone start danger_zone
\n “`<\/p>\n
\n “`
\n\/tzone list
\n “`<\/p>\n
\n “`
\n\/tzone stop danger_zone
\n “`<\/p>\n
\n “`
\n\/tzone start danger_zone
\n “`<\/p>\n
\n “`
\n\/tzone remove danger_zone
\n “`<\/p>\n
\nThe area data is automatically saved in`plugins\/TSLzone\/data.yml`Includes:
\n– Regional coordinate information
\n– Damage settings
\n– Frequency settings
\n– Activation status<\/p>\n
\n“`yaml
\nzones:
\ndanger_zone:
\npos1:
\nworld: world
\nx: 100.0
\nY: 64.0
\nfrom: 200.0
\npos2:
\nworld: world
\nx: 150.0
\nand: 80.0
\nfrom: 250.0
\ndamage: 2.0
\nfrequency: 5
\nactive: true
\n“`<\/p>\n
\nCustomize all plugin messages, support color code:
\n“`yaml
\n# Color codes: &0-&9, &a-&f, &l(bold), &o(italics), &n(underline), &m(strike line), &k(obfuscation), &r(reset)
\nzone:
\ncreate:
\nsuccess: “&a created the region successfully &e’%s’ &a!”
\nsuccess-info: “&e damage: &7%s &e| Frequency: &7%s seconds”
\n“`<\/p>\n
\n|———|——|——|
\n| `tslzone.use`| Basic usage permissions (pos1, pos2, list) | OP |
\n| `tslzone.admin`| Administrator permissions (create, start, stop, remove, reload) | OP |<\/p>\n
\n“`
\n# Give players basic permissions
\n\/lp user
\n\/lp user
\n“`<\/p>\n
\n– **Maximum area**: 500\u00d7500\u00d7500 blocks
\n– **Purpose**: Prevent excessively large areas from affecting server performance
\n– **Check timing**: Automatically check when zone creation<\/p>\n
\n– Use Folia’s zone scheduler to ensure thread safety
\n– Intelligent entity detection, only deal with organisms in the area
\n– Exception handling mechanism to prevent plug-in from crashing<\/p>\n
\nA: Make sure that the selected area does not exceed 500\u00d7500\u00d7500 blocks. Available`\/tzone list`Check the area size.<\/p>\n
\nA: Check whether the area is started (`\/tzone list`Check the status), ensure there are biological entities in the area.<\/p>\n
\nA: Check`plugins\/TSLzone\/data.yml`Whether the file exists and is readable and writeable.<\/p>\n
\nA: Make sure to have it`tslzone.use`or`tslzone.admin`Permissions.<\/p>\n
\nEnable debug mode to view detailed logs:
\n1. View server console output
\n2. Check if the plugin is loading correctly
\n3. use`\/tzone reload`Reload configuration<\/p>\n
\n– \u2728 Initial Version Release
\n– \u2705 Complete regional management system
\n– \u2705 Folia 1.21+ is fully compatible
\n– \u2705 Customizable message system
\n– \u2705 Data persistence support<\/p>\n
\n1. Check the troubleshooting section of this document
\n2. Make sure you are using Folia 1.21+ server
\n3. Contact the plugin developer to report the problem<\/p>\n