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).