DeliverySystem
适用于 Paper Minecraft 服务器(1.20.x)的完整、高度可配置的配送系统。 玩家从发送者 NPC 处领取包裹,在限定时间内将其运送给接收者 NPC,并以此获得金钱奖励(通过 Vault)、原版经验值以及带有完整升级系统的内部“快递员”经验值。
无需硬性依赖——Vault 是可选的(软依赖),仅用于金钱奖励。NPC 使用原版实体(默认为村民),无需第三方插件。
✨ 特性
- 6 种任务类型:普通、紧急、易碎、贵重、夜间、秘密——每种都有各自的奖励倍率、时间限制和权限要求。
- 4 个难度等级(简单 / 普通 / 困难 / 极端),影响最大距离、奖励倍率和获得的经验值。
- 防篡改包裹:通过
PersistentDataContainer进行标识——绝不使用名称或描述,后者仅作为装饰性用途。 - 持久化配送 NPC:在游戏中创建/移除,无外部依赖。
- 带奖惩机制的计时器:提前送达可获得奖励加成,迟到会受到惩罚,超时则任务失败。
- 可配置的任务冷却时间(可通过权限绕过)。
- 快递员升级系统:包含经验值和完全自定义的职衔称号。
- 统计信息、历史记录和排行榜,各自拥有专用的游戏内 GUI。
- YAML 或 SQLite 存储,可从配置中完全切换,实现 100% 异步 I/O(绝不影响主线程)。架构已为未来的 MySQL 后端做好准备。
- 公共 API (
DeliverySystemAPI),允许其他插件创建、分配和完成配送,或读取快递员统计信息。 - 完善的生命周期处理:登出、死亡、世界切换、服务器重启——数据不会丢失或损坏。
? 命令
| 命令 | 描述 |
|---|---|
/delivery |
打开可用任务菜单 |
/delivery accept <id> |
接受一项任务 |
/delivery cancel |
取消当前活跃任务 |
/delivery info |
显示你的活跃任务信息 |
/delivery history [page] |
查看你的配送历史 |
/delivery stats |
查看你的快递员统计信息 |
/delivery leaderboard |
全服快递员排行榜 |
/deliveryadmin create <sender|receiver> <id> [name] |
在你所在位置创建一个 NPC |
/deliveryadmin remove <id> |
移除一个 NPC |
/deliveryadmin give <player> <type> [difficulty] |
手动分配一项任务 |
/deliveryadmin reload |
重新加载配置 |
/deliveryadmin debug |
显示诊断信息 |
? 权限
deliverysystem.use— 基础使用权限(默认:所有人)deliverysystem.admin— 基础管理员权限(默认:op)deliverysystem.admin.create/.remove/.give/.reload/.debugdeliverysystem.bypass.cooldowndeliverysystem.mission.urgent/.fragile/.valuable/.night/.secret
完整列表见 permissions.md (发布后更新链接)。
⚙️ 要求
- Paper 1.20.x 或兼容分支 —— 不支持原版 Spigot(使用了仅限 Paper 的 API)。
- Java 17+
- Vault + 兼容的经济插件(可选,仅用于金钱奖励时需要)。
? 存储
- YAML —— 每个数据类别一个文件,加上每个玩家一个文件。适合小型服务器。
- SQLite(默认)—— 单文件数据库,JAR 包中内置纯 Java JDBC 驱动,无需原生依赖。推荐大多数服务器使用。
- MySQL —— 架构已就绪(共享 JDBC 池接口),实现在未来版本中推出。
? 许可证
根据 MIT License 发布。
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
46
Beds Always Explode
rabiesland
使床在所有维度中爆炸的模组
诅咒玩法机制
30
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧