PlayerPassport

PlayerPassport adds a stylized in-game Passport GUI for every player and a privacy-friendly viewing system (request → accept/deny).
Players can store a birth date (age is calculated automatically) and join cities through a controlled invite system.

---

Key Features

• Passport GUI with player head/skin and structured info
• Privacy system: regular players must request access; target player can accept/deny
• Staff bypass: police/helper/moderator/admin can view instantly (no request, no distance)
• City system: only Admin/OP can create cities and assign a Mayor
  Mayors can invite players; players can accept/deny invites or leave a city
• City locks: admins can lock a city for a duration (blocks leaving/changing city) + exemptions
• Birthday reward: if birth date is set and today is the player’s birthday → reward item (default: 🎂 cake), once per year
• Localization: English (default), Ukrainian, French (switchable in config)
• Optional integrations
  • Marriageyou: shows Gender and Marriage partner automatically
  • 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
• /passport deny <player> — deny a view request

Cities (invite only)

• /passport city accept — accept city invite
• /passport city deny — deny city invite
• /passport city leave — leave your city (blocked if your city is locked)

Mayor

• /passport city invite <player> — invite player to your city
• /passport city members — list your city members
• /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

---

Permissions (LuckPerms)

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