Başlangıçta İtem Verme Sistemi(json)

Yeni oluşturulan karakterlerin, belirlemiş olduğunuz item’lara (eşyalar) sahip şekilde oyuna başlamasını sağlar. İsterseniz bu item’ların karaktere giydirilmiş (donatılmış) olarak gelmesini de sağlayabilirsiniz. Ayrıca başlangıç item’ları için adet, bonuslar ve taşlar (soketler, yani süreli eşyalar) gibi özellikleri de ayarlayabilirsiniz.

Bu işlev yalnızca PlayerCreate (karakter oluşturulduğunda) sırasında çağrılır ve tetiklenir. Bu nedenle, eşyaların iki kez verilmesini önlemek için ayrıca bir görev bayrağına ihtiyaç yoktur. Tabloda yapılan değişikliklerden sonra sunucuyu yeniden başlatmanıza gerek yoktur; sadece /reload g komutunu kullanmanız yeterlidir.

Tek can sıkıcı kısım, ekipmanlar için her öğenin yerleştirileceği tam yuva dizinlerini (slot) belirtmek zorunda olmanızdır.

---

Başlangıçta İtem Verme Sistemi (JSON)

Metin2 özel sunucularında oyuncuların oyun içi deneyimini artırmak için başlatma aşamasında belirli itemlerin otomatik olarak verilmesi oldukça yaygın bir özelliktir. Bu işlem genellikle C++ backend tarafında ya da Python tabanlı client-side sistemler üzerinden yönetilir. Bu yazıda JSON formatında yapılandırılan başlangıç item sisteminin nasıl kurulacağını ve nasıl çalıştığını detaylıca ele alacağız.

JSON Nedir ve Neden Kullanılır?
JSON (JavaScript Object Notation), verileri insanlar ve makineler tarafından kolayca okunabilen, hafif bir veri değişim formatıdır. Metin2 geliştiricileri, özellikle başlangıç item sistemi gibi dinamik yapıları tanımlamak için JSON kullanmayı tercih eder. JSON, esnekliği sayesinde hem C++ hem de Python sistemlerinde kolayca entegre edilebilir.

JSON Tabanlı Item Listesi Örneği
Aşağıda örnek bir JSON dosyası görülmektedir. Bu dosya, oyuncu karakter oluşturulduğunda veya oyuna giriş yapıldığında verilecek itemleri tanımlar:
{
'items': [
{'vnum': 1, 'count': 1},
{'vnum': 25, 'count': 5},
{'vnum': 701, 'count': 1}
]
}

C++ Backend Tarafında Entegrasyon
Game server tarafında C++ tabanlı bir yapı kullanılıyorsa, JSON parser kütüphaneleri (örneğin nlohmann/json) ile bu yapıyı okumak oldukça kolaydır. Sunucu, oyuncu giriş yaptığında bu dosyadaki item listesini kontrol ederek ilgili itemleri envanterine ekler. Bu sistem aynı zamanda farklı classlara özel item verme gibi gelişmiş senaryolara da izin verir.

Python Client Tarafında Uygulama
Metin2 client tarafında Python ile yazılmış UI Script (uiscript) sistemleri de JSON dosyalarını okuyabilir. Özellikle GUI tabanlı sistemlerde (Py GUI) bu veriler kullanıcı arayüzüne entegre edilerek, oyuncuya başlangıç itemlerini göstermek mümkün olur. Bu sayede hem backend hem frontend tarafında tutarlı bir yapı sağlanır.

Olası Hatalar ve Çözüm Yolları
JSON formatında küçük bir yazım hatası bile sistemin çalışmamasına neden olabilir. Özellikle süslü parantez eksikliği, virgül yerine noktalı virgül konması gibi hatalar dikkat edilmesi gereken durumlardır. JSON doğrulama araçları kullanarak yapısal hataları önceden tespit edebilirsiniz.

Sonuç
JSON formatında yapılandırılmış başlangıç item sistemleri, Metin2 özel sunucularında esneklik ve kolay yönetim sağlar. Hem C++ backend hem de Python client tarafında entegre edilebilir olması sayesinde geliştiricilere büyük kolaylık sunar.

---

Starting Item Giving System (JSON)

In Metin2 private servers, automatically giving certain items at the start of the game is a common feature that enhances the player experience. This process is typically managed through the C++ backend or Python-based client-side systems. In this article, we will examine how to set up and operate a starting item system configured via JSON format in detail.

What is JSON and Why is it Used?
JSON (JavaScript Object Notation) is a lightweight data interchange format that is easy for both humans and machines to read. Metin2 developers often prefer JSON to define dynamic structures like starting item systems due to its flexibility. Thanks to its adaptability, JSON can be easily integrated into both C++ and Python systems.

Example JSON-Based Item List
Below is an example JSON file that defines which items should be given to players upon character creation or login:
{
'items': [
{'vnum': 1, 'count': 1},
{'vnum': 25, 'count': 5},
{'vnum': 701, 'count': 1}
]
}

Integration on the C++ Backend[/BR]If a C++-based structure is used on the game server side, JSON parser libraries (e.g., nlohmann/json) make reading this structure quite simple. Upon player login, the server checks the item list in this file and adds the corresponding items to the player's inventory. This system also allows advanced scenarios such as giving different items based on character classes.

Implementation on the Python Client Side
On the Metin2 client side, UI scripts written in Python can also read JSON files. Particularly in GUI-based systems (Py GUI), these data can be integrated into the user interface to display starting items to the player. This ensures consistency across both backend and frontend components.

Possible Errors and Solutions
Minor syntax errors in JSON format, such as missing curly braces or using semicolons instead of commas, can prevent the system from working. These are common issues to watch out for. You can use JSON validation tools to detect structural errors beforehand.

Conclusion
Starting item systems configured with JSON provide flexibility and easier management for Metin2 private servers. Their ability to integrate into both C++ backend and Python client-side implementations offers great convenience to developers.