PlayerPassport
PlayerPassport adds a stylized in-game Passport GUI for every player and a privacy-friendly viewing system (request → accept/deny).
Players can set a birth date (age is calculated automatically) and join cities through a controlled invite system.
The plugin also supports City Guests (guest invites with accept/deny).
Key Features
- Passport GUI with player head/skin and structured info
- Privacy system: regular players must request access; target can accept/deny
- Staff bypass: staff can view instantly (no request, no distance)
- City system: only Admin/OP can create cities and assign a Mayor
- Mayors can invite residents; players can accept/deny or leave
- City Guests: any city member can invite a player to become a guest (accept/deny required)
- City locks: admins can lock a city for a duration + per-player exemptions
- Birthday reward: if birth date is set and today is the player's birthday → reward (once per year)
- Localization: English (default), Ukrainian, French (configurable)
- Optional integrations
- Marriageyou: automatically shows Gender and Marriage partner
- Origins (+ PlaceholderAPI): shows Race (hidden automatically if missing)
Commands
Players
/passport— open your passport/passport setbirth <YYYY-MM-DD>— set birth date/passport clearbirth— clear birth date
View Requests (privacy)
/passport request <player>— request to view someone's passport (distance + timeout configurable)/passport accept <player>— accept a view request (opens passport for requester)/passport deny <player>— deny a view request
Cities (residents, invite-only)
/passport city accept— accept city invite (become a resident)/passport city deny— deny city invite/passport city leave— leave your city (blocked if your city is locked)
City Guests
/passport city guest add <player>— invite an online player to become a guest of your city (any city member can use it)/passport city guest accept— accept a guest invite/passport city guest deny— deny a guest invite/passport city guest leave— leave the city as a guest (remove yourself from guest list)/passport city guest remove <player>— remove a guest from your city (any city member can use it)/passport city guests— list guests of your city
Mayor
/passport city invite <player>— invite player to your city (resident invite)/passport city members— list members of your city/passport city kick <player>— kick a member from your city
Admin
/passport city create <city> <mayor>— create city and set mayor/passport city delete <city>— delete city/passport city setmayor <city> <player>— change mayor/passport city list— list all cities/passport city members <city>— view members of a city/passport citylock add <city> <duration> [reason]— lock city (30m/12h/7d/1w…)/passport citylock remove <city>— remove lock/passport citylock list— list locks/passport citylock exempt add <player> <city>— add exemption/passport citylock exempt remove <player> <city>— remove exemption/passport citylock exempt list <player>— list exemptions/passport reload— reload config/languages/data
PlaceholderAPI Placeholders
City (resident)
%playerpassport_city%— your city display name (empty if not in a city)%playerpassport_city_key%— your city key (empty if not in a city)
City checks
%playerpassport_is_in_city%—true/false%playerpassport_is_in_city_<city>%—true/falsefor a specific city
Examples:%playerpassport_is_in_city_kyiv%,%playerpassport_is_in_city_New_York%
Guests
%playerpassport_is_guest_anywhere%—true/false%playerpassport_is_guest_in_<city>%—true/falsefor a specific city
Examples:%playerpassport_is_guest_in_kyiv%,%playerpassport_is_guest_in_Red_City%%playerpassport_guest_city%— guest city key (empty if not a guest)%playerpassport_guest_city_name%— guest city display name (empty if not a guest)
Lists
%playerpassport_city_citizens%— comma-separated list of residents in your city%playerpassport_city_guests%— comma-separated list of guests in your city%playerpassport_city_citizens_<city>%— residents list for a specific city%playerpassport_city_guests_<city>%— guests list for a specific city
City locks
%playerpassport_city_locked%—true/falsefor your city%playerpassport_city_locked_<city>%—true/falsefor a specific city%playerpassport_city_lock_remaining%— remaining lock time for your city (e.g.7d 3h) or empty%playerpassport_city_lock_remaining_<city>%— remaining lock time for a specific city
Permissions
Player
passport.usepassport.editpassport.view.other
Staff
passport.view.bypass
Admin
passport.city.adminpassport.admin.citylockpassport.admin.exemptpassport.citylock.bypasspassport.admin.reload
Notes
- Language placeholders in messages use
{city}format (not%city%). - Requires Paper (1.21.x). PlaceholderAPI is optional (only needed for placeholders).
