GeoBlock 1.0.0

================================================================================
                              GEOBLOCK v1.0
                    Real World Map Minecraft Plugin
================================================================================

Developer: [inal12]
Platform: Paper/Spigot 1.20.x
Java: 17+
License: MIT

================================================================================
                               DESCRIPTION
================================================================================

GeoBlock is a unique plugin that brings the real world into Minecraft at a 1:1
scale. Players can teleport to real GPS coordinates, build in their own
neighborhoods/cities, and experience real-time weather and day/night cycles
synchronized with the actual world.

================================================================================
                                FEATURES
================================================================================

🌍 REAL WORLD MAP
   • 1:1 scale coordinate system (1 block ≈ 1 meter)
   • Teleport to GPS coordinates (/geo tp <lat> <lng>)
   • Explore real-world locations in Minecraft
   • Realistic terrain heights with Google Maps Elevation API

🌤️ REAL-TIME WEATHER
   • Free weather sync with Open-Meteo API
   • Real rain, snow, and thunderstorms
   • Temperature, humidity, and wind speed info
   • No API key required - completely free!

🕐 REAL-TIME DAY/NIGHT CYCLE
   • Automatic timezone detection based on player location
   • Minecraft time synced to real-world time
   • Full timezone support worldwide

📍 LOCATION HUD SYSTEM
   • BossBar showing weather, temperature, and location
   • Scoreboard with city, district, neighborhood info
   • Real-time GPS coordinate updates
   • Land ownership information

🏠 REGION CLAIM SYSTEM
   • Chunk-based land claiming
   • Persistent storage with SQLite database
   • Per-player claim limits
   • Protection system (build/break permissions)

🌐 MULTI-LANGUAGE SUPPORT
   • English (default)
   • Turkish
   • Per-player language selection
   • Easily extendable language system

================================================================================
                                COMMANDS
================================================================================

/geo help              - Show help menu
/geo tp <lat> <lng>    - Teleport to GPS coordinates
                         Example: /geo tp 40.7580 -73.9855 (New York)
                         Example: /geo tp 48.8584 2.2945 (Paris)
                         Example: /geo tp 51.5074 -0.1278 (London)

/geo here              - Show current GPS coordinates
/geo claim             - Claim the chunk you're standing in
/geo unclaim           - Remove your claim
/geo weather           - Show real weather info
/geo weather sync      - Force weather sync (Admin)
/geo time              - Force time sync (Admin)
/geo lang <en/tr>      - Change language
/geo reload            - Reload configuration (Admin)

================================================================================
                               PERMISSIONS
================================================================================

geoblock.teleport      - Use /geo tp command
geoblock.here          - Use /geo here command
geoblock.claim         - Claim/unclaim regions
geoblock.weather       - View weather info
geoblock.lang          - Change language
geoblock.admin         - Admin commands (reload, time, weather sync)

================================================================================
                              INSTALLATION
================================================================================

1. Copy GeoBlock.jar to your plugins/ folder
2. Start the server
3. Edit plugins/GeoBlock/config.yml
4. (Optional) Add Google Maps API key for realistic terrain
5. Use /geo reload to apply changes

================================================================================
                              API INFORMATION
================================================================================

WEATHER: Open-Meteo API
   • Completely free
   • No API key required
   • https://open-meteo.com/

LOCATION (Geocoding): BigDataCloud + Nominatim
   • Completely free
   • No API key required
   • City, district, neighborhood data

TERRAIN (Optional): Google Maps Elevation API
   • Free tier available
   • Required for realistic elevation data
   • API key needed
   • https://console.cloud.google.com/

================================================================================
                           EXAMPLE LOCATIONS
================================================================================

USA:
   New York (Times Square)  : /geo tp 40.7580 -73.9855
   Los Angeles              : /geo tp 34.0522 -118.2437
   Chicago                  : /geo tp 41.8781 -87.6298
   Miami                    : /geo tp 25.7617 -80.1918
   Las Vegas                : /geo tp 36.1699 -115.1398

EUROPE:
   Paris (Eiffel Tower)     : /geo tp 48.8584 2.2945
   London (Big Ben)         : /geo tp 51.5007 -0.1246
   Rome (Colosseum)         : /geo tp 41.8902 12.4922
   Berlin                   : /geo tp 52.5200 13.4050
   Amsterdam                : /geo tp 52.3676 4.9041

ASIA:
   Tokyo                    : /geo tp 35.6762 139.6503
   Dubai (Burj Khalifa)     : /geo tp 25.1972 55.2744
   Singapore                : /geo tp 1.3521 103.8198
   Hong Kong                : /geo tp 22.3193 114.1694
   Beijing                  : /geo tp 39.9042 116.4074

OTHER:
   Sydney (Opera House)     : /geo tp -33.8568 151.2153
   Rio de Janeiro           : /geo tp -22.9068 -43.1729
   Cairo (Pyramids)         : /geo tp 29.9792 31.1342
   Cape Town                : /geo tp -33.9249 18.4241

================================================================================
                           TECHNICAL INFORMATION
================================================================================

• Platform: Paper/Spigot 1.20.4+
• Java Version: 17 or higher
• Database: SQLite (built-in)
• Dependencies: None (standalone)
• Performance: Async API calls, smart caching

================================================================================
                                 SUPPORT
================================================================================

Bug reports and suggestions:
GitHub: [inal122]
Discord: [coming]

================================================================================
                              VERSION HISTORY
================================================================================

v1.0.0 (2026)
   • Initial release
   • GPS coordinate system
   • Real-time weather sync (Open-Meteo)
   • Real-time day/night cycle
   • HUD system (BossBar + Scoreboard)
   • Region claim system
   • EN/TR language support
   • Location API (BigDataCloud + Nominatim)

================================================================================
                    Explore the Real World in Minecraft with GeoBlock!
================================================================================




Tr

================================================================================
                              GEOBLOCK v1.0
                    Gerçek Dünya Haritası Minecraft Eklentisi
================================================================================

Geliştirici: [inal12]
Platform: Paper/Spigot 1.20.x
Java: 17+
Lisans: MIT

================================================================================
                                  TANIM
================================================================================

GeoBlock, gerçek dünya haritasını Minecraft'a 1:1 ölçekte aktaran benzersiz bir
eklentidir. Oyuncular gerçek GPS koordinatlarına ışınlanabilir, kendi
mahallelerinde/şehirlerinde yapılar inşa edebilir ve gerçek zamanlı hava durumu
ile gündüz/gece döngüsü deneyimleyebilir.

================================================================================
                               ÖZELLİKLER
================================================================================

🌍 GERÇEK DÜNYA HARİTASI
   • 1:1 ölçekli koordinat sistemi (1 blok ≈ 1 metre)
   • GPS koordinatlarına ışınlanma (/geo tp <lat> <lng>)
   • Gerçek dünya konumlarını Minecraft'ta keşfedin
   • Google Maps Elevation API ile gerçekçi arazi yükseklikleri

🌤️ GERÇEK ZAMANLI HAVA DURUMU
   • Open-Meteo API ile ücretsiz hava durumu senkronizasyonu
   • Gerçek yağmur, kar ve fırtına
   • Sıcaklık, nem ve rüzgar hızı bilgisi
   • API key gerektirmez - tamamen ücretsiz!

🕐 GERÇEK ZAMANLI GÜN/GECE
   • Oyuncunun konumuna göre otomatik saat dilimi algılama
   • Gerçek dünya saatine göre Minecraft zamanı
   • Türkiye için Europe/Istanbul (UTC+3) desteği

📍 KONUM HUD SİSTEMİ
   • BossBar'da hava durumu, sıcaklık ve konum
   • Scoreboard'da şehir, ilçe, mahalle bilgisi
   • GPS koordinatları gerçek zamanlı güncelleme
   • Arsa sahiplik bilgisi

🏠 BÖLGE CLAIM SİSTEMİ
   • Chunk bazlı arsa sahipleme
   • SQLite veritabanı ile kalıcı kayıt
   • Oyuncu başına claim limiti
   • Koruma sistemi (build/break izinleri)

🌐 ÇOK DİLLİ DESTEK
   • İngilizce (varsayılan)
   • Türkçe
   • Oyuncu bazlı dil seçimi
   • Kolay genişletilebilir dil sistemi

================================================================================
                                KOMUTLAR
================================================================================

/geo help              - Yardım menüsünü göster
/geo tp <lat> <lng>    - GPS koordinatına ışınlan
                         Örnek: /geo tp 41.0082 28.9784 (İstanbul)
                         Örnek: /geo tp 38.4237 27.1428 (İzmir)
                         Örnek: /geo tp 39.9334 32.8597 (Ankara)

/geo here              - Mevcut GPS koordinatını göster
/geo claim             - Bulunduğun chunk'ı sahiplen
/geo unclaim           - Sahiplenmeyi kaldır
/geo weather           - Gerçek hava durumunu göster
/geo weather sync      - Hava durumunu zorla senkronize et (Admin)
/geo time              - Zamanı zorla senkronize et (Admin)
/geo lang <en/tr>      - Dil değiştir
/geo reload            - Ayarları yeniden yükle (Admin)

================================================================================
                                 İZİNLER
================================================================================

geoblock.teleport      - /geo tp komutunu kullanma
geoblock.here          - /geo here komutunu kullanma
geoblock.claim         - Arsa sahipleme/bırakma
geoblock.weather       - Hava durumu görüntüleme
geoblock.lang          - Dil değiştirme
geoblock.admin         - Admin komutları (reload, time, weather sync)

================================================================================
                                  KURULUM
================================================================================

1. GeoBlock.jar dosyasını plugins/ klasörüne kopyalayın
2. Sunucuyu başlatın
3. plugins/GeoBlock/config.yml dosyasını düzenleyin
4. (Opsiyonel) Google Maps API key ekleyin (gerçekçi arazi için)
5. /geo reload komutuyla ayarları yeniden yükleyin

================================================================================
                              API BİLGİLERİ
================================================================================

HAVA DURUMU: Open-Meteo API
   • Tamamen ücretsiz
   • API key gerektirmez
   • https://open-meteo.com/

KONUM (Geocoding): BigDataCloud + Nominatim
   • Tamamen ücretsiz
   • API key gerektirmez
   • Şehir, ilçe, mahalle bilgisi

ARAZİ (Opsiyonel): Google Maps Elevation API
   • Ücretsiz tier mevcut
   • Gerçekçi yükseklik verisi için gerekli
   • API key gerektirir
   • https://console.cloud.google.com/

================================================================================
                            ÖRNEK KONUMLAR
================================================================================

TÜRKİYE:
   İstanbul (Taksim)    : /geo tp 41.0370 28.9850
   Ankara (Kızılay)     : /geo tp 39.9208 32.8541
   İzmir (Konak)        : /geo tp 38.4189 27.1287
   Antalya              : /geo tp 36.8969 30.7133
   Bursa                : /geo tp 40.1885 29.0610

DÜNYA:
   Paris (Eyfel)        : /geo tp 48.8584 2.2945
   New York (Times Sq)  : /geo tp 40.7580 -73.9855
   Tokyo                : /geo tp 35.6762 139.6503
   Dubai (Burj Khalifa) : /geo tp 25.1972 55.2744
   Sydney (Opera House) : /geo tp -33.8568 151.2153

================================================================================
                              TEKNİK BİLGİLER
================================================================================

• Platform: Paper/Spigot 1.20.4+
• Java Sürümü: 17 veya üzeri
• Veritabanı: SQLite (dahili)
• Bağımlılıklar: Yok (bağımsız çalışır)
• Performans: Async API çağrıları, akıllı önbellekleme

================================================================================
                                 DESTEK
================================================================================

Hata bildirimi ve öneriler için:
GitHub: [inal122]
Discord: [coming]

================================================================================
                              SÜRÜM GEÇMİŞİ
================================================================================

v1.0.0 (2026)
   • İlk sürüm
   • GPS koordinat sistemi
   • Gerçek zamanlı hava durumu (Open-Meteo)
   • Gerçek zamanlı gün/gece döngüsü
   • HUD sistemi (BossBar + Scoreboard)
   • Bölge claim sistemi
   • TR/EN dil desteği
   • Konum API (BigDataCloud + Nominatim)

================================================================================
                     GeoBlock ile Minecraft'ta Gerçek Dünyayı Keşfedin!
================================================================================