Minecraft Mods / Simple Auth

Simple Auth

v1.0.0

Complete authentication, home teleports, and land protection for offline servers.

Download JAR

Features

Authentication
/register command
/login command
SHA-256 password hashing
Spectator until authenticated
Home System
/sethome to save location
/home to teleport back
/spawn to go to spawn
Persistent storage
Residence (Land Claims)
Define claim areas
Block breaking protection
Explosion protection
Multiple residences

Commands

Authentication

Command Description
/register <pass> <pass> Register a new account (type password twice)
/login <pass> Login to your account

Home & Teleport

Command Description
/sethome Save your current position as home
/home Teleport to your saved home
/spawn Teleport to world spawn point

Residence (Land Claims)

Command Description
/res pos1 Set first corner of selection
/res pos2 Set second corner of selection
/res create <name> Create residence from selection
/res delete <name> Delete your residence
/res list List all your residences
/res info [name] Show residence information

Authentication Flow

1
Player joins server

Connection is established with the server

2
Set to spectator mode

Player cannot interact with the world until authenticated

3
Action bar prompt appears
Please register: /register <password> <password>
4
Authentication complete

Player is set to survival mode and can play normally

Creating a Residence

1
Go to first corner

Stand at one corner of your desired area and type /res pos1

2
Go to opposite corner

Stand at the opposite corner and type /res pos2

3
Create the residence

Type /res create MyBase to protect the area

Protection: Other players cannot break or place blocks in your residence. Explosions from TNT and creepers are also blocked!

Security

Passwords are hashed with SHA-256
Minimum password length: 4 characters
Players frozen until authenticated
All interactions blocked before login
Damage prevented until authenticated

Configuration

Data is stored in the server config folder:

File Contents
simpleauth_passwords.json Hashed passwords
simpleauth_homes.json Player home locations
simpleauth_residences.json Land claim data
Admin Tip: To reset a player's password, delete their entry from simpleauth_passwords.json and restart the server.

Installation

  1. Download simpleauth-1.0.0.jar
  2. Place in server mods/ folder
  3. Restart the server

Compatibility

Minecraft 1.21.11
Forge 61.0.3+
Server-side only