L-Farmer

Overview
L-Farmer is an enterprise-grade automated farming plugin designed specifically for modern Minecraft 1.21+ servers and Folia multithreading architecture. It provides reliable, high-performance crop harvesting, item collection, storage management, and team collaboration with zero unnecessary server overhead.

By utilizing Folia-native regional schedulers, asynchronous database connection pooling (HikariCP), and packet-level TextDisplay entities, L-Farmer runs lag-free even under heavy server loads.


Features

Automated Harvesting & Collection

• Auto-Harvest: Automatically detects and harvests mature crops (Wheat, Carrots, Potatoes, Beetroots, Nether Wart, Cocoa Beans, Sugar Cane, Cactus, Melons, Pumpkins, Sweet Berries, and Bamboo).
• Auto-Replant: Instantly replants the appropriate seed upon harvesting.
• Mob Drop Collector: Collects drops from mobs and spawners within the operational perimeter.
• Ground Item Pickup: Vacuum drops lying on the ground directly into storage (restricted to whitelisted items).

Chunk Range Visualization

• Players can toggle a visual range display in the farmer interface.
• Spawns particle boundaries around all operational chunks for 10 seconds to clearly outline the coverage area.

Portable Farmer Egg

• Farmers are packaged as a single inventory item upon pickup or block break.
• All stored inventory items, upgrade tiers, and fuel amounts are preserved inside the item.

Five Modular Upgrade Categories

• Capacity: Expand storage capacity from 5,000 items up to 150,000+ items.
• Range: Increase working area from 1 chunk up to 3x3 or 5x5 chunks.
• Speed: Decrease harvesting check interval from 100 ticks down to 20 ticks.
• Fortune: Add double-drop probability up to 100% bonus yield.
• Tax Reduction: Reduce auto-sell tax rate from 20% down to 0%.

Fuel & Operating Costs

• Optional fuel system requiring upkeep for harvesting operations.
• Supports solid fuels (Coal, Charcoal, Coal Blocks, Lava Buckets, Blaze Rods).
• Allows economy-based salary payments to replenish fuel instantly.

Access Control & Member Management

• Add trusted teammates with granular permissions.
• Configurable access flags: Open GUI, Withdraw items, Sell items, and Purchase upgrades.

Audit Logging

• Detailed tracking of all actions: placements, removals, upgrades, fuel additions, sales, and withdrawals.
• Accessible in-game via an interactive log GUI (/farmer log) or through daily plain-text log files on disk.

Claim & Protection Compatibility

• Restricts placement outside owned claims, islands, or plots.
• Full integration with L-Claim, Lands, SuperiorSkyblock2, BentoBox, Towny, GriefPrevention, WorldGuard, and PlotSquared.
• Configurable world blacklists and region restrictions.

Holographic Displays

• Uses Minecraft 1.21 TextDisplay entities directly.
• Displays real-time owner, storage fill rate, and status without external hologram plugin dependencies.

Multi-Language Support

• Full out-of-the-box support for English and Turkish with 100% key parity.
• Historical logs dynamically format based on the active server locale.

Commands & Permissions

Command	Description	Permission
/farmer	Opens the farmer GUI for the current chunk	farmer.use
/farmer help	Displays the help guide	farmer.use
/farmer list	Lists all placed farmers owned by the player	farmer.use
/farmer stats	Opens the statistics dashboard	farmer.use
/farmer remove	Picks up and packages the farmer at the current chunk	farmer.use
/farmer log <player> [page]	Opens the audit log viewer for a player	farmer.admin
/farmer admin [player/page] [page]	Opens the server-wide farmer management panel	farmer.admin
/farmer give <player> [amount]	Gives farmer egg item(s) to a player	farmer.admin.give
/farmer reload	Reloads all configuration and locale files	farmer.admin.reload

Placement Limits

• farmer.limit.<number> - Sets the maximum placed farmers per player (e.g. farmer.limit.3).
• farmer.limit.admin - Grants unlimited farmer placement.

PlaceholderAPI

Placeholder	Description
%lfarmer_placed%	Number of active farmers placed by the player
%lfarmer_max%	Maximum number of farmers the player can place
%lfarmer_storage_total%	Total items currently stored across player's farmers
%lfarmer_total_earned%	Total currency earned from farmer sales
%lfarmer_total_collected%	Total items harvested by player's farmers
%lfarmer_chunk_has_farmer%	Whether current chunk contains an active farmer (true/false)
%lfarmer_chunk_farmer_owner%	Owner name of the farmer in current chunk
%lfarmer_chunk_farmer_level%	Capacity upgrade level of the farmer in current chunk

Supported Integrations

• Claims & Lands: L-Claim, Lands, SuperiorSkyblock2, BentoBox, Towny, GriefPrevention, WorldGuard, PlotSquared
• Economy & Prices: Vault, PlayerPoints, ShopGUIPlus, EconomyShopGUI, prices.yml
• Cosmetics & Addons: ItemsAdder, PlaceholderAPI
• Server Software: Spigot, Paper, Purpur, Folia (1.21+)

Configuration



Installation

1. Download L-Farmer.jar.
2. Place the file into your server's plugins directory.
3. Verify that the server runs Java 21+ and Minecraft 1.21+.
4. Start or restart the server.
5. Adjust settings in config.yml, prices.yml, and locale files as desired.
6. Execute /farmer reload to apply any modifications.