CptFullPlugin

CptFullPlugin is a comprehensive, all-in-one Minecraft server plugin built for Paper 1.21 (Java 21). It merges three previously separate plugins — CptPlugin, CptAdmin, and CptInfo — into a single, unified jar with a shared configuration and permission system.

🔌 Dependencies

• Required: Paper (or forks) 1.21+, Java 21+
• Soft-dependencies (Optional but recommended):
  • LuckPerms (5.4+)
  • GSit (3.3.3+)

---

✨ Feature Overview

🏠 Essentials & TPA System

Core player commands and a complete request-based teleportation system with timeouts and opt-out toggles.

Feature	Commands	Description
Spawn TP	/spawn	Teleport to spawn (configurable XYZ + yaw/pitch)
Back	/back	Return to last position after TP or death
Rules	/pravidla	Displays server rules as an in-game book
Help	/cpthelp	Categorised help menu
TPA System	/tpa <player>, /tpahere, /tpaccept, /tpdeny, /tpatoggle	Safe player-to-player teleportation

🏡 Home & 💍 Marriage Systems

• Home System: Up to N named home points per player (configurable limit), managed via GUI (/cpthomes) or commands (/cptsethome [name], /cpthome <name>). Unlimited homes available via permissions.
• Marriage System: Full player-marriage feature including proposals, divorce, shared home, and partner teleport.
  • Commands: /marry <player|accept|deny|divorce|info|sethome|home|tp>

🧍 Poses, Gestures & Auras

• Express Yourself: Built-in player expressions (integrates with GSit when available).
  • Poses: /sit · /lay · /crawl · /spin
  • Gestures: /love · /cry · /happy · /gestures (Full GUI Menu)
• Player Aura: Particle aura around the player with intensity levels 1–20, on/off toggle, and a per-player whitelist.
  • Commands: /aura <1-20|on|off> · /aurawhitelist <player>

---

🎭 Roleplay Role System

Players can spin a Wheel of Fortune (/cptrole) to receive a secret roleplay role. There are 14 built-in roles, each with a unique backstory displayed in an in-game book, including: Fanatical Inquisitor · Old Faith Devotee · Anarchist · Occultist · Smuggler · Safe-cracker · Saboteur · Double Agent · Grey Eminence · Fanatic Chronicler · Schizophrenic Hunter · Prophecy Guardian · Time Traveller · and more...

🛠️ Admin Note: Role inventories and assignments can be managed via the GUI using /cptroleplay.

---

📋 Quest & Progress Tracking (CptInfo)

Each player gets a set of objectives tied to their roleplay role, tracked automatically. Progress is easily viewed in a GUI via /cptinfo.

Supported Objective Types:

• MOB_KILL — Kill a set number of entities.
• ITEM_DELIVERY — Deliver items to a physical Altar Chest in the world.
• BUILD_QUEST — Build a specific block structure.
• TRIGGER — Condition tracked by the advanced trigger engine.

⚙️ Advanced Trigger Engine

15 built-in trigger engines for complex, immersive quest conditions:

Engine	Description
BOOK_NAME	Write online players' names into a written book
PROXIMITY	Spend time near a specific player
SMUGGLE	Enter a zone without forbidden items
MASKED_NIGHT	Be active at night wearing a specific mask/helmet
SIGN_TEXT	Place a sign with specific words inside a zone
SABOTAGE	Break specific block types
CONTAINER_REGION	Insert specific items into containers within a zone
TROPHY_EXTRACT	Remove a trophy item from a container
MAILBOX	Insert an item into a mailbox
COMMAND_EVENT	Execute a specific command
RARE_ITEM	Obtain a rare item
STRUCTURAL_RITUAL	Build a specific structure
PLAYER_KILL	Kill another player
MILESTONE	Reach a playtime/stat milestone
BOOK_VOLUME	Fill a book to a certain page count

---

🌍 Community Goals & Server Progress

• Global Progress Bar: Shows the average quest completion % across all active players.
• Community Milestones: Auto-triggers console commands when the server reaches specific goals (e.g., 20 unique players or 100 total play-hours).
• Anonymous Hint System: Broadcasts random hints in chat at configurable intervals (requires a minimum of N players online for anonymity protection).

---

🔒 Admin Tools (CptAdmin)

A full moderation suite and administration panel to keep your server under control.

• Punishments: Temporary or permanent bans and mutes. (/cptban, /cptunban, /cptbanlist, /cptmute, /cptunmute)
• Spawn Protection: Knockback zone around spawn (/cptspawnaura, /cptspawnaurawhitelist).
• Management: Player inventory viewer, admin GUI (/admincpt), and binding/immobilising players (/bound [player]).
• Quest & Role Admin: Panel for quest management (/cptadminquest, /cptadmininfo) and role whitelist overview (/cptrolewhitelist).

---

🛠️ Configuration & Files

All behaviour is controlled through a single config.yml which supports hot-reloading via /cptadmin reload.

The plugin automatically generates and manages separate files for clean organization: config.yml · messages.yml · roles.yml · hints.yml · marry.yml · aura.yml · homes.yml · punishments.yml · rules.yml · tpa.yml · spawnaura.yml