FactionAddon is a Minecraft plugin that extends chat functionality for servers with faction systems. This plugin is based on LPC (LuckPerms Chat) and includes additional features specifically designed for faction servers.
⚠️ Warning: This plugin is currently still in development. Some features may not be fully implemented or may contain bugs.
- Advanced Chat System: Based on LPC with LuckPerms support
- Item Display in Chat: Shows items and inventories directly in chat
- Permission System: Complete integration with LuckPerms
- CAPS Control: Automatic detection and management of uppercase messages
- Discord Webhook: Automatic staff notifications
- PlaceholderAPI: Complete support for custom placeholders
/showitem- Show an item in chat/showinv- Show inventory in chat/factionaddonreload- Reload configurations
lpc.colorcodes- Allows use of color codeslpc.rgbcodes- Allows use of RGB codesstaff.caps- Exemption from CAPS controlstaff.notify- Receives staff notifications
- Java 21 or higher
- Paper 1.21 or higher
- LuckPerms 5.4 or higher
- PlaceholderAPI 2.11.6 or higher
- Download the latest version of the plugin
- Place the
.jarfile in theplugins/folder - Restart the server
- Configure the plugin according to your needs
The plugin automatically generates a config.yml file with the following options:
# Discord Webhook Configuration
webhook:
url: "YOUR_DISCORD_WEBHOOK_URL"
# CAPS Control
warnOnCaps: true- Java 21
- Paper API
- LuckPerms API
- PlaceholderAPI
- MiniMessage for text formatting
- Lombok for boilerplate reduction
src/main/java/com/minegolem/factionAddon/
├── commands/ # Plugin commands
├── listeners/ # Event listeners
├── utils/ # Utility classes
├── webhook/ # Discord webhook system
├── FactionAddon.java # Main class
├── Logger.java # Logging system
└── ChatInventoryHolder.java
This project is open to contributions! If you want to contribute:
- Fork the repository
- Create a branch for your feature (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is distributed under the MIT license. See the LICENSE file for more details.
- LPC (LuckPerms Chat) - Original plugin on which this fork is based
- LuckPerms Team - For the excellent permission system
- PaperMC - For the development API
- PlaceholderAPI - For the placeholder system
For support or questions:
- Open an issue on GitHub
- Contact the author: WorkWolf_2
Note: This plugin is a fork of LPC and maintains compatibility with the original features while adding new characteristics specific to faction servers.