ProClaimAuth

# ProClaimAuthForge

Server-side Forge utility mod for authentication, claims, homes, warps, TPA, ranks, join titles, premium skin restoration and timed ground item cleanup.

## Installation

1. Download the JAR that matches your Minecraft/Forge server version.
2. Put the JAR into the server `mods` folder.
3. Do not install it on player clients. This mod is designed to run server-side only.
4. Start the server once to generate the config files.
5. Enable only the systems you want with `/modsystem`.

All modules are disabled on first install. This is intentional so server owners can enable features one by one.

## Module control

Only operators can use `/modsystem`.

Commands:

- `/modsystem` — shows every module and whether it is on/off.
- `/modsystem <module> on` — enables a module.
- `/modsystem <module> off` — disables a module.

Available modules:

- `auth`
- `claim`
- `home`
- `warp`
- `tpa`
- `rank`
- `skin`
- `loginmessage`
- `itemcleanup`
- `safezone`

Examples:

- `/modsystem auth on`
- `/modsystem claim on`
- `/modsystem skin on`
- `/modsystem itemcleanup on`
- `/modsystem safezone on`

## Authentication

Enable with:

- `/modsystem auth on`

Commands:

- `/register <password> <password>` — registers your account.
- `/login <password>` — logs into your account.
- `/logout` — locks your session again.
- `/changepassword <oldPassword> <newPassword>` — changes your password.

While not logged in, players are restricted until they authenticate.

## Claims

Enable with:

- `/modsystem claim on`

Commands:

- `/claim` — shows claim help and selection information.
- `/claim create` — creates a claim from the current selection.
- `/claim delete` — deletes the claim you are standing in if you own it.
- `/claim list` — lists your claims.
- `/claim trust <player>` — allows a player to build in your claim.
- `/claim untrust <player>` — removes trust.
- `/claimblocks` — shows your available claim block allowance.

The default selection tool is configurable in `proclaimauthforge.cfg`.

## Homes

Enable with:

- `/modsystem home on`

Commands:

- `/sethome <name>` — saves a home.
- `/home <name>` — teleports to a saved home.
- `/homes` — lists homes.
- `/delhome <name>` — deletes a home.

## Warps

Enable with:

- `/modsystem warp on`

Commands:

- `/setwarp <name>` — creates a server warp. Operator only.
- `/delwarp <name>` — deletes a server warp. Operator only.
- `/warp <name>` — teleports to a warp.
- `/warps` — lists warps.

## TPA

Enable with:

- `/modsystem tpa on`

Commands:

- `/tpa <player>` — sends a teleport request.
- `/tpaccept` — accepts the latest teleport request.
- `/tpdeny` — denies the latest teleport request.

Requests expire automatically.

## Ranks

Enable with:

- `/modsystem rank on`

Operator commands:

- `/addrank <rank> <color> [displayName]` — creates or updates a rank.
- `/setrank <player> <rank|none>` — assigns or removes a rank.

Color examples:

- `red`
- `gold`
- `green`
- `blue`
- `&c`
- `&6`

Example:

- `/addrank admin red Admin`
- `/setrank Steve admin`

The rank appears beside the player name in chat/name formatting, such as `[Admin] Steve`.

## Login message

Enable with:

- `/modsystem loginmessage on`

When enabled, joining players see a large title and subtitle on screen. Text can be edited in `proclaimauthforge.cfg`:

- `loginmessage.title`
- `loginmessage.subtitle`

Color codes with `&` are supported.

## SkinRestorer

Enable with:

- `/modsystem skin on`

Commands:

- `/skin set <premiumName>` — applies and saves the skin from a premium Minecraft account name.
- `/skin clear` — removes the saved override and tries to use the player’s own premium name again.

When the module is enabled, the mod automatically tries to load a premium skin on join. This is fully server-side and uses Mojang session/profile APIs. Client-side skin caching can sometimes delay visual refreshes until relogging.

## Ground item cleanup

Enable with:

- `/modsystem itemcleanup on`

The mod periodically removes dropped ground items from all worlds to help reduce lag. The interval is configurable in `proclaimauthforge.cfg`:

- `itemcleanup.interval_seconds`

Default interval: 300 seconds.

## SafeZone

Enable with:

- `/modsystem safezone on`

Operator commands:

- `/safezone pos1` — sets the first corner to your current position.
- `/safezone pos2` — sets the second corner to your current position.
- `/safezone create <name>` — creates or updates a safezone from the selected area.
- `/safezone remove <name>` — removes a safezone.
- `/safezone list` — lists all safezones.
- `/safezone info` — shows information about the safezone you are standing in.

Players inside a safezone do not take damage. This includes common damage types such as mobs, players, fall damage, fire and environmental damage.

Safezones also protect the area itself for non-operator players:

- block breaking
- block placing
- chest/furnace/container interaction
- bucket use
- entity interaction
- explosion block damage

Operators can still edit and manage safezone areas.

## Server-side-only design

Players do not need to install this mod. The server accepts vanilla/unmodded clients because the mod is marked as server-side only and accepts missing client-side versions.