Template:API: Difference between revisions

From Spring
Jump to navigationJump to search
← Older edit
Flozi (talk | contribs)
0 edits
m #2
Flozi (talk | contribs)
0 edits
make name linkable
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
<includeonly>{{prefix|{{{prefix}}}}}{{name|{{{name}}}}}{{var|1=({{{args}}})}}
<includeonly>{{prefix|{{{prefix}}}}}{{name|{{anchor|{{{name}}}}}[[#{{{name}}}|{{{name}}}]]}}{{var|1=({{{args}}})}}{{#if: {{{return|}}}|<br>return: {{var|1={{{return}}}}}|}}{{#if: {{{output|}}}|{{var|1=<br>-> {{{output}}}}}|}}
 
{{#if: {{{return|}}}|return: {{var|1={{{return}}}}}|}}{{#if: {{{output|}}}|{{var|1=-> {{{output}}}}}|}}


:{{{info}}}
:{{{info}}}
</includeonly><noinclude>
</includeonly><noinclude>
{{API
|prefix = Spring.
|name = UseTeamResource
|args = {{type|number}} teamID, {{type|string}} {{value|"metal"}} {{pipe}} {{value|"energy"}}, {{type|number}} amount {{pipe}} { metal = {{type|number}} amount, energy = {{type|number}} amount }
|output = {{type|nil}} {{pipe}} {{type|bool}} hadEnough
|info = Imposes a one-off usage of resources on the given team. The return value indicates whether or not the team had sufficient resources to meet the usage demand.
}}


<pre>
<pre>
Line 30: Line 20:


:Deduct the specified amount from the team's metal or energy resource.
:Deduct the specified amount from the team's metal or energy resource.
vs.
<pre>
{{API <!-- Callin example -->
|prefix = addon <!-- May use gadget: instead? -->
|name = AllowUnitTransfer
|arg1 = {{type|number}} unitID
|arg2 = {{type|number}} unitDefID
|arg3 = {{type|number}} oldTeam
|arg4 = {{type|number}} newTeam
|arg5 = {{type|bool}} capture
|return = {{type|bool}} allow <!-- note that this is a different entry than output above -->
|info = Called just before a unit is transferred to a different team, the boolean return value determines whether or not the transfer is permitted.
}}</pre>
{{prefix|addon.}}{{name|AllowUnitTransfer}}{{var|1=({{type|number}} unitID, {{type|number}} unitDefID, {{type|number}} oldTeam,
{{type|number}} newTeam, {{type|bool}} capture)}}
return: {{var|{{type|bool}} allow}}
:Called just before a unit is transferred to a different team, the boolean return value determines whether or not the transfer is permitted.</noinclude>

Latest revision as of 19:43, 28 March 2020


{{API <!-- Callout example -->
|prefix = Spring
|name = UseTeamResource
|arg1 = {{type|number}} teamID
|arg2 = {{type|string}} "metal" {{pipe}} "energy"
|arg3 = {{type|number}} amount {{pipe}} { metal = {{type|number}} amount, energy = {{type|number}} amount }
|output = {{type|nil}} {{pipe}} {{type|bool}} hadEnough
|info = Imposes a one-off usage of resources on the given team. The return value indicates whether or not the team had sufficient resources to meet the usage demand.
}}

Spring.UseTeamResource(number teamID, string "metal" | "energy", number amount | { metal = number amount, energy = number amount })

-> nil | bool hadEnough

Deduct the specified amount from the team's metal or energy resource.
Retrieved from "https://springrts-wiki.p2004a.com/mediawiki/index.php?title=Template:API&oldid=22317"