Character templates
Purpose
This page holds the game’s character and item templates. It has four sections: character definitions, item definitions, level curves and traits. A character definition decides which traits and which level curve a character is born with; an item definition is the template of every item that can be given in the game. When you change a template the old version is not deleted; a new version is released.
When to use
- To define a new item (weapon, consumable, cosmetic…).
- To change which traits characters are born with.
- To set the XP needed per level.
- To try whether a definition is valid before releasing it.
Step by step
Add a new item
- In the Eşya tanımları (Item definitions) section press Yeni silah (New weapon). Only admins with the related write permission see the button. Weapon is not a separate kind: it is the “Weapon / equipment” kind; you can change the kind in the form.
- Temel bilgiler (Basic information): name, key, kind; the max stack if the item is stackable.
- Ticaret (Trade): tradeability and NPC buy and sell prices.
- Görünüm (3D) (Appearance (3D)): if you wish, choose a published model.
- Oyun verisi (Game data): add the extra values the game will read, row by row.
- Kayıt (Save): write a reason and save. The item’s system information and details open when you press the row.
Release a new version for a character definition
- In the Karakter tanımları (Character definitions) section press Yeni sürüm yayınla (Release new version); or open a definition and choose Bu tanımla yeni sürüm hazırla (Prepare a new version with this definition).
- Write the key and choose at least one trait.
- If needed, change the values coming from the traits for this definition with Üzerine yazılacak değerler (Values to overwrite).
- Set the display name, the model and the game data.
- Write a reason and release. The panel states the work to be done in one sentence before saving.
Note
The trait order and values are merged at release time and become a new version. The display name, model and game data are independent of the version; they take effect immediately when saved.
Try without releasing
With Doğrula / önizle (Validate / preview) you can see whether the definition is valid and its merged form without saving anything. Önizle (Preview) in the level curve section also computes on the server the curve’s highest level and the total XP for that level.
Release a level curve
- In the Seviye eğrileri (Level curves) section press Yeni sürüm yayınla.
- Write the curve key and the curve’s JSON definition; check the result first with Önizle.
- Write a reason and press Yayınla (Release). The new version does not replace the old one.
Fields and options
Item form
| Field | Required | Description |
|---|---|---|
| Name | Yes | The name the player will see |
| Key | Yes | Lowercase letters, digits, underscores; fixed after saving |
| Kind | Yes | Consumable, Weapon / equipment, Material, Cosmetic, VIP card |
| Stackable | Yes | Yes or No |
| Max stack | If stackable | 1 to 2147483647 |
| Tradeable | Yes | Yes or No |
| NPC buy price, NPC sell price | No | If empty, trade in that direction is off; 0 is free |
| 3D model | No | A published model |
| Values | No | Game data rows |
| Action reason | Yes | At least 8 characters |
Character definition form
| Field | Required | Description |
|---|---|---|
| Definition key | Yes | Fixed after saving |
| Trait keys | Yes | At least one; order matters |
| Values to overwrite | No | Section, name, field and value rows |
| Display name | No | The name shown in the game |
| 3D model | No | A published model |
| Game data | No | Extra values |
| Action reason | Yes | At least 8 characters |
In overwrite rows the Bölüm (Section) is one of: Nitelikler (Attributes; fields: Default value, Min, Max), Kaynaklar (Resources; Default value, Max (expression), Regeneration per minute, When it reaches zero) and Türetilmiş değerler (Derived values; Expression). System fields used by a plugin are locked.
Common situations
| Situation | What to do |
|---|---|
| “Yayın için en az bir özellik anahtarı yazın” (Write at least one trait key to release) | A version with no traits empties the definition; choose at least one trait. |
| The “Yeni sürüm yayınla” or “Yeni silah” button is missing | Your account’s role has no related write permission; the page is read-only. |
| Someone else changed the same record and a conflict warning appeared | See the latest state with Güncel hâli yükle (Load the current state); or deliberately overwrite with Yine de kaydet (Save anyway). |
| “Bu anahtar zaten var” (This key already exists) | You cannot write an existing key in the new version form; edit the definition from its detail with Bu tanımla yeni sürüm hazırla. |
| I cannot delete a record with a “Sistem” (System) badge | It is a system record used by a plugin; it is not deleted, changes become a new version. |
| I cannot change traits from this page | Traits are only inspected on this screen. |
| There is no “weapon” in the item kind list | Weapon is not a separate kind; it is the “Weapon / equipment” kind. |