TimberPlus

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 |