FreshGuardRK

FEATURES

• Automatic protection for players joining the server for the first time.
• Configurable protection duration. The default duration is 30 minutes.
• Online playtime or calendar-time countdown modes.
• Protection against PvP melee attacks, projectiles, potions, TNT, crystals, anchors, pets, fire and lava.
• Optional protection against mobs, fall damage, explosions, drowning, suffocation, void damage, lightning, poison and wither.
• Optional removal of protection when a protected player attacks.
• Optional attack confirmation before protection is removed.
• Voluntary protection removal with confirmation.
• World blacklist, whitelist and per-world overrides.
• Optional WorldGuard region integration.
• Block breaking, block placing, item pickup, Ender Pearl and Chorus Fruit restrictions.
• Command blacklist and whitelist.
• Configurable BossBar and ActionBar.
• Persistent warnings before protection expires.
• Optional grace period.
• Optional console rewards when protection expires.
• Administrative commands for online and offline player profiles.
• Persistent administrative history.
• PlaceholderAPI support.
• Public API for integration with other plugins.
• UUID-based player storage.
• Lightweight asynchronous SQLite storage.
• Automatic database migration and backup.
• Geyser and Floodgate friendly through Bukkit UUID identity.
• Fully configurable messages.
• Legacy color codes and HEX color support.
• Safe configuration reload command.

INSTALLATION

1. Stop your Minecraft server.
2. Place FreshGuardRK.jar inside the plugins folder.
3. Start the server.
4. Edit plugins/FreshGuardRK/config.yml and messages.yml.
5. Run /fg reload after changing supported configuration options.

FreshGuardRK uses a local SQLite database. No external database server, username, password or additional dependency installation is required.

Do not use the global Bukkit or Spigot /reload command when installing or updating the plugin. Restart the server when replacing the JAR.

MAIN COMMANDS

Command aliases:

Duration examples:

PERMISSIONS

Regular player permissions are available by default. Administrative permissions are assigned to server operators by default.

freshguard.bypass prevents automatic protection from being granted. Administrative commands can use --force when protection must be granted to a player with bypass.

PLACEHOLDERAPI

PlaceholderAPI is optional. When installed, FreshGuardRK provides:

OPTIONAL INTEGRATIONS

• WorldGuard: Region blacklist and whitelist rules.
• PlaceholderAPI: FreshGuardRK placeholders.
• Geyser/Floodgate: Players are handled through the UUID identity presented by Bukkit.

The plugin continues working when optional integrations are not installed.

STORAGE

FreshGuardRK uses a lightweight local SQLite database stored at:

Database operations are processed outside the main server thread. Player profiles, remaining protection time, warnings, rewards, administrative history and the global timer state survive restarts.

When upgrading from the previous JSON-based database schema, FreshGuardRK creates the following backup before migrating:

DEFAULT BEHAVIOR

• New players receive 30 minutes of protection.
• Only eligible online playtime consumes the timer.
• Protected players cannot damage other players.
• Protected players cannot receive PvP damage.
• Protection may be surrendered using /newbie disable.
• The BossBar displays the remaining time.
• Player data is saved in SQLite.

Every important behavior can be adjusted in the documented configuration file.

IMPORTANT INFORMATION

• Protection is automatically granted only to players joining for the first time.
• Existing players can receive protection with /fg enable <player> --force.
• WorldGuard and PlaceholderAPI are optional.
• Shared database writing between multiple servers is not supported.
• Use a separate FreshGuardRK database for each server.
• Test combat rules with the other PvP, duel, arena and minigame plugins installed on your server.