CitizenPass
- By
CitizenPass adds a full-fledged passport system to Minecraft role-playing servers. Each player receives his own passport with character data, which can be opened through the GUI. The plugin uses SQLite to store data.
📖 CitizenPass
A passport system for Minecraft RP servers. Every player receives a passport with their RP data — opened via a convenient GUI, stored in a database, and integrated with other plugins through a public API.
✅ A single jar works across the full version range — from 1.16.5 to 1.21.x (Paper, Spigot, Purpur). No separate builds for each version.
✨ Features
- 📖 Passport item (
PAPER) — opens on right-click - 🖼️ 54-slot GUI with the player's head as a photo
- 💾 SQLite storage — no external database required
- 🎨 Flexible text formatting —
&-codes, hex colours&#rrggbb, and gradients - 🔐 Flexible permissions — compatible with LuckPerms and PermissionsEx
- 🔌 Public API for integration with other plugins (e.g. a wedding plugin)
- ♻️ Hot reload of configuration without restarting the server
📋 Passport Fields
| Field | Description |
|---|---|
| 🪪 RP Name | Character name |
| 🎂 Date of Birth | e.g. 15.03.1995 |
| 🏙️ Place of Birth | City / location |
| 💍 Marital Status | Updated by the wedding plugin |
| 💼 Profession | Character's occupation |
| 🛂 Citizenship | City / state |
| 👫 Spouse | RP name of the other half |
⌨️ Commands
| Command | Permission | Description |
|---|---|---|
/passport |
passport.use |
Open your own passport |
/passport <player> |
passport.view |
Open another player's passport |
/passport set <field> <player> <value> |
passport.edit |
Edit a passport field |
/passport give [player] |
passport.admin |
Give the passport item |
/passport reload |
passport.admin |
Reload config.yml |
/passport help |
passport.use |
List available commands |
Aliases: /pass, /pasport
🔐 Permissions
| Permission | Default | Description |
|---|---|---|
passport.use |
✅ everyone | Open your own passport |
passport.view |
🔧 op | View other players' passports |
passport.edit |
🔧 op | Edit passport data (for officials / clerks) |
passport.admin |
🔧 op | Full access (includes all permissions above) |
⚙️ Configuration
The config.yml file is created on first launch. Customisable options:
The CitizenPass Team
