MinePass

MinePass adds a password gate to Paper servers using Minecraft's native Dialog system. Players are held during the configuration phase and must enter a configured password before they can enter the world.

Compatibility

Paper 1.21.11
Paper 26.1 (Not Avaliable)
Paper 26.2
Paper 26.3

The project is compiled against the Paper 1.21.11 API and uses APIs that are present across the supported range.

Features

Native Minecraft Dialog password prompt
Multiple independent passwords
Permanent passwords
Temporary passwords with configurable expiration
Custom passwords chosen by server administrators
Server lockdown
Password listing and removal
Persistent YAML storage
GitHub and Modrinth update checks
Login timeout and attempt limits
Passwords can contain spaces when entered through the command

Installation

Download the MinePass jar.
Place it in the server's plugins directory.
Start the Paper server.
Create at least one password from the server console or an operator account.

Example:

/mp create Perm Banana123

Commands

Command	Description
`/mp list`	Lists all configured passwords and their status.
`/mp create Perm <password>`	Creates a permanent password.
`/mp create Temp <password>`	Creates a temporary password.
`/mp delete <password>`	Deletes a password.
`/mp lockserver`	Rejects new connections, including valid passwords.
`/mp unlockserver`	Allows connections again.
`/mp update`	Checks GitHub and Modrinth for a newer release.

All commands require the minepass.admin permission, which defaults to operators.

Configuration

plugins/MinePass/config.yml

temporary-password-duration: 1h
maximum-password-length: 128
login-timeout-seconds: 60
maximum-login-attempts: 3

update-check:
  enabled: true
  github-repository: NotPossible-Technologies/MinePass
  modrinth-project: minepass

Temporary password durations support seconds, minutes, hours, and days.

Examples:

30s
15m
2h
7d

Data

Password data is stored in:

plugins/MinePass/data.yml

Passwords are stored as configured so /mp list can display them. Treat data.yml as sensitive server data.

Dialog behavior

MinePass uses the native Minecraft Dialog API during the connection configuration phase. The player does not enter the world until the connection is accepted.

The native Minecraft text input used by the Dialog API is not a masked password field, so entered text may be visible in the client.

Requirements

Paper
Minecraft 1.21.11 or newer within the supported version range
Java 21 or newer

Version	Minecraft	Loader	Download
MinePass 1.0.0 1.0.0	1.21.11	paper	Download
MinePass 1.0.0 1.0.0	26.3	paper	Download
MinePass 1.0.0 1.0.0	26.2	paper	Download