🪶 ShibaGrace

ShibaGrace is an elegant, 100% server-side Fabric mod (Version 1.21.11) that ensures a fair starting experience for new players on your server. It protects new players from PvP and marks them visually with beautiful, floating feathers – all without requiring players to install the mod themselves!

✨ Features

• 100% Server-Side: The mod only needs to be installed on the server. Vanilla clients can join without any issues.
• Automatic PvP Protection: New players receive a default 45-minute PvP protection when joining for the first time (time is configurable). They cannot be attacked, nor can they attack other players.
• Visual Indicators (No Client Mod Required!):
  • Players under grace protection receive a 🪶 symbol in front of their name in the tablist and chat.
  • A magical floating feather acts as a "drone," gliding smoothly above the player's head, instantly signaling to everyone: This player is protected!
• Smart Timer System: Players are notified in the chat when their protection is about to expire (warnings at 10 mins, every minute from 5 mins, 30 secs, and a 10-second countdown).

🛠️ Commands & Permissions

👥 For All Players (No OP Required)

• /shibagrace check
  • Displays exactly how much time is left in your grace period, down to the second.

👑 For Admins (Requires OP Level 2)

• /shibagrace on
  • Enables the grace system globally for the entire server.
• /shibagrace off
  • Disables the grace system globally (pauses all timers and temporarily removes visual feathers).
• /shibagrace setdefaulttime <minutes>
  • Changes the default protection time for players joining the server for the very first time (Default: 45 minutes).
• /shibagrace player <name> settime <minutes>
  • Sets the exact remaining grace time for a specific player (e.g., as a reward or punishment).
• /shibagrace player <name> addtime <minutes>
  • Adds additional minutes to a specific player's protection.
• /shibagrace player <name> removetime <minutes>
  • Removes minutes from a specific player's protection.

💾 Technical Details

• No Database Setup Required: All data is saved efficiently in a simple .dat file within your world storage. Even if the server crashes, not a single second of protection time is lost.
• Performance: The floating feathers are updated using intelligent interpolation logic. Orphaned entities (leftover feathers) are automatically and invisibly cleaned up by the server to 100% prevent memory leaks.