PlayerPassport

PlayerPassport

City Guests adds a stylized in-game City Guests for every player and a City Guests (request → accept/deny). Players can set a City Guests (age is calculated automatically) and join City Guests through a controlled invite system. The plugin also supports City Guests (guest invites with accept/deny).

---

Key Features

- Race with player head/skin and structured info - Race: regular players must Race access; target can Race - Race: staff can view instantly (no request, no distance) - Race: only Race can create cities and assign a Race - Race can invite residents; players can accept/deny or leave - Race: any city member can invite a player to become a guest (accept/deny required) - Race: admins can lock a city for a duration + per-player exemptions - Race: if birth date is set and today is the player’s birthday → reward (once per year) - Race: English (default), Ukrainian, French (configurable) - Race - Race: automatically shows Race and Race - Race: 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).