AccessPass

插件

· 作者 Sqrilizz

一个简单 PaperMC 插件,阻止玩家跨越自定义世界边界(X/Z),除非他们拥有相应权限。包含语言自动检测(RU/EN)、配置重载、方块交互保护以及可自定义的消息提示。

0 本站下载 0 关注 更新于 1 年前

最新 2.0 · 1.21.8 · Bukkit / Folia

一键开服(送7天)

AccessPass 2.0 - 高级访问控制系统

? Minecraft 服务器的强大访问控制插件


✨ 功能特性

? 核心访问控制

  • 领地保护:限制玩家进入特定坐标区域
  • 多语言支持:支持俄语和英语,具备自动检测功能
  • 权限系统:针对不同访问级别提供细粒度的权限控制
  • 音效与视觉特效:可自定义的通知和反馈效果

? 2.0 版本新增内容

? 临时通行证

  • 向玩家发放限时访问通行证
  • 灵活的时长系统(秒、分钟、小时、天)
  • 自动清理过期的通行证
  • 使用 JSON 数据库进行持久化存储

?️ 区域管理

  • 创建具有不同设置的多个自定义区域
  • 基于优先级的区域系统
  • 用特定区域覆盖全局边界
  • 简便的区域创建与管理方式

?️ 图形用户界面 (GUI)

  • 用户友好的管理界面
  • 实时统计数据和监控
  • 快速访问所有插件功能
  • 可视化的区域和通行证管理

? 开发者 API

  • 供其他插件使用的完整 API
  • 易于与现有系统集成
  • 详尽的文档说明
  • 示例实现代码

?️ 安装指南

环境要求

  • Minecraft: 1.8.9 - 1.21.8
  • 服务器类型: Paper, Spigot 或 Folia
  • Java: 17 或更高版本

快速设置

  1. 下载 JAR 文件
  2. 将其放入 plugins/ 文件夹
  3. 启动或重启服务器
  4. 在 plugins/AccessPass/config.yml 中进行配置

? 命令列表

基础命令

命令 描述 所需权限
/accesspass reload 重新加载配置 accesspass.admin
/accesspass setlimit <X> <Z> <minX> <minZ> 设置全局边界 accesspass.admin
/accesspass info 查看插件信息 accesspass.admin

新增命令 (v2.0)

命令 描述 所需权限
/accesspass gui 打开管理 GUI accesspass.gui
/accesspass temp <player> <time> 授予临时通行证 accesspass.temp
/accesspass zone <name> <x1> <z1> <x2> <z2> 创建区域 accesspass.zone

使用示例

# 授予 1 小时临时通行证
/accesspass temp Player123 1h

# 授予 30 分钟临时通行证  
/accesspass temp Player123 30m

# 创建出生点区域
/accesspass zone spawn -100 -100 100 100

# 打开管理 GUI
/accesspass gui

? 权限说明

核心权限

  • accesspass.bypass - 绕过所有限制
  • accesspass.admin - 完全管理权限

新增权限 (v2.0)

  • accesspass.gui - 访问管理 GUI
  • accesspass.temp - 授予临时通行证
  • accesspass.zone - 管理区域

⚙️ 配置说明

全局边界

limits:
  global:
    limitX: 1000      # X 轴最大坐标
    limitZ: 1000      # Z 轴最大坐标
    minX: -1000       # X 轴最小坐标
    minZ: -1000       # Z 轴最小坐标
    enabled: true     # 启用全局边界

临时通行证

temporaryPasses:
  enabled: true
  defaultDuration: 3600    # 默认时长为 1 小时
  maxDuration: 86400       # 最大时长为 24 小时
  cleanupInterval: 300     # 每 5 分钟清理一次

区域设置

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

GUI 设置

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

? API 使用方法

基本集成

// 检查玩家是否有访问权限
if (AccessPassAPI.hasAccess(player, location)) {
    // 允许执行操作
}

// 授予临时通行证
AccessPassAPI.grantTemporaryPass(player.getUniqueId(), 3600);

// 创建区域
AccessPassAPI.createZone("myzone", -100, -100, 100, 100, 1);

// 检查是否超出边界
if (AccessPassAPI.isOutOfBounds(location)) {
    // 位置已超出边界
}

可用的 API 方法

  • hasAccess(Player, Location) - 检查玩家访问权限
  • grantTemporaryPass(UUID, long) - 授予临时通行证
  • hasValidTemporaryPass(UUID) - 检查通行证有效性
  • createZone(String, int, int, int, int, int) - 创建区域
  • isOutOfBounds(Location) - 检查是否违反边界规则
  • getActivePassCount() - 获取当前有效通行证数量

? 主要特点

? 性能优化

  • 高效的边界检查算法
  • 可配置的性能选项
  • 对服务器性能影响极小
  • 智能缓存和清理系统

? 高度可配置

  • 丰富的配置选项
  • 可自定义的消息和特效
  • 灵活的权限系统
  • 多语言支持

?️ 服务器兼容性

  • Paper: 全面支持现代功能
  • Spigot: 完全兼容
  • Folia: 原生多线程支持
  • Legacy: 向后兼容 (1.8.9+)

? 监控与分析

  • 实时统计数据
  • 性能指标
  • 调试日志选项
  • GUI 监控界面

? 应用场景

? 出生点保护

  • 防止出生点被破坏
  • 为新玩家创建安全区域
  • 轻松管理出生点边界

? 商店区域

  • 限制对高级区域的访问
  • 创建具有临时访问权限的 VIP 专区
  • 管理商业区域

? 活动管理

  • 活动期间临时开放访问
  • 基于区域的活动场地
  • 限时访问控制

?️ 服务器安全

  • 防止未经授权的访问
  • 管理玩家权限
  • 控制领地访问

? 支持

? 获取帮助

  • 问题报告: 在 GitHub 上报告漏洞
  • 提问: 在讨论区提问
  • 建议: 提交功能请求

? 资源


由 Sqrilizz ❤️ 制作

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源