AdvancedBans - 简洁高效封禁面板

💡重要通知

作者已宣布从 SpigotMC 退休，AdvancedBans 的开发将无限期停止。对于此资源的用户，这意味着 AdvancedBans 的开发将完全永久停止，除非未来它再次成为作者的个人项目。感谢您的理解。

如需支持、问题或疑问，请通过 Discord 联系作者：mathhulk#5603，或加入 Discord 服务器：https://discord.gg/2TqbhpB。您也可以在 AdvancedBan 的 Discord 服务器上获得支持。

🎮简介

AdvancedBans 是一个为 AdvancedBan 插件设计的简洁、美观的网页管理面板。它允许您自行托管，并通过网页界面查看和管理服务器的处罚记录。

✨主要特性

多版本支持

• 支持多个 AdvancedBan 插件版本：

- 旧版：1.2.5

- 稳定版：2.1.5

- 测试版：2.1.6

主题系统

• 内置精美默认主题和贡献者主题。
• 支持创建自定义主题。
• 允许用户在前端选择自己喜欢的主题。

多语言支持

• 提供默认的贡献者翻译语言。
• 支持创建自定义语言文件。
• 允许用户在前端选择显示语言。

处罚管理

• 搜索功能：提供强大的处罚记录搜索。

- 可按处罚状态搜索。

- 可按处罚类型搜索。

- 可通过玩家名、原因、操作者进行关键词搜索。

- 支持在单次搜索中混合匹配多个查询条件。

玩家列表

• 玩家在线列表每 5 秒自动更新一次。
• 可配置服务器地址和端口。
• 为旧版服务器提供可选的 Query 查询支持。
• 此功能可以全局启用或禁用。

导航链接

• 可配置自定义“支持”链接。
• 可配置自定义“申诉”链接。
• 可以独立启用或禁用其中一个或全部链接。

🔧安装要求

• PHP：推荐版本 v7.2.8 或更高。
• PHP 模块：必须启用 mysqlnd 和 nd_mysqli。
• Apache 模块：mod_rewrite（可选，可以启用以优化 URL）。

⭐安装与配置

部署文件

• 将 advancedbans 项目克隆或下载到您的本地 Web 目录。
• 找到位于 static\database.php 的数据库配置文件。
• 使用文本编辑器（如 Notepad++ 或 Nano）打开此文件。
• 在相应位置填入您的数据库凭据。

database.php 配置示例：

<?php
define("DATABASE_HOST", "host");
define("DATABASE_USER", "user");
define("DATABASE_PASSWORD", "password");
define("DATABASE_DATABASE", "database");

面板配置

AdvancedBans 的主配置文件位于 static\configuration.json。您可以在此更改面板的各项功能设置。

重要提示：

• 修改配置文件后，建议使用 JSON 验证器检查格式，确保没有误删必要内容。
• version 字段必须根据您服务器安装的 AdvancedBan 插件版本来设置：

- `"stable"`：对应 AdvancedBan 2.1.5。

- `"legacy"`：对应 AdvancedBan 1.2.5。

- `"beta"`：对应 AdvancedBan 2.1.6。

configuration.json 配置示例：

{
    "version": "stable",
    "mod_rewrite": false,
    "default": {
        "theme": "photon",
        "language": "en-US"
    },
    "language": {
        "title": "AdvancedBans",
        "description": "Simple and sleek punishment panel for AdvancedBan."
    },
    "player_count": {
        "enabled": true,
        "query": false,
        "host": "mc.hypixel.net",
        "port": "25565"
    },
    "navigation": {
        "contact": {
            "enabled": true,
            "link": "http://example.com/contact"
        },
        "appeal": {
            "enabled": true,
            "link": "http://example.com/appeal"
        }
    }
}

❓自定义指南

添加新语言

• 语言文件位于 static\languages 目录。
• 创建一个新的 JSON 文件，例如 zh-CN.json。
• 使用以下模板进行翻译：

语言文件模板：

{
    "language": "中文",
    "collection": {
        "punishments": "处罚记录",
        "support": "支持",
        "contact": "联系",
        "appeal": "申诉",
        "credit": "致谢",
        "themes": "主题",
        "default": "默认",
        "languages": "语言",
        "players": "玩家",
        "search": "搜索",
        "copy": "复制",
        "copied": "已复制",
        "inactive": "已失效",
        "active": "生效中",
        "first": "首页",
        "previous": "上一页",
        "next": "下一页",
        "last": "末页",
        "name": "玩家名",
        "reason": "原因",
        "operator": "操作者",
        "date": "日期",
        "expires": "到期时间",
        "type": "类型",
        "status": "状态",
        "ban": "封禁",
        "temp_ban": "临时封禁",
        "ip_ban": "IP封禁",
        "mute": "禁言",
        "temp_mute": "临时禁言",
        "warning": "警告",
        "temp_warning": "临时警告",
        "kick": "踢出",
        "error_no_punishments": "本页没有可显示的处罚记录",
        "error_not_evaluated": "不适用"
    }
}

贡献翻译：如果您翻译了新的语言，欢迎提交 Pull Request，作者会将其合并到主分支中。

创建自定义主题

• 主题文件位于 static\themes 目录。
• AdvancedBans 始终会加载 Bootstrap 和 jQuery 的核心文件，并遵循 Bootstrap 的 HTML 结构。
• 主题的文件结构示例如下：

主题目录结构：

themes /
\ - photon /
    | - css /
    |   \ - photon.css
    | - img /
    | - js /
    \ - configuration.json

• 将自定义的样式表和脚本分别放入 css 和 js 文件夹。
• 主题的 configuration.json 文件应遵循以下模板：

主题配置文件模板：

{
    "theme": "我的主题名称",
    "creator": "您的名字"
}

更换图标

要更换 AdvancedBans 的图标，请替换以下文件：

• static\resources\images 目录下的图标文件。
• static\resources\images\icons 目录下的图标文件。
• 根目录下的 favicon.ico 文件。

您可以使用在线工具（如 https://www.favicon-generator.org）来生成图标文件。

🔧致谢

AdvancedBan 插件的原作者是 Leoko。您可以在 SpigotMC 上找到该插件：https://www.spigotmc.org/resources/advancedban.8695/。