CourierNew - 信使邮件系统

💡简介

CourierNew 是一款为 Spigot 服务器设计的实体邮件系统插件。它允许玩家以书本的形式撰写并发送信件，并通过邮差 NPC 进行投递。管理员可以利用此插件一次性向所有玩家发送公告，确保重要消息能被每位玩家看到。

❓起源与目的

CourierNew 是基于一个已停止更新的 Bukkit 插件 Courier 进行部分重制的全新插件。它的开发旨在将原插件的核心功能带到更新版本的 Minecraft 中，并优化其内部逻辑，提供更稳定、更现代的体验。

⭐功能特性

• 实体邮差系统：信件通过生成的邮差 NPC 投递给玩家。
• 灵活发送：支持向单个、多个、所有在线或所有曾加入服务器的玩家发送信件。
• 信件管理：可以撰写、编辑、接收未读邮件以及销毁信件。
• 高度可配置：可调整邮差行为、延迟、生成规则等。
• 权限控制：细致的权限节点，方便管理不同玩家的使用范围。

🎮命令列表

• /letter <消息>

撰写一封新信件。消息中允许使用 Minecraft 颜色代码和 \n 换行符。如果手中已有一封由你撰写但未发送的信件，此命令会将新消息追加到该信件中。

• /post <玩家>

将手中的信件发送给指定玩家。可通过逗号分隔用户名来同时发送给多个玩家。

• 使用 /post * 可发送给所有在线玩家。
• 使用 /post ** 可发送给所有曾加入过服务器的玩家。

• /unread

收取所有未读邮件。

• /shred

销毁手中的信件。

• /shredall

销毁背包中的所有信件。

• /couriernew help

显示帮助信息。

• /couriernew reload

重新加载所有配置文件。

🔧安装与要求

运行环境要求

• 服务器核心：Spigot 或 Paper (1.14 - 1.19)
• Java 版本：Java 8 或更高版本

安装步骤

• 下载最新版本的插件 JAR 文件。
• 将 JAR 文件放入服务器的 plugins 文件夹。
• 启动或重启服务器。

✨配置说明

首次运行后，插件会生成默认配置文件。主要配置文件内容及说明如下：

receive-delay: 100
resend-delay: 2400
remove-delay: 200
spawn-distance: 5
protected-courier: true
courier-entity-type: VILLAGER
blocked-gamemodes: []
blocked-worlds: []

• receive-delay：信件接收的延迟时间（单位：游戏刻）。此设置用于玩家加入服务器、发送信件后，或离开被禁用的世界/游戏模式时。
• resend-delay：当邮件未被领取时，重新尝试投递的等待时间（单位：游戏刻）。
• remove-delay：邮差生成后，等待多久将其移除（单位：游戏刻）。
• spawn-distance：邮差在距离玩家多少格远的位置生成（单位：方块）。
• protected-courier：是否保护邮差，防止其他玩家从非自己的邮差那里取走邮件。
• courier-entity-type：邮差的实体类型（默认为 VILLAGER）。
• blocked-gamemodes：禁止接收邮件的游戏模式列表（例如：[SURVIVAL, CREATIVE]）。
• blocked-worlds：禁止接收邮件的世界名称列表。

消息文件配置

消息配置文件支持颜色代码。在默认包含 $PLAYER$ 占位符的消息中，它会被替换为相应的玩家名称。各条消息的名称已说明了其用途。

数据文件

第三个配置文件用于存储待发送的邮件数据。除非你确切知道自己在做什么，否则请不要修改此文件！

⭐权限节点

• couriernew.letter - 允许玩家撰写/编辑信件。
• couriernew.post.one - 允许玩家每次向一名玩家发送信件。
• couriernew.post.multiple - 允许玩家同时向多名玩家发送信件。
• couriernew.post.allonline - 允许玩家向所有在线玩家发送信件。
• couriernew.post.all - 允许玩家向所有曾加入服务器的玩家发送信件。
• couriernew.help - 允许玩家使用帮助命令。
• couriernew.shred - 允许玩家销毁一封信件。
• couriernew.shredall - 允许玩家销毁背包中的所有信件。
• couriernew.unread - 允许玩家收取未读邮件。
• couriernew.reload - 允许重新加载插件配置。

🔧故障排除

邮差不生成？

请按以下步骤检查

• 在 WorldGuard 配置中，将 block-plugin-spawning 设置为 false。
• 在 server.properties 文件中，确保 allow-npcs 设置为 true。
• 如果使用了 EssentialsProtect，请确保没有阻止村民（或其他设定实体）的生成。
• 检查是否有其他插件阻止了生物生成。