L-Farmer
一款高级、模块化且高性能的 Minecraft 农场插件,原生支持 Folia 并兼容多平台(Paper、Purpur、Spigot、Folia)。
功能特性
1. 多平台与原生 Folia 支持
- 在传统 Spigot、Paper 和 Purpur 服务器上使用标准的 Bukkit 调度器。
- 在 Folia 服务器上自动切换至原生区域多线程机制(
RegionScheduler、GlobalRegionScheduler 和 AsyncScheduler),实现零刻延迟。
2. 高性能数据库存储 (HikariCP)
- SQLite: 本地文件存储,具备优化的连接管理。
- MySQL / MariaDB: 专为多服务器架构和高流量网络设计的高性能连接池。
3. 模块化农场操作
- 自动化作物收获: 自动收割成熟作物(小麦、胡萝卜、土豆、甜菜根、下界疣、可可豆、甘蔗、仙人掌、西瓜、南瓜、甜浆果和竹子)。
- 即时自动补种: 收获后自动种植相应的种子或树苗。
- 生物与刷怪笼收集器: 收集农场运作区域内被击杀的生物和刷怪笼掉落的物品。
- 地面物品真空吸入: 自动将区块范围内的地面掉落物直接吸入农场存储(通过配置的白名单过滤)。
- 自动化售卖 (Auto-Sell): 按可配置的时间间隔定期出售存储的物品,并将收益直接存入所有者的余额中。
4. 交互式区块范围可视化
- 玩家可以直接从农场界面切换可视范围边界。
- 在活动区块边缘投射绿色粒子屏障线,持续 10 秒,以清晰预览耕作范围。
5. 便携式农场蛋与数据持久化
- 拾取或破坏方块时,农场会被打包成一个定制的农场生成蛋物品。
- 所有存储物品、升级等级和燃料余额均 100% 保存在物品的 NBT 数据中。
6. 五种模块化升级
- 存储容量: 将存储从 1 级扩展到 5 级(5,000 至 150,000+ 物品)。
- 工作范围: 将操作区域从 1 个区块扩展到 3x3 区块和 5x5 区块。
- 收获速度: 将收获检测引擎从 100 刻加速至 20 刻。
- 幸运/产量: 通过最高 100% 的双倍掉落几率加成来提升作物产量。
- 税收减免: 将自动售卖的服务器税收扣除从 20% 降低至 0%。
7. 燃料与工资经济系统
- 可选的每次行动燃料消耗(收获、生物战利品、地面收集)。
- 使用固体燃料(煤炭、木炭、煤块、岩浆桶、烈焰棒)补充燃料,或直接支付经济货币作为工资来为农场充电。
8. 原生显示实体全息图
- 直接在农场上方使用 Minecraft 1.21+ 包级别的
TextDisplay 实体。
- 实时显示所有者、存储填充率和活跃状态指示器,无需依赖 DecentHolograms 或 HolographicDisplays。
9. 细粒度成员访问控制
- 与团队或岛屿成员共享农场访问权限。
- 可单独切换的权限:
- 打开菜单: 浏览存储并检查升级。
- 提取物品: 将物品取出放入背包。
- 出售物品: 出售单个物品或执行全部出售操作。
- 升级农场: 使用个人余额购买升级。
10. 审计操作日志
- 全面的审计跟踪,记录放置、移除、升级、燃料充值、提取、手动售卖、自动售卖和管理员操作。
- 在游戏中通过
/farmer log <player> 浏览记录,或查看每日文本日志文件 (plugins/L-Farmer/logs/<player>/<date>.log)。
11. 完整的领地与岛屿保护
- 防止在未拥有的荒野或未授权土地上放置农场。
- 针对禁用的世界以及区域/城镇过滤器提供专用的集成钩子,适用于:
- L-Claim
- Lands
- SuperiorSkyblock2
- BentoBox (BSkyBlock / AcidIsland)
- Towny
- GriefPrevention
- WorldGuard
- PlotSquared
12. 完整的双语言对等支持
- 开箱即用地支持英语 (
locale/messages_en.yml) 和土耳其语 (locale/messages_tr.yml),键值完全对应。
- 历史日志条目在显示时动态翻译为当前激活的语言。
命令与权限
| 命令 |
描述 |
权限 |
/farmer (别名: /ciftci, /çiftçi, /lfarmer) |
在当前区块打开农场界面 |
farmer.use |
/farmer help |
显示帮助菜单和命令指南 |
farmer.use |
/farmer list |
列出该玩家拥有的所有活跃农场 |
farmer.use |
/farmer stats |
打开个人农业统计仪表板 |
farmer.use |
/farmer remove |
移除并打包当前区块中的农场 |
farmer.use |
/farmer log <player> [page] |
打开玩家的审计操作日志查看器 |
farmer.admin |
/farmer admin [player/page] [page] |
全局管理面板(管理、传送、清除、删除) |
farmer.admin |
/farmer give <player> [amount] |
向玩家发放农场生成蛋物品 |
farmer.admin.give |
/farmer reload |
重新加载所有配置文件和本地化文件 |
farmer.admin.reload |
限制权限
farmer.limit.<number>:设置每个玩家最多可放置的农场数量(例如 farmer.limit.3)。
farmer.limit.admin:授予无限放置农场的权限。
PlaceholderAPI 占位符
| 占位符 |
描述 |
%lfarmer_placed% |
玩家放置的活跃农民数量 |
%lfarmer_max% |
玩家可放置的农民最大数量 |
%lfarmer_storage_total% |
当前所有农民中存储的物品总数 |
%lfarmer_total_earned% |
通过农民销售获得的总金钱数 |
%lfarmer_total_collected% |
玩家农民的总收获物品数 |
%lfarmer_chunk_has_farmer% |
当前区块是否包含活跃的农民(true/false) |
%lfarmer_chunk_farmer_owner% |
当前区块中农民的所有者名称 |
%lfarmer_chunk_farmer_level% |
当前区块中农民的存储容量等级 |
discord: squezsaz
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧