Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!

Lolka12321 /

PassportPlugin

Modern passport system for Paper / Spigot servers.

PassportPlugin

Modern passport system for your server

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Description

PassportPlugin is an advanced plugin for Paper 1.21.1 that adds a complete passport system to your server.
Create a unique RP atmosphere where every player has their own passport with name, surname, age, and citizenship!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✨ Key Features

Modern Interface

Beautiful GUI with gradient colors
Interactive buttons and visual effects
Country flag support (skull textures)
Unified color palette for comfortable usage
4 rows in GUI for convenient element placement

Passport Management

Create passports through beautiful AnvilGUI
Edit existing passports
View your own and others' passports (with permission)
Automatic display of name and age above head
Unique passport series and numbers

Country System

9 preset countries with flags: Russia , USA , Germany , France , UK , China , Japan , Canada , Italy
Unique series for each country (RU, US, DE, etc.)
Easy to add your own countries through config

Request System

Administrators can request to view passports
Players can accept or deny requests
Interactive clickable buttons in chat
Automatic request timeout after 30 seconds

Multi-language

Full Russian language support
Full English language support
Simple system for adding new languages
All messages are customizable

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Commands


/passport - View your passport
/passport create - Create a new passport
/passport edit - Edit your passport
/passport help - View command help
/passport check <player> - Request to view passport
/passport remove <player> - Remove player's passport
/passport reload - Reload configuration
/passport accept - Accept view request
/passport deny - Deny view request

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Permissions

Basic Permissions:


passport.*
passport.view
passport.create
passport.edit
passport.help
passport.accept
passport.deny

Admin Permissions:


passport.admin
passport.check
passport.remove
passport.reload

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ Configuration

config.yml

Language selection (en-EN or ru-RU)
GUI element position configuration
Add or modify countries
Configure flag textures

Language Files

lang/en-EN.yml
lang/ru-RU.yml

Adding Your Own Country:


countries:
  your_country:
    name: "Your Country Name"
    series: "YC"
    texture: "base64_encoded_texture"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Developer API


import fellangera.passport.api.PassportAPI;

String name = PassportAPI.get(player, "%name%");
String surname = PassportAPI.get(player, "%surname%");
String age = PassportAPI.get(player, "%age%");
String region = PassportAPI.get(player, "%region%");
String passportId = PassportAPI.get(player, "%passport_id%");

Available Placeholders: