MCDR-Plugins
MCDRpost
版权信息
一些更新信息
[!WARNING]
Added on 2025 6th Sept.: 已经实现了旧版本数据文件的自动升级转换, 见 README 或者 release
- 如果直接加载新版本, 旧版的订单数据不能被加载, 但是原来的数据仍然存在, 并且会创建一个新的空文件
orders.json来存储订单数据
更新日志见 CHANGELOG
介绍
一个用于邮寄/传送物品的MCDR插件
依赖
- Python >= 3.10
- MCDReforged >= 2.15.0
- Minecraft Data API 任意版本
- Minecraft >= 1.13 (如果不使用自定义 Handler)2
[!IMPORTANT] 我们十分推荐开启服务器的 RCON
安装
将在 release 或 catalogue 下载的 .mcdr 插件文件放入插件目录下加载即可
[!NOTE]
从 MCDR v2.12.0 开始, MCDR 内可以通过命令直接从插件仓库安装插件, 而不需要再自行下载插件.
对于 MCDRpost, 可以使用以下命令
!!MCDR plugin install mcdrpost来安装, 这也是推荐做法
功能
使用该插件可以将副手的物品发送给别的玩家
也可以发送给离线玩家（但该玩家必须曾经进过服务器）
不可以发送给自己哦~
- 玩家发出物品后, 物品(订单)将会存放在【中转站】
- 需要收件人收取订单才能收到物品, 之后【中转站】会删除该订单
- 还未查收的订单可以取消, 物品会从【中转站】退回, 并删除订单
- 每人存放【中转站】的订单数有上限, 以防止把邮件寄送作为储存箱等的滥用
- 如果你要问为啥一定是用副手传送接收呢 , 因为
- 用
give传到身上任意栏位, 如果身上东西多的话, 传回来还要找一下, 比较麻烦, 还不容易找到传回来的是哪个东西 - 如果身上东西满了的话
give是拿不到物品的, 防止粗心大意的小天才 - 该插件传送和接收前均会检查并提示副手物品, 不用担心会直接 replace 掉原本副手的物品
- 当然为什么不传送当前主手所持栏位进行传送呢？
因为懒2333
- 用
使用
| 命令(全写) | 缩写 | 说明 |
|---|---|---|
!!post |
!!po |
显示帮助信息, 所有的 !!post 都可以换成 !!po |
!!post post <player> [comment] |
!!po p <player> [comment] |
发送副手物品, 可以没有备注 |
!!post receive <orderid> |
!!po r <orderid> |
接收输入单号的物品到副手 |
!!post cancel <orderid> |
!!po c <orderid> |
取消订单, 仅限对方未收取时 |
!!post post_list |
!!po pl |
列出发件列表 |
!!post list post |
!!po ls post |
列出发件列表 |
!!post receive_list |
!!po rl |
列出收件列表 |
!!post list receive |
!!po ls receive |
列出收件列表 |
!!post list players |
!!po ls players |
列出已注册玩家名单 |
!!post player add <player> |
注册一个新玩家 | |
!!post player remove <player> |
删除已经注册的玩家 |
上面命令中的r表示receive, p表示post, l表示list, c表示cancel
Added in version 3.1.0: 支持命令的全写, 例如!!po post Flyky full-name-support
Added in version 3.1.0: list 子命令新增 post receive, 效果等同于 !!po pl 和 !!po rl
配置
MCDRpost的配置文件（3.0.0或以上）在 config/MCDRpost/config.yml 中
但是旧版本（2.1.1或以下）没有配置文件, 请自行修改插件中的 mcdrpost/__init__.py
点击快速跳转
2.1.1 及以下
[!NOTE] 该版本已归档, 不再维护, 推荐使用新版本
对于 2.1.1 及以下的版本(应该说, 2.1.0 和 2.1.1), Flyky 并没有提供配置文件, 想要配置需要编辑 mcdrpost/__init__.py 才能够修改
在 mcdrpost/__init__.py 文件中 Line 13 ~ 17, 有以下五行代码
Prefix = '!!po'
MaxStorageNum = 5 # 最大存储订单量, 设为-1则无限制
SaveDelay = 1
OrderJsonDirectory = './config/MCDRpost/'
OrderJsonFile = OrderJsonDirectory + 'PostOrders.json'
这些属性就是配置, 含义见下表
| 属性 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| Prefix | str |
'!!po' |
插件命令的前缀 |
| MaxStorageNum | int |
5 |
每个玩家最大存储的订单数量, -1 不限制 |
| SaveDelay | int |
1 |
新增 SaveDelay 个订单时保存一次 |
| OrderJsonDirectory | str |
'./config/MCDRpost/' |
订单数据文件储存的文件夹 |
| OrderJsonFile | str |
'./config/MCDRpost/PostOrders.json' |
订单数据文件的名称, 应是一个 .json 文件 |
[!NOTE] Line 18 处的
command_item = -2请别动, 这是用来自动检测版本的
3.0.0 版本或以上
在 3.0.0 版本中, xieyuen 对插件进行了模块化重构,
配置不再是写死在代码中, 而是放到了配置文件 config.yml 中
下面的 配置表 是最新版本配置文件的内容
配置表
| 属性 | Python类型 | 默认值 | 描述 | 备注 |
|---|---|---|---|---|
| allow_alias | bool |
true |
是否允许别名 | 已弃用3 |
| auto_fix | bool |
false |
是否自动修复订单 | |
| auto_register | bool |
true |
是否自动为新玩家注册 | |
| max_storage | int |
5 |
订单最大存储量, 设置为 -1 不限制 | |
| receiving_tip_delay | float |
3.0 |
提示延迟 | |
| command_prefixes | list[str] |
['!!po', '!!post'] |
命令根节点 | 已弃用3 |
| command_permission | dict |
~ | 见权限表 | 已弃用3 |
| permissions | dict |
~ | 见权限表 | 代替 command_permission |
| prefix.enable_addition | bool |
true |
是否注册多个根命令 | 代替 allow_alias |
| prefix.more_prefix | bool |
['!!post'] |
其他命令根节点 | 代替 command_prefixes |
[!NOTE] Deprecated in v3.4.0 and will be removed in v3.6:
allow_aliascommand_prefixed已经弃用并被合并到prefix内command_permission改名为permissions- 【已落实】
receive_tip_delay改名为receiving_tip_delay
权限表
[!NOTE] MCDReforged 的权限系统支持 5 种权限:
owner,admin,helper,user和guest. 在设定权限的时候, 用 0~4 五个数字代替权限等级.更多权限信息见 MCDR 官方文档
| 属性 | 默认权限 | 描述 |
|---|---|---|
| root | 0 | 根命令的权限 |
| post | 0 | 发送邮件的权限(同时包括列出发件列表的权限) |
| receive | 0 | 接收邮件的权限(同时包括列出收件列表的权限) |
| cancel | 0 | 取消邮件的权限 |
| list_orders | 2 | 获得中转站全部订单信息的权限 |
| list_players | 2 | 获得全部已注册玩家的权限 |
| player | 3 | player 子命令的权限 |
注意信息
- 可能会有部分带有特殊复杂 NBT 标签的物品无法传送, 会提示检测不到可传送的物品, 所以尝试一下即可
- 不开启 RCON 的话, 插件可能会有一定的延迟导致发送/接收失败
[!WARNING] 切勿传送原版非法堆叠数的物品!!!
例如使用 carpet 地毯堆叠的空潜影盒, 会导致该物品无法接收
自定义 Handler + 特定模组兼容 也许可以解决这个问题
[!IMPORTANT] 如果您的 Minecraft 服务器要从 1.20.5 以下升级到 1.20.5 版本或以上, 请让玩家们清空中转站, 因为订单数据的 nbt 不能自动地转化成新版本的 components, 升级之后订单的物品会因为标签结构改变而不能取走
一些图片
API
[!NOTE] 如果你在使用插件的时候没有遇到什么问题, 可以忽略这段内容
点击 此处 跳转至 MCDRpost 的自定义 Handler 文档
Future
在将来某一个时间（也许是 MCDR 不再支持 Python 3.10 的时候）, MCDRpost 将会从 Python 3.10 迁移到 3.12 或者更高版本, 届时 MCDRpost 将会进入 4.x 版本