TimberPlus Plugin

TimberPlus is an advanced tree cutting plugin for Minecraft servers (Paper/Folia) that introduces mini-game mechanics to make wood chopping more engaging. Players can activate the cutting mode with /tmp, and upon breaking a log, they are presented with an action bar mini-game.

📋 Features

🎮 Mini-Game System

• Visual mini-game on the Action Bar
• Moving arrow and target zone mechanics
• 3 successful hits required to cut the whole tree
• Cooldown system for failures

🌳 Tree Detection

• Realistic tree detection using BFS algorithm
• Support for all Minecraft tree types (Oak, Birch, Spruce, Jungle, Acacia, Dark Oak, Mangrove, Cherry, Bamboo, Crimson, Warped)
• Leaf checking and size limits
• Permission-based access control per tree type

🛠️ Axe System

• Support for all axe types
• Durability calculation system
• Unbreaking enchantment support
• Low durability warnings

📊 Statistics

• SQLite database for player stats
• Tracking logs broken, successful games, success rate
• Leaderboard system

🔧 Management

• Detailed configuration file
• Permission-based access control
• World-based activation
• PlaceholderAPI support
• Folia server support

📁 Installation

1. Requirements:

   • Paper/Folia 1.20+ server
   • Java 17+
   • PlaceholderAPI (optional)

2. Setup:

   # Copy TimberPlus-1.0.0.jar to your plugins folder
   cp TimberPlus-1.0.0.jar /path/to/server/plugins/
   
   # Restart server
   /restart

🎯 Commands

Command	Description	Permission
/tmp	Toggle tree cutting mode	timberplus.use
/tmp help	Help menu	-
/tmp stats [player]	View statistics	timberplus.command.stats
/tmp top	View leaderboard	timberplus.command.leaderboard
/tmp reload	Reload plugin	timberplus.admin
/tmp reset <player>	Reset player stats	timberplus.admin
/tmp debug	Debug info	timberplus.admin

🔐 Permissions

Basic Permissions

• timberplus.use - Use the plugin
• timberplus.unlimited - Access all tree types
• timberplus.bypass.cooldown - Bypass cooldowns
• timberplus.bypass.durability - Bypass durability

Command Permissions

• timberplus.command.stats - Stats command
• timberplus.command.leaderboard - Leaderboard command

Admin Permissions

• timberplus.admin - All admin commands

Tree Type Permissions

• timberplus.tree.oak - Oak
• timberplus.tree.birch - Birch
• timberplus.tree.spruce - Spruce
• timberplus.tree.jungle - Jungle
• timberplus.tree.acacia - Acacia
• timberplus.tree.dark_oak - Dark Oak
• timberplus.tree.mangrove - Mangrove
• timberplus.tree.cherry - Cherry
• timberplus.tree.bamboo - Bamboo
• timberplus.tree.crimson - Crimson
• timberplus.tree.warped - Warped

📈 PlaceholderAPI

Placeholder	Description
%timberplus_logs_broken%	Total logs broken
%timberplus_rank%	Player rank
%timberplus_success_rate%	Success rate
%timberplus_total_games%	Total games
%timberplus_successful_games%	Successful games

---

TimberPlus Eklentisi (Turkish)

TimberPlus, Minecraft sunucuları için geliştirilmiş, ağaç kesme işlemini bir mini oyun mekaniği ile daha eğlenceli hale getiren bir Paper/Folia eklentisidir. Oyuncular /tmp komutu ile modu aktif hale getirir ve bir kütük kırdıklarında Action Bar üzerinde çıkan mini oyunu tamamlayarak ağacı tek seferde kesebilirler.

📋 Özellikler

🎮 Mini-Oyun Sistemi

• Action Bar üzerinde görsel mini oyun
• Hareket eden ok ve hedef bölgesi
• Ağacı kesmek için 3 başarılı vuruş gerekir
• Başarısızlık durumunda bekleme süresi

🌳 Ağaç Algılama

• BFS algoritması ile gerçekçi ağaç tespiti
• Tüm Minecraft ağaç türleri desteği
• Yaprak kontrolü ve boyut sınırları
• Yetki tabanlı ağaç türü erişimi

🛠️ Balta Sistemi

• Tüm balta türleri desteği
• Dayanıklılık hesaplama sistemi
• Kırılmazlık büyüsü desteği
• Düşük dayanıklılık uyarıları

📊 İstatistikler

• SQLite veritabanı ile oyuncu istatistikleri
• Kırılan kütük, başarılı oyun, başarı oranı takibi
• Liderlik tablosu (Leaderboard)

🔧 Yönetim

• Detaylı konfigürasyon dosyası
• Yetki tabanlı erişim kontrolü
• Dünya bazlı aktif/pasif ayarı
• PlaceholderAPI desteği
• Folia sunucu desteği

📁 Kurulum

1. Gereksinimler:

   • Paper/Folia 1.20+ sunucu
   • Java 17+
   • PlaceholderAPI (isteğe bağlı)

2. Kurulum:

   # TimberPlus-1.0.0.jar dosyasını plugins klasörüne kopyalayın
   cp TimberPlus-1.0.0.jar /path/to/server/plugins/
   
   # Sunucuyu yeniden başlatın
   /restart

🎯 Komutlar

Komut	Açıklama	Yetki
/tmp	Modu aç/kapat	timberplus.use
/tmp help	Yardım menüsü	-
/tmp stats [oyuncu]	İstatistikleri gör	timberplus.command.stats
/tmp top	Liderlik tablosu	timberplus.command.leaderboard
/tmp reload	Eklentiyi yenile	timberplus.admin
/tmp reset <oyuncu>	İstatistikleri sıfırla	timberplus.admin
/tmp debug	Hata ayıklama bilgisi	timberplus.admin

📈 PlaceholderAPI

Placeholder	Açıklama
%timberplus_logs_broken%	Toplam kırılan kütük
%timberplus_rank%	Oyuncu sıralaması
%timberplus_success_rate%	Başarı oranı
%timberplus_total_games%	Toplam oyun
%timberplus_successful_games%	Başarılı oyun