第一道门

第一道门

它允许玩家阅读规则、获取新手包、获得保护以及执行由所有者或管理员设置的其他操作。

第一道门预览查看大图

FirstGate

FirstGate 是一个面向 Minecraft 服务器的首次加入引导插件。它帮助服主通过规则接受、新手礼包、教程出生点、主城出生点传送、临时新玩家保护、玩家追踪、数据库存储以及内置网页面板，引导新玩家完成一个简洁的欢迎流程。

此版本适用于 Paper、Purpur、Spigot 以及兼容 Bukkit 的服务器。

特点

首次加入引导

FirstGate 在玩家加入时检测新玩家，并能在其进入主世界之前引导他们浏览你的服务器。

  • 首次加入玩家检测
  • 教程出生点支持
  • 主城出生点支持
  • 规则接受系统
  • 接受规则后给予新手礼包
  • 自动完成引导追踪
  • 管理员重置和完成控制

规则 GUI

FirstGate 为新玩家提供了一个简洁的规则系统。

  • /rules 命令
  • 规则 GUI
  • 接受规则按钮
  • 可配置的规则文本
  • 追踪谁接受了规则
  • 防止玩家从 GUI 中取走物品

新手礼包

玩家接受规则后，给予他们一个可配置的新手礼包。

  • 一次性新手礼包发放
  • 可配置的物品列表
  • 支持物品名称和描述
  • 防止重复领取新手礼包
  • 如果背包已满，安全地掉落剩余物品

新玩家保护

在新玩家起步时提供保护。

  • 临时保护计时器
  • 阻挡 PvP 伤害
  • 阻挡生物伤害
  • 可选摔落、火焰和熔岩保护
  • 管理员保护/取消保护命令
  • 重启后保护状态仍然保存

内置网页面板

FirstGate 包含一个基于浏览器的网页面板，用于管理插件，无需仅使用命令。

默认网页面板地址：

http://127.0.0.1:8087 或 http://0.0.0.0:8087 或 http://<服务器IP>:8087

重要：

  • 127.0.0.1 表示只能从服务器本机访问该面板。
  • 要从其他设备访问，请将 web.yml 中的主机地址更改为你的服务器 IP 或 0.0.0.0。
  • 如果你使用 0.0.0.0，请保管好你的令牌，并且在没有保护的情况下不要公开暴露该面板。
  • FirstGate 会自动生成一个安全的网页令牌。
  • 没有固定的默认令牌。
  • 使用 /fg web token 查看你当前的网页面板令牌。

该网页面板可以管理：

  • 仪表盘统计信息
  • 玩家引导状态
  • 规则
  • 新手礼包
  • 教程和主城出生点
  • 保护
  • 配置
  • 数据库状态
  • 日志
  • 网页设置

命令

玩家命令

命令 描述
/rules 打开服务器规则 GUI。
/rules accept 直接接受规则。
/firstgate rules 使用主命令打开规则 GUI。
/firstgate accept 使用主命令接受规则。
/fg rules /firstgate rules 的简写版本。
/fg accept /firstgate accept 的简写版本。

主要管理员命令

命令 描述
/fg help 显示 FirstGate 帮助菜单。
/fg reload 重新加载插件配置。
/fg version 显示插件和服务器版本信息。
/fg settutorial 将教程出生点设置为当前位置。
/fg setmainspawn 将主城出生点设置为当前位置。
/fg status <玩家> 显示玩家的引导状态。
/fg reset <玩家> 重置玩家的引导进度。
/fg complete <玩家> 将玩家标记为已完成引导。
/fg sendrules <玩家> 为玩家发送或打开规则。

设置示例：

/fg settutorial
/fg setmainspawn
/fg reload

保护命令

命令 描述
/fg protect <玩家> <分钟> 为玩家提供临时保护。
/fg unprotect <玩家> 移除玩家的保护。

示例：

/fg protect Steve 10
/fg unprotect Steve

保护行为可以在 config.yml 中配置。

新手礼包命令

命令 描述
/fg kit give <玩家> 手动给予玩家配置好的新手礼包。

示例：

/fg kit give Steve

新手礼包通常会在玩家接受规则后自动发放。

网页面板命令

命令 描述
/fg web status 显示网页面板是否在运行。
/fg web start 启动网页面板。
/fg web stop 停止网页面板。
/fg web restart 重启网页面板。
/fg web token 显示当前的网页面板登录令牌。
/fg web reset-token 生成一个新的网页面板令牌。
/fg web url 显示当前的网页面板 URL。

示例：

/fg web status
/fg web token
/fg web url

默认网页面板 URL：

http://127.0.0.1:8087

对于局域网或远程访问，编辑 web.yml：

web:
  host: "0.0.0.0"
  port: 8087

然后打开：

http://你的服务器IP:8087

数据库命令

FirstGate 默认使用本地数据库存储。

命令 描述
/fg database status 显示数据库连接和存储状态。
/fg database migrate 如果可用，将旧的 YAML 玩家数据迁移到数据库。
/fg database backup 创建数据库备份。

示例：

/fg database status
/fg database backup

默认存储：

SQLite

正常使用无需外部数据库。

权限

权限 描述
firstgate.admin 授予访问所有 FirstGate 管理员功能的权限。
firstgate.reload 允许重新加载插件。
firstgate.setup 允许设置教程和主城出生点。
firstgate.status 允许检查玩家的引导状态。
firstgate.reset 允许重置或完成玩家引导。
firstgate.protect 允许使用保护和解保护命令。
firstgate.rules 允许使用 /rules。
firstgate.bypass 允许跳过引导。
firstgate.notify 接收管理员警告和通知。
firstgate.web 允许使用网页面板管理命令。
firstgate.web.token 允许查看或重置网页令牌。
firstgate.web.start 允许启动、停止和重启网页面板。
firstgate.database 允许查看数据库状态。
firstgate.database.migrate 允许数据库迁移。
firstgate.database.backup 允许数据库备份。
firstgate.kit.give 允许手动给予新手礼包。

大多数管理员权限默认授予给管理员。普通玩家可以使用 /rules。

安装

  1. 下载 Bukkit/Paper 插件 JAR 文件。
  2. 将 JAR 文件放入服务器的 plugins 文件夹。
  3. 重启服务器。
  4. 设置教程出生点：
/fg settutorial
  1. 设置主城出生点：
/fg setmainspawn
  1. 查看网页面板令牌：
/fg web token

  1. 打开网页面板：

    http://127.0.0.1:8087

  2. 根据需要编辑 config.yml 和 web.yml。

  3. 重新加载插件：

/fg reload

支持平台

此版本支持：

  • Paper
  • Purpur
  • Spigot
  • 兼容 Bukkit 的服务器

为了获得最佳体验，推荐使用 Paper 或 Purpur。

Java 要求

FirstGate 要求：

Java 21+

该插件专为运行 Java 21 或更新版本的现代 Minecraft 服务器环境设计。

备注

此版本不包含 Fabric、Forge 和 NeoForge 版本，除非它们已全面测试。此 Bukkit 版本是推荐的正式版。

FirstGate 不使用遥测技术，默认情况下也不需要外部数据库。

简短的 Modrinth 摘要：

适用于 Paper/Purpur/Spigot/Bukkit 服务器的首次加入引导、规则 GUI、新手礼包、新玩家保护、数据库存储和内置网页面板。