NewbieProtect-pikutog

SUMMARY FIELD (paste into Modrinth's "Summary", max 256 characters)
EN: Protects players who join for the first time from PvP for a configurable time. Counts online time only by default, survives restarts, and supports English and Japanese messages.
JA: 初参加のプレイヤーを、設定した時間だけ PvP 不可にします。初期設定ではオンライン時間だけを数え、再起動しても続きから。メッセージは英語・日本語に対応。

================ DESCRIPTION BODY STARTS BELOW (paste everything under this line) ================

NewbieProtect

English | [日本語](#日本語)

A simple new-player protection plugin. Players who join your server for the first time cannot be attacked by other players (and cannot attack them) for a configurable amount of time, so they have a chance to gather their first resources in peace.

Features

• First-join protection: a new player is protected from PvP for the time you set, for example 30 minutes.
• Online time only (default): the timer only runs while the player is online, so a new player who logs off right away does not lose the protection. You can switch to real time in the config.
• Survives restarts: the remaining time is saved, so it continues where it left off after a restart.
• Attacks and projectiles: protected players can neither attack nor be attacked. Arrows, tridents and other projectiles count too.
• Clear feedback: a welcome message, an action bar message when someone tries to attack, and a message when the protection ends.
• Admin commands: check, remove or give protection, and reload the config.
• English and Japanese: choose the language in config.yml. Every message can be edited, and you can add your own language file.
• Lightweight: no database and no dependencies. Data is saved in the background.

Requirements

• Paper 1.21 or newer (Folia is not supported)

Installation

1. Put NewbieProtect.jar into your plugins folder.
2. Start the server. plugins/NewbieProtect/config.yml and the lang folder are created.
3. Edit config.yml as you like.
4. Run /newbie reload (or restart the server).

Configuration

language: "en" # "en" or "ja" (or your own language file)

protection:
duration: "30m" # 30s, 30m, 1h30m, 2d ... (s, m, h, d, w)
count-offline-time: false

Option · Description
language · Language of the in-game messages. en and ja are included.
protection.duration · How long a new player is protected.
protection.count-offline-time · false (recommended): only online time counts. true: the timer keeps running while the player is offline.

Commands and permissions

Command · Permission · Description
/newbie (or /newbie check) · none · Shows your remaining protection time.
/newbie check · newbieprotect.admin · Shows the remaining time of an online player.
/newbie give · newbieprotect.admin · Gives an online player a new protection for the configured time.
/newbie remove · newbieprotect.admin · Ends the protection of an online player.
/newbie reload · newbieprotect.admin · Reloads config.yml and the language files.

Permission · Default · Description
newbieprotect.admin · OP · Allows the admin commands above.
newbieprotect.bypass · nobody · Players with this permission never receive protection.

The alias /newbieprotect works as well.

Languages

On the first start, lang/en.yml and lang/ja.yml are created in plugins/NewbieProtect/. Set language in config.yml to choose one. To add your own language, copy lang/en.yml to lang/.yml, translate it and set language: "". Any message missing from a language file falls back to English.

Notes and limitations

• Only players who join for the first time are protected. Players who joined before the plugin was installed are not protected. To protect someone manually, use /newbie give .
• Only PvP is blocked. Protected players can still take damage from mobs, fall damage and so on.
• Only direct hits and projectiles are blocked. Indirect damage (for example splash potions or TNT) may not be blocked.
• check, give and remove for other players only work while that player is online.

日本語

[English](#newbieprotect) | 日本語

シンプルな新規プレイヤー保護プラグインです。初めてサーバーに参加したプレイヤーは、設定した時間のあいだ、他のプレイヤーに攻撃されず、攻撃もできません。最初の資源集めを、落ち着いて進められます。

機能

• 初参加の保護: 新規プレイヤーを、設定した時間（例: 30分）だけ PvP から守ります。
• オンライン時間だけを数える（初期設定）: タイマーはログインしている間だけ進みます。すぐにログアウトしても、保護は減りません。設定で、実時間に切り替えることもできます。
• 再起動しても続く: 残り時間は保存されるので、再起動しても続きから数えます。
• 攻撃と飛び道具: 保護中の人は、攻撃も被攻撃もできません。矢や三叉槍などの飛び道具も対象です。
• わかりやすい通知: 参加時のメッセージ、攻撃しようとした時のアクションバー表示、保護が終わった時のメッセージが出ます。
• 管理コマンド: 保護の確認・解除・付与と、設定の再読み込みができます。
• 英語・日本語に対応: config.yml で言語を選べます。メッセージはすべて編集でき、自分の言語ファイルを追加することもできます。
• 軽量: データベースも、依存プラグインも不要です。データの保存は、裏で行われます。

必要なもの

• Paper 1.21 以降（Folia には非対応です）

導入方法

1. NewbieProtect.jar を plugins フォルダに入れます。
2. サーバーを起動します。plugins/NewbieProtect/config.yml と lang フォルダが作られます。
3. config.yml を好きなように編集します。
4. /newbie reload を実行します（またはサーバーを再起動します）。

設定

language: "ja" # "en" か "ja"（自作の言語ファイルも可）

protection:
duration: "30m" # 30s, 30m, 1h30m, 2d ... (s, m, h, d, w)
count-offline-time: false

項目 · 説明
language · ゲーム内メッセージの言語。en と ja が付属しています。
protection.duration · 新規プレイヤーを保護する時間。
protection.count-offline-time · false（おすすめ）: オンライン時間だけを数えます。true: ログアウト中も時間が進みます。

コマンドと権限

コマンド · 権限 · 説明
/newbie（または /newbie check） · なし · 自分の残り時間を表示します。
/newbie check · newbieprotect.admin · オンラインのプレイヤーの残り時間を表示します。
/newbie give · newbieprotect.admin · オンラインのプレイヤーに、設定した時間の保護を新しく付与します。
/newbie remove · newbieprotect.admin · オンラインのプレイヤーの保護を終わらせます。
/newbie reload · newbieprotect.admin · config.yml と言語ファイルを再読み込みします。

権限 · 初期値 · 説明
newbieprotect.admin · OP · 上の管理コマンドを使えます。
newbieprotect.bypass · 誰も持たない · この権限を持つ人は、保護を受けません。

別名の /newbieprotect も使えます。

言語

初回の起動時に、plugins/NewbieProtect/ に lang/en.yml と lang/ja.yml が作られます。config.yml の language で選んでください。自分の言語を追加するには、lang/en.yml を lang/.yml としてコピーして翻訳し、language: "" と設定します。言語ファイルにないメッセージは、英語で表示されます。

注意点と制限

• 保護されるのは、初めて参加した人だけです。プラグインを入れる前に参加していた人は、保護されません。手動で保護したい場合は、/newbie give を使ってください。
• 止めるのは PvP だけです。保護中でも、モブや落下などのダメージは受けます。
• 直接の攻撃と飛び道具だけを止めます。スプラッシュポーションや TNT などの間接的なダメージは、止められない場合があります。
• 他のプレイヤーへの check・give・remove は、相手がオンラインの時だけ使えます。