FirstGate
FirstGate 是一款用于 Minecraft 服务器的首次加入引导插件。它帮助服务器管理员为新玩家提供清晰的新手引导流程,包括规则确认、新手礼包、教程出生点、主出生点传送、临时新手保护、玩家追踪、数据库存储以及内置的网页面板。
此版本适用于 Paper、Purpur、Spigot 和 Bukkit 兼容 的服务器。
功能特性
首次加入引导
FirstGate 会在玩家加入时检测新玩家,并可在他们进入主世界之前引导他们完成服务器的初始流程。
- 首次加入玩家检测
- 支持教程出生点
- 支持主出生点
- 规则确认系统
- 接受规则后发放新手礼包
- 自动跟踪引导完成状态
- 管理员重置与完成控制
规则 GUI
FirstGate 包含一套简洁的规则系统,供新玩家使用。
/rules 命令
- 规则图形界面 (GUI)
- 接受规则按钮
- 可配置规则文本
- 记录谁已接受规则
- 防止玩家从 GUI 中取走物品
新手礼包
在玩家接受规则后,为他们提供可配置的新手礼包。
- 一次性发放新手礼包
- 可配置物品列表
- 支持物品名称和描述 (lore)
- 防止重复发放新手礼包
- 如果背包已满,安全掉落剩余物品
新手保护
在新手起步阶段保护他们免受伤害。
- 临时保护计时器
- 阻止 PvP 伤害
- 阻止怪物伤害
- 可选的下落、火焰和岩浆保护
- 管理员保护/取消保护命令
- 重启后保存保护状态
内置网页面板
FirstGate 包含一个基于浏览器的网页面板,无需仅依赖命令行即可管理插件。
默认网页面板地址:
或 或
重要提示:
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 <player> |
显示某玩家的引导状态。 |
/fg reset <player> |
重置某玩家的引导进度。 |
/fg complete <player> |
标记某玩家为完全引导完成。 |
/fg sendrules <player> |
向某玩家发送或打开规则。 |
示例设置:
/fg settutorial
/fg setmainspawn
/fg reload
保护命令
| 命令 |
描述 |
/fg protect <player> <minutes> |
给予玩家临时保护。 |
/fg unprotect <player> |
移除某玩家的保护。 |
示例:
/fg protect Steve 10
/fg unprotect Steve
保护行为可在 config.yml 中进行配置。
新手礼包命令
| 命令 |
描述 |
/fg kit give <player> |
手动将配置好的新手礼包给予某玩家。 |
示例:
/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://YOUR_SERVER_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 |
允许手动给予初始套装。 |
大多数管理权限默认授予操作员(OP)。普通玩家可以使用 /rules。
安装
- 下载 Bukkit/Paper jar 文件。
- 将 jar 文件放入服务器的
plugins 文件夹中。
- 重启服务器。
- 设置教程出生点:
/fg settutorial
- 设置主出生点:
/fg setmainspawn
- 查看网页面板令牌:
/fg web token
- 打开网页面板:
8. 根据需要编辑 `config.yml` 和 `web.yml`。
9. 重新加载插件:
/fg reload
支持的平台
此版本支持:
- Paper
- Purpur
- Spigot
- 兼容 Bukkit 的服务器
推荐使用 Paper 或 Purpur 以获得最佳体验。
Java 要求
FirstGate 需要:
Java 21+
该插件专为运行 Java 21 或更高版本的现代 Minecraft 服务器环境设计。
---
## 注意事项
除非经过充分测试,否则此版本不包含 Fabric、Forge 和 NeoForge 构建。此 Bukkit 版本是推荐的生产版本。
FirstGate 不使用遥测功能,且默认情况下不需要外部数据库。
Short Modrinth summary:
首次加入的新手引导、规则 GUI、初始套装、新玩家保护、数据库存储以及适用于 Paper/Purpur/Spigot/Bukkit 服务器的内置网页面板。
FirstGate
FirstGate is a first-join onboarding plugin for Minecraft servers. It helps server owners guide new players through a clean welcome flow with rules acceptance, starter kits, tutorial spawn, main spawn teleport, temporary new-player protection, player tracking, database storage, and a built-in web panel.
This release is for Paper, Purpur, Spigot, and Bukkit-compatible servers.
Features
First-Join Onboarding
FirstGate detects new players when they join and can guide them through your server before they enter the main world.
- First-join player detection
- Tutorial spawn support
- Main spawn support
- Rules acceptance system
- Starter kit after accepting rules
- Automatic onboarding completion tracking
- Admin reset and completion controls
Rules GUI
FirstGate includes a clean rules system for new players.
/rules command
- Rules GUI
- Accept rules button
- Configurable rules text
- Tracks who accepted the rules
- Prevents players from taking items from the GUI
Starter Kit
Give new players a configurable starter kit after they accept the rules.
- One-time starter kit delivery
- Configurable item list
- Supports item names and lore
- Prevents duplicate starter kits
- Drops leftover items safely if inventory is full
New Player Protection
Protect new players while they are starting out.
- Temporary protection timer
- Blocks PvP damage
- Blocks mob damage
- Optional fall, fire, and lava protection
- Admin protect/unprotect commands
- Protection state saved through restarts
Built-In Web Panel
FirstGate includes a browser-based web panel for managing the plugin without using only commands.
Default web panel address:
or or
Important:
127.0.0.1 means the panel is only accessible from the server machine itself.
- To access it from another device, change the host in
web.yml to your server IP or 0.0.0.0.
- If you use
0.0.0.0, keep your token private and do not expose the panel publicly without protection.
- FirstGate generates a secure web token automatically.
- There is no fixed default token.
- Use
/fg web token to view your current web panel token.
The web panel can manage:
- Dashboard stats
- Player onboarding status
- Rules
- Starter kit
- Tutorial and main spawns
- Protection
- Config
- Database status
- Logs
- Web settings
Commands
Player Commands
| Command |
Description |
/rules |
Opens the server rules GUI. |
/rules accept |
Accepts the rules directly. |
/firstgate rules |
Opens the rules GUI using the main command. |
/firstgate accept |
Accepts the rules using the main command. |
/fg rules |
Short version of /firstgate rules. |
/fg accept |
Short version of /firstgate accept. |
Main Admin Commands
| Command |
Description |
/fg help |
Shows the FirstGate help menu. |
/fg reload |
Reloads the plugin configuration. |
/fg version |
Shows plugin and server version information. |
/fg settutorial |
Sets the tutorial spawn to your current location. |
/fg setmainspawn |
Sets the main spawn to your current location. |
/fg status <player> |
Shows onboarding status for a player. |
/fg reset <player> |
Resets a player's onboarding progress. |
/fg complete <player> |
Marks a player as fully onboarded. |
/fg sendrules <player> |
Sends or opens the rules for a player. |
Example setup:
/fg settutorial
/fg setmainspawn
/fg reload
---
### Protection Commands
| Command | Description |
| -------------------------------- | ------------------------------------ |
| `/fg protect <player> <minutes>` | Gives a player temporary protection. |
| `/fg unprotect <player>` | Removes protection from a player. |
Examples:
/fg protect Steve 10
/fg unprotect Steve
Protection behavior can be configured in config.yml.
Starter Kit Commands
| Command |
Description |
/fg kit give <player> |
Gives the configured starter kit to a player manually. |
Example:
/fg kit give Steve
Starter kits are normally given automatically after a player accepts the rules.
---
### Web Panel Commands
| Command | Description |
| --------------------- | ---------------------------------------- |
| `/fg web status` | Shows whether the web panel is running. |
| `/fg web start` | Starts the web panel. |
| `/fg web stop` | Stops the web panel. |
| `/fg web restart` | Restarts the web panel. |
| `/fg web token` | Shows the current web panel login token. |
| `/fg web reset-token` | Generates a new web panel token. |
| `/fg web url` | Shows the current web panel URL. |
Examples:
/fg web status
/fg web token
/fg web url
Default web panel URL:
http://127.0.0.1:8087
For LAN or remote access, edit web.yml:
web:
host: "0.0.0.0"
port: 8087
Then open:
---
### Database Commands
FirstGate uses local database storage by default.
| Command | Description |
| ---------------------- | ----------------------------------------------------------- |
| `/fg database status` | Shows database connection and storage status. |
| `/fg database migrate` | Migrates old YAML player data to the database if available. |
| `/fg database backup` | Creates a database backup. |
Examples:
/fg database status
/fg database backup
Default storage:
SQLite
No external database is required for normal use.
---
## Permissions
| Permission | Description |
| ---------------------------- | -------------------------------------------------------- |
| `firstgate.admin` | Gives access to all FirstGate admin features. |
| `firstgate.reload` | Allows reloading the plugin. |
| `firstgate.setup` | Allows setting tutorial and main spawn. |
| `firstgate.status` | Allows checking player onboarding status. |
| `firstgate.reset` | Allows resetting or completing player onboarding. |
| `firstgate.protect` | Allows protect and unprotect commands. |
| `firstgate.rules` | Allows using `/rules`. |
| `firstgate.bypass` | Allows bypassing onboarding. |
| `firstgate.notify` | Receives admin warnings and notices. |
| `firstgate.web` | Allows web panel management commands. |
| `firstgate.web.token` | Allows viewing or resetting the web token. |
| `firstgate.web.start` | Allows starting, stopping, and restarting the web panel. |
| `firstgate.database` | Allows viewing database status. |
| `firstgate.database.migrate` | Allows database migration. |
| `firstgate.database.backup` | Allows database backup. |
| `firstgate.kit.give` | Allows manually giving starter kits. |
Most admin permissions default to operators. Normal players can use `/rules`.
---
## Installation
1. Download the Bukkit/Paper jar.
2. Put the jar into your server’s `plugins` folder.
3. Restart the server.
4. Set the tutorial spawn:
/fg settutorial
5. Set the main spawn:
/fg setmainspawn
6. View the web panel token:
/fg web token
7. Open the web panel:
8.
http://127.0.0.1:8087
- Edit
config.yml and web.yml if needed.
- Reload the plugin:
/fg reload
---
## Supported Platforms
This release supports:
* Paper
* Purpur
* Spigot
* Bukkit-compatible servers
Paper or Purpur is recommended for the best experience.
---
## Java Requirement
FirstGate requires:
Java 21+
The plugin is designed for modern Minecraft server environments running Java 21 or newer.
Notes
Fabric, Forge, and NeoForge builds are not included in this release unless they are fully tested. This Bukkit release is the recommended production version.
FirstGate does not use telemetry and does not require an external database by default.
**Short Modrinth summary:**
First-join onboarding, rules GUI, starter kits, new-player protection, database storage, and a built-in web panel for Paper/Purpur/Spigot/Bukkit servers.
评论 0
登录后参与评分
还没有评论,来抢沙发吧