=== Syntax ===
<code xml n>
<select [[role="" [count="0"]] [all="false"] [hero=""] by-attribute="" by-talent="" by-quality="" by-name="" by-item="" val="" min="" max="" inverted="" />
</code>
* '''{| class="wikitable sortable"|-!Attribut!! Standardwert!! Erklärung|-|role''': ||||Rollenbezeichnung innerhalb der Gruppe. Möglich sind 'Anführer', 'Dieb', 'Kämpfer', 'Mitreisender'. Wenn es keinen Helden mit dieser Rolle in der Gruppe gibt, wird automatisch der Gruppenleiter selektiert.* '''|-|count''': ||0||Schränkt die Anzahl an zu selektierenden Helden auf Basis der Rollenbezeichnung ein. Wenn bspw. 2 angegeben, werden höchstens zwei Helden selektiert.Wenn 0, dann gibt es keine Beschränkung.|-* '''|all''': ||false||Mit all="true" können alle Helden der Gruppe selektiert werden (standardmäßig zu Beginn einer Gruppen-ZB/.|-Quest)* |hero||||Hier kann die '''heroHeldID''': Mit Angabe des Heldennamens oder der HeldID kann ein Held eines Helden der Gruppe selektiert werden. (Achtung: Der Held muss sich jedoch in der Gruppe befinden! Sofern möglich) angegeben werden. Die HeldID kann bspw. via dem [[hero]]-Tag ermittelt werden.|-|by-attribute||||Hier kann ein [[Heldattribute|Attribut]] angegeben werden.|-|by-talent||||Hier kann eine Fertigkeit, wie z.B. 'Schwimmen', angegeben werden.|-|by-quality||||Hier kann eine Eigenschaft, sollte die HeldID verwendet wie z.B. 'ST', angegeben werden.|-|by-name||||Hier kann eine Variable angegeben werden. Dies ist sinnvoll, da wenn eine Heldvariable (Scope="hero") abgefragt werden soll.|-|by-item||||Hier kann der Name einer Ware angegeben werden, um diejenigen Helden zu selektieren, die einen solchen Gegenstand bei sich haben.|-|val|||||(nur in Kombination mit by-attribute/by-talent/by-quality/by-name/by-item) Wenn ein bestimmter Wert gesetzt sein soll.|-|min||||(nur in Kombination mit by-attribute/by-talent/by-quality/by-name/by-item) Angabe eines Mindestwertes|-|max||||(nur in Kombination mit by-attribute/by-talent/by-quality/by-name/by-item) Angabe eines Maximalwertes|-|inverted||false||Mit inverted="true" kann angegeben werden, dass alle diejenigen Helden selektiert werden sollen, welche gerade nicht eindeutig selektiert sind. Funktioniert auch in Verbindung mit ''count''. Hinweis: Falls derzeit alle Helden selektiert sind, istim Anschluss nur der Gruppenführer selektiert.|}
== Beispiele ==
=== Beispiele Kämpfer auswählen === 1)
<code xml n>
<select role="Kämpfer" />
</code>
2)=== Diebe auswählen ===
<code xml n>
<select role="Dieb" count="1" />
</code>
3)=== Gruppenführer auswählen ===
<code xml n>
<select role="Anführer"/>
</code>
4)=== zufälligen Held auswählen ===
<code xml n>
<!-- Annahme: eine Probe mit der ID "Pr1" wurde in der Szene bereits durchgeführt --><store name="heldid" scope="quest"><hero output="id" by-challenge="Pr1" selectrole="worst*"/></store><select herocount="${heldid}1"/><!-- Wählt den schlechtesten Held der Probe Pr1. -->
</code>
=== Held nach einer Probe auswählen ===
<code xml n>
<!-- Annahme: eine Probe mit name="Pr1" wurde in der Szene bereits durchgeführt -->
<store name="id_held" scope="quest"><hero output="id" by-challenge="Pr1" select="worst"/></store>
<select hero="${id_held}"/><!-- Wählt den schlechtesten Held der Probe Pr1. -->
</code>
=== Alle Helden nacheinander anhand einer Eigenschaft wählen ===Wählt alle Helden aus, die mindestens IQ 15 haben.<code xml><select by-quality="IQ" min="15" /></code>
Mit folgender Methode kann man alle SC der Gruppe nacheinander anwählen:
=== Helden anhand einer Fertigkeit wählen ===Wählt alle Helden aus, die Gassenwissen maximal 5 haben.<code xml n><select by-talent="Gassenwissen" max="5" /></code>
<!-- Muss in 2 Szenen aufgeteilt werden. Szene 1: -->
<store name="gruppenmitglieder" scope="quest"= Helden anhand einer Variable wählen ===Wählt alle Helden aus, die die Variable ''soelder_rang'' haben.<code xml><get attributeselect by-name="anzahl_gruppenmitgliedersoelder_rang"/></storecode>
<include="szene2"/>
=== Helden anhand einer Ware wählen ===
Wählt alle Helden aus, die einen Gewürzkuchen bei sich haben.
<code xml>
<select by-item="Gewürzkuchen" min="1" />
</code>
<!-- Und dann Szene 2: --> === Alle Helden nacheinander wählen ===
<switch name="gruppenmitglieder"> <null> <!-- Szene fertig da alle durch. --> <include target="weiter"/> </null> <case val="0"> <!-Um jedes Gruppenmitglied nacheinander anzuwählen, kann man auf eine [[for]]- Szene fertig da alle durchSchleife zurückgreifen. --> <include target="weiter"/> </case> <else> <store name="zufaelligerHeldID"><hero output="id" select="random"/></store> <select hero="${zufaelligerHeldID}"/> <has name="schon_mal_dran_gewesen"> <success> <include target="szene2"/><!-- War schon, also '''Achtung''': Im Anschluss ist nur noch ein Versuch. --> </success> <failure> <set name="gruppenmitglieder" dec="1"/><!-- Einer weniger. --> <store name="schon_mal_dran_gewesen" scope="hero" expire="1h">..Held selektiert (nämlich der letzte, der sich vorgestellt hat).</store>
<!-- Hier dann, was auch immer man dem Held antuen möchte. ;) --code xml><for all="${sys:heroes}" name="heldid"> <select hero="${heldid}"/> <p>Name: <get attribute="name"/></p></for></code>
=== Aus einer Gruppe einen Helden anhand eines Attributes wählen und danach nennen ===
Wählt einen Helden aus, der magisch begabt ist, und gibt anschließend dessen Namen als Teil des Textes aus.
<code xml>
<for all="${sys:heroes}" name="heldid">
<select hero="${heldid}"/>
<has attribute="magisch" val="true" show="none">
<success>
<store name="magischbegabt" scope="scene"><get attribute="name"/></store>
</success>
</has>
</for>
<has name="magischbegabt" show="none">
<success>
<p>Mit seinem Stab wirkt <get name="magischbegabt"/> einen Stabzauber.</p>
</success>
</has>
</code>
<!-- Noch eine Runde. --> <include target="hitze2"/> </failure> </has> </else></switch>== Die anderen Helden wählen ===
Um diejenigen Helden auszuwählen, welche gerade nicht selektiert sind:
<code xml>
<select inverted="true" />
</code>
[[Kategorie:AOQML]][[Kategorie:Gruppe]][[Kategorie:Mitarbeit-Tags]]