Отладка

From Vintage Story Wiki
This page is a translated version of the page Debugging and the translation is 100% complete.
Other languages:

This page was last verified for Vintage Story version 1.15.


Немного информации о том, как отслеживать проблемы. Как для игроков, так и для моддеров.

Отладка проблем с производительностью

Если вы хотите сообщить о проблеме с производительностью оригинальной игры, предоставьте следующую информацию.

  • Тип задержки: в целом низкая частота кадров, короткие или длинные скачки задержки?
  • Это отставание клиента или сервера:
    • Признаки задержки клиента: частота кадров будет низкой или экран будет зависать на короткое или длительное время.
    • Симптомы задержки сервера: значок отключения в правом верхнем углу, блоки снова появляются, животные не двигаются, сломанные блоки занимают некоторое время, прежде чем их выпадение появляется

Если его клиент отстает

  • Как выглядит график частоты кадров и кадров в секунду? (нажмите CTRL+F3, чтобы увидеть)
  • Какие у вас настройки графики, какая у вас видеокарта и объем оперативной памяти?
  • Каково текущее использование памяти? Как долго ты играл? Это одиночная игра или мультиплеер?
  • Сделайте скриншот вывода профилировщика кадров (нажмите CTRL+F10 для переключения). Перед созданием скриншота также введите команду .edi, чтобы получить дополнительные выходные данные профилировщика кадров.
  • Только при отдельных скачках задержки запустите команду .debug logticks 20, если у вас обычно выше 60 кадров в секунду, или .debug logticks 40, если у вас обычно выше 30 кадров в секунду. Дайте ему поработать некоторое время, а затем отправьте нам файл client-main.txt, который находится в %appdata%/VintagestoryData/Logs. Запустите ту же команду еще раз, чтобы отключить ведение журнала. Убедитесь, что и здесь включена расширенная отладочная информация (через .edi).

Если его сервер лагает, и вы являетесь владельцем или в одиночной игре

  • Запустите команду /debug logticks 100, подождите некоторое время, а затем отправьте нам server-main.txt, он находится в %appdata%/VintagestoryData/Logs. Запустите ту же команду еще раз, чтобы отключить ведение журнала


Повышение производительности сервера

  • Убедитесь, что сохраненная игра находится на SSD
  • Убедитесь, что 2+ ГБ оперативной памяти остаются свободными
  • в serverconfig.json MaxChunkRadius = уменьшите до 10 или ниже, чтобы уменьшить максимальное расстояние просмотра, TickTime = установите 40 или 50. Это дает немного запаса процессора (снижает TPS сервера с 30 TPS до 25 или 20)
  • в servermagicnum.json DefaultEntityTrackingRange = установлено значение 3 (уменьшить диапазон, на котором существа на расстоянии все еще активны, со 128 блоков до 96 блоков)


Modding
Green Items require C# coding
Basics

Getting Started | Mod Types | Simple Examples | Theme Pack

Asset System | Textures | Items | Recipes | Blocks | Entities | Model Creator | Animation Basics | VTML & Icons | Mod Packaging & Release | Modinfo | Debugging

Advanced

JSON Patching | Advanced JSON Items | The Remapper | Server-Client Considerations | Compatibility with other mods

Setting Up Your Development Environment (General - Windows - Linux)

Advanced Blocks | Advanced Items | Item-Block Interactions | Block Behavior | Block Entities | Particle Effects | World Access | Inventory Handling | Chat Commands | GUIs | Server-Client Networking | Monkey patching (Harmony)

Data Management

Savegame Data Storage | ModConfig File | Chunk Data Storage | Tree Attribute

Worldgen

WorldGen Concepts | Terrain | Ores | Trees | WorldGen API

Rendering

Shaders and Renderers

Property Overview

Item | Entity | Block | Block Behaviors | Block Classes | Block Entities | Block Entity Behaviors

Workflows & Infrastructure

Modding Efficiency Tips | Mod-engine compatibility | Mod Extensibility | Load Order

Additional Resources

List of server commands | List of client commands | Client startup parameters | Creative Starter Guide | ServerBlockTicking | Bot System | WorldEdit | Cinematic Camera

Example Mods | API Docs | GitHub Repository