
?️ NewbieGuard
为新手玩家提供的临时 PvP 保护,专为 Folia 打造。
Folia · Java 21+ · Adventure boss bar
让新手玩家获得起步优势:在他们首次加入时提供一段可配置的保护窗口期,并显示实时 Boss 栏倒计时。倒计时会在玩家离线时暂停,并在其打出第一拳时自动解除保护。
专为 Folia 构建——它全程使用区域和实体调度器,绝不触碰传统的 BukkitScheduler。
✨ 功能
- ? 首次加入保护 — 为新玩家提供可配置时长(默认 60 分钟)的保护。
- ? 实时 Boss 栏 — 每秒倒计时,并在时间临近结束时改变颜色:? 绿色 → ? 黄色 → ? 红色。
- ⏸️ 离线安全 — 计时器仅在玩家在线时运行;离线时间不会扣除。
- ? PvP 护盾 — 取消对受保护玩家的 incoming 攻击,并对攻击者显示一条防刷屏的提示。
- ⚔️ 公平竞技 — 如果受保护的玩家先攻击他人,其自身的保护将被移除(可配置)。
- ? 管理员绕过 —
newbie.bypass 权限允许工作人员测试性地攻击受保护的玩家。
- ?️ 手动控制 — 随时通过命令授予或移除保护。
- ? 仅限新玩家 — 回归玩家永远不会受到保护。
? 命令
| 命令 |
描述 |
权限 |
/newbie check [player] |
显示剩余保护时间 |
newbie.check (自己) · newbie.admin (其他人) |
/newbie grant <player> [minutes] |
为在线玩家授予保护 |
newbie.admin |
/newbie remove <player> |
移除玩家的保护 |
newbie.admin |
? 权限
| 权限 |
描述 |
默认值 |
newbie.bypass |
攻击受保护的玩家 |
op |
newbie.check |
检查自己的剩余时间 |
everyone |
newbie.admin |
授予/移除保护,检查他人的时间 |
op |
⚙️ 配置
protection-duration-minutes: 60
remove-on-attack: true
bypass-permission: "newbie.bypass"
bossbar:
green-threshold-minutes: 10
yellow-threshold-minutes: 5
messages:
protection-start: "&a你将在 {duration} 分钟内免受 PvP 伤害"
protection-expired: "&e你的 PvP 保护已过期"
protection-removed-attack: "&c你攻击了其他玩家 —— 你的保护已被移除"
blocked-attack: "&c该玩家仍处于新手保护期内,无法被攻击"
bossbar-format: "新手 PvP 保护 —— 剩余时间 {time}"
? Boss 栏支持 {time}、{minutes} 和 {seconds} 占位符。
聊天消息支持传统的 & 颜色代码。
? 依赖
? 备注
- 保护状态存储在每位玩家的持久化数据中,因此它会 在重启和重新加入后保留。
- 在安装插件之前就已经加入的玩家不受保护——请使用
/newbie grant 手动为他们提供保护。

?️ NewbieGuard
Temporary PvP protection for new players, built for Folia.
Folia · Java 21+ · Adventure boss bar
New players get a head start: a configurable protection window the moment they first
join, with a live boss bar counting down the time left. The countdown pauses while
they're offline, and protection drops automatically the moment they throw the first
punch.
Built specifically for Folia — it uses the region and entity schedulers throughout
and never touches the legacy BukkitScheduler.
✨ Features
- ? First-join protection — new players are shielded for a configurable duration (default 60 minutes).
- ? Live boss bar — counts down every second and shifts colour as time runs low: ? green → ? yellow → ? red.
- ⏸️ Offline-safe — the timer only ticks while the player is online; time offline is never deducted.
- ? PvP shield — incoming attacks on a protected player are cancelled, and the attacker gets a short, spam-protected notice.
- ⚔️ Fair play — if a protected player strikes someone first, their own protection is removed (configurable).
- ? Staff bypass —
newbie.bypass lets staff hit protected players for testing.
- ?️ Manual control — grant or remove protection at any time with commands.
- ? New players only — returning players are never protected.
? Commands
| Command |
Description |
Permission |
/newbie check [player] |
Show remaining protection time |
newbie.check (self) · newbie.admin (others) |
/newbie grant <player> [minutes] |
Grant protection to an online player |
newbie.admin |
/newbie remove <player> |
Remove a player's protection |
newbie.admin |
? Permissions
| Permission |
Description |
Default |
newbie.bypass |
Attack protected players |
op |
newbie.check |
Check your own remaining time |
everyone |
newbie.admin |
Grant / remove protection, check others |
op |
⚙️ Configuration
protection-duration-minutes: 60
remove-on-attack: true
bypass-permission: "newbie.bypass"
bossbar:
green-threshold-minutes: 10
yellow-threshold-minutes: 5
messages:
protection-start: "&aYou are protected from PvP for {duration} minutes"
protection-expired: "&eYour PvP protection has expired"
protection-removed-attack: "&cYou attacked another player — your protection has been removed"
blocked-attack: "&cThis player is still under new-player protection and cannot be attacked"
bossbar-format: "New Player PvP Protection — Time left {time}"
? The boss bar supports {time}, {minutes} and {seconds} placeholders.
Chat messages support legacy & colour codes.
? Requirements
|
|
| Server |
Folia |
| Java |
21 or newer |
? Notes
- Protection is stored in each player's persistent data, so it survives restarts and rejoins.
- Players who joined before the plugin was installed are not protected — use
/newbie grant to protect them manually.
Lightweight, no dependencies, and Folia-native.
评论 0
登录后参与评分
还没有评论,来抢沙发吧