AccessPass

# AccessPass 2.0 - Advanced Access Control System <div align="center"> **🚀 Powerful access control plugin for Minecraft servers** (https://img.shields.io/badge/Minecraft-1.8.9--1.21.8-green.svg)](https://modrinth.com/mod/accesspass) (https://img.shields.io/badge/Server-Paper%20%7C%20Spigot%20%7C%20Folia-blue.svg)](https://modrinth.com/mod/accesspass) (https://img.shields.io/badge/Java-17+-orange.svg)](https://modrinth.com/mod/accesspass) (https://img.shields.io/badge/License-MIT-yellow.svg)](https://modrinth.com/mod/accesspass) </div> --- ## ✨ Features ### 🔒 **Core Access Control** - **Territory Protection**: Restrict player access to specific coordinates - **Multi-Language Support**: Russian and English with auto-detection - **Permission System**: Granular permissions for different access levels - **Sound & Visual Effects**: Customizable notifications and feedback ### 🆕 **New in Version 2.0** #### 🎫 **Temporary Passes** - Issue time-limited access passes to players - Flexible duration system (seconds, minutes, hours, days) - Automatic cleanup of expired passes - JSON database for persistent storage #### 🗺️ **Zone Management** - Create multiple custom zones with different settings - Priority-based zone system - Override global boundaries with specific zones - Easy zone creation and management #### 🖥️ **GUI Interface** - User-friendly management interface - Real-time statistics and monitoring - Quick access to all plugin features - Visual zone and pass management #### 🔌 **Developer API** - Full API for other plugins - Easy integration with existing systems - Comprehensive documentation - Example implementations --- ## 🛠️ Installation ### Requirements - **Minecraft**: 1.8.9 - 1.21.8 - **Server Type**: Paper, Spigot, or Folia - **Java**: 17 or higher ### Quick Setup 1. Download the JAR file 2. Place it in your `plugins/` folder 3. Start/restart your server 4. Configure in `plugins/AccessPass/config.yml` --- ## 📋 Commands ### Basic Commands | Command | Description | Permission | |---------|-------------|------------| | `/accesspass reload` | Reload configuration | `accesspass.admin` | | `/accesspass setlimit <X> <Z> <minX> <minZ>` | Set global boundaries | `accesspass.admin` | | `/accesspass info` | Plugin information | `accesspass.admin` | ### New Commands (v2.0) | Command | Description | Permission | |---------|-------------|------------| | `/accesspass gui` | Open management GUI | `accesspass.gui` | | `/accesspass temp <player> <time>` | Grant temporary pass | `accesspass.temp` | | `/accesspass zone <name> <x1> <z1> <x2> <z2>` | Create zone | `accesspass.zone` | ### Usage Examples ```bash # Grant 1-hour temporary pass /accesspass temp Player123 1h # Grant 30-minute temporary pass /accesspass temp Player123 30m # Create spawn zone /accesspass zone spawn -100 -100 100 100 # Open management GUI /accesspass gui ``` --- ## 🔐 Permissions ### Core Permissions - `accesspass.bypass` - Bypass all restrictions - `accesspass.admin` - Full administrative access ### New Permissions (v2.0) - `accesspass.gui` - Access management GUI - `accesspass.temp` - Grant temporary passes - `accesspass.zone` - Manage zones --- ## ⚙️ Configuration ### Global Boundaries ```yaml limits: global: limitX: 1000 # Maximum X coordinate limitZ: 1000 # Maximum Z coordinate minX: -1000 # Minimum X coordinate minZ: -1000 # Minimum Z coordinate enabled: true # Enable global boundaries ``` ### Temporary Passes ```yaml temporaryPasses: enabled: true defaultDuration: 3600 # 1 hour default maxDuration: 86400 # 24 hours maximum cleanupInterval: 300 # Cleanup every 5 minutes ``` ### Zones ```yaml limits: zones: spawn: enabled: true x1: -100 z1: -100 x2: 100 z2: 100 priority: 1 ``` ### GUI Settings ```yaml gui: enabled: true title: "AccessPass Management" size: 27 updateInterval: 20 ``` --- ## 🔌 API Usage ### Basic Integration ```java // Check player access if (AccessPassAPI.hasAccess(player, location)) { // Allow action } // Grant temporary pass AccessPassAPI.grantTemporaryPass(player.getUniqueId(), 3600); // Create zone AccessPassAPI.createZone("myzone", -100, -100, 100, 100, 1); // Check boundaries if (AccessPassAPI.isOutOfBounds(location)) { // Location is out of bounds } ``` ### Available API Methods - `hasAccess(Player, Location)` - Check player access - `grantTemporaryPass(UUID, long)` - Grant temporary pass - `hasValidTemporaryPass(UUID)` - Check pass validity - `createZone(String, int, int, int, int, int)` - Create zone - `isOutOfBounds(Location)` - Check boundary violation - `getActivePassCount()` - Get active pass count --- ## 🌟 Key Features ### 🚀 **Performance Optimized** - Efficient boundary checking algorithms - Configurable performance settings - Minimal impact on server performance - Smart cachi