> For the complete documentation index, see [llms.txt](https://voseraproject.gitbook.io/voseraproject/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://voseraproject.gitbook.io/voseraproject/eklenti-hizmeti/randomitemchange/oyun-mekanigi.md). # Oyun Mekaniği ### Durum Akışı Her arena kendi bağımsız oyun durumunda ilerler: * **Bekleniyor** — arenaya yeterli oyuncu katılana kadar bu aşamada kalınır. En az 2 oyuncuya ulaşıldığında otomatik olarak geri sayım aşamasına geçilir. * **Başlıyor** — `lobby-countdown` ayarından gelen süre boyunca geri sayım yapılır. Arena, tanımlı minimum oyuncu sayısına ulaşırsa geri sayım otomatik olarak kısaltılır ("arena doldu, süre kısaltıldı" bildirimiyle). Oyuncu sayısı tekrar 2'nin altına düşerse başlangıç iptal edilip bekleme aşamasına dönülür. Son saniyelerde hem sohbete mesaj hem de ekrana geri sayım başlığı gösterilir. * **Oynanıyor** — rastgele eşya dağıtımı, sınır daralması (etkinse) ve maç süresi takibi bu aşamada aktiftir. * **Bitiyor** — kazanan belirlenir, ödüller dağıtılır, harita otomatik olarak eski haline getirilir, oyuncular lobiye gönderilir. ### Rastgele Eşya Sistemi Eklenti başlarken, sunucudaki geçerli tüm eşyalardan (bloklar dahil) oluşan bir liste hazırlanır. `config.yml` içindeki kara listeye eklenen eşyalar bu listeden çıkarılır, böylece komut blokları, bariyer, bedrock gibi yönetimsel/hileli bloklar asla rastgele verilmez. Her arenanın kendine ait bir sayacı vardır; bu sayaç dolduğunda hayatta kalan tüm oyunculara kara listede olmayan eşyalardan rastgele biri verilir ve süre yeniden başlar. Bu süre hem `config.yml` → `duration` anahtarından hem de yetkili bir komutla anlık olarak değiştirilebilir. ### Eşya Göstergesi (BossBar) Her arenanın ekranın üstünde, sıradaki eşya değişimine kalan süreyi gösteren kendine ait bir ilerleme çubuğu (boss bar) bulunur. Maça yeni katılan oyuncular ve izleyiciler otomatik olarak bu çubuğu görür; maç bittiğinde çubuk kaldırılır. ### Envanter Koruması Oyuncu maça katıldığında mevcut envanteri, zırhı ve oyun modu güvenle yedeklenir. Maçtan ayrıldığında veya maç bittiğinde bu veriler geri yüklenir — böylece oyuncular kendi normal eşyalarını kaybetmez. ### Ödül Komutları Maç sonucuna göre (öldürme, 1./2./3. sıra, beraberlik) çalıştırılacak konsol komutları `config.yml` üzerinden tanımlanır ve `%player%` ile hedef oyuncuya işaret edilebilir. Boş bırakılan bir ödül alanı, o sıralama için hiçbir komut çalıştırmaz. > **Not:** Düello maçlarında ödül komutları ve istatistik güncellemeleri devre dışıdır — sadece normal arena maçlarının sonuçları sayılır. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://voseraproject.gitbook.io/voseraproject/eklenti-hizmeti/randomitemchange/oyun-mekanigi.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.