L-Barn

Features

• Placement-based barns – place a special item as a block, right-click to open the GUI
• 17 page-based GUI menus – no external GUI dependencies (InventoryClickEvent based)
• 14 default animal types + growth stages (BABY → TEEN → ADULT), leveling, color/theme variants
• Feeding system – manual feeding + automatic food depository (vanilla and ItemsAdder food)
• Product storage – animals produce items automatically; take / sell / drop per item or all at once
• Barn levels – capacity, storage size, yield multiplier, upgrade costs, unlocked animals
• Item boosters – PRODUCTION / CHANCE / FOOD / LEVEL, stackable, time-limited
• Vault economy – buy animals, upgrade barns, earn money from selling products
• Hologram above each barn (level, owner, animals, storage, multiplier, members)
• Activity logging – human-readable or JSON logs with rotation and event filtering
• Storage – SQLite, MySQL, MariaDB with HikariCP pooling, automatic schema migration
• Turkish & English messages (messages_tr.yml / messages_en.yml)
• Many integrations – PlaceholderAPI, ItemsAdder, Towny, Lands, L-Claim, SimpleClaimSystem, WorldGuard, Multiverse-Core, MultiWorld, Geyser/Floodgate (Bedrock forms), EconomyShopGUI, ShopGUIPlus, zShop
• Folia support – per-barn regional tasks via reflection
• bStats metrics

Requirements

Supported Plugins: Vault, SuperiorSkyblock2, BentoBox, GriefPrevention, HuskClaims, Towny, Lands, L-Claim, SimpleClaimSystem, WorldGuard, Multiverse-Core, MultiWorld, ItemsAdder, Geyser, Floodgate, JobsReborn, AuraSkills, AureliumSkills, mcMMO, MMOCore, EconomyShopGUI, EconomyShopGUI-Premium, ShopGUIPlus, zShop, PlaceholderAPI

Gameplay

How It Works:

1. Get a barn block: /barn item (or an admin runs /barnadmin give <player> [amount]).
2. Right-click a surface to place it — a barn is created at that location.
3. Right-click the block to open the Main Menu (owner or members only).
4. Buy animals in the Animal Shop with money (animals unlock at barn levels).
5. Pump food into the Food Depository — animals eat automatically from it while a player is within spawner.radius blocks (default 16).
6. Fed animals grow (BABY → TEEN → ADULT), level up, and produce items into the barn's Storage on a schedule.
7. Sell or take products — sell all, take all, per-item left-click take / right-click sell.
8. Upgrade the barn to increase capacity, storage size and the yield multiplier, and unlock new animals.
9. Apply boosters to multiply production, growth speed, food efficiency, or get bonus items on production.
10. Add members and grant them fine-grained permissions, or pick the barn up and move it elsewhere — data is fully preserved.

Production Loop:

• Runs every spawner.tick-interval ticks (default 20) but only while at least one player is within spawner.radius blocks (default 16). No player nearby → the barn pauses (barns never self-delete, not even when idle).
• Auto-feeding: when an animal's energy (food) drops to 0, one matching item is consumed from the food depository (feed-value energy per item, capped by feeding.food-capacity).
• Hunger: each tick energy drains by interval × feeding.bonus-multiplier × hunger-rate × food-reduction (FOOD boosters reduce the drain).
• Growth: while fed above growth-food-threshold-percent of one feed portion, growth accumulates at interval × level-multiplier × level-boost × growth-multiplier (LEVEL boosters multiply this). Unfed animals lose growth (growth-decay per second).
• Leveling: when growth reaches growth-per-level (scaled by growth-requirement-multiplier), the animal levels up; stages follow the level (BABY lv1 / TEEN lv5 / ADULT lv10 by default).
• Production: every production-interval / (barn-multiplier × production-boost) seconds (min 1s) the animal produces its stage product (or ItemsAdder custom product) into the barn storage. If storage is full, production pauses — nothing is ever silently lost.
• CHANCE boosters roll chance-percent for bonus-amount extra items on each production.
• Stats are safe: all writes go through a single async pool and are flushed on shutdown.

Breaking & Pickup:

• Breaking is configurable (barn-break):
  • enabled, optional required-tools (default: iron/golden/diamond/netherite pickaxes), silk-touch requirement (default: Silk Touch 1), durability-loss on the tool.
  • Animals are refunded at their buy price.
  • Storage contents: sold automatically if sell-contents-on-break (unsellable items drop on the ground) or dropped as items.
  • The barn block drops as an item (direct-to-inventory puts it straight into the inventory).
• Pickup from the GUI: “Pick Up Barn” gives an item that carries the barn's ID in a hidden lore tag (LBARN-BARN:<uuid>). Placing it restores the barn with all animals, level, members, and boosters (crash-safe: picked-up barns are saved in the background too).
• Explosions: barns are explosion-proof by default; if disabled, an exploded barn is fully removed from the database (no ghost barns).

Commands & Permissions

Player Commands:

Admin Commands: (alias /lbarnadmin, supports tab completion)

Permission Nodes:

GUI Menus

All GUIs are page-based, refresh live every second (food timers, booster countdowns, progress bars), and support & color codes. No inventory APIs or dependencies are used.

Animals

14 default animal types included in animals.yml. (Stage progression: BABY lv1 → TEEN lv5 → ADULT lv10).

Every type supports itemsadder: references for food items, icons and products.

Barn Levels

Configurable in barnlevels.yml:

Boosters

Configurable in boosters.yml:

• stack-mode: additive (additive or multiplicative) controls how same-kind boosters combine.
• Same-kind boosters stack and extend the active duration; different kinds run independently.
• Booster items are recognized by a hidden lore tag (LBARN-BOOSTER:<id>), so they survive enchantment/storage plugins.

Economy

• Vault is required; disabled automatically when Vault or an economy provider is missing.
• Buying animals and upgrading barns withdraw money; selling products and breaking barns deposit it.
• Sell prices are resolved in this order by economy.provider:
  1. prices.yml (default) — per-material prices defined by the admin
  2. economyshopgui / economyshopgui-premium — EconomyShopGUI sell prices
  3. shopguiplus — ShopGUIPlus sell prices
  4. zshop — zShop sell prices (v2 & v3 supported)
• economy.sell-price-multiplier scales every sale.
• Money formatting (money-format): compact K/M/B/T abbreviations with 0-2 decimals; falls back to Vault's formatter when disabled.

Storage

• SQLite (plugins/L-Barn/barns.db, WAL mode, busy timeout) — zero-config default.
• MySQL / MariaDB — driven by storage.type; JDBC drivers are bundled.
• HikariCP connection pool — fully configurable under connection-pool (maximum-pool-size, minimum-idle, connection-timeout-ms, max-lifetime-ms, idle-timeout-ms, connection-test-query).
• Tables: lbarn_barns, lbarn_animals, lbarn_food_stats — created and auto-migrated (adding new columns with metadata checks) on startup.
• Storage & food inventories are serialized Base64 inventories; members and boosters are persisted as compact text records.
• Upsert syntax auto-detected for MySQL 8.0.19+ (row aliases) vs older MySQL/MariaDB (VALUES()).
• Cross-server (sync-gui): with MySQL/MariaDB set database.server-name (e.g. survival-1) and database.sync-gui-enabled: true — the admin barn list then shows barns from all servers sharing the database, tagged with their server name. Every barn records the server it was created on.

Integrations

L-Barn provides native compatibility and integrations with popular Minecraft plugins.

PlaceholderAPI (%lbarn_...%):

• Auto-registered expansion with two modes: %lbarn_<key>% (default barn) and %lbarn_barn_<uuid>_<key>% (explicit barn).
• Global keys: count, has, member_count, is_owner_any, is_member_any
• Barn keys: level, capacity, animals, animals_free, animals_percent, members, storage_used, storage_max, storage_free, food_used, food_slots, food_max, boost_active, boost_multiplier, boost_count, boost_remaining, boost_remaining_formatted, owner, world, x, y, z, last_activity, next_level, next_level_cost, is_owner, is_member, animals_<typeId>, animals_<typeId>_levels

ItemsAdder:

• Barn block and item: itemsadder:namespace:id (fallback to BARREL)
• Animal icons, food items, and products support itemsadder: references anywhere.

Land Claims & Protection:

• Towny – residents only, optional nation access (require-town, allow-nation)
• Lands – requires claimed land; owner-only mode; respects BLOCK_PLACE role flag
• L-Claim – requires claimed chunk; mayor or member
• SimpleClaimSystem – requires claim; owner/member/visitor build permission
• WorldGuard – region blacklist/whitelist, optional build-flag enforcement
• Multiverse-Core / MultiWorld – world blacklist/whitelist

Bedrock Support (Geyser / Floodgate):

• Native Cumulus forms for Bedrock players (main menu, animals, shop, upgrade confirm, storage, booster info, pickup confirm).
• Color codes are stripped cleanly for Bedrock rendering.

Activity Logging:

• File logging to plugins/L-Barn/logs/activity.log with size-based rotation.
• Supports human-readable or JSON format, console mirroring, and 25 distinct event types.

Configuration

Configuration files located in plugins/L-Barn/:

Example config.yml:

language: "tr"
storage:
  type: "sqlite"

database:
  host: "localhost"
  port: 3306
  database: "lbarn"
  user: "root"
  password: ""
  server-name: "survival-1"
  sync-gui-enabled: false

auto-save:
  enabled: true
  seconds: 300

spawner:
  radius: 16
  tick-interval: 20
  offline-progress-seconds: 0
  unload-idle-seconds: 300

barn:
  block-material: "BARREL"
  item-material: "BARREL"
  item-name: "&2&lL-Barn &7Ahır"
  explosion-proof: true

barn-break:
  enabled: true
  direct-to-inventory: false
  required-tools: [IRON_PICKAXE, GOLDEN_PICKAXE, DIAMOND_PICKAXE, NETHERITE_PICKAXE]
  durability-loss: 1
  silk-touch:
    required: true
    level: 1
  sell-contents-on-break: false

hologram:
  enabled: true
  height: 1.25

feeding:
  bonus-multiplier: 1.0
  food-capacity: 200

economy:
  enabled: true
  sell-price-multiplier: 1.0
  provider: "prices.yml"

money-format:
  enabled: true
  decimals: 2

logging:
  enabled: true
  json-format: false
  console-output: false
  max-log-files: 10
  max-log-size-mb: 10
  log-all-events: false

Support

• Discord: squezsaz