L-Farmer

Advanced, modular, and high-performance Minecraft Farmer plugin with native Folia and multi-platform (Paper, Purpur, Spigot, Folia) support.

Features

1. Multi-Platform & Native Folia Support

• Uses standard Bukkit schedulers on traditional Spigot, Paper, and Purpur servers.
• Automatically switches to native regional multithreading (RegionScheduler, GlobalRegionScheduler, and AsyncScheduler) on Folia servers for zero tick lag.

2. High-Performance Database Storage (HikariCP)

• SQLite: Local file storage with optimized connection management.
• MySQL / MariaDB: High-performance connection pooling designed for multi-server setups and high-traffic networks.

3. Modular Farmer Operations

• Automated Crop Harvest: Automatically harvests mature crops (Wheat, Carrots, Potatoes, Beetroots, Nether Wart, Cocoa Beans, Sugar Cane, Cactus, Melons, Pumpkins, Sweet Berries, and Bamboo).
• Instant Auto-Replant: Automatically replants the appropriate seed or sapling upon harvest.
• Mob & Spawner Collector: Collects drops from mobs and spawners killed within the farmer's operational territory.
• Ground Item Vacuum: Automatically vacuums dropped items on the ground within chunk range directly into farmer storage (filtered by configured whitelist).
• Automated Selling (Auto-Sell): Periodically sells stored items at configurable intervals and deposits earnings directly into the owner's balance.

4. Interactive Chunk Range Visualization

• Players can toggle visual range boundaries directly from the farmer interface.
• Projects green particle barrier lines along active chunk borders for 10 seconds to clearly preview the farming perimeter.

5. Portable Farmer Egg & Data Persistence

• Farmers are packaged into a customized Farmer Spawn Egg item upon pickup or block break.
• All stored items, upgrade levels, and fuel balances are 100% preserved inside the item's NBT data.

6. Five Modular Upgrades

• Storage Capacity: Scale storage from Level 1 up to Level 5 (5,000 to 150,000+ items).
• Working Range: Expand operational area from 1 chunk to 3x3 chunks and 5x5 chunks.
• Harvest Speed: Accelerate harvesting check engine from 100 ticks down to 20 ticks.
• Fortune / Yield: Boost crop yield with bonus double-drop chance up to 100%.
• Tax Reduction: Lower the auto-sell server tax deduction from 20% down to 0%.

7. Fuel & Salary Economy System

• Optional fuel consumption per action (harvesting, mob loot, ground collection).
• Refuel using solid fuels (Coal, Charcoal, Coal Blocks, Lava Buckets, Blaze Rods) or pay an economy salary directly to recharge the farmer.

8. Native Display Entity Holograms

• Uses Minecraft 1.21+ packet-level TextDisplay entities directly above the farmer.
• Real-time display of owner, storage fill rate, and active status indicators without requiring DecentHolograms or HolographicDisplays.

9. Granular Member Access Control

• Share farmer access with team or island members.
• Individual toggleable permissions:
  • Open Menu: Browse storage and inspect upgrades.
  • Withdraw Items: Take items into inventory.
  • Sell Items: Sell individual items or execute sell-all actions.
  • Upgrade Farmer: Purchase upgrades using personal balance.

10. Audit Action Logging

• Comprehensive audit tracking for placements, removals, upgrades, fuel deposits, withdrawals, manual sales, auto-sells, and admin actions.
• Browse records in-game with /farmer log <player> or inspect daily text log files (plugins/L-Farmer/logs/<player>/<date>.log).

11. Complete Claim & Island Protection

• Prevents placing farmers in unowned wilderness or unauthorized land.
• Dedicated integration hooks with disabled worlds and region/town filters for:
  • L-Claim
  • Lands
  • SuperiorSkyblock2
  • BentoBox (BSkyBlock / AcidIsland)
  • Towny
  • GriefPrevention
  • WorldGuard
  • PlotSquared

12. Complete Dual-Language Parity

• Full out-of-the-box language support for English (locale/messages_en.yml) and Turkish (locale/messages_tr.yml) with 100% key parity.
• Historical log entries translate dynamically into the active language upon display.

---

Commands & Permissions

Command	Description	Permission
/farmer (aliases: /ciftci, /çiftçi, /lfarmer)	Opens the farmer interface in the current chunk	farmer.use
/farmer help	Displays the help menu and command guide	farmer.use
/farmer list	Lists all active farmers owned by the player	farmer.use
/farmer stats	Opens the personal farming statistics dashboard	farmer.use
/farmer remove	Removes and packages the farmer in current chunk	farmer.use
/farmer log <player> [page]	Opens the audit action log viewer for a player	farmer.admin
/farmer admin [player/page] [page]	Global administrative panel (manage, teleport, clear, delete)	farmer.admin
/farmer give <player> [amount]	Gives farmer spawn egg item(s) to a player	farmer.admin.give
/farmer reload	Reloads all configuration and locale files	farmer.admin.reload

Limit Permissions

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

---

PlaceholderAPI Placeholders

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 money earned through 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%	Storage capacity level of the farmer in current chunk

---

discord: squezsaz