CptFullPlugin
CptFullPlugin 是一款专为 Paper 1.21(Java 21)打造的全面、一站式 Minecraft 服务器插件。它将此前三个独立的插件——CptPlugin、CptAdmin 和 CptInfo——合并为一个统一的 jar 包,并共享配置与权限系统。
? 依赖项
- 必需: Paper(或其分支)1.21+,Java 21+
- 软依赖(可选但推荐):
✨ 功能概览
? 基础指令与 TPA 系统
核心玩家指令以及一套完整的基于请求的传送系统,支持超时机制和退出选项切换。
| 功能 |
指令 |
描述 |
| 出生点传送 |
/spawn |
传送至出生点(可配置 XYZ 坐标及偏航角/俯仰角) |
| 返回 |
/back |
在传送或死亡后返回上一个位置 |
| 规则 |
/pravidla |
以游戏内书籍的形式显示服务器规则 |
| 帮助 |
/cpthelp |
分类的帮助菜单 |
| TPA 系统 |
/tpa <player>, /tpahere, /tpaccept, /tpdeny, /tpatoggle |
安全的玩家间传送功能 |
? 家园与 ? 婚姻系统
- 家园系统: 每位玩家最多可拥有 N 个命名的家园点(上限可配置),通过 GUI(
/cpthomes)或指令(/cptsethome [name], /cpthome <name>)进行管理。拥有相应权限的玩家可拥有无限数量的家园。
- 婚姻系统: 完整的功能包括求婚、离婚、共享家园以及伴侣传送。
- 指令:
/marry <player|accept|deny|divorce|info|sethome|home|tp>
? 姿势、手势与光环
- 表达自我: 内置玩家表情动作(在可用时集成 GSit)。
- 姿势:
/sit · /lay · /crawl · /spin
- 手势:
/love · /cry · /happy · /gestures(完整 GUI 菜单)
- 玩家光环: 围绕玩家的粒子光环,强度等级为 1–20,支持开关切换,并提供按玩家设置的白名单。
- 指令:
/aura <1-20|on|off> · /aurawhitelist <player>
? 角色扮演角色系统
玩家可以转动命运之轮(/cptrole)来获得一个秘密的角色扮演身份。共有 14 种内置身份,每种身份都配有独特的背景故事,并在游戏内书籍中展示,包括:
狂热异端审判官 · 古老信仰追随者 · 无政府主义者 · 神秘主义者 · 走私犯 · 开锁专家 · 破坏者 · 双面间谍 · 灰色教皇 · 狂热编年史家 · 精神分裂猎人 · 预言守护者 · 时间旅行者 · 以及更多...
?️ 管理员注意: 可以通过使用 /cptroleplay 打开 GUI 来管理角色背包和分配。
? 任务与进度追踪 (CptInfo)
此功能尚未完全测试
每位玩家都会获得与其角色扮演身份绑定的一系列目标,系统将自动追踪进度。玩家可以通过 /cptinfo 在 GUI 中轻松查看进度。
支持的目标类型:
MOB_KILL — 击杀指定数量的实体。
ITEM_DELIVERY — 将物品交付到世界中的物理祭坛箱。
BUILD_QUEST — 建造特定的方块结构。
TRIGGER — 由高级触发引擎跟踪的条件。
⚙️ 高级触发引擎
15 种内置触发引擎,用于实现复杂且沉浸式的任务条件:
| 引擎 |
描述 |
BOOK_NAME |
将在线玩家的名称写入已签名的书籍 |
PROXIMITY |
在特定玩家附近停留一定时间 |
SMUGGLE |
进入区域且不携带违禁物品 |
MASKED_NIGHT |
夜间活动时佩戴特定面具/头盔 |
SIGN_TEXT |
在区域内放置写有特定文字的告示牌 |
SABOTAGE |
破坏特定类型的方块 |
CONTAINER_REGION |
将特定物品放入区域内的容器中 |
TROPHY_EXTRACT |
从容器中取出奖杯物品 |
MAILBOX |
将物品投入邮箱 |
COMMAND_EVENT |
执行特定指令 |
RARE_ITEM |
获得稀有物品 |
STRUCTURAL_RITUAL |
建造特定结构 |
PLAYER_KILL |
击杀其他玩家 |
MILESTONE |
达到游玩时间/统计里程碑 |
BOOK_VOLUME |
将书籍填满至指定页数 |
? 社区目标与服务器进度
- 全局进度条: 显示所有活跃玩家的平均任务完成百分比。
- 社区里程碑: 当服务器达到特定目标时(例如 20 名独特玩家或 100 总游玩小时数),自动触发控制台指令。
- 匿名提示系统: 按可配置的时间间隔在聊天频道广播随机提示(需要至少 N 名玩家在线以确保匿名保护)。
? 管理员工具 (CptAdmin)
一套完整的审核套件和管理面板,确保你的服务器尽在掌控之中。
- 惩罚: 临时或永久封禁和静音。 (
/cptban, /cptunban, /cptbanlist, /cptmute, /cptunmute)
- 出生点保护: 出生点周围的击退区域 (
/cptspawnaura, /cptspawnaurawhitelist)。
- 管理: 玩家背包查看器、管理员 GUI(
/admincpt)以及束缚/ immobilising 玩家(/bound [player])。
- 任务与角色管理: 任务管理面板(
/cptadminquest, /cptadmininfo)和角色白名单概览(/cptrolewhitelist)。
?️ 配置与文件
所有行为均通过单一的 config.yml 进行控制,并支持通过 /cptadmin reload 热重载。
插件会自动生成并管理单独的文件以保持整洁的组织结构:
config.yml · messages.yml · roles.yml · hints.yml · marry.yml · aura.yml · homes.yml · punishments.yml · rules.yml · tpa.yml · spawnaura.yml
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧