PooperMC

PooperMC is a comprehensive solution for Minecraft server networks, combining all necessary features in one simple plugin. This lightweight and efficient tool offers a wide range of capabilities while maintaining codebase simplicity and ease of maintenance.

The modern codebase, written in Java 21+, ensures fast response times and code relevance. Although the plugin is still in development, it already serves as a reliable choice for any server network requiring a functional and lightweight solution.

System Requirements

• Java 21 or higher
• SignedVelocity (for Velocity only)

Main Features

Chat Utilities

Enhance server communication with:

• Message logging: All messages are saved in history, accessible to moderators via /msg-hist command
• Private messaging: Send private messages to players using /msg PlayerName or reply via /w
• Mentions: Use @PlayerName to mention other players or @everyone for everyone
• Chat colors: Support for MiniMessage colors and styles

Custom Server List

Customize server display in the multiplayer game list:

• Enhanced MotD: Custom messages with MiniMessage support and randomization capability
• Custom icons: Configurable server icons from image links with random selection function
• Player count: Option to set custom or fake online player count
• Player limit: Setting maximum player count with "one more than current online" option

Moderation

All moderation actions are duplicated to Discord via webhooks:

• Bans: Temporary and permanent bans with reason specification
• Kicking: Kicks with explanation of reasons
• Chat muting: Mutes with time restrictions and reasons
• Reports: Simple reporting system for all players
• Staff chat: Private chat for moderators (requires pee.staff permission)

Social Features

Perfect for large servers with various game modes:

• Friend system: Basic friend system with add requests
• Party system: Group creation with invitations, joint match entry, and separate chat

Additional Modules

All modules are disabled by default and completely optional:

• Vein mining: Configurable ore vein mining with animation and proper tool wear
• Improved mob AI: More intelligent behavior, including group panic when attacked
• Death banning: Automatic ban or kick after death with full customization
• Anvil limit removal: Removes cost limitation, slowing price growth after level 40
• Enhanced sleep: Night skip optimization with realistic settings and even dreams
• AFK system: Configurable away-from-keyboard function
• Block commands: Opening crafting table, loom, ender chest without placing blocks
• Global ender chest: Shared chest accessible to all server players

Other Capabilities

• Global whitelist: Works on proxy, not just backend servers
• Custom join logic: Utilities for connecting to game modes with plugin messaging support
• Player cache: Saving all player data (name and UUID) for later use

Usage

Configuration

The configuration file is designed for ease of use and contains detailed descriptions of all parameters.

Translations

Localizations are automatically downloaded from online database with stable internet connection, taking only a few kilobytes on each startup.

Data Storage

Several data storage methods are available: YAML and RAM require no additional setup, while database usage requires manual configuration.

Future Plans

• Lightweight TAB-list utility
• Extended moderation tools, including vanishing
• Use of inventory interfaces instead of pure commands
• Addition of more translations

For Developers

PooperMC uses three lightweight libraries:

• LibPG - utility library with various functions
• boosted-yaml - reliable configuration handling library
• libby - dynamic database driver loading for reduced file size