AccessPass

AccessPass 2.0 - Advanced Access Control System

---

✨ 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

New Commands (v2.0)

Usage Examples

# 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

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

temporaryPasses:
  enabled: true
  defaultDuration: 3600    # 1 hour default
  maxDuration: 86400       # 24 hours maximum
  cleanupInterval: 300     # Cleanup every 5 minutes

Zones

limits:
  zones:
    spawn:
      enabled: true
      x1: -100
      z1: -100
      x2: 100
      z2: 100
      priority: 1

GUI Settings

gui:
  enabled: true
  title: "AccessPass Management"
  size: 27
  updateInterval: 20

---

🔌 API Usage

Basic Integration

// 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 caching and cleanup systems

🔧 Highly Configurable

• Extensive configuration options
• Customizable messages and effects
• Flexible permission system
• Multiple language support

🛡️ Server Compatibility

• Paper: Full support with modern features
• Spigot: Complete compatibility
• Folia: Native multi-threading support
• Legacy: Backward compatibility (1.8.9+)

📊 Monitoring & Analytics

• Real-time statistics
• Performance metrics
• Debug logging options
• GUI monitoring interface

---

🎯 Use Cases

🏠 Spawn Protection

• Protect spawn areas from griefing
• Create safe zones for new players
• Manage spawn boundaries easily

🏪 Shop Areas

• Restrict access to premium areas
• Create VIP zones with temporary access
• Manage commercial areas

🎮 Event Management

• Temporary access for events
• Zone-based event areas
• Time-limited access control

🛡️ Server Security

• Prevent unauthorized access
• Manage player permissions
• Control territory access

---

🤝 Support

📞 Getting Help

• Issues: Report bugs on GitHub
• Questions: Ask in discussions
• Suggestions: Submit feature requests

📚 Resources

• Github: Github
• Webpage: Page

---