Редактирование: X-Ray extensions

<div style="padding: .5em 1em; float: right; background: #f2f2f2; border: 1px solid #aaaaaa;">
<big>'''X-Ray extensions'''</big>
----
{| style="border: none"
| '''Тип'''                     || Расширения движка
|-
| '''Авторы'''                  || malandrinus, kolmogor, K.D., RayTwitty (aka Shadows),
Real Wolf, kstn, _призрак_, SkyLoader
|-
| '''Официальный репозиторий''' || [https://github.com/KD87/xray-extensions GitHub]
|-
| '''Официальная тема'''        || [http://www.amk-team.ru/forum/topic/10538-x-ray-extensions AMK форум]
|}
</div>
Этот проект представляет собой набор добавлений, расширяющих возможности движка для скриптеров, а также, в ряде случаев, меняющих поведение игры. Изменения реализованы в виде бинарных патчей библиотек и исполняемых файлов.

Информация данной статьи актуальна для '''175''' ревизии официального репозитория.
=Изменения=
==ТЧ==
===Класс game_object===
====Основные методы====
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">// CActor
set_actor_visual(string)
float get_sprint_factor()
set_sprint_factor(float)
float get_actor_take_dist()
set_actor_take_dist(float)
float get_actor_max_weight()
set_actor_max_weight(float)
float get_actor_max_walk_weight()
set_actor_max_walk_weight(float)
open_inventory_box(game_object*)
set_camera_direction(vector)
update_camera_direction(game_object*)
enable_car_panel(bool)
attach_vehicle(game_object*)
detach_vehicle(vector)
set_goodwill_ex(int, int, int)
change_goodwill_ex(int, int, int)
float get_camera_fov()
set_camera_fov(float)
restore_camera_fov()
float get_hud_fov()
set_hud_fov(float)
set_hud_animation_channel(int)
set_hud_animation_callback_param(int)
set_use_hud_animation_callback(bool)
clear_personal_record(int, int)
uint actor_body_state()
bool is_actor_normal()
bool is_actor_crouch()
bool is_actor_creep()
bool is_actor_climb()
bool is_actor_walking()
bool is_actor_running()
bool is_actor_sprinting()
bool is_actor_crouching()
bool is_actor_creeping()
bool is_actor_climbing()

// CCar
float get_fuel()
set_fuel(float)
float get_fuel_consumption()
set_fuel_consumption(float)
float get_fuel_tank()

// CEntityAlive
heal_wounds(float)
update_condition()

// CGameObject
string specific_character()
int get_bone_visible(string, int)
int set_bone_visible(string, int)
int get_bone_id(string, int)
string get_bone_name()
bool has_visual()
ini_file* get_visual_ini()
bool nonscript_usable()

// CHangingLamp
set_lsf_speed(float)
set_lsf_amount(float)
set_lsf_smap_jitter(float)
float get_lsf_speed()

// CHolderCustom
game_object* get_holder_owner()

// CHudItem
play_hud_animation(string, bool)
uint get_hud_animation_remaining_time()
int get_hud_animation_length(string, int)
bool is_cyclic_hud_animation()
bool has_hud_animation(string)
uint get_hud_item_state()
int get_hud_bone_id(string, int)
vector get_hud_bone_pos(string)
int get_hud_bone_visible(string, int)
int set_hud_bone_visible(string, int)

// CInventoryBox
game_object* object_from_inv_box(int)
uint inv_box_count()

// CInventoryItem
float get_weight()

// CInventoryOwner
bool is_on_belt(game_object*)
bool is_in_ruck(game_object*)
bool is_in_slot(game_object*)
bool move_to_ruck(game_object*)
bool move_to_belt(game_object*)
bool move_to_slot(game_object*)
bool move_to_slot_and_activate(game_object*)
game_object* item_on_belt(int)
game_object* item_in_ruck(int)
uint belt_count()
uint ruck_count()
uint slot_number()
float get_inventory_weight()
invalidate_inventory()

// CObject
float radius()
string get_visual_name()
set_visual_name(string)

// CProjector
projector_on()
projector_off()
bool projector_is_on()
switch_projector(bool)

// CSpaceRestrictor
float get_shape_radius()

// CTorch
switch_torch(bool)
bool is_torch_enabled()
set_torch_range(float)
set_torch_color(vector)
set_torch_omni_range(float)
set_torch_omni_color(vector)
set_torch_glow_radius(float)
set_torch_spot_angle(float)
set_torch_color_animator(string)
switch_night_vision(bool)

// CWeapon
int get_wpn_bone_visible(string, int)
int set_wpn_bone_visible(string, int)</syntaxhighlight>
=====CActor=====
<code>set_actor_visual(string<path>)</code> - устанавливает путь до визуала.<br/>
<code>float<speed> get_sprint_factor()</code> - возвращает скорость бега.<br/>
<code>set_sprint_factor(float<speed>)</code> - устанавливает скорость бега.<br/>
<code>float<dist> get_actor_take_dist()</code> - возвращает дистанцию поднятия предметов.<br/>
<code>set_actor_take_dist(float<dist>)</code> - устанавливает дистанцию поднятия предметов.<br/>
<code>float<max_weight> get_actor_max_weight()</code> - возвращает максимальный вес рюкзака.<br/>
<code>set_actor_max_weight(float<max_weight>)</code> - устанавливает максимальный вес рюкзака.<br/>
<code>float<max_walk_weight> get_actor_max_walk_weight()</code> - возвращает максимально-переносимый вес рюкзака.<br/>
<code>set_actor_max_walk_weight(float<max_walk_weight>)</code> - устанавливает максимально-переносимый вес рюкзака.<br/>
<code>open_inventory_box(game_object*<box_obj>)</code> - открывает окно обыска инвентарного ящика.<br/>
<code>set_camera_direction(vector<x, y, z>)</code> - устанавливает направление камеры.<br/>
<code>update_camera_direction(game_object*<target_obj>)</code> - направляет камеру в позицию объекта.<br/>
<code>enable_car_panel(bool<is_visible>)</code> - устанавливает видимость панели машины (прогресс-бар состояния).<br/>
<code>attach_vehicle(game_object*<holder_obj>)</code> - садит ГГ в машину или станковое оружие.<br/>
<code>detach_vehicle(vector<exit_pos>)</code> - высаживает ГГ из машины в заданную позицию на уровне.<br/>
<code>set_goodwill_ex(int<who_id>, int<to_whom_id>, int<goodwill>)</code> - устанавливает отношения между персонажами.<br/>
<code>change_goodwill_ex(int<who_id>, int<to_whom_id>, int<goodwill_change>)</code> - изменяет отношения между персонажами на заданное значение.<br/>
<code>float<fov> get_camera_fov()</code> - возвращает текущий fov камеры.<br/>
<code>set_camera_fov(float<fov>)</code> - устанавливает fov камеры.<br/>
<code>restore_camera_fov()</code> - восстанавливает предыдущий fov камеры (заданный методом <code>set_camera_fov</code>).<br/>
<code>float<dist> get_hud_fov()</code> - возвращает расстояние от камеры до худа оружия.<br/>
<code>set_hud_fov(float<dist>)</code> - устанавливает расстояние от камеры до худа оружия.<br/>
<code>set_hud_animation_channel(int<blend_channel>)</code> -- устанавливает номер канала блендинга анимации, который будет передан в колбек на завершение анимации (только при проигрывании анимации через метод <code>play_hud_animation</code>).<br/>
<code>set_hud_animation_callback_param(int<param>)</code> -- устанавливает произвольный параметр, который будет передан в колбек на завершение анимации (только при проигрывании анимации через метод <code>play_hud_animation</code>).<br/>
<code>set_use_hud_animation_callback(bool<use_callback>)</code> -- включает использование колбека на завершение анимации (только при проигрывании анимации через метод <code>play_hud_animation</code>).<br/>
<code>clear_personal_record(int<id_from>, int<id_to>)</code> - очищает отношения между двумя мобами по их id.<br/>
<code>uint<state> actor_body_state()</code> - возвращает номер текущего стейта.<br/>
<code>bool is_actor_normal()</code> - возвратит true, если ГГ просто стоит.<br/>
<code>bool is_actor_crouch()</code> - возвратит true, если ГГ присел.<br/>
<code>bool is_actor_creep()</code> - возвратит true, если ГГ глубоко присел.<br/>
<code>bool is_actor_climb()</code> - возвратит true, если ГГ находится на лестнице.<br/>
<code>bool is_actor_walking()</code> - возвратит true, если ГГ идет медленным шагом.<br/>
<code>bool is_actor_running()</code> - возвратит true, если ГГ идет быстрым шагом.<br/>
<code>bool is_actor_sprinting()</code> - возвратит true, если ГГ бежит.<br/>
<code>bool is_actor_crouching()</code> - возвратит true, если ГГ двигается в присяде.<br/>
<code>bool is_actor_creeping()</code> - возвратит true, если ГГ двигается в глубоком присяде.<br/>
<code>bool is_actor_climbing()</code> - возвратит true, если ГГ двигается на лестнице.<br/>
=====CCar=====
<code>float<fuel> get_fuel()</code> - возвращает текущее количество топлива.<br/>
<code>set_fuel(float<fuel>)</code> - устанавливает текущее количество топлива.<br/>
<code>float<consumption> get_fuel_consumption()</code> - возвращает расход топлива.<br/>
<code>set_fuel_consumption(float<consumption>)</code> - устанавливает расход топлива.<br/>
<code>float<tank_size> get_fuel_tank()</code> - возвращает размер топливного бака.<br/>
=====CEntityAlive=====
<code>heal_wounds(float<factor>)</code> - уменьшает силу кровотечения.<br/>
<code>update_condition()</code> - принудительно обновляет внутренние параметры состояния персонажа (жизнь, выносливость, кровотечение и т.д.).<br/>
=====CGameObject=====
<code>string<profile_name> specific_character()</code> - возвращает название профиля персонажа.<br/>
<code>int<is_visible>[0 or 1] get_bone_visible(string<bone_name>)</code> - возвращает видимость кости по имени.<br/>
<code>set_bone_visible(string<bone_name>, int<visible>[0 or 1])</code> - устанавливает видимость кости по имени.<br/>
<code>int<bone_id> get_bone_id(string<bone_name>)</code> - возвращает id кости по имени.<br/>
<code>string<bone_name> get_bone_name()</code> - возвращает имя кости по id (для установки id кости, необходимо использовать глобальную функцию <code>set_int_arg0(int<bone_id>)</code>).<br/>
<code>bool<visual> has_visual()</code> - возвратит true, если объект имеет визуал.<br/>
<code>ini_file* get_visual_ini()</code> - возвращает ссылку на внутренний конфиг модели.<br/>
<code>bool<is_usable> nonscript_usable()</code> - возвратит true, если над объектом разрешены нескриптовые действия.<br/>
=====CHangingLamp=====
<code>set_lsf_speed(float<speed>)</code> - устанавливает скорость затухания тени (чем больше - тем быстрее).<br/>
<code>set_lsf_amount(float<amount>)</code> - устанавливает максимальное ослабление тени (1.0 - пропадает до нуля, 0.0 - не ослабляется вовсе).<br/>
<code>set_lsf_smap_jitter(float<jitter>)</code> - устанавливает коэффициент размытия теней (чем больше число, тем больше размытие с отдалением от источника).<br/>
<code>float<speed> get_lsf_speed()</code> - возвращает скорость затухания тени.<br/>
Для работы данных методов необходимы дополнительные правки движка и шейдеров. Этот функционал широко используются в моде OGSE/OGSR.<br/>

=====CHolderCustom=====
<code>game_object*<owner_obj> get_holder_owner()</code> - возвращает владельца машины или станкового оружия.<br/>
=====CHudItem=====
<code>play_hud_animation(string<anim_name>, bool<mix_in>)</code> - проигрывает анимацию с заданным именем.<br/>
<code>uint<remaining_time> get_hud_animation_remaining_time()</code> - возвращает время, оставшееся до окончания текущей анимации.<br/>
<code>int<length> get_hud_animation_length(string<anim_name>)</code> - возвращает длительность анимации по её имени.<br/>
<code>bool<is_cyclic> is_cyclic_hud_animation()</code> - возвратит true, если текущая анимация зациклена.<br/>
<code>bool<has_anim> has_hud_animation(string<anim_name>)</code> - возвратит true, если анимация есть в модели.<br/>
<code>uint<state> get_hud_item_state()</code> - возвращает номер текущего стейта.<br/>
<code>int<bone_id> get_hud_bone_id(string<bone_name>)</code> - возвращает id кости по имени.<br/>
<code>vector<pos> get_hud_bone_pos(string<bone_name>)</code> - возвращает позицию кости по имени.<br/>
<code>int<is_visible>[0 or 1] get_hud_bone_visible(string<bone_name>)</code> - возвращает видимость кости по имени.<br/>
<code>set_hud_bone_visible(string<bone_name>, int<visible>[0 or 1])</code> - устанавливает видимость кости по имени.<br/>
=====CInventoryBox=====
<code>game_object*<item_obj> object_from_inv_box(int<object_number>)</code> - возвращает предмет в ящике по номеру.<br/>
<code>uint<items_count> inv_box_count()</code> - возвращает количество предметов в ящике.<br/>
=====CInventoryItem=====
<code>float<weight> get_weight()</code> - возвращает вес предмета.<br/>
=====CInventoryOwner=====
<code>bool<is_on_belt> is_on_belt(game_object*<item_obj>)</code> - возвратит true, если предмет на поясе.<br/>
<code>bool<is_in_ruck> is_in_ruck(game_object*<item_obj>)</code> - возвратит true, если предмет в рюкзаке.<br/>
<code>bool<is_in_slot> is_in_slot(game_object*<item_obj>)</code> - возвратит true, если предмет в слоте.<br/>
<code>move_to_ruck(game_object*<item_obj>)</code> - перемещает предмет в рюкзак.<br/>
<code>move_to_belt(game_object*<item_obj>)</code> - перемещает предмет на пояс.<br/>
<code>move_to_slot(game_object*<item_obj>)</code> - перемещает предмет в слот.<br/>
<code>move_to_slot_and_activate(game_object*<item_obj>)</code> - перемещает предмет в слот и активирует его.<br/>
<code>game_object*<item_obj> item_on_belt(int<object_number>)</code> - возвращает предмет на поясе по номеру.<br/>
<code>game_object*<item_obj> item_in_ruck(int<object_number>)</code> - возвращает предмет в рюкзаке по номеру.<br/>
<code>uint<count> belt_count()</code> - возвращает количество предметов на поясе.<br/>
<code>uint<count> ruck_count()</code> - возвращает количество предметов в рюкзаке.<br/>
<code>uint<number> slot_number()</code> - возвращает количество слотов.<br/>
<code>float<total_weight> get_inventory_weight()</code> - возвращает суммарный вес инвентаря.<br/>
<code>invalidate_inventory()</code> - принудительно обновляет все данные в инвентаре.<br/>
=====CObject=====
<code>float<radius> radius()</code> - возвращает виртуальный радиус объекта.<br/>
<code>string<path> get_visual_name()</code> - возвращает путь до визуала объекта.<br/>
<code>set_visual_name(string<path>)</code> - устанавливает путь до визуала объекта.<br/>
=====CProjector=====
<code>projector_on()</code> - включает прожектор.<br/>
<code>projector_off()</code> - выключает прожектор.<br/>
<code>bool<is_on> projector_is_on()</code> - возвратит true, если прожектор включён.<br/>
<code>switch_projector(bool<switch_on>)</code> - переключает прожектор.<br/>
=====CSpaceRestrictor=====
<code>float<radius> get_shape_radius()</code> - возвращает радиус рестриктора.<br/>
=====CTorch=====
<code>switch_torch(bool<switch_on>)</code> - переключает фонарь.<br/>
<code>bool<is_on> is_torch_enabled()</code> - возвратит true, если фонарь включён.<br/>
<code>set_torch_range(float<range>)</code> - устанавливает дальность основного света фонаря.<br/>
<code>set_torch_color(vector<R, G, B>)</code> - устанавливает цвет основного света от фонаря.<br/>
<code>set_torch_omni_range(float<range>)</code> - устанавливает дальность амбиент-света фонаря.<br/>
<code>set_torch_omni_color(vector<R, G, B>)</code> - устанавливает цвет амбиент-света от фонаря.<br/>
<code>set_torch_glow_radius(float<radius>)</code> - устанавливает радиус глоу-эффекта от фонарика.<br/>
<code>set_torch_spot_angle(float<angle>)</code> - устанавливает радиус светового пятна от фонарика.<br/>
<code>set_torch_color_animator(string<path>)</code> - устанавливает путь до аниматора цвета.<br/>
<code>switch_night_vision(bool<switch_on>)</code> - переключает состояние ПНВ.<br/>
=====CWeapon=====
<code>int<is_visible>[0 or 1] get_wpn_bone_visible(string<bone_name>)</code> - возвращает видимость кости оружия по имени.<br/>
<code>set_wpn_bone_visible(string<bone_name>, int<visible>[0 or 1])</code> - устанавливает видимость кости оружия по имени.<br/>
====Хак для изменения значений в памяти объектов====
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">// CActor
float get_actor_float(int)
set_actor_float(vector, float, int)
int get_actor_int(string, int)
set_actor_int(int, int)
int get_actor_int16(string, int)
string get_actor_shared_str()
int set_actor_shared_str(string, int)
float get_actor_condition_float(int)
set_actor_condition_float(vector, float, int)
int get_actor_condition_int(string, int)

// CCar
float get_car_float(int)
set_car_float(vector, float, int)
int get_car_int(string, int)
set_car_int(int, int)
int get_car_int16(string, int)
set_car_int16(int, int)

// CCustomMonster
float get_custom_monster_float(int)
int get_custom_monster_int(string, int)

// CGameObject
float get_go_float(int)
set_go_float(vector, float, int)
int get_go_int(string, int)
set_go_int(int, int)
int get_go_int16(string, int)
set_go_int16(int, int)
string get_go_shared_str()
int set_go_shared_str(string, int)

// CHolderCustom
int get_holder_int(string, int)

// CHudItem
float get_hud_float(int)
set_hud_float(vector, float, int)
string get_hud_shared_str()
int set_hud_shared_str(string, int)
int save_hud_bone_float(string, int)

// CInventoryItem
float get_inventory_item_float(int)
set_inventory_item_float(vector, float, int)
int get_inventory_item_int(string, int)
set_inventory_item_int(int, int)
int get_inventory_item_int8(string, int)
set_inventory_item_int8(int, int)
int get_inventory_item_int16(string, int)
set_inventory_item_int16(int, int)
string get_inventory_item_shared_str()
int set_inventory_item_shared_str(string, int)

// CWeapon
float get_wpn_float(int)
set_wpn_float(vector, float, int)
int get_wpn_int(string, int)
set_wpn_int(int, int)
int get_wpn_int8(string, int)
set_wpn_int8(int, int)
int get_wpn_int16(string, int)
set_wpn_int16(int, int)
string get_wpn_shared_str()
int set_wpn_shared_str(string, int)

// CWeaponMagazinedWGrenade
int get_wpn_gl_int(string, int)

// Memory access functions
float get_memory_float(int)
set_memory_float(vector, float, int)
int get_memory_int(string, int)
set_memory_int(int, int)
int get_memory_int8(string, int)
set_memory_int8(int, int)
int get_memory_int16(string, int)
set_memory_int16(int, int)</syntaxhighlight>
Методы предназначены для изменения тех значений в памяти игровых объектов, которые недоступны через стандартные средства.<br/>
Применение всех функций практически одинаково, так что рассматриваю только пример на классе '''CGameObject'''.<br/>

'''Смещение''' - это смещение адреса нашей переменной от начала класса. Узнать смещения можно несколькими способами:<br/>
1) посмотреть в дебаговой версии движка, через какой-нибудь дизассембелер;<br/>
2) прогнать в цикле все значения и вывести их значения в лог, после чего шаманить, сравнивая и догадываясь, какое значение за что отвечает :)

'''Функция для получения значений из класса CActor'''<br/>
'''type''' - тип значения (''integer'' или ''float'')<br/>
'''cycle_length''' - диапазон поиска значений (обычно хватает от 500 до 2000)<br/>
<syntaxhighlight lang="lua">function get_actor_values(type, cycle_length)
	if cycle_length then
		if type == "float" then
			get_console():execute("clear_log")
			for i = 1, cycle_length do
				local value = db.actor:get_actor_float(i)
				if value then log1("Float value = "..value.."; Position = "..i) end
			end
			flush_log()
		elseif type == "integer" then
			get_console():execute("clear_log")
			for i = 1, cycle_length do
				local value = db.actor:get_actor_int(nil, i)
				if value then log1("Integer value = "..value.."; Position = "..i) end
			end
			flush_log()
		end
	end
end</syntaxhighlight>
Результат записывается в лог игры.

<code>float<value> get_go_float(int<offset>)</code> - возвращает значение с плавающей точкой по заданному смещению.<br/>
<code>set_go_float(nil, float<value>, int<offset>)</code> - устанавливает значение с плавающей точкой по заданному смещению (первый аргумент - заглушка).<br/>
<code>int<value> get_go_int(nil, int<offset>)</code> - возвращает целочисленное значение по заданному смещению (первый аргумент - заглушка).<br/>
<code>set_go_int(int<offset>, int<value>)</code> - устанавливает целочисленное значение по заданному смещению.<br/>
<code>string<value> get_go_shared_str()</code> - возвращает строковое значение по заданному смещению (смещение задается через глобальную функцию <code>set_int_arg0(int<offset>)</code>).<br/>
<code>set_go_shared_str(string<value>, int<offset>)</code> - устанавливает строковое значение по заданному смещению.<br/>

Также, пару слов о методах для ГГ - их существует два типа, для класса '''CActor''' и класса '''CActorCondition'''. В последнем лежит много параметров вроде сытости, алкоголизма, силы прыжка и т.п.

====Методы для получения адреса базового объекта====
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">uint cast_car()
uint cast_game_object()
uint cast_hud_item()
uint cast_inventory_box()
uint cast_inventory_item()
uint cast_weapon()</syntaxhighlight>
Методы позволяют получить адрес в памяти, откуда начинается базовый объект (адрес в большинстве случаев не совпадает с началом объекта в целом). Результат можно использовать в разных хаках, когда известно смещение относительно конкретного класса.
====Методы для проверки типа объекта====
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">bool is_actor()
bool is_ammo()
bool is_anomaly()
bool is_antirad()
bool is_artefact()
bool is_binoculars()
bool is_bottle_item()
bool is_car()
bool is_custom_monster()
bool is_eatable_item()
bool is_entity_alive()
bool is_explosive()
bool is_food_item()
bool is_game_object()
bool is_grenade()
bool is_grenade_launcher()
bool is_hanging_lamp()
bool is_helicopter()
bool is_holder()
bool is_hud_item()
bool is_inventory_box()
bool is_inventory_item()
bool is_inventory_owner()
bool is_knife()
bool is_medkit()
bool is_missile()
bool is_monster()
bool is_outfit()
bool is_physics_shell_holder()
bool is_projector()
bool is_scope()
bool is_script_zone()
bool is_silencer()
bool is_space_restrictor()
bool is_stalker()
bool is_torch()
bool is_trader()
bool is_weapon()
bool is_weapon_gl()
bool is_weapon_magazined()
bool is_weapon_pistol()
bool is_weapon_shotgun()</syntaxhighlight>
Методы предназначены для проверки типа объекта (к какому классу принадлежит). Применение достаточно простое:
<syntaxhighlight lang="lua">if obj:is_<class_name>() then
...
end</syntaxhighlight>
====Методы не имеющие привязки к определенному объекту====
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">game_object* get_object_arg_1(int)
set_object_arg_1(game_object*)
set_calibrating_vector(vector)
set_vector_global_arg_1(vector)
set_vector_global_arg_2(vector)
set_vector_global_arg_3(vector)
set_vector_global_arg_4(vector)</syntaxhighlight>
Эти методы предназначены для передачи или получения значений в(из) другие(их) методы(ов), в которых, по причине отсутствия необходимого прототипа, штатно это сделать нельзя.
Могут вызываться для любого типа объекта в игре.
===Класс matrix===
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">mul_43(matrix, matrix)
transform_tiny(vector, vector, vector, vector)
transform_tiny1(vector, vector, vector, vector)
transpose(float)</syntaxhighlight>
<code>mul_43(matrix<m1>, matrix<m2>)</code> - умножает две матрицы без последнего столбца и записывает результат в матрицу для которой вызывался метод.<br/>
<code>transform_tiny(vector<res>, vector<v>)</code> - умножает матрицу на вектор (перевод из одной системы координат в другую), с записыванием результата в вектор res.<br/>
<code>transform_tiny1(vector<v>)</code> - умножает матрицу на вектор (перевод из одной системы координат в другую), с записыванием результата в сам вектор.<br/>
<code>transpose()</code> - транспонирует матрицу (зеркалирование относительно главной диагонали).<br/>
===Класс CTime===
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">set_value(int, int, int)
int, int, int, int, int, int, int get_value()</syntaxhighlight>
<code>set_value(int<lv>, int<gv>)</code> - устанавливает значение объекта из компонент.<br/>
<code>int<lv>, int<gv> get_value()</code> - возвращает младшую и старшую часть счетчика.<br/>
===Класс CALifeSimulator===
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">CSE_Abstract* teleport_object(string, vector, uint, uint, uint)
CSE_Abstract* assign_story_id(string, vector, uint, uint, uint)</syntaxhighlight>
<code>teleport_object(nil, vector<position>, uint<level_vertex_id>, uint<game_vertex_id>, uint<id>)</code> - телепортирует объект по его id в заданную позицию на уровне.<br/>
<code>assign_story_id(nil, nil, uint<id>, uint<story_id>)</code> - устанавливает story_id объекту по его id.<br/>
===Класс CSE_Abstract===
'''Свойства'''<br/>
<code>angle<vector></code> - задает направление поворота объекта.
===Класс CSE_ALifeObject===
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">use_ai_locations(bool)</syntaxhighlight>
<code>use_ai_locations(bool<use>)</code> - задает использование AI-локаций (сетки) для объекта.
===Пространство имен level===
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">game_object* get_target_obj(int)
float get_target_dist()
int get_target_element(int)

int has_cam_effector(int)
int has_pp_effector(int)
bool has_indicators()

int advance_game_time(int)
game_object* get_second_talker(int)
int vertex_id(int)

float get_memory_float(string, int, bool, string)
int get_memory_int(int)

bool perform_ray_pick_query()
float get_ray_pick_dist()
game_object* get_ray_pick_obj(int)
int get_ray_pick_element(int)

CUIDialogWnd* get_inventory_wnd()
CUIDialogWnd* get_pda_wnd()
CUIDialogWnd* get_talk_wnd()
CUIDialogWnd* get_car_body_wnd()
CUIDialogWnd* get_trade_wnd()

int send_event_mouse_wheel(int)
int send_event_key_hold(int)
int send_event_key_release(int)
int send_event_key_press(int)

set_ce_time(float)
set_ce_amplitude(float)
set_ce_period_number(float)
set_ce_power(float)
bool add_ce()

vector get_tri_vertex1(int)
vector get_tri_vertex2(int)
vector get_tri_vertex3(int)

float get_tri_shootfactor(string, int, bool, string)
int get_tri_flags(int)</syntaxhighlight>
<code>game_object*<obj> get_target_obj()</code> - возвращает игровой объект (если он имеет шейпы), на который в данный момент направлена камера.<br/>
<code>float<dist> get_target_dist()</code> - возвращает дистанцию до точки, на которую в данный момент направлена камера.<br/>
<code>int<element> get_target_element()</code> - если камера направлена на игровой объект (который имеет шейпы), то возвращает номер кости, иначе возвращает номер полигона статической геометрии.<br/>

<code>int<is_cam_eff>[0 or +] has_cam_effector(int<effect_id>)</code> - вернет true, если заданный эффектор камеры в данный момент активен (0 - эффектор не активен, иначе - активен).<br/>
<code>int<is_pp_eff>[0 or +] has_pp_effector(int<effect_id>)</code> - вернет true, если заданный эффектор постпроцесса в данный момент активен (0 - эффектор не активен, иначе - активен).<br/>
<code>bool has_indicators()</code> - вернет true, если интерфейс худа сейчас показан.<br/>

<code>advance_game_time(int<time_ms>)</code> - прокручивает игровое время вперед на заданное количество миллисекунд.<br/>
<code>game_object*<obj> get_second_talker()</code> - возвращает игровой объект, с которым в данный момент открыто окно разговора.<br/>
<code>int<lvid> vertex_id()</code> - возвращает level_vertex_id по позиции на уровне (для установки позиции, необходимо использовать функцию игрового объекта <code>obj:set_vector_global_arg_1(vector<pos>)</code>).<br/>

<code>float<value> get_memory_float(nil, int<addr>)</code> - возвращает число с плавающей точкой по абсолютному адресу.<br/>
<code>int<value> get_memory_int(int<addr>)</code> - возвращает целое число по абсолютному адресу.<br/>
===Глобальное пространство имен===
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">log1(string)
fail(string)
int flush_log(int, int)
int bind_to_dik(int, int)

int get_extensions_flags(int, int)
int set_extensions_flags(int, int)
int get_actor_flags(int, int)
int set_actor_flags(int, int)
int get_input_language(int, int)
int set_input_language(int, int)

int set_trade_filtration_on(int, int)
int set_trade_filtration_off(int, int)
int set_manual_grouping_on(int, int)
int set_manual_grouping_off(int, int)
int set_manual_highlight_on(int, int)
int set_manual_highlight_off(int, int)
int get_manual_highlight(int, int)
int set_highlight_color(int, int)

int sum_args(int, int)
int sub_args(int, int)

int GetGoodwill(int, int)
int update_inventory_window(int, int)
init_external_libs(string)

set_game_time(float, float)
int print_level_time(int, int)
int print_alife_time(int, int)
int set_ignore_game_state_update(int, int)

screenshot0(string)
screenshot1(string)
screenshot2(string)
screenshot3(string)

set_hud_inertia(float, float)
set_hud_inertia_param2(float, float)

float get_static_rescale_factor()
set_static_rescale_factor(float, float)

int set_int_arg0(int, int)
int set_int_arg1(int, int)
int set_int_arg2(int, int)
int set_int_arg3(int, int)
int set_int_arg4(int, int)
int set_int_arg5(int, int)
int set_int_arg6(int, int)
set_float_args_12(float, float)
set_float_args_34(float, float)</syntaxhighlight>
<code>log1(string<message>)</code> - выводит строку-сообщение в лог.<br/>
<code>fail(string<message>)</code> - принудительно останавливает игру и выводит сообщение в лог.<br/>
<code>flush_log()</code> - записывает содержимое лога в лог-файл (аналогично вызову консольной команды flush).<br/>
<code>int<DIK_keys> bind_to_dik(int<key_bindings>)</code> - переводит код команды-экшена в код клавиши, забинденной на этот экшен.<br/>

<code>int<ex_flags> get_extensions_flags()</code> - возвращает состояние флагов работы колбеков (1 - key_press, 2 - key_release, 4 - key_hold, 8 - mouse_wheel, 16 - mouse_move).<br/>
<code>set_extensions_flags(int<ex_flags>)</code> - устанавливает состояние флагов работы колбеков (1 - key_press, 2 - key_release, 4 - key_hold, 8 - mouse_wheel, 16 - mouse_move).<br/>
<code>int<flags> get_actor_flags()</code> - возвращает состояние флагов из перечисления psActorFlags.<br/>
<code>set_actor_flags(int<flags>)</code> - устанавливает состояние флагов из перечисления psActorFlags.<br/>
<code>int<lang>[0 or 1] get_input_language()</code> - возвращает номер языка для ввода в полях редактирования (0 - eng, 1 - rus).<br/>
<code>set_input_language(int<lang>[0 or 1])</code> - устанавливает номер языка для ввода в полях редактирования (0 - eng, 1 - rus).<br/>

<code>set_trade_filtration_on()</code> - включает режим скриптовой фильтрации предметов в окне торговли.<br/>
<code>set_trade_filtration_off()</code> - выключает режим скриптовой фильтрации предметов в окне торговли.<br/>
<code>set_manual_grouping_on()</code> - включает режим скриптовой группировки предметов в окне торговли и обыска.<br/>
<code>set_manual_grouping_off()</code> - выключает режим скриптовой группировки предметов в окне торговли и обыска.<br/>
<code>set_manual_highlight_on()</code> - включает режим скриптовой подсветки предметов в окне торговли и обыска.<br/>
<code>set_manual_highlight_off()</code> - выключает режим скриптовой подсветки предметов в окне торговли и обыска.<br/>
<code>int<is_highlight>[0 or 1] get_manual_highlight()</code> - возвращает включенность режима скриптовой подсветки предметов.<br/>
<code>set_highlight_color(int<color_id>, int<GetARGB(A, R, G, B)>)</code> - устанавливает соответствие между индексом цвета и кодом цвета.<br/>

<code>int<result> sum_args(int<val1>, int<val2>)</code> - производит сложение двух чисел и возвращает целочисленный результат (при ариф. операциях, Lua возвращает число с плавающей точкой).<br/>
<code>int<result> sub_args(int<val1>, int<val2>)</code> - производит вычитание двух чисел и возвращает целочисленный результат (при ариф. операциях, Lua возвращает число с плавающей точкой).<br/>

<code>int<goodwill> GetGoodwill(int<who_id>, int<to_whom_id>)</code> - возвращает текущее отношение между персонажами.<br/>
<code>update_inventory_window()</code> - обновляет все графические элементы окна инвентаря.<br/>
<code>init_external_libs()</code> - вызывает подключение дополнительных библиотек, прописанных в движке, внутри этой функции (используется в моде OGSE/OGSR).<br/>

<code>print_level_time()</code> - выводит отладочную информацию в лог о времени уровня.<br/>
<code>print_alife_time()</code> - выводит отладочную информацию в лог о времени алайфа.<br/>
<code>set_ignore_game_state_update()</code> - устанавливает запрет на выполнение одного цикла обновления внутренних параметров времени (используется в моде OGSE/OGSR).<br/>

<code>screenshot0(string<path>)</code> - создает скриншот в обычном режиме и сохраняет файл по указанному пути.<br/>
<code>screenshot1(string<path>)</code> - создает скриншот в режиме cubemap и сохраняет файл по указанному пути.<br/>
<code>screenshot2(string<path>)</code> - создает скриншот в режиме save и сохраняет файл по указанному пути.<br/>
<code>screenshot3(string<path>)</code> - создает скриншот в режиме levelmap и сохраняет файл по указанному пути.<br/>

<code>set_hud_inertia(float<speed>)</code> - устанавливает скорость инерции худа.<br/>
<code>set_hud_inertia_param2(float<shift>)</code> - устанавливает силу инерции худа.<br/>

<code>float<rescale> get_static_rescale_factor()</code> - возвращает коэффициент сжатия элементов окна на выбранном разрешении.<br/>
<code>set_static_rescale_factor(float<rescale>)</code> - устанавливает коэффициент сжатия элементов окна на выбранном разрешении.<br/>

Остальные методы предназначены для передачи или получения значений в(из) другие(их) методы(ов), в которых, по причине отсутствия необходимого прототипа, штатно это сделать нельзя.
===Оконные классы===
====Класс CUIWindow====
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">DetachFromParent()
BringToTop()
Update()
float GetVPos()
float GetHPos()
float GetCursorX()
float GetCursorY()
float GetAbsolutePosX()
float GetAbsolutePosY()</syntaxhighlight>
<code>DetachFromParent()</code> - отсоединяет окно от родительского с последующем удалением.<br/>
<code>BringToTop()</code> - перемещает окно на вершину в иерархии дочерних окон.<br/>
<code>Update()</code> - дополнительно вызывает виртуальный метод обновления окна.<br/>
<code>float<x> GetVPos()</code> - возвращает положение окна по оси X.<br/>
<code>float<y> GetHPos()</code> - возвращает положение окна по оси Y.<br/>
<code>float<x> GetCursorX()</code> - возвращает положение мыши в окне по оси X.<br/>
<code>float<y> GetCursorY()</code> - возвращает положение мыши в окне по оси Y.<br/>
<code>float<x> GetAbsolutePosX()</code> - возвращает абсолютное положение окна по оси X.<br/>
<code>float<y> GetAbsolutePosY()</code> - возвращает абсолютное положение окна по оси Y.<br/>
====Класс CUIStatic====
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">SetTextComplexMode(bool)
AdjustWidthToText()
AdjustHeightToText()
SetVTextAlign(uint)
SetTextPos(float, float)
CanRotate(bool)</syntaxhighlight>
<code>SetTextComplexMode(bool<mode>)</code> - включает режим комплексной работы с текстом.<br/>
<code>AdjustWidthToText()</code> - растягивает ширину окна под размер текста.<br/>
<code>AdjustHeightToText()</code> - растягивает высоту окна под размер текста.<br/>
<code>SetVTextAlign(uint<align>[0-2])</code> - задает выравнивание текста по вертикали.<br/>
<code>SetTextPos(float<x>, float<y>)</code> - задает положение текста внутри окна.<br/>
<code>CanRotate(bool)</code> - устанавливает возможность вращения текстуры окна.<br/>
====Класс CUIListWnd====
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">SetSelectedItem(int)</syntaxhighlight>
<code>SetSelectedItem(int<idx>)</code> - устанавливает выбранный элемент списка по его индексу.
====Класс CUIComboBox====
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">AddItem(string)
string GetText()</syntaxhighlight>
<code>AddItem(string<text>)</code> - добавляет новый элемент с заданным текстом.<br/>
<code>string<text> GetText()</code> - возвращает текущую надпись в окне выпадающего списка.<br/>
====Класс CUITrackBar====
'''Регистрация функций в движке'''
<syntaxhighlight lang="lua">float GetFValue()
bool IsChanged()</syntaxhighlight>
<code>float<value> GetFValue()</code> - возвращает текущее значение ползунка.<br/>
<code>bool<changed> IsChanged()</code> - возвратит true, если значение было изменено с момента последнего сохранения окна опций.<br/>
===Рекомендации===
При использовании правок движка из этого проекта, рекомендуется расширить некоторые таблицы новыми значениями, например таблицы с идентификаторами колбеков, идентификаторами клавиш и т.п.<br/>
Код следует поместить в главный модуль '''_g.script'''.

'''callback'''
<syntaxhighlight lang="lua">callback["on_key_press"] = 123
callback["on_key_release"] = 124
callback["on_key_hold"] = 125
callback["on_mouse_wheel"] = 126
callback["on_mouse_move"] = 127
callback["anomaly_hit"] = 128
callback["drop_item_from_inventory"] = 129
callback["on_item_belt"] = 130
callback["on_item_ruck"] = 131
callback["on_item_slot"] = 132
callback["select_inventory_item"] = 133
callback["switch_torch"] = 134
callback["set_dest_lvid"] = 135
callback["create_cell_item"] = 136
callback["attach_vehicle"] = 137
callback["use_vehicle"] = 138
callback["detach_vehicle"] = 139
callback["after_save"] = 140
callback["cell_item_focus_start"] = 141
callback["cell_item_focus_end"] = 142
callback["group_cell_item"] = 143
callback["hit_effector"] = 144
callback["set_goodwill"] = 145
callback["before_update"] = 150
callback["drop_item_in_box"] = 151
callback["before_hit"] = 152
callback["npc_hit"] = 153
callback["update_addons_visibility"] = 154
callback["update_hud_addons_visibility"] = 155
callback["before_use"] = 156
callback["animation_end"] = 157
callback["select_pda_contact"] = 180</syntaxhighlight>
'''DIK_keys'''
<syntaxhighlight lang="lua">DIK_keys["MOUSE_4"] = 340
DIK_keys["MOUSE_5"] = 341
DIK_keys["MOUSE_6"] = 342
DIK_keys["MOUSE_7"] = 343
DIK_keys["MOUSE_8"] = 344</syntaxhighlight>
'''key_bindings'''
<syntaxhighlight lang="lua">key_bindings["kSPRINT_TOGGLE"] = 8
key_bindings["kENGINE"] = 15
key_bindings["kARTEFACT"] = 30
key_bindings["kWPN_FIREMODE_PREV"] = 38
key_bindings["kWPN_FIREMODE_NEXT"] = 39
key_bindings["kPAUSE"] = 40
key_bindings["kCHAT_TEAM"] = 45
key_bindings["kACTIVE_JOBS"] = 53
key_bindings["kMAP"] = 54
key_bindings["kCONTACTS"] = 55
key_bindings["kVOTE_BEGIN"] = 57
key_bindings["kVOTE"] = 58
key_bindings["kVOTEYES"] = 59
key_bindings["kVOTENO"] = 60
key_bindings["kSPEECH_MENU_0"] = 63
key_bindings["kSPEECH_MENU_1"] = 64
key_bindings["kUSE_BANDAGE"] = 73
key_bindings["kUSE_MEDKIT"] = 74
key_bindings["kQUICK_SAVE"] = 75
key_bindings["kQUICK_LOAD"] = 76</syntaxhighlight>
Также рекомендуется использовать следующие скриптовые обвязки:<br/>
'''level'''
<syntaxhighlight lang="lua">function level.change_game_time(m, h, d)
	level.advance_game_time((m or 0) * 60000 + (h or 0) * 3600000 + (d or 0) * 86400000)
end</syntaxhighlight>
'''relation_registry'''
<syntaxhighlight lang="lua">function relation_registry.get_goodwill(who_id, to_whom_id)
	return GetGoodwill(who_id, to_whom_id)
end

function relation_registry.set_goodwill(who_id, to_whom_id, goodwill)
	return db.actor:set_goodwill_ex(who_id, to_whom_id, goodwill)
end

function relation_registry.change_goodwill(who_id, to_whom_id, goodwill_change)
	return db.actor:change_goodwill_ex(who_id, to_whom_id, goodwill_change)
end</syntaxhighlight>
----
Автор: '''RayTwitty (aka Shadows)'''
[[Категория:Редактирование движка]]