Просмотр исходного текста страницы Профиль NPC

__NOTOC__
{| class="wikitable" style="float:right; margin-left:0.8em; clear:right; text-align: center; font-size:12px; width: 300px;"
|-
| colspan=2 style="font-size:20px;"|
'''Профиль NPC'''
|-
| '''Автор'''
| [[Участник:aka_sektor|aka_sektor]]
|-
| '''Дополнил'''
| Charsi
|-
| '''Тип статьи'''
| справка
|-
| '''Актуальность'''
| [[S.T.A.L.K.E.R. - Тень Чернобыля|ТЧ]], [[S.T.A.L.K.E.R. - Чистое Небо|ЧН]], [[S.T.A.L.K.E.R. - Зов Припяти|ЗП]]
|}

'''Профиль NPC (Non-Player Character/Неигровой персонаж)'''<ref>Документация к X-Ray SDK 0.7 от [[GSC Game World]]</ref><ref>[http://www.amk-team.ru/forum/topic/7450-spravochnik-po-funkciyam-i-klassam/?do=findComment&comment=464472 Пост пользователя "Malandrinus" на AMK форуме]</ref> – это полное описание персонажа, включающее имя, группировку, ранг, репутацию, обмундирование, внешний вид, озвучку и диалоги. Используется для типизированной простановки персонажей, что экономит и время и позволяет достичь определенной неповторимости от игры к игре.


Сначала создается первичная секция профиля в [[*.xml]]-файле (в данном случае: ''npc_profile.xml'') подключенном в параметре <code>files</code>, секции <code>[profiles]</code>, файла ''gamedata\config\'''system.ltx'''''

Пример:
<syntaxhighlight lang=xml>
	<character id="first_profile_npc_name">
		<class>npc_class_name</class>
	</character>
</syntaxhighlight>

По '''классу''' указанному в первичной секции (в данном случае: <code>npc_class_name</code> ) читаются вторичные секции из [[*.xml]]-файлов (в данном случае: ''character_desc_*.xml'') подключенных в параметре <code>specific_characters_files</code>, секции <code>[profiles]</code>, файла ''gamedata\config\'''system.ltx'''''

== Подробнее о статусах ==
* '''используются''' — обязательные теги профиля NPC.
* '''необязательны''' — теги профиля NPC, но как можно понять из названия - не являющиеся обязательными. Например, если вас устраивает значение установленное по умолчанию.
* '''не используются''' — теги от предыдущих версий движков игры, были отключены или переименованы в новых версиях. Рекомендуется удалить из профиля NPC.

Вместо символа <code>$</code> – значение.
{| class="wikitable"
|-
! Теги !! Статус !! Платформа !! Описание тегов !! Пример значения !! Варианты значений и их описание
|-
| <source lang=xml><specific_character id="$" team_default = "1"></source>
или
<source lang=xml><specific_character id="$" no_random = "1"></source>
|| используются || ТЧ, ЧН, ЗП
|| Начало вторичной секции профиля ||
<source lang=xml><specific_character id="main_profile_npc_name" team_default = "1"></source>
или
<source lang=xml><specific_character id="main_profile_npc_name" no_random = "1"></source>
||
<code>id="$"</code> – имя секции.

'''Значения алгоритма чтения секции:'''<br>
<code>team_default = "1"</code> – случайно выбирает одну вторичную секцию в классе из других с таким же значением.

<code>no_random = "1"</code> – исключает секцию из алгоритма. Для уникальных профилей, например.

'''Указывать значение, нужно только одно.'''<br>
Если указать оба, произойдет 1 вариант вылета: [[specific_character.cpp]]<br>
А если ни одного, то вылет: [[xrServer_Objects_ALife_Monsters.cpp]]
|-
| <source lang=xml><name>$</name></source> || необязательны || ТЧ, ЧН, ЗП || Имя персонажа ||
<source lang=xml><name>GENERATE_NAME_stalker</name></source>

или

<source lang=xml><name>npc_name</name></source>
|| Случайно сгенерированное (в данном случае: из секции <code>stalker_names_stalker</code> файла ''gamedata\config\'''system.ltx''''')

или

уникальное имя <code>string id</code> из [[*.xml]]-файла подключенного в параметре <code>files</code>, секции <code>[string_table]</code>, файла ''gamedata\config\'''localization.ltx'''''

Если теги не указывать, просто не будет отображаться имя.
|-
| <source lang=xml><icon>$</icon></source> || необязательны || ТЧ, ЧН, ЗП || Иконка персонажа в интерфейсе || <source lang=xml><icon>ui_npc_icon_name</icon></source> || Имя <code>texture id</code> из [[*.xml]]-файла подключенного в параметре <code>files</code>, секции <code>[texture_desc]</code>, файла ''gamedata\config\'''system.ltx'''''

Если теги не указывать, будет установлена указанная в движке по умолчанию иконка <code>ui_npc_u_barman</code>.
|-
| <source lang=xml><class>$</class></source> || используются || ТЧ, ЧН, ЗП || Имя класса || <source lang=xml><class>npc_class_name</class></source> || Должен соответствовать указанному в первичной секции профиля.

Если теги не указывать, произойдет вылет: [[xrServer_Objects_ALife_Monsters.cpp]]
|-
| <source lang=xml><community>$</community></source> || используются || ТЧ, ЧН, ЗП || Группировка. По ней определяются отношения || <source lang=xml><community>stalker</community></source> || Соответствующие указанному в параметре <code>communities</code>, секции <code>[game_relations]</code> файла по пути ''gamedata\config\creatures\'''game_relations.ltx'''''

Если теги не указывать, произойдет 2 вариант вылета: [[specific_character.cpp]]
|-
| <source lang=xml><terrain_sect>$</terrain_sect></source> || необязательны || ТЧ, ЧН, ЗП || Неизвестно || <source lang=xml><terrain_sect>stalker_terrain</terrain_sect></source> || Значения по умолчанию указаны в одноименной секции в файле по пути: ''gamedata\config\creatures\'''m_stalker.ltx'''''
|-
| <source lang=xml><rank>$</rank></source> || используются || ТЧ, ЧН, ЗП || Ранг персонажа || <source lang=xml><rank>149</rank></source> || в цифрах; соответствующие указанному в параметре <code>rating</code>, секции <code>[game_relations]</code> файла по пути ''gamedata\config\creatures\'''game_relations.ltx'''''

Если теги не указывать, произойдет 3 вариант вылета: [[specific_character.cpp]]
|-
| <source lang=xml><reputation>$</reputation></source> || используются || ТЧ || Репутация персонажа || <source lang=xml><reputation>12</reputation></source> || Соответствующие указанному в параметре <code>reputation_names</code>, секции <code>[game_relations]</code> файла по пути ''gamedata\config\creatures\'''game_relations.ltx''''' 
|-
| <source lang=xml><money min="$" max="$" infinitive="$"/></source> || необязательны || ТЧ, ЧН, ЗП || Количество денег || <source lang=xml><money min="200" max="600" infinitive="0"/></source> || Если тег не указывать, будет использовано значение из параметра <code>money</code> по умолчанию указано в файле по пути: ''gamedata\config\creatures\'''m_stalker.ltx''''' 

Если параметр удалить, будет установлено значение <code>0</code>. Однако, в игре это не окажет эффекта, т.к. значение уже записано в '''all.spawn''', его можно только изменить тегом.

<code>min</code> – минимум

<code>max</code> – максимум

Будет выбрано случайным образом от указанного минимума до указанного максимума. Если не указывать, будет установлено значение <code>0</code>.

<code>infinitive="0"</code> – не восполняется.

<code>infinitive="1"</code> – восполняется после каждой сделки, но каждая отдельная сделка будет ограничена количеством денег NPC.
|-
| <source lang=xml><snd_config>$</snd_config></source> || необязательны || ТЧ, ЧН, ЗП || Озвучка  || <source lang=xml><snd_config>characters_voice\human_01\newbie\</snd_config></source> || Путь до озвучки относительно директории ''gamedata\sounds''

Если теги не указывать, NPC просто будет молчать.
|-
| <source lang=xml><crouch_type>$</crouch_type></source> || необязательны || ТЧ, ЧН, ЗП || Неизвестно || <source lang=xml><crouch_type>-1</crouch_type></source> || Значение параметра <code>crouch_type</code> по умолчанию указано в файле по пути: ''gamedata\config\creatures\'''m_stalker.ltx''''' 
|-
| <source lang=xml><panic_threshold>$</panic_threshold></source> || необязательны || ТЧ, ЧН, ЗП || Функция оценки вероятности победы. Если падает ниже указанного порога, то NPC впадает в панику || <source lang=xml><panic_threshold>0.1</panic_threshold></source> || от <code>0</code> до <code>1</code>

<code>0</code> — вообще не паникует

<code>1</code> — всегда паникует

Значение параметра <code>panic_threshold</code> по умолчанию указано в файле по пути: ''gamedata\config\creatures\'''m_stalker.ltx''''' 
|-
| <source lang=xml><visual>$</visual></source> || используются || ТЧ, ЧН, ЗП || Модель персонажа || <source lang=xml><visual><code>actors\novice\green_stalker_2</code></visual></source> || Путь к [[*.ogf]]-файлу относительно директории ''gamedata\meshes''

От прописанной в модели '''User Data''' ([[*.ltx]]-файл по пути: ''gamedata\config\models\capture'') зависит бронированность NPC.

Если теги удалить, это не окажет эффекта, т.к. значение уже записано в '''all.spawn''', его можно только изменить тегом.
|-
| <source lang=xml><supplies>$</supplies></source> || необязательны || ТЧ, ЧН, ЗП || Секция спавна инвентаря ||
<syntaxhighlight lang=ini>
<supplies>
[spawn] \n
device_torch \n
wpn_pm, cond=0.5 \n
ammo_9x18_fmj = 1 \n
wpn_ak74 = 1, silencer \n
ammo_5.45x39_fmj = 3 \n
vodka = 1, prob=0.5 \n
device_torch = 1, prob=1 \n
</supplies>
</syntaxhighlight>

Также можно подключить [[*.xml]]-файлы со спавн-секциями из директории ''gamedata\config''

<syntaxhighlight lang=ini>
<supplies>
[spawn] \n
device_torch \n
wpn_pm, cond=0.5 \n
ammo_9x18_fmj = 1 \n
wpn_ak74 = 1, silencer \n
ammo_5.45x39_fmj = 3 \n
#include "gameplay\character_items.xml" \n
#include "gameplay\character_food.xml" \n
#include "gameplay\character_drugs.xml"
</supplies>
</syntaxhighlight>
|| <code>section = #, prob=$, cond=$ \n</code> 

или

<code>wpn_section = #, addon addon addon\n</code> 

Где:

<code>\n</code> — переход на следующую строку

<code>section</code> — имя секции предмета

<code>#</code> — количество предметов (если не задано, будет равно <code>1</code>)

<code>cond=$</code> — состояние предмета после спавна (только для ТЧ). От <code>0</code> до <code>1</code>.

<code>prob=$</code> — вероятность спавна предмета. От <code>0</code> до <code>1</code>.

<code>wpn_section</code> — имя секции оружия

<code>addon</code> — имя секции аддона (работает только с оружием). Могут быть указаны все доступные (см. параметры <code>scope_status</code>, <code>silencer_status</code> и <code>grenade_launcher_status</code> в конфиге оружия), через запятую

Если теги не указывать, NPC будет пустой.
|-
| <source lang=xml><critical_wound_weights>
$
</critical_wound_weights></source> || необязательны || ТЧ, ЧН, ЗП || Неизвестно || <source lang=xml><critical_wound_weights>55,30,15</critical_wound_weights></source>

или вместо этого подключить [[*.xml]]-файл с тегами из директории ''gamedata\config''
<source lang=ini>
#include "gameplay\character_criticals_*.xml"
</source>
|| Значение параметра <code>critical_wound_weights</code> по умолчанию указано в файле по пути: ''gamedata\config\creatures\'''m_stalker.ltx''''' 
|-
| <source lang=xml><start_dialog>$</start_dialog></source> || необязательны || ТЧ, ЧН, ЗП || Диалог приветствия || <source lang=xml><start_dialog>hello_dialog</start_dialog></source>

Также можно подключить [[*.xml]]-файл с тегами из директории ''gamedata\config''
<source lang=ini>#include "gameplay\character_dialogs.xml"</source>

Если теги удалить, это не окажет эффекта, т.к. значение уже записано в '''all.spawn''', его можно только изменить тегом.
|| Имя <code>dialog id</code> из [[*.xml]]-файла подключенного в параметре <code>files</code>, секции <code>[profiles]</code>, файла ''gamedata\config\'''system.ltx'''''
|-
| <source lang=xml><actor_dialog>$</actor_dialog></source> || необязательны || ТЧ, ЧН, ЗП || Обычный диалог || <source lang=xml><actor_dialog>dm_cool_info_dialog</actor_dialog></source> || Имя <code>dialog id</code> из [[*.xml]]-файла подключенного в параметре <code>files</code>, секции <code>[profiles]</code>, файла ''gamedata\config\'''system.ltx'''''

Также можно подключить [[*.xml]]-файл с тегами из директории ''gamedata\config''
<source lang=ini>#include "gameplay\character_dialogs.xml"</source>

Если теги удалить, это не окажет эффекта, т.к. значение уже записано в '''all.spawn''', его можно только изменить тегом.
|-
| <source lang=xml></specific_character></source> || используются || ТЧ, ЧН, ЗП || Конец вторичной секции профиля || Отсутствует || Отсутствует
|-
!colspan="6" align="center"|Устаревшие теги
|-
| <source lang=xml><map_icon x="$" y="$"></map_icon></source> || не используются || ТЧ || Неизвестно || <source lang=xml><map_icon x="1" y="0"></map_icon></source> || Неизвестно
|-
| <source lang=xml><bio>$</bio></source> || не используются || ТЧ || Биография персонажа || <source lang=xml><bio>npc_bio_name</bio></source> || Имя <code>string id</code> из [[*.xml]]-файла подключенного в параметре <code>files</code>, секции <code>[string_table]</code>, файла ''gamedata\config\'''localization.ltx'''''
|}

=== Как это работает ===
# При спавне персонажа, считывается первичная секция его профиля (в данном случае: <code>first_profile_npc_name</code>)
# По первичной секции профиля, считывается класс его профиля (в данном случае: <code>npc_class_name</code>)
# По классу, считывается список всех вторичных секций для его профиля (например: <code>main_profile_npc_name</code>, <code>main_profile_npc_2_name</code>, <code>main_profile_npc_3_name</code> и т.д.)
# Одна из вторичных секций профиля выбирается случайно

== Уникальный профиль ==
Для некоторых персонажей требуется четкое соответствие вторичной секции профиля. Например, для уникальных квестовых или сюжетных персонажей.

Задается тегами <code><specific_character>$</specific_character></code>.

Пример:
<syntaxhighlight lang=xml>
<character id="first_profile_npc_name">	
<class>npc_class_name</class>
<specific_character>main_profile_npc</specific_character>
</character>			
</syntaxhighlight>

=== Как это работает ===
# При спавне персонажа, считывается первичная секция его профиля (в данном случае: <code>first_profile_npc_name</code>)
# По первичной секции профиля, считывается класс его профиля (в данном случае: <code>npc_class_name</code>)
# По классу, считывается только та секция профиля, которая указана тегами (в данном случае: <code>main_profile_npc</code>)<br>Если указанная секция не будет найдена, произойдет 2 вариант вылета: [[xml_str_id_loader.h]]

== Источники ==
{{reflist|3}}

[[Категория:Игровые архивы]][[Категория:Конфиги]]