ProClaimAuth

# ProClaimAuthForge

Server-side Forge/NeoForge utility mod: authentication, claims, safezones, homes, warps, TPA, ranks, join titles, premium skin restoration, timed ground-item cleanup, a full staff/admin toolkit, vein miner, tree feller and a virtual ender chest.

All in-game messages are **bilingual (English + Turkish)**.

## Installation

1. Download the JAR that matches your Minecraft version **and** loader (Forge or NeoForge).
2. Put the JAR into the server `mods` folder.
3. Do **not** install it on player clients — this mod is server-side only.
4. Start the server once to generate `config/proclaimauthforge/data.json`.
5. Everything is ready: **all modules are enabled by default.** Turn off what you don't want with `/modsystem`.

> **Changed in 1.0.1:** modules used to be off on first install. They are now **on** by default so the mod works out of the box.

## Supported versions

**Forge:** 1.7.10, 1.12.2, 1.18.1, 1.18.2, 1.20.1, 1.21.1, 1.21.11, 26.1, 26.1.2, 26.2
**NeoForge:** 1.20.1, 1.21.1, 1.21.11, 26.1, 26.1.2, 26.2

## Module control

Operator only.

- `/modsystem` or `/modsystem stat` — shows every module with its on/off state.
- `/modsystem all on` / `/modsystem all off` — toggles **every** module at once.
- `/modsystem <module> on|off` — toggles a single module.

Modules: `auth`, `claim`, `safezone`, `home`, `warp`, `tpa`, `rank`, `skin`, `loginmessage`, `itemcleanup`, `admin`, `veinminer`, `treefeller`, `enderchest`

## Authentication

- `/register <password> <password>`
- `/login <password>`
- `/logout`
- `/changepassword <oldPassword> <newPassword>`

Until a player logs in they are **completely frozen**: they cannot move, chat, attack, break or place blocks, or drop/pick up items. Passwords are stored salted and hashed.

## Claims

Select two corners with a **golden shovel** (right-click twice) or with commands, then create the claim.

- `/claim pos1` / `/claim pos2` — set the corners manually.
- `/claim create <name>` — creates the claim from your selection.
- `/claim remove <name>` — removes your claim.
- `/claim list` — lists your claims.
- `/claim trust <player>` / `/claim untrust <player>` — run while standing inside the claim.
- `/claimblocks` — shows your used/total claim block allowance.

Operator claim-block management:

- `/claimblocks check <player|uuid>`
- `/claimblocks add|remove|set <player|uuid> <amount>`
- `/claimblocks default [amount]`

Claims protect against block breaking/placing, container access (chests, trapped chests, furnaces, barrels…), entity interaction, bucket use, **TNT/explosion block damage**, lava and flint & steel. Owners, trusted players and operators are unaffected.

## SafeZone

Operator only.

- `/safezone pos1` / `/safezone pos2`
- `/safezone create <name>` / `/safezone remove <name>`
- `/safezone list` / `/safezone info`

Players inside a safezone take no damage, and the area gets the same protection set as claims.

## Homes and Warps

- `/sethome [name]`, `/home [name]`, `/delhome [name]` — name defaults to `home`.
- `/setwarp <name>` and `/delwarp <name>` — operator only.
- `/warp <name>`, `/warps`

## TPA

- `/tpa <player>`, `/tpaccept`, `/tpdeny` (alias `/tpdenny`)

## Ranks

Operator only.

- `/addrank <rank> <colorCode> [displayName]`
- `/setrank <player> <rank|none>`

Use a **colour code** for the colour, e.g. `&c`, `&6`, `&a`. Example:

```
/addrank admin &c Admin
/setrank Steve admin
```

Result in chat: `[Admin] Steve: hello`

## Login message

Joining players get an on-screen title and subtitle. Toggle with `/modsystem loginmessage on|off`.

## SkinRestorer

- `/skin set <premiumName>` — applies and saves a premium account's skin.
- `/skin clear` — removes the override and falls back to the player's own name.

**Fixed in 1.0.1:** the skin is now applied and refreshed **automatically on join**. Previously it only appeared after dying or re-running the command.

## Ground item cleanup

Periodically clears dropped items from the world.

**New in 1.0.1:** players are warned in chat **1 minute** and **10 seconds** before the cleanup runs, then told how many items were removed. Interval: 300 seconds.

## Admin toolkit (new in 1.0.1)

Operator only, module `admin`.

- `/admin env <player>` — opens the player's inventory as a chest you can edit.
- `/admin ec <player>` — opens the player's ender chest.
- `/admin mute <player> <duration> [reason]` / `/admin unmute <player>`
- `/admin tempban <player> <duration> [reason]`
- `/admin warn <player> [reason]` — **3 warnings = auto-kick, 6 = auto-ban.**
- `/admin history <player>` — full ban/mute/warning history.
- `/admin vanish [player]` (alias `/admin v`) — invisible and hidden from the tab list.
- `/admin god [player]` — immune to all damage.
- `/admin unbanall` — lifts every ban at once (vanilla bans + tempbans).

Duration format: `30s`, `15m`, `3h`, `7d`, `2w`. Leave empty or use `perm` for permanent.

Turning the `admin` module off disables the whole toolkit — including any currently active god/vanish states.

## Vein miner (new in 1.0.1)

Hold **shift** and mine an ore with a **pickaxe** to break the whole vein (coal, iron, gold, diamond, netherite/ancient debris, and any modded `*_ore`). Up to 64 blocks; the tool loses durability per block.

## Tree feller (new in 1.0.1)

Hold **shift** and chop a log with an **axe** to fell the whole tree. Only natural logs — planks and processed wood are not affected. Durability scales with the number of blocks.

## Virtual ender chest (new in 1.0.1)

- `/enderchest` or `/ec` — opens your own ender chest from anywhere.

## Server-side-only design

Players do **not** need to install this mod. It uses only vanilla menus and vanilla packets, registers no custom network channels, and is marked so vanilla clients can join normally.

## Version-specific limitations (please read)

- **26.1 / 26.1.2 / 26.2:** `/admin env` works for **online players only**. Offline editing works on 1.18.1 – 1.21.11.
- **1.7.10 and 1.12.2:** these builds do **not** include the 1.0.1 feature set (admin toolkit, vein miner, tree feller, ender chest, login freeze, `/modsystem all|stat`).