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)

🎯 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ı)

🎯 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 |