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/false for 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/false for 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/false for your city
• %playerpassport_city_locked_<city>% — true/false for 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.use
• passport.edit
• passport.view.other

Staff

• passport.view.bypass

Admin

• passport.city.admin
• passport.admin.citylock
• passport.admin.exempt
• passport.citylock.bypass
• passport.admin.reload

---

Notes

• Language placeholders in messages use {city} format (not %city%).
• Requires Paper (1.21.x). PlaceholderAPI is optional (only needed for placeholders).