PlayerPassport

# 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> ` — 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.b