# YLEconomy v0.2

A comprehensive, multi-language economy solution for Minecraft servers developed by YoungLion.

[English](#english) | [Türkçe](#türkçe)

---

<a name="english"></a>
# English

## Overview

YLEconomy is a powerful Vault-compatible economy plugin for Minecraft servers that provides a complete financial system with multi-currency support, banking features, intuitive commands, and extensive customization options. Suitable for servers of any size.

## Key Features

- **Multi-currency System**: Support for multiple currencies with independent balances
- **Banking System**: Complete banking system with different account types, interest rates, and upgrades
- **Vault Integration**: Fully compatible with all Vault-dependent plugins
- **Intuitive UI**: Player-friendly commands and scoreboard display
- **Advanced Admin Tools**: Comprehensive economy management for server administrators
- **Extensive Customization**: Highly configurable to fit your server's needs
- **Multi-language Support**: Available in 11 languages (EN, PL, TR, DE, FR, ES, RU, IT, AZ, VI, AR)
- **Robust Data Storage**: Secure and reliable data storage with auto-save capabilities
- **Optimized Performance**: Lightweight with minimal server impact

## Requirements

- Minecraft server running Paper/Spigot 1.19+
- Java 21 or higher
- [Vault]( https://www.spigotmc.org/resources/vault.34315/) plugin installed

## Installation

1. Download the latest YLEconomy.jar from the releases page
2. Place the jar file in your server's `plugins` folder
3. Restart your server or use a plugin manager to load the plugin
4. Configuration files will be automatically generated in the `plugins/YLEconomy` directory

## Configuration

Edit the `config.yml` file in the `plugins/YLEconomy` directory to configure the plugin:

```yaml
# Language Settings (Available: en, pl, tr, de, fr, es, ru, it, az, vi, ar)
language: en

# Currency Settings
currency:
name: Young Lion Minecoin
singular: YLM
plural: YLMs
starting-balance: 100.0
max-balance: -1 # -1 for unlimited

# Bank System
bank:
enabled: true
interest:
enabled: true
rate: 0.5 # 0.5% interest rate
interval: 1440 # In minutes (1440 = 24 hours)
account-types:
standard:
name: "Standard Account"
interest-multiplier: 1.0
max-balance: 10000.0
fee: 0.0
gold:
name: "Gold Account"
interest-multiplier: 1.5
max-balance: 50000.0
fee: 1000.0
premium:
name: "Premium Account"
interest-multiplier: 2.0
max-balance: 100000.0
fee: 5000.0

# Scoreboard Settings
scoreboard:
enabled: true
title: "&6YoungLion Economy"
format: "&eYLM: &9%balance%"
bank-format: "&eBank: &9%balance% &7(%account_type%)"
update-interval: 20 # ticks (20 ticks = 1 second)

# Data Storage Settings
data:
# Format for saving player data: username or uuid
save-format: username
save-interval: 300 # seconds
auto-save: true
```

## Commands

### Player Commands

| Command | Description | Permission |
|---------|-------------|------------|
| `/economy` or `/eco` | Shows main economy commands | - |
| `/eco balance [player]` | View balance | yleconomy.balance |
| `/eco bal [player]` | Shortcut for balance command | yleconomy.balance |
| `/eco top [page]` | Show richest players | yleconomy.top |
| `/eco pay <player> <amount>` | Send money to another player | yleconomy.pay |
| `/eco bank` | Access bank system | yleconomy.bank |
| `/eco bank info` | View your bank account details | yleconomy.bank |
| `/eco bank deposit <amount>` | Deposit money into your account | yleconomy.bank |
| `/eco bank withdraw <amount>` | Withdraw money from your account | yleconomy.bank |
| `/eco bank upgrade` | Upgrade your bank account type | yleconomy.bank |
| `/eco help` | Display help menu | - |

### Admin Commands

| Command | Description | Permission |
|---------|-------------|------------|
| `/ecoadmin` or `/ecoa` | Shows admin command menu | yleconomy.admin |
| `/ecoa set <player> <amount>` | Set a player's balance | yleconomy.admin |
| `/ecoa give <player> <amount>` | Give money to a player | yleconomy.admin |
| `/ecoa take <player> <amount>` | Take money from a player | yleconomy.admin |
| `/ecoa reset <player>` | Reset a player's balance | yleconomy.admin |
| `/ecoa bank info <player>` | View player's bank account information | yleconomy.admin |
| `/ecoa bank reset <player>` | Reset a player's bank account | yleconomy.admin |
| `/ecoa bank set <player> <type>` | Change a player's bank account type | yleconomy.admin |
| `/ecoa help` | Show admin help | yleconomy.admin |

## Permissions

- `yleconomy.balance` - Access to balance command (default: true)
- `yleconomy.pay` - Access to payment command (default: true)
- `yleconomy.top` - Access to top command (default: true)
- `yleconomy.bank` - Access to bank commands (default: true)
- `yleconomy.admin` - Access to all economy administrative commands (default: op)

## Localization

The plugin supports multiple languages. You can change the language in the config.yml file:

```yaml
# Language Settings (Available: en, pl, tr, de, fr, es, ru, it, az, vi, ar)
language: en
```

## Data Storage

Player data is stored in YAML files in the `plugins/YLEconomy/userdata` directory. Bank data is stored in `plugins/YLEconomy/bank` directory.

## Support

For support, bug reports, or feature requests, please create an issue on our GitHub repository.

## License

YLEconomy is licensed under the MIT License. See the LICENSE file for more information.

## Credits

- **Creator**: cavanshirpro
- **Organization**: YoungLion

---

<a name="türkçe"></a>
# Türkçe

## Genel Bakış

YLEconomy, Minecraft sunucuları için çok para birimli destek, bankacılık özellikleri, sezgisel komutlar ve kapsamlı özelleştirme seçenekleri ile eksiksiz bir finansal sistem sağlayan, Vault uyumlu güçlü bir ekonomi eklentisidir. Her boyuttaki sunucu için uygundur.

## Temel Özellikler

- **Çoklu Para Birimi Sistemi**: Bağımsız bakiyelerle birden fazla para birimi desteği
- **Bankacılık Sistemi**: Farklı hesap türleri, faiz oranları ve yükseltmelerle tam bankacılık sistemi
- **Vault Entegrasyonu**: Tüm Vault bağımlı eklentilerle tam uyumluluk
- **Sezgisel Kullanıcı Arayüzü**: Oyuncu dostu komutlar ve skor tablosu gösterimi
- **Gelişmiş Yönetici Araçları**: Sunucu yöneticileri için kapsamlı ekonomi yönetimi
- **Kapsamlı Özelleştirme**: Sunucunuzun ihtiyaçlarına uyacak şekilde yüksek düzeyde yapılandırılabilir
- **Çoklu Dil Desteği**: 11 dilde mevcut (EN, PL, TR, DE, FR, ES, RU, IT, AZ, VI, AR)
- **Sağlam Veri Depolama**: Otomatik kaydetme özellikleriyle güvenli ve güvenilir veri depolama
- **Optimize Edilmiş Performans**: Sunucu üzerinde minimum etkiyle hafif yapı

## Gereksinimler

- Paper/Spigot 1.19+ çalıştıran Minecraft sunucusu
- Java 21 veya daha yüksek
- Yüklü [Vault]( https://www.spigotmc.org/resources/vault.34315/) eklentisi

## Kurulum

1. Sürümler sayfasından en son YLEconomy.jar dosyasını indirin
2. Jar dosyasını sunucunuzun `plugins` klasörüne yerleştirin
3. Sunucunuzu yeniden başlatın veya eklentiyi yüklemek için bir eklenti yöneticisi kullanın
4. Yapılandırma dosyaları `plugins/YLEconomy` dizininde otomatik olarak oluşturulacaktır

## Yapılandırma

Eklentiyi yapılandırmak için `plugins/YLEconomy` dizinindeki `config.yml` dosyasını düzenleyin:

```yaml
# Dil Ayarları (Mevcut: en, pl, tr, de, fr, es, ru, it, az, vi, ar)
language: tr

# Para Birimi Ayarları
currency:
name: Young Lion Minecoin
singular: YLM
plural: YLM
starting-balance: 100.0
max-balance: -1 # -1 sınırsız için

# Banka Sistemi
bank:
enabled: true
interest:
enabled: true
rate: 0.5 # %0.5 faiz oranı
interval: 1440 # Dakika cinsinden (1440 = 24 saat)
account-types:
standard:
name: "Standart Hesap"
interest-multiplier: 1.0
max-balance: 10000.0
fee: 0.0
gold:
name: "Altın Hesap"
interest-multiplier: 1.5
max-balance: 50000.0
fee: 1000.0
premium:
name: "Premium Hesap"
interest-multiplier: 2.0
max-balance: 100000.0
fee: 5000.0

# Skor Tablosu Ayarları
scoreboard:
enabled: true
title: "&6YoungLion Ekonomi"
format: "&eYLM: &9%balance%"
bank-format: "&eBanka: &9%balance% &7(%account_type%)"
update-interval: 20 # tick (20 tick = 1 saniye)

# Veri Depolama Ayarları
data:
# Oyuncu verilerini kaydetme formatı: username veya uuid
save-format: username
save-interval: 300 # saniye
auto-save: true
```

## Komutlar

### Oyuncu Komutları

| Komut | Açıklama | İzin |
|---------|-------------|------------|
| `/economy` veya `/eco` | Ana ekonomi komutlarını gösterir | - |
| `/eco balance [oyuncu]` | Bakiyeyi görüntüle | yleconomy.balance |
| `/eco bal [oyuncu]` | Bakiye komutu için kısayol | yleconomy.balance |
| `/eco top [sayfa]` | En zengin oyuncuları göster | yleconomy.top |
| `/eco pay <oyuncu> <miktar>` | Başka bir oyuncuya para gönder | yleconomy.pay |
| `/eco bank` | Banka sistemine eriş | yleconomy.bank |
| `/eco bank info` | Banka hesap detaylarını görüntüle | yleconomy.bank |
| `/eco bank deposit <miktar>` | Hesabına para yatır | yleconomy.bank |
| `/eco bank withdraw <miktar>` | Hesabından para çek | yleconomy.bank |
| `/eco bank upgrade` | Banka hesap tipini yükselt | yleconomy.bank |
| `/eco help` | Yardım menüsünü göster | - |

### Yönetici Komutları

| Komut | Açıklama | İzin |
|---------|-------------|------------|
| `/ecoadmin` veya `/ecoa` | Yönetici komut menüsünü gösterir | yleconomy.admin |
| `/ecoa set <oyuncu> <miktar>` | Bir oyuncunun bakiyesini ayarla | yleconomy.admin |
| `/ecoa give <oyuncu> <miktar>` | Bir oyuncuya para ver | yleconomy.admin |
| `/ecoa take <oyuncu> <miktar>` | Bir oyuncudan para al | yleconomy.admin |
| `/ecoa reset <oyuncu>` | Bir oyuncunun bakiyesini sıfırla | yleconomy.admin |
| `/ecoa bank info <oyuncu>` | Oyuncunun banka hesap bilgilerini görüntüle | yleconomy.admin |
| `/ecoa bank reset <oyuncu>` | Oyuncunun banka hesabını sıfırla | yleconomy.admin |
| `/ecoa bank set <oyuncu> <tip>` | Oyuncunun banka hesap tipini değiştir | yleconomy.admin |
| `/ecoa help` | Yönetici yardımını göster | yleconomy.admin |

## İzinler

- `yleconomy.balance` - Bakiye komutuna erişim (varsayılan: true)
- `yleconomy.pay` - Ödeme komutuna erişim (varsayılan: true)
- `yleconomy.top` - Top komutuna erişim (varsayılan: true)
- `yleconomy.bank` - Banka komutlarına erişim (varsayılan: true)
- `yleconomy.admin` - Tüm ekonomi yönetim komutlarına erişim (varsayılan: op)

## Yerelleştirme

Eklenti birden fazla dili destekler. Dili config.yml dosyasında değiştirebilirsiniz:

```yaml
# Dil Ayarları (Mevcut: en, pl, tr, de, fr, es, ru, it, az, vi, ar)
language: tr
```

## Veri Depolama

Oyuncu verileri `plugins/YLEconomy/userdata` dizinindeki YAML dosyalarında saklanır. Banka verileri `plugins/YLEconomy/bank` dizininde saklanır.

## Destek

Destek, hata raporları veya özellik istekleri için lütfen GitHub deposunda bir sorun oluşturun.

## Lisans

YLEconomy, MIT Lisansı altında lisanslanmıştır. Daha fazla bilgi için LICENSE dosyasına bakın.

## Krediler

- **Yaratıcı**: cavanshirpro
- **Organizasyon**: YoungLion