Logo
cptplugin
PluginLicenseRef-All-Rights-Reserved

cptplugin

All-in-one plugin for Minecraft Paper 1.21.1 RP servers

40
Downloads
2
Followers
3 weeks ago
Updated
📦
7
Versions
decorationsocialpaperpurpur
Download Latestv1.0.7View on Modrinth

📖About cptplugin

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>

🧍 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)

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