
PooperMC
是一款面向 Minecraft 服务器网络的“一站式”解决方案,旨在通过一个简单插件提供你所需的所有功能。PooperMC 轻量且高效,力求在保持代码库简洁易维护的同时提供尽可能多的功能。
基于 Java 21+ 的现代代码库可实现快速响应并始终保持代码最新。
尽管该插件仍在开发中,但它已经是任何需要稳定且轻量级插件的服务器网络的可靠选择。
更多信息请访问 (即将上线)!
要求
- Java 21 或更高版本。查看如何安装或更新 Java 的说明 在此处。
- SignedVelocity(仅限 Velocity):
发布版
你可以在以下平台找到我们的官方发布版:
- Modrinth(推荐):modrinth.com/plugin/pooper
- GitHub:github.com/MarcPG1905/PooperMC/releases
- Hangar:hangar.papermc.io/MarcPG1905/PooperMC
- SpigotMC:spigotmc.org/resources/poopermc.115129
- Planet Minecraft:planetminecraft.com/mod/peelocity-all-in-one-proxy-plugin
- CurseForge:curseforge.com/minecraft/bukkit-plugins/pooper
功能
大多数功能可在配置文件中启用或禁用。
部分功能默认未启用,请务必检查配置文件!
聊天工具
一些提升聊天体验的功能。
- 消息记录: 所有消息都会被记录,管理员可使用
/msg-hist查看。 - 私聊: 你可以使用
/msg PlayerName向其他玩家发送全局私信,或使用/w进行回复。 - 提及: 输入
@PlayerName可以 ping 另一位玩家,或@everyone提及所有人。 - 聊天颜色: 你可以在聊天中使用 MiniMessage 的颜色和样式。
自定义服务器列表
指你在多人服务器列表中查看服务器时看到的所有内容。
- 更好的 MotD: 使用 MiniMessage 的简单自定义 MOTD,支持随机化。
- 更好的 Favicons: 来自图片链接的自定义服务器图标,支持随机化。
- 在线玩家计数: 你可以设置自定义或虚假的在线玩家数量,但这不诚实且不被推荐。
- 更好的玩家上限: 你可以设置自定义的最大玩家数。它还允许将最大玩家数始终设置为比当前在线玩家多一人。
管理功能
所有与管理相关的操作也会发送到 Discord Webhook。
- 封禁: 支持设置过期时间、永久封禁及原因。
- 踢出: 支持指定原因踢出玩家。
- 禁言: 支持设置过期时间和原因的禁言。
- 举报: 易于使用的举报功能,任何人都可以使用。
- Staff-Chat: 员工聊天频道,所有拥有
pee.staff权限的管理员均可在此私密聊天。
社交功能
适合拥有多个游戏模式的大型服务器的社交功能。
- 好友系统: 简单的好友系统,支持好友请求,功能精简。
- 队伍系统: 简单的队伍系统,支持邀请、组队匹配及队伍内聊天。
Paper 模块
所有模块默认均为禁用状态,完全可选。你可以在配置文件中的 modules 下启用它们。
- 矿脉挖掘: 完全可配置的矿脉挖掘功能,包含动画、正确的物品耐久损耗等。
- 更好的生物 AI: 允许实现如单个生物受击导致整群恐慌,或整体更智能的 AI 行为等功能。
- 死亡封禁: 如果玩家死亡或被击杀,将对其进行封禁或踢出。完全可定制。
- 移除铁砧上限: 移除铁砧的使用次数限制,改为从 40 级开始让经验消耗增长变慢,以避免出现高达 500 级的荒谬消耗。
- 更好的睡眠: 根据配置优化睡眠机制,例如更真实地跳过夜晚、更稳健的所需玩家数量计算,甚至梦境功能。
- 自定义 AFK: 一个简单的闲置(AFK)功能,可按需配置。
- 实用方块命令: 无需放置方块即可打开实用方块的命令,如工作台、织布机或末影箱。
- 全局末影箱: 服务器上所有玩家均可访问的全局末影箱,相当于社区共享储物箱。
其他
一些难以归类但依然实用的功能。
- 全局白名单: 在代理层生效而非仅在后端服务器生效的白名单。
- 自定义加入逻辑: 用于加入配置文件中设定的游戏模式的工具,还支持通过
pooper:joining通道进行插件通信,适用于大厅插件。 - 玩家缓存: 缓存所有玩家的用户名和 UUID 以便后续使用,即使玩家离线也可获取。
使用方法
配置文件
配置文件设计得简单直观。配置文件自带详细的说明,你可以从中找到所需的一切。
翻译
翻译会通过 一个简单的数据库 自动下载,这意味着你只需确保网络连接稳定即可,无需手动操作。每次启动时,下载过程仅占用几 KB 的数据量。
数据存储
有多种数据存储方式可在配置文件中设置。YAML 和 RAM 存储均无需额外配置。
但如果想使用数据库,则需要自行设置。如需简要说明,请访问 数据库帮助页面(即将上线)!
未来目标
我们希望在将来添加的一些主要功能包括:
- 简单且轻量的 TAB 列表工具。
- 更广泛的管理工具,例如隐身功能。
- 部分功能使用物品栏界面而非纯命令。
- 需要更多翻译以使插件及所有使用该插件的服务器对任何人开放。
联系方式
Discord
你可以加入我的 Discord 社区并直接 @我 以获取快速回复:
直接联系
如果你不使用 Discord 或希望以其他方式联系我,请通过以下任一方式:
- 电子邮件:me@marcpg.com
- Discord:
@marcpg1905
开发者须知
使用的库
PooperMC 旨在尽可能轻量化。我们仅使用了三个非常小巧的工具库:
- LibPG - 由 MarcPG 提供的工具库,具备多种功能,如下载、配对、时间格式等。
- boosted-yaml - 提供可靠且轻量级的配置库,支持文件版本等功能。
- libby - 允许动态下载数据库驱动程序,从而减小文件大小。

PooperMC
is an all-in-one solution for your Minecraft server network that aims to provide all the features you need in just one simple plugin. Being lightweight and efficient, PooperMC tries to provide as many features as possible while having a simple and easy-to-maintain codebase.
The modern codebase using Java 21+ allows for fast response times and always-up-to-date code.
Although the plugin is still in development, it is already a valid choice for any server network that needs a working and lightweight plugin.
Read more at (soon...)!
Requirements
- Java 21 or higher. Find instructions on how to install or update Java here.
- SignedVelocity (only for Velocity):
Releases
You can find our official releases on these platforms:
- Modrinth (recommended): modrinth.com/plugin/pooper
- GitHub: github.com/MarcPG1905/PooperMC/releases
- Hangar: hangar.papermc.io/MarcPG1905/PooperMC
- SpigotMC: spigotmc.org/resources/poopermc.115129
- Planet Minecraft: planetminecraft.com/mod/peelocity-all-in-one-proxy-plugin
- CurseForge: curseforge.com/minecraft/bukkit-plugins/pooper
Features
Most features can be enabled or disabled in the configuration.
Some aren't enabled by default, so make sure to check out the configuration!
Chat Utilities
Some stuff that improves the chatting experience.
- Message Logging: All messages are logged and can be seen by moderators using
/msg-hist. - Private Messaging: You can globally message someone using
/msg PlayerNameor/wto reply. - Mentions: By writing
@PlayerName, you can ping another player or@everyone. - Chat Colors: You can use MiniMessage's colors and styles in the chat.
Custom Server List
Refers to everything you see when looking at the server in your multiplayer server list.
- Better MotD: Simple custom MotDs that use MiniMessage and can be randomized.
- Better Favicons: Custom server icons from image links that can be randomized.
- Online Player Count: You can set a custom or fake online player count, although that's dishonest and not recommended.
- Better Player Limit: You can set the custom max players. It also allows for the maximum number of players to always be one more than the online players.
Moderation
Everything moderation-related is also sent to a Discord Webhook.
- Banning: Bans with expiration, permanent bans, and reasons.
- Kicking: Kicks with reasons.
- Muting: Mutes with expiration and reasons.
- Reporting: Easy reports that can be used by anyone and are pretty easy to use.
- Staff-Chat: A staff chat where all staff members (pee.staff permission) can chat privately.
Social Stuff
Some social-stuff that's nice for bigger servers with multiple game modes.
- Friend-System: A simple friend system with friend requests and not much usage.
- Party-System: A simple party system with invites, joining matches together, and party chatting.
Paper-Modules
All modules are disabled by default and are fully optional. You can enable them in the configuration under modules.
- Vein-Mining: Fully configurable vein-mining with animation, proper item damage, etc.
- Better Mob-AI: Allows for stuff like whole groups panicking if one gets hit or generally a more intelligent AI.
- Death-Banning: Will ban or kick a player if they die or get killed. Fully customizable.
- No Anvil-Cap: Will remove the anvil cost limit and instead just make the cost grow slower, starting at level 40, to not reach absurd costs like 500 levels.
- Better Sleep: Will optimize sleep based on configuration, like more realistically skipping the night, more robust required player calculations, or even dreams.
- Custom AFK: A simple AFK feature that can be configured to your liking.
- Utility Block Commands: Commands for opening utility blocks, like the crafting table, a loom, or your ender chest, without needing to place down a block.
- Global Ender Chest: A global ender chest that everyone on the server can access. Acts like a community chest.
Other
Some stuff that can't be categorized but is still nice to have.
- Global Whitelist: A whitelist that works on the proxy instead of only the backend servers.
- Custom Join-Logic: Utilities for joining a game mode configured in the configuration, which also support plugin messaging over
pooper:joining, for lobby plugins. - Player-Cache: Caches all players with their name and UUID for later use, even if they are offline.
Usage
Configuration
The configuration is designed to be simple and descriptive. You can find everything you need inside the configuration file, which ships with useful descriptions.
Translations
Translations are automatically downloaded over a simple database, which means that you don't have to do anything except have a stable internet connection. The download itself will only take a few kilobytes on each startup.
Data Storage
There are multiple ways of storing the data that you can set in the configuration. YAML and RAM both don't require additional configuration.
But if you want to use a database, you will need to set it up yourself. For simple instructions, please visit the database help page (soon...)!
Future Goals
Some of the major features that we hope to add in the future are:
- Simple and lightweight TAB-list utility.
- A wider range of moderation utilities, such as vanishing.
- Some features use inventory interfaces instead of pure commands.
- More translations are needed to make the plugin and all servers using it accessible to anyone.
Contact
Discord
You can join my Discord community and just ping me for a quick response:
Direct Contact
If you don't use Discord or would like to contact me otherwise, please rely on one of these methods:
- E-Mail: me@marcpg.com
- Discord:
@marcpg1905
For Developers
Used Libraries
PooperMC is made to be as lightweight as possible. We only use three very small utility libraries:
- LibPG - A utility library provided by MarcPG that has various features, like downloads, pairs, time formats, etc.
- boosted-yaml - Provides a reliable and lightweight configuration library with file versions and more.
- libby - Allows for dynamically downloading the database drivers to have a smaller file size.
下载 PooperMC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PooperMC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PooperMC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PooperMC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PooperMC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PooperMC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PooperMC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PooperMC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PooperMC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PooperMC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
仅 Paper:
- 添加了「自定义挂机」(Custom AFK)模块,目前仅包含基础功能,暂无其他主要特性。
- 添加了「实用方块命令」(Utility Block Commands)模块,允许你通过命令打开合成台或铁砧等菜单。
- 添加了「全局末影箱」(Global Ender Chest)模块,新增一个服务器内所有玩家共享的末影箱,可通过
/global-ec访问。 - 群矿(Vein-Mining)现在改为模块形式,而非普通内置功能。
重大修复:
- Boss 血条现在会在计时器结束后自动移除。
- 代理上的计时器命令现已正常工作。
- 修复了赦免、解除静音和举报功能,此前这些功能无法正常使用。
开发相关:
- 切换至更稳健的下载与更新检查机制,使用位于 的新 API。
- 移除了代理与服务端检查功能,因其可靠性不足。
- 更新了构建脚本中的部分配置。
- 将部分基础命令从 Peelocity 迁移至 Commands 模块。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧