---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.4
alternate:
  - https://yandex.com.tr/dev/games/doc/en/sdk/construct-3/text-localization.md
  - https://yandex.com.tr/dev/games/doc/hi/sdk/construct-3/text-localization.md
  - https://yandex.com.tr/dev/games/doc/ko/sdk/construct-3/text-localization.md
  - https://yandex.com.tr/dev/games/doc/ru/sdk/construct-3/text-localization.md
  - https://yandex.com.tr/dev/games/doc/tr/sdk/construct-3/text-localization.md
  - https://yandex.com.tr/dev/games/doc/vi/sdk/construct-3/text-localization.md
  - https://yandex.com.tr/dev/games/doc/zh/sdk/construct-3/text-localization.md
  - href: tr/sdk/construct-3/text-localization.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/games/doc/tr/llms.txt

# Metin yerelleştirme

<!-- source: tr/_includes/script-common.md -->
<!-- source: tr/_includes/script/index-js.md -->

<!-- endsource: tr/_includes/script/index-js.md -->

<!-- source: tr/_includes/script/requirements-js.md -->

<!-- endsource: tr/_includes/script/requirements-js.md -->

<!-- source: tr/_includes/script/image-modal-js.md -->

<!-- endsource: tr/_includes/script/image-modal-js.md -->
<!-- endsource: tr/_includes/script-common.md -->

Bu eklentinin temel işlevlerinden biri, otomatik metin çeviri sistemidir.

Yapmanız gereken tek şey, JSON formatında çevirileri hazırlamak ve yeni veya mevcut projelerinizde rahatça kullanmaktır.

Geliştirme sürecinde temel olarak göz önünde bulundurduğumuz prensip, projenize ek kod eklememektir. Çoğu zaman oyununuzu yerelleştirmek için hiç kod yazmanız gerekmez.



## Çeviri dosyalarını oluşturma {#create-i18n-files}

Oyununuzu yerelleştirmenin ilk adımı, JSON çevirilerini hazırlamaktır.

Öncelikle, `Files` dizini içinde `i18n` adında bir klasör oluşturmanız gerekir. Ardından, bu klasörde [ISO 639-1 formatında](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes){.external} dil kodları ile adlandırılmış JSON dosyaları oluşturun.

![](../../_images/construct-3/text-localization/create-i18n-files.gif)

Örneğin, `en.json` ve `ru.json` dosyalarını şu içerikle oluşturalım:

{% list tabs %}

- `en.json`

    ```json showLineNumbers
    {
    "game": {
        "title": "First Fantasy 10"
    },
    "potions": {
        "health": "Health Potion",
        "mana": "Mana Potion"
    }
    }
    ```

- `ru.json`

    ```json showLineNumbers
    {
    "game": {
        "title": "Первая Фантазия 10"
    },
    "potions": {
        "health": "Зелье жизни",
        "mana": "Зелье маны"
    }
    }
    ```

{% endlist %}

Bu şekilde, İngilizce ve Rusça olmak üzere iki dil için çeviriler oluşturduk. Artık bunları projemizde kullanabiliriz.



## Düzenlerde kullanım {#use-in-layouts}

Şimdi çevirilerimizi kullanmak için, düzende bir metin nesnesi oluşturalım ve ona `{game.title}` değerini atayalım.

![](../../_images/construct-3/text-localization/example.webp)

Şimdi oynat (önizleme) düğmesine bastığımızda, bir mucize göreceğiz — metnimiz otomatik olarak "First Fantasy 10" değerine dönüşecek.

Bu, otomatik yerelleştirme sistemimizin [Metin](https://www.construct.net/en/make-games/manuals/construct-3/plugin-reference/text){.external}, [Sprite Yazı Tipi](https://www.construct.net/en/make-games/manuals/construct-3/plugin-reference/sprite-font){.external} ve [Uyarlanabilir Metin](https://yandex.com.tr/dev/games/doc/tr/sdk/construct-3/adaptive-text.md) nesneleri içindeki metni değiştirebildiği için gerçekleşir.

![](../../_images/construct-3/text-localization/result.webp)



## Olaylarda kullanım {#use-in-events}

Ayrıca, Construct 3'ün yerel olaylarında ve diğer yerlerde çeviri anahtarlarını kullanabilirsiniz.

Otomatik yerelleştirme sistemi, oyun sırasında bile değişiklik olduğunda `{potions.mana}`'yı "Mana Potion" ile değiştirebilir.

![](../../_images/construct-3/text-localization/runtime-set-text.webp)

Üstelik sadece **Set text** kullanımıyla sınırlı değilsiniz — metni istediğiniz zaman ve istediğiniz şekilde değiştirebilirsiniz.

Örneğin, bir düğmeye basıldığında daktilo animasyonu başlatabilir ve her şey çalışacaktır.

![](../../_images/construct-3/text-localization/runtime-typewrite-text.gif)


---


<!-- source: tr/_includes/button-git.md -->
<a href="https://github.com/yandex-games-plugins/construct3">
  <span class="button">Depo</span>
</a>
<!-- endsource: tr/_includes/button-git.md -->