# RegionTokens Plugin<\/p>\n
<\/p>\n
This Minecraft plugin lets you create zones and give players time-based tokens that control how long they can stay in each zone.<\/p>\n
## \ud83c\udfaf Features<\/p>\n
– **\ud83d\uddfa\ufe0f Zone Management**: Define cuboid zones with an intuitive zone selection tool
\n– **\ud83c\udfab Token-Based Access**: Players need tokens to enter restricted zones
\n– **\u23f1\ufe0f Time Tracking**: Token time only counts down while inside the zone
\n– **\ud83d\udcca Database**: SQLite storage for persistent player data
\n– **\ud83d\udd0c PlaceholderAPI**: Full integration for custom placeholders
\n– **\ud83d\udd10 Permission-Based**: Complete permission system for zones and tokens
\n– **\ud83d\udeab Anti-Exploit**: Protection against teleporting, dropping tokens, and jumping without tokens
\n– **\u2699\ufe0f Reload Command**: Hot-reload configuration without server restart
\n– **\ud83c\udfa8 Customizable Messages**: Fully configurable messages and notifications<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– Java 21+
\n– Spigot\/Paper 1.21.1+
\n– Gradle (for building from source)<\/p>\n
The compiled JAR will be in `build\/libs\/RegionTokens-1.0.0.jar`<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Download `RegionTokens-1.0.0.jar` from `build\/libs\/`
\n2. Place in your server’s `plugins\/` folder
\n3. Restart the server
\n4. Configuration files will be auto-generated in `plugins\/RegionTokens\/`<\/p>\n
## \ud83d\ude80 Quick Start<\/p>\n
### Step 1: Get the Zone Tool
\n“`
\n\/rgtk tool
\n“`
\nThis gives you shears that act as the zone creation tool.<\/p>\n
### Step 2: Create a Zone ### Step 3: Create a Token Examples: **Duration Formats**: `1h`, `30m`, `60s`, `1h30m`, etc.<\/p>\n ### Step 4: Assign Token to Zone Use these to find IDs: ### Step 5: Configure Token Item (Optional) Give the token to a player: ## \ud83d\udcd6 Complete Command Reference<\/p>\n ### Zone Commands ### Token Commands ### Tool Commands ### System Commands ## \ud83d\udd10 Permissions<\/p>\n ### Admin Permissions ### Player Permissions ## \ud83d\udcca Features in Detail<\/p>\n ### Multiple Tokens Per Zone ### Token Countdown ### Zone Protection ### Anti-Exploit Features ## \ud83d\udcbe Data Storage<\/p>\n “` ## \u2699\ufe0f Configuration<\/p>\n Edit `plugins\/RegionTokens\/config.yml` to customize:<\/p>\n “`yaml messages: zone: token: pagination: See `config.yml` for all customizable options.<\/p>\n ## \ud83d\udd0c PlaceholderAPI Placeholders<\/p>\n “` ## \ud83d\udee0\ufe0f Troubleshooting<\/p>\n ### Players can’t enter zones ### Tokens not counting down ### Zone creation issues ### Database errors ## \ud83d\udcdd License<\/p>\n All rights reserved. RegionTokens \u00a9 2026<\/p>\n ## \ud83e\udd1d Support<\/p>\n For issues, feature requests, or questions, contact the plugin author.<\/p>\n —<\/p>\n **Version**: 1.0.0 This Minecraft plugin lets you create zones and give players time-based tokens that control how long they can stay in each zone.<\/p>\n","protected":false},"featured_media":131375,"template":"","meta":{"_minecraft_slug":"region-tokens","_minecraft_project_id":"tFuFebVo","_minecraft_author":"ItzSD","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":44,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"region-tokens.zip","_minecraft_size_bytes":12879729,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:25:06.417396Z","_minecraft_date_created":"2026-01-30T05:24:28.171346Z","_minecraft_date_modified":"2026-01-28T12:31:32.544121Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/region-tokens","_minecraft_icon_attachment_id":131375,"_minecraft_imported_at":"2026-06-07T17:52:44+00:00","_minecraft_import_hash":"83e17931b0e5e1eb767187f17aab0c0b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,126,127,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-131374","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-management","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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","minecraft_version-1-21-9"],"yoast_head":"\n
\n1. **Left-click** a block with the tool to set Position 1
\n2. **Right-click** a block with the tool to set Position 2
\n3. Run `\/rgtk zone create
\n“`
\n\/rgtk token create
\n“`<\/p>\n
\n– `\/rgtk token create FarmToken 1h` – 1 hour duration
\n– `\/rgtk token create ArenaToken 30m` – 30 minute duration
\n– `\/rgtk token create VIPToken 2h` – 2 hours duration<\/p>\n
\n“`
\n\/rgtk token assign
\n“`<\/p>\n
\n– `\/rgtk zone list` – Lists all zones with IDs
\n– `\/rgtk token list` – Lists all tokens with IDs<\/p>\n
\n“`
\n\/rgtk token item
\n“`<\/p>\n
\n“`
\n\/rgtk token give
\n“`<\/p>\n
\n| Command | Description | Permission |
\n|———|————-|———–|
\n| `\/rgtk zone create
\n| `\/rgtk zone list [page]` | List all zones | `regiontokens.admin.zones.list` |
\n| `\/rgtk zone rename
\n| `\/rgtk zone kickto
\n| `\/rgtk zone show
\n| `\/rgtk zone delete
\n| Command | Description | Permission |
\n|———|————-|———–|
\n| `\/rgtk token create
\n| `\/rgtk token list [page]` | List all tokens | `regiontokens.admin.token.create` |
\n| `\/rgtk token assign
\n| `\/rgtk token unassign
\n| `\/rgtk token duration
\n| `\/rgtk token item
\n| `\/rgtk token rename
\n| `\/rgtk token lore add
\n| `\/rgtk token lore set
\n| `\/rgtk token lore remove
\n| `\/rgtk token give
\n| `\/rgtk token delete
\n| Command | Description | Permission |
\n|———|————-|———–|
\n| `\/rgtk tool` | Get the zone selection tool | `regiontokens.admin.tool` |<\/p>\n
\n| Command | Description | Permission |
\n|———|————-|———–|
\n| `\/rgtk reload` | Reload configuration | `regiontokens.admin.reload` |
\n| `\/rgtk help` | Show help message | None |<\/p>\n
\n“`
\nregiontokens.admin.tool # Use zone tool
\nregiontokens.admin.zones.create # Create\/delete zones
\nregiontokens.admin.zones.list # List zones
\nregiontokens.admin.zones.kickto # Set zone kick location
\nregiontokens.admin.zones.rename # Rename zones
\nregiontokens.admin.token.create # Create\/delete tokens
\nregiontokens.admin.token.duration # Change token duration
\nregiontokens.admin.token.create # Manage token items
\nregiontokens.admin.token.create # Manage token lore
\nregiontokens.admin.reload # Reload plugin
\nregiontokens.role.admin # Admin access to all commands
\n“`<\/p>\n
\n“`
\nregiontokens.zones.enter # Enter token-restricted zones
\nregiontokens.zones.bypass.* # Bypass all zones
\nregiontokens.zones.bypass.
\nregiontokens.token.use.* # Use all tokens
\nregiontokens.token.use.
\n“`<\/p>\n
\n– Assign multiple tokens to a single zone
\n– Each token can have different durations
\n– Players can use any of the assigned tokens to enter<\/p>\n
\n– Tokens count down in real-time while inside the zone
\n– Time displays in token lore (HH:MM:SS format)
\n– Warning message when time is running low
\n– Automatic kick when time expires<\/p>\n
\n– **Movement Block**: Prevents walking into zones without tokens
\n– **Teleport Block**: Prevents `\/tp` into zones without tokens
\n– **Fallback Kick**: Kicks players found in zones without valid tokens
\n– **Item Drop Detection**: Kicks players who drop their tokens
\n– **Inventory Verification**: Prevents holding tokens without being in zone<\/p>\n
\n– Players cannot stay in zone after dropping tokens
\n– Teleporting into zone without token is blocked
\n– Jumping from above into zone triggers automatic kick
\n– Token time persists if dropped and picked up again
\n– Bypass permissions for admins to bypass all checks<\/p>\n
\nplugins\/RegionTokens\/
\n\u251c\u2500\u2500 config.yml # Main configuration
\n\u251c\u2500\u2500 zones\/
\n\u2502 \u251c\u2500\u2500 1.yml # Zone data
\n\u2502 \u2514\u2500\u2500 2.yml # Zone data
\n\u251c\u2500\u2500 tokens\/
\n\u2502 \u251c\u2500\u2500 1.yml # Token data
\n\u2502 \u2514\u2500\u2500 2.yml # Token data
\n\u2514\u2500\u2500 playerdata.db # SQLite database (player times)
\n“`<\/p>\n
\nplugin:
\n name: “RegionTokens”
\n version: “1.0.0”<\/p>\n
\n prefix: “&8[&bRegionTokens&8]&r”<\/p>\n
\n created:
\n title: “&a&lZone Created”
\n subtitle: “&6{zoneName} &bsuccessfully created”
\n # … more messages<\/p>\n
\n created: “{prefix} &eToken created…”
\n assigned: “{prefix} &eToken {tokenName} &eassigned…”
\n # … more messages<\/p>\n
\n items-per-page: 5
\n“`<\/p>\n
\n%regiontokens_zone% # Current zone name
\n%regiontokens_time_left% # Time remaining in token
\n%regiontokens_token% # Current token name
\n“`<\/p>\n
\n1. Check if player has `regiontokens.zones.enter` permission
\n2. Verify they have a valid token in inventory
\n3. Check token duration hasn’t expired
\n4. Ensure token is assigned to the zone<\/p>\n
\n1. Verify player is actually in the zone
\n2. Check if time warning threshold is set too high
\n3. Look for permission issues with `regiontokens.token.use.*`<\/p>\n
\n1. Ensure both positions are set (use `\/rgtk tool`)
\n2. Both positions must be in the same world
\n3. Position 1 and 2 must be different coordinates<\/p>\n
\n1. Check `playerdata.db` permissions (should be readable\/writable)
\n2. Ensure SQLite is not locked by another process
\n3. Try deleting the database to regenerate (clears all player times)<\/p>\n
\n**Last Updated**: January 28, 2026
\n**Java Version**: 21+
\n**Minecraft Version**: 1.21.1+<\/p>\n","protected":false},"excerpt":{"rendered":"