Installation & Setup

Requirements, installation steps, and permission configuration for both the server plugin and the optional client mod.

Requirements

Server Plugin

Requirement Version Notes
Server softwarePaper 1.21 or 1.21.1Spigot is not supported. Paper only.
Java21 or higherRequired by Paper 1.21.
DependenciesNoneThe plugin is self-contained.

Client Mod (Optional)

Requirement Version Notes
Mod loaderFabric Loader (latest for 1.21)Download from fabricmc.net
Fabric APILatest for 1.21Required dependency for the mod.
Minecraft1.21 or 1.21.1Must match the server version.
Java21 or higherAlready required by Minecraft 1.21.
EnvironmentClient-side onlyDo not install on the server.

Plugin Installation

  1. Download the JAR

    Obtain ProtectedAreaPlugin-1.0.jar from your distribution source.

  2. Place it in the plugins folder

    Copy the JAR to your server's plugins/ directory.

  3. Start the server

    On first launch, the plugin automatically creates all required folders and configuration files inside plugins/ProtectedAreaPlugin/.

  4. Verify the plugin loaded

    Check your server console for the line "[ProtectedAreaPlugin] Enabling...". The plugin is ready to use.

Generated File Structure

plugins/
  ProtectedAreaPlugin/
    Config/
      Config.yml            ← mod-required flag and kick message
    AreaNotification/
      Rules.yml             ← basic rule violation messages
      AdvancedRules.yml     ← advanced rule violation messages
    areas/                  ← one YAML file per protected area

Client Mod Installation

  1. Install Fabric Loader

    Download and run the Fabric Installer for Minecraft 1.21 from fabricmc.net/use/installer. Select your Minecraft version and click Install.

  2. Add Fabric API

    Download the latest Fabric API for 1.21 and place it inside your .minecraft/mods/ folder. Fabric API is a required dependency.

  3. Add the client mod JAR

    Copy ProtectedAreaClient.jar into the same .minecraft/mods/ folder.

  4. Launch with the Fabric profile

    Open the Minecraft Launcher, select the Fabric profile, and launch the game. The mod activates automatically when connecting to a compatible server.

Controls

Action Default Key Description
Debug: Next PageRight ArrowAdvances to the next page in the Debug HUD.
Debug: Previous PageLeft ArrowGoes back to the previous page in the Debug HUD.

Permissions

The plugin uses a single permission node that gates access to all administrative commands.

Permission Description Default
protectedarea.admin Full access to all /area commands and subcommands. OP