---
title: weapon
summary: Справочная запись интерфейса X4. Типы известны только в явно указанной области.
section: reference
kind: api
status: reference
updated: 2026-10-26
tags: ["API","X4"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/","https://www.lua.org/manual/5.1/manual.html","https://luajit.org/ext_ffi_api.html"]
---
## Возвращаемое значение

| Тип | Значение |
| --- | --- |
| [`none`](wiki:type-results) (MD action) | Тип описывает объявленный интерфейс, а не успешный игровой эффект. |

[Типы и методы](wiki:types)

## Атрибуты XML

[Как устроены типы схем](wiki:schema-types)

`libraries/common.xsd`

| Атрибут | Тип из схемы | Обязателен | По умолчанию / fixed |
| --- | --- | --- | --- |
| `ware` | [`expression`](wiki:schema-expression-b8bc0e4f) | да | не объявлено |
| `macro` | [`expression`](wiki:schema-expression-b8bc0e4f) | нет | не объявлено |
| `context` | [`expression`](wiki:schema-expression-b8bc0e4f) | нет | не объявлено |
| `group` | [`expression`](wiki:schema-expression-b8bc0e4f) | нет | не объявлено |

`libraries/common.xsd`

| Атрибут | Тип из схемы | Обязателен | По умолчанию / fixed |
| --- | --- | --- | --- |
| `macro` | [`namestring`](wiki:schema-namestring-3646b03f) | да | не объявлено |
| `path` | [`namestring`](wiki:schema-namestring-3646b03f) | нет | не объявлено |
| `optional` | [`boolean`](wiki:schema-boolean-bf84d3d6) | нет | не объявлено |
| `ammunition` | [`namestring`](wiki:schema-namestring-3646b03f) | нет | не объявлено |
| `weaponmode` | [`extendedweaponmodelookup`](wiki:schema-extendedweaponmodelookup-6bdd43be) | нет | не объявлено |
| `debug` | [`boolean`](wiki:schema-boolean-bf84d3d6) | нет | не объявлено |

`libraries/gamestarts.xsd`

| Атрибут | Тип из схемы | Обязателен | По умолчанию / fixed |
| --- | --- | --- | --- |
| `ware` | [`xs:string`](wiki:schema-xs-string-d5652e9b) | нет | не объявлено |
| `context` | [`xs:string`](wiki:schema-xs-string-d5652e9b) | нет | не объявлено |
| `group` | [`xs:string`](wiki:schema-xs-string-d5652e9b) | нет | не объявлено |
| `comment` | [`comment`](wiki:schema-comment-c44bb2fd) | нет | не объявлено |

`libraries/parameters.xsd`

| Атрибут | Тип из схемы | Обязателен | По умолчанию / fixed |
| --- | --- | --- | --- |
| `maxaimrangefactor` | `unknown` | нет | не объявлено |
| `fastcharge` | `unknown` | нет | не объявлено |
| `maxshotrangefactor` | `unknown` | нет | не объявлено |
| `maxextrashotrange` | `unknown` | нет | не объявлено |

Действие MD может записать результат в именованную переменную или изменить мир. Это не возвращаемое значение Lua. Выходная переменная зависит от действия и атрибутов.

## Пример и контекст

Смотрите [основы языка](wiki:x4-code-basics), [типы и методы](wiki:types) и [события Lua / MD](wiki:md-lua-bridge). Там приведены самостоятельные учебные примеры. Исходные файлы проектов и фрагменты их внутренней реализации в этом справочнике не распространяются.