zFeedFarm

A Minecraft plugin designed to detect and prevent kill-farming with configurable punishments, warnings, sounds, and a lightweight GUI.

Features

• Permissions system
  • zfeedfarm.admin
  • zfeedfarm.bypass
  • zfeedfarm.notify
• MiniMessage support for colors and formatting throughout messages
• Multi-line YAML support for configurable messages (YAML lists and <newline> strings)
• Custom sounds for each action with volume and pitch settings
• Async-safe architecture using CompletableFuture.runAsync() and scheduler-safe tasks
• Highly customizable thresholds, commands, sounds, and text values

Anti Kill-Farm Logic

• Tracks kill counts per victim (X → Y relationships)
• Executes configured commands when thresholds are reached
• Sends warnings at the configured threshold and at half-threshold
• Keeps data until punishment executes, even across disconnects
• Auto-cleans old tracking data after a configurable timeout

GUI (ALPHA)

• Main menu with:
  • info
  • victims
  • reset
  • refresh
• Victim list view with skull-based icons
• Visual indicators for punished and warning states

Commands

• /zfeedfarm reload
• /zfeedfarm gui
• /zfeedfarm reset
• /zfeedfarm info
• /zfeedfarm help

Data Persistence

• Currently uses in-memory data tracking with smart cleanup
• File-based persistence can be added later if needed

Installation

1. Build the plugin with Maven
2. Place the resulting JAR in your server's plugins/ folder
3. Restart the server
4. Configure config.yml, messages.yml, and gui.yml as needed

Notes

• GUI support is still alpha-quality and may change
• Permissions and command behavior are configurable via plugin configs
• Sound and message behavior can be customized per action