შეცდომების შესახებ შეტყობინება

1. პირველი, რაც უნდა გააკეთოთ, არის ჩვენი GitLab საკითხები შემოწმება, თუ ეს შეცდომა უკვე ცნობილია.
2. თუ არა შექმენით პრობლემა Bug template-ით და შეეცადეთ აღწეროთ ხარვეზი რაც შეიძლება კარგად, საჭიროების შემთხვევაში დაამატეთ ეკრანის ანაბეჭდები.
3. ატვირთეთ ჟურნალის ფაილი დამატებითი ინფორმაციისთვის, რომელიც დაგვეხმარება პრობლემის იდენტიფიცირებაში. იხილეთ ქვემოთ, თუ როგორ უნდა მიიღოთ ჟურნალები. (შენიშვნა: დარწმუნდით, რომ არ არის სენსიტიური ინფორმაცია ჩართული ჟურნალის ფაილებში)
4. გამოაგზავნეთ საკითხი

მინიშნება: თუ არ გსურთ GitLab ანგარიშის შექმნა, შეგიძლიათ შეუერთდეთ ჩვენს Discord და შეატყობინეთ ხარვეზის შესახებ #bugs-and-support-ში.

შეაგროვეთ ჟურნალები

თუ Veloren-თან დაკავშირებული პრობლემები შეგექმნებათ, შეიძლება მოგთხოვოთ მორები ან კვალი. ეს გაკვეთილი გაჩვენებთ, თუ როგორ უნდა შეაგროვოთ ჟურნალები, თქვენი ოპერაციული სისტემისა და Veloren-ის დაყენების მეთოდის მიხედვით.

ნაგულისხმევად Veloren სერვერი და Voxygen ორივე აწარმოებენ ჟურნალებს. ისინი იბეჭდება ტერმინალში/cmd და ფაილში, სახელად voxygen.log.<todays_date>. ის კი ბეჭდავს, სადაც ფაილი მდებარეობს ტერმინალში/cmd:

Nov 25 01:40:14.388  INFO veloren_voxygen::logging: Setup terminal and file logging. logdir="/mnt/games/cargo-build/debug/userdata/voxygen/logs"

ნაგულისხმევად, დეტალურობა არის INFO, მაგრამ გთხოვთ, მოგვაწოდოთ ჟურნალები TRACE დონეზე (როგორც ნაჩვენებია ქვემოთ). მოძებნეთ შეტყობინება სახელწოდებით Tracing is successfully set to TRACE, რათა დაადასტუროთ, რომ TRACE დონე ჩართულია.

Linux და macOS

საჰაერო ხომალდი

1. დაიწყეთ Airshipper -vv არგუმენტით.
2. როდესაც თამაში დაიწყება, ის ტერმინალში დაბეჭდავს ჟურნალის ფაილის ადგილმდებარეობას. შეამოწმეთ Airshipper გვერდი.

შედგენილი

1. დაიწყეთ ვოქსიგენი TRACE დონიდან ტერმინალში:

    RUST_LOG="trace" ./target/debug/veloren-voxygen
    # or RUST_LOG="trace" cargo run
    ```

2. დააკოპირეთ კვალი ტერმინალიდან ან ზემოთ ნახსენები ჟურნალის ფაილიდან.

## Windows

### საჰაერო ხომალდი

1. CMD-ის გახსნა.
> Windows-ზე დააჭირეთ `Windows key + R`. შემდეგ აკრიფეთ `cmd` და დააჭირეთ `enter`.
2. აკრიფეთ `airshipper run -vv` და დააჭირეთ Enter.
3. გაუშვით თამაში (სანამ პრობლემას არ წააწყდებით).
4. ჟურნალები უნდა განთავსდეს `%Appdata%/airshipper/profiles/default/userdata/voxygen/logs`-ში
ან შეამოწმეთ [Airshipper](airshipper.md) გვერდი.

### შედგენილი

#### Git Bash

-> იხილეთ Linux/Compiled ზემოთ

##### Cmd

1. გახსენით CMD.
2. გადადით თქვენს veloren საქაღალდეში `cd` ბრძანებით, მაგ. `cd C:\Users\<Your Username>\Desktop\veloren`.
3. ჩაწერეთ `set RUST_LOG=trace&& veloren-voxygen.exe` და დააჭირეთ Enter (ზუსტად როგორც აქ, უფსკრულის გარეშე `&&`-მდე)
4. ჟურნალები ახლა დაიბეჭდება CMD-ში და საქაღალდეში `userdata\voxygen\logs` ან `%appdata%\veloren\`.

## ინფორმაციის შეგროვება გრაფიკული შეცდომებისთვის

ზოგჯერ შეიძლება სასარგებლო იყოს დამატებითი ინფორმაციის შეგროვება გრაფიკული პრობლემების გამართვისას. ეს ინფორმაცია ყოველთვის არ არის საჭირო, ამიტომ ის ძირითადად ემსახურება როგორც მინიშნებას, რათა მიუთითოს მომხმარებლები, როდის იქნება ინფორმაცია გამოსადეგი.

### wgpu API კვალი

1. შექმენით საქაღალდე, რომელიც ინახავს კვალს. (მაგ. `wgpu-trace`)

```shell
        mkdir wgpu-trace
    ```

2. გაუშვით თამაში გარემოს ცვლადით `WGPU_TRACE_DIR` დაყენებული ახალ საქაღალდეში.
(გზა შეიძლება იყოს აბსოლუტური ან ფარდობითი)
- Linux

```shell
            WGPU_TRACE_DIR="./wgpu-trace" airshipper start
        ```

- ფანჯრები

```shell
            set "WGPU_TRACE_DIR=./wgpu-trace"
            airshipper start
        ```

3. გაიმეორეთ ხარვეზი/ავარია და შემდეგ გამოდით თამაშიდან (კვალი უფრო დიდი იქნება, თუ ამას გარკვეული დრო დასჭირდება).
4. დაარქივეთ კვალის საქაღალდე მარტივი გაზიარებისთვის.

დამატებითი ინფორმაციისთვის wgpu-ს API-ის მიკვლევის შესახებ იხილეთ <https://github.com/gfx-rs/wgpu/wiki/Debugging-wgpu-Applications#tracing-infrastructure>

## Dx12/Dx11 გამართვის ფენის გამომავალი

პირველ რიგში, შეამოწმეთ, რომ იყენებთ dx12 ან dx11 გრაფიკულ ბაზას.

### DebugView++-ის გამოყენებით

1. აიძულეთ გამართვის ფენა Voxygen-ისთვის (შენიშვნა: თუ თქვენ თავად შეადგინეთ თამაში `--release`-ის გარეშე, მაშინ ეს ნაბიჯი შეიძლება გამოტოვოთ):
1. გაუშვით `dxcpl`.
2. დააწკაპუნეთ „სიის რედაქტირებაზე“.
3. დაამატეთ `veloren-voxygen.exe` და დააწკაპუნეთ OK.
4. დარწმუნდით, რომ "Force On" არჩეულია გამართვის ფენის განყოფილებაში.
5. დააწკაპუნეთ "Apply".
> **გაფრთხილება:** გამართვის ფენების ჩართვა დამატებით ხარჯებს ამატებს, დარწმუნდით, რომ მიჰყევით ბოლო საფეხურს
ხელახლა გამორთეთ ისინი.
2. დააყენეთ DebugView++:
1. ჩამოტვირთეთ უახლესი `DebugView++.exe` ვერსია ამ გვერდიდან: <https://github.com/CobaltFusion/DebugViewPP/releases>.
2. ჩამოტვირთეთ ფილტრის პარამეტრები აქ: <a href="assets/debugview++/View.xml" download="View.xml">View.xml</a>
3. გაუშვით `DebugView++.exe`.
4. გახსენით ფილტრის პარამეტრების ეკრანი `F5`-ით.
5. დააწკაპუნეთ ღილაკზე „ჩატვირთვა“, აირჩიეთ გადმოწერილი ფილტრის პარამეტრების ფაილი, დააჭირეთ „გახსნას“ და შემდეგ
დააჭირეთ "OK" ფილტრის პარამეტრების ეკრანის დასახურად.
3. გაუშვით voxygen (dx backend-ს აქვს პრობლემები) და გაუშვით ავარიის/შეცდომის დადგომამდე.
4. DebugView++-ში დააჭირეთ `Ctrl + S`, რათა შეინახოთ მიმდინარე ხედი, რომელიც შეიცავს ყველა გამართვის შეტყობინებას
ვოქსიგენი.
5. გააზიარეთ შენახული ფაილი.
6. ისევ გაუშვით `dxcpl` და ამოიღეთ ვოქსიგენი სიიდან.

#### ვიზუალური სტუდიის გამოყენებით

1. დააინსტალირეთ ვიზუალური სტუდია <https://visualstudio.microsoft.com/downloads/>.
2. აიძულეთ გამართვის ფენა Voxygen-ისთვის (შენიშვნა: თუ თქვენ თავად შეადგინეთ თამაში `--release`-ის გარეშე, მაშინ ეს ნაბიჯი შეიძლება გამოტოვოთ):
1. ღია ვიზუალური სტუდია.
2. გადადით Debug > Graphics > DirectX მართვის პანელზე.
3. დააწკაპუნეთ ღილაკზე `Edit List...`..
4. დაამატეთ `veloren-voxygen.exe` სიას (აუცილებლად წაშალეთ ეს დასრულების შემდეგ).
5. შეცვალეთ Debug Layer პარამეტრი Force On.
6. დააწკაპუნეთ განაცხადის და გადით მართვის პანელიდან.
3. გახსენით Voxygen შესრულებადი როგორც პროექტი ([ორიგინალი ინსტრუქციები](https://docs.microsoft.com/en-us/visualstudio/debugger/how-to-debug-an-executable-not-part-of-a-visual-studio-solution?view=vs-2019#to-create-a-new-exe-project-for-an-existing-app)):
1. ვიზუალურ სტუდიაში: ფაილი > გახსნა > პროექტი.
2. გადადით veloren-voxygen.exe-ზე, აირჩიეთ ის და დააჭირეთ გახსნას.
4. გაუშვით პროექტი (მწვანე ისარი და ან ვარიანტი გამართვის მენიუში).
5. საკითხის რეპროდუცირება.
6. ვიზუალურ სტუდიას ექნება განყოფილება, სახელწოდებით "გამომავალი" გრაფიკული გამართვის ფენის და სხვა შემთხვევითი მასალების გამომავალი (ამის გაზიარება შესაძლებელია კოპირ-პასტის საშუალებით).