---
title: set_entity_role
summary: Referenz zur X4-Schnittstelle. Typen sind nur innerhalb des angegebenen Geltungsbereichs geklärt.
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"]
---
## Beschreibung

Referenz zur X4-Schnittstelle. Typen sind nur innerhalb des angegebenen Geltungsbereichs geklärt.

## Rückgabewert

| Typ | Bedeutung |
| --- | --- |
| [`none`](wiki:type-results) (MD-Aktion) | Typen beschreiben die deklarierte Schnittstelle, nicht den Nachweis eines erfolgreichen Spieleffekts. |

[Typen und Methoden](wiki:types)

## XML-Attribute

[Wie wirken schema Typen?](wiki:schema-types)

`libraries/common.xsd`

| Attribut | Schematyp | Erforderlich | Standard / festgelegt |
| --- | --- | --- | --- |
| `chance` | [`expression`](wiki:schema-expression-b8bc0e4f) | Nein | nicht deklariert |
| `weight` | [`expression`](wiki:schema-expression-b8bc0e4f) | Nein | nicht deklariert |
| `comment` | [`comment`](wiki:schema-comment-c44bb2fd) | Nein | nicht deklariert |
| `entity` | [`entity`](wiki:schema-entity-bca3685f) | Ja. | nicht deklariert |
| `role` | [`entityrole`](wiki:schema-entityrole-e1b70787) | Ja. | nicht deklariert |

Eine MD-Aktion kann eine benannte Variable schreiben oder die Spielwelt ändern. Das ist kein Lua-Rückgabewert. Die Ausgabevariable hängt von der Aktion und ihren Attributen ab.

## Beispiel und Kontext

Siehe [Sprachkenntnisse](wiki:x4-code-basics), [Arten und Methoden](wiki:types) und [Lua / MD-Veranstaltungen](wiki:md-lua-bridge). Beispiele gibt es unabhängige Lernbeispiele. Mit dieser Referenz werden keine Projekt-Quelldateien oder private Implementierungsfragmente verteilt.