Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
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):
✨ 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>
- Commands:
🧍 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)
- Poses:
- 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>
- Commands:
🎭 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)
This has not been fully tested
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