
# PooperMC
是一个一体化解决方案,适用于您的 Minecraft 服务器网络,旨在在一个简单的插件中提供您所需的所有功能。PooperMC 轻量且高效,力求在保持简单且易于维护的代码库的同时,提供尽可能多的功能。
使用 Java 21+ 的现代化代码库可实现快速响应时间和始终最新的代码。
虽然该插件仍在开发中,但它已经是一个有效且轻量级插件的理想选择,适用于任何需要运行插件的服务器网络。
了解更多信息,请访问 https://marcpg.com/pooper (即将推出)!
## 要求
- **Java 21 或更高版本**。 查找有关如何安装或更新 Java 的说明 [在此](https://docs.papermc.io/misc/java-install)。
- **SignedVelocity** (仅适用于 Velocity): https://modrinth.com/plugin/signedvelocity
## 发布
您可以在这些平台上找到我们的官方发布版:
- Modrinth (推荐): [modrinth.com/plugin/pooper](https://modrinth.com/plugin/pooper)
- GitHub: [github.com/MarcPG1905/PooperMC/releases](https://github.com/MarcPG1905/PooperMC/releases)
- Hangar: [hangar.papermc.io/MarcPG1905/PooperMC](https://hangar.papermc.io/MarcPG1905/PooperMC)
- SpigotMC: [spigotmc.org/resources/poopermc.115129](https://www.spigotmc.org/resources/poopermc.115129/)
- Planet Minecraft: [planetminecraft.com/mod/peelocity-all-in-one-proxy-plugin](https://www.planetminecraft.com/mod/peelocity-all-in-one-proxy-plugin/)
- CurseForge: [curseforge.com/minecraft/bukkit-plugins/pooper](https://www.curseforge.com/minecraft/bukkit-plugins/pooper)
## 特性
大多数功能可以在配置中启用或禁用。
有些默认情况下未启用,因此请务必查看配置!
### 聊天实用程序
一些可以改善聊天体验的功能。
- **消息记录:** 所有消息都会被记录下来,管理员可以使用 `/msg-hist` 查看。
- **私信:** 您可以使用 `/msg PlayerName` 或 `/w` 来全局发送消息或回复。
- **提及:** 通过编写 `@PlayerName`,您可以标记其他玩家或 `@everyone`。
- **聊天颜色:** 您可以在聊天中使用 MiniMessage 的颜色和样式。
### 自定义服务器列表
指你在多人游戏服务器列表中看到的所有内容。
- **更好的 MotD:** 使用 MiniMessage 的简单自定义 MotD,可以随机化。
- **更好的 Favicon:** 可以随机化的来自图片链接的自定义服务器图标。
- **在线玩家数:** 您可以设置自定义或虚假的在线玩家数,虽然这不诚实且不建议这样做。
- **更好的玩家上限:** 您可以设置自定义的最大玩家数。它还允许最大玩家数始终比在线玩家数多一个。
### 模版
所有与模版相关的内容也会发送到 Discord Webhook。
- **封禁:** 带有到期日期的封禁、永久封禁和原因。
- **踢出:** 带有原因的踢出。
- **静音:** 带有到期日和原因的静音。
- **举报:** 任何人都可以使用的便捷举报功能,并且非常易于使用。
- **工作人员聊天:** 所有工作人员(pee.staff 权限)都可以私密聊天的工作人员聊天。
### 社交功能
一些适合大型游戏模式服务器的社交功能。
- **好友系统:** 一个简单的好友系统,带有好友请求,但功能不多。
- **队伍系统:** 一个简单的队伍系统,带有邀请、一起加入匹配和队伍聊天。
### Paper 模块
所有模块默认情况下都已禁用,并且是完全可选的。您可以在配置的 `modules` 下启用它们。
- **矿脉开采:** 完全可配置的矿脉开采,带有动画、适当的项目耐久度等。
- **更好的生物 AI:** 允许生物在一只受到攻击时全盘恐慌,或者通常拥有更智能的 AI。
- **死亡封禁:** 如果玩家死亡或被击杀,将封禁或踢出该玩家。完全可定制。
- **取消砂轮上限:** 将取消砂轮成本限制,而只是让成本增长得更慢,从 40 级开始,以避免成本达到 500 级等荒谬的数字。
- **更好的睡眠:** 可以根据配置优化睡眠,例如更多地跳过夜晚,更强大的玩家计算,甚至做梦。
- **自定义 AFK:** 一个可以根据您的喜好配置的简单 AFK 功能。
- **实用方块命令:** 用于打开实用方块(如工作台、验光台或您的末影箱)的命令,而无需放置方块。
- **全局末影箱:** 服务器上的每个人都可以访问的全局末影箱。 充当社区宝箱。
### 其他
一些无法分类但仍然不错的功能。
- **全局白名单:** 在代理而不是后端服务器上运行的白名单。
- **自定义加入逻辑:** 用于加入在配置中配置的游戏模式的实用程序,还支持通过 `pooper:joining` 进行插件消息,适用于大堂插件。
- **玩家缓存:** 缓存所有玩家及其姓名和 UUID 以备将来使用,即使他们离线。
## 用法
### 配置
配置设计为简单且描述性。您可以在配置文件的内部找到所有您需要的内容,该文件附带了有用的描述。
### 翻译
翻译会自动从 [简单的数据库](https://marcpg.com/poopermc/translations/) 下载,这意味着您只需要有一个稳定的互联网连接,而无需做任何事情。每次启动时,下载本身只会占用几千字节。
### 数据存储
您可以设置在配置中设置的多种存储数据方式。YAML 和 RAM 不需要额外的配置。
但是,如果您想使用数据库,则需要自行设置。有关简单说明,请访问 [数据库帮助页面](https://marcpg.com/poopermc/database) (即将推出)!
## 未来目标
我们希望在未来添加的一些主要功能包括:
- 简单的轻量级的 TAB-list 实用程序。
- 更多样化的模版实用程序,例如消失。
- 一些功能使用库存界面而不是纯命令。
- 需要更多翻译,以使该插件和使用该插件的所有服务器对所有人都能访问。
## 联系方式
### Discord
您可以加入我的 Discord 社区,并直接 ping 我获取快速回复:https://discord.gg/HvWhqY3kRG
### 直接联系
如果您不使用 Discord 或希望通过其他方式联系我,请依赖以下方法之一:
- 电子邮件:[me@marcpg.com](mailto:me@marcpg.com)
- Discord:@marcpg1905
## 供开发人员使用
### 使用的库
PooperMC 旨在尽可能轻量级。我们仅使用三个非常小的实用程序库:
- [LibPG](https://github.com/MarcPG1905/LibPG) - 由 MarcPG 提供的实用程序库,具有各种功能,例如下载、对、时间格式等。
- [boosted-yaml](https://github.com/dejvokep/boosted-yaml) - 提供可靠且轻量级的配置文件库,具有文件版本等。
- [libby](https://github.com/AlessioDP/libby) - 允许动态下载数据库驱动程序,以获得更小的文件大小。