# SU.Buildings.SetProductionPercentage

## SU.Buildings.SetProductionPercentage(buildingID, swords, bows, armors, racespecialweapons)

Gibt dem durch die ID angegebenen Gebäude den Auftrag, eine spezielle Anzahl an Waren herzustellen.

#### Notiz

* die KI stellt die Produktion der Waffenschmiede alle paar Sekunden um, somit ist diese Funktion **bei aktivierten KIs** momentan ziemlich **sinnlos**!
* die Summe der Waffen muss 100% ergeben
* die KI setzt ihre Waffenproduktion kontinuierlich selbst und überschreibt damit die hiermit gesetzten Werte immer wieder... Eine Funktion um dieses Verhalten deaktivieren zu können ist in Planung.
* **bei jedem Aufruf dieser Funktion werden interne Werte zurückgesetzt.** Dadurch wird als erstes Produkt immer die erste Waffe hergestellt, die nicht 0% zugewiesen hat. D.h., **wird diese Funktion kontinuierlich** (z.B. alle 5 Ticks) mit z.B. 1% Schwerter **aufgerufen**, werden **deutlich mehr als 1% Schwerter hergestellt**, da bei jedem Aufruf wieder 1 Schwert hergestellt wird! Eine Änderung der internen von S4 verwendeten Statistik ist in Planung...

#### Parameter

* `buildingID`: ID des Gebäudes
* `swords`: Prozent der zu produzierenden Schwerter
* `bows`: Prozent der zu produzierenden Bögen
* `armors`: Prozent der zu produzierenden Rüstungen
* `racespecialweapons`: Prozent der zu produzierenden Spezialwaffen (wird beim Römer und Dunklen Volk automatisch zu "swords" addiert)

#### Rückgabewert

* 1: erfolgreicher Aufruf (dies bedeutet nur, dass die Parameter valide waren und nicht zwingend, dass der Auftrag ausgeführt wird, z.B. wenn das Gebäude diese Ware nicht produzieren kann!)
* 0: sonst / Fehler / Summe der Waffen nicht 100%

#### Beispiel

```lua
local success = SU.Buildings.SetProductionPercentage(buildingID, 10, 60, 0, 30)
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.settlers-united.com/s4-lua-api-de/su-library-functions/su.buildings/su.buildings.setproductionpercentage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
