addRating: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Arma[ _]2(\|.*)]]" to "{{GameCategory|arma2|Scripting Commands}}")
m (Some wiki formatting)
(34 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| ofp |Game name=
|game1= ofp
|version1= 1.00


|1.00|Game version=
|game2= ofpe
|version2= 1.00


|arg= local |Multiplayer Arguments=
|game3= arma1
|version3= 1.00


|eff= global |Multiplayer Effects=
|game4= arma2
|version4= 1.00


|gr1= Object Manipulation |GROUP1=
|game5= arma2oa
____________________________________________________________________________________________
|version5= 1.50


| Add a number to the [[rating]] of a unit - negative values can be used to reduce the rating.
|game6= tkoh
<br>This command is usually used to reward for completed mission objectives. The rating is given at the end of the mission and is automatically adjusted when killing enemies or friendlies.  
|version6= 1.00


<br>When the rating gets below -2000, the unit's side switches to "ENEMY" ([[sideEnemy]]) and the unit is attacked by everyone.(see [[ArmA:_Rating Values|Rating Values]])
|game7= arma3
|version7= 0.50


<br><br>See also: [[Arma_3:_Event_Handlers#HandleRating]] |DESCRIPTION=
|arg= local
____________________________________________________________________________________________


| unitName '''addRating''' rating |SYNTAX=
|eff= global


|p1= unitName: [[Object]] |PARAMETER1=
|gr1= Object Manipulation


|p2= rating: [[Number]] |PARAMETER2=
|descr= Add a number to the [[rating]] of a unit - negative values can be used to reduce the rating.
<br>This command is usually used to reward for completed mission objectives. The rating is given at the end of the mission and is automatically adjusted when killing enemies or friendlies.


| [[Nothing]] |RETURNVALUE=
<br>When the rating gets below -2000, the unit's side switches to "ENEMY" ([[sideEnemy]]) and the unit is attacked by everyone.(see [[ArmA:_Rating Values|Rating Values]])
____________________________________________________________________________________________
 
|x1= <code>[[player]] [[addRating]] 2000;</code> |EXAMPLE1=
____________________________________________________________________________________________


| [[Side relations]], [[ArmA: Rating Values|Rating Values]], [[rating]], [[rank]], [[setUnitRank]], [[sideEnemy]] |SEEALSO=
<br><br>See also: [[Arma_3:_Event_Handlers#HandleRating]]


}}
|s1= unitName [[addRating]] rating
 
|p1= unitName: [[Object]]


<h3 style="display:none">Notes</h3>
|p2= rating: [[Number]]
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|r1= [[Nothing]]
</dl>


<h3 style="display:none">Bottom Section</h3>
|x1= <sqf>player addRating 2000;</sqf>


[[Category:Scripting Commands|ADDRATING]]
|seealso= [[Side relations]] [[ArmA: Rating Values|Rating Values]] [[rating]] [[rank]] [[setUnitRank]] [[sideEnemy]]
[[Category:Scripting Commands OFP 1.99|ADDRATING]]
}}
[[Category:Scripting Commands OFP 1.96|ADDRATING]]
[[Category:Scripting Commands OFP 1.46|ADDRATING]]
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]


<!-- CONTINUE Notes -->
{{Note
<dl class="command_description">
|user= Benargee
<dd class="notedate">Posted on November 16, 2014 - 19:11 (UTC)</dd>
|timestamp= 20141116191100
<dt class="note">[[User:Benargee|Benargee]]</dt>
|text= Since there is no '''setRating''' command, its expected behaviour can scripted as such:
<dd class="note">
<sqf>
Since there is no '''setRating''' command, its expected behaviour can scripted as such:
BNRG_fnc_setRating = {
<code>BNRG_fnc_setRating = {
   params ["_wantedRating", "_unit"];
   _setRating = _this select 0;
   private _currentRating = rating _unit;
  _unit = _this select 1;
   private _difference = _wantedRating - _currentRating;
   _getRating = rating _unit;
   _unit addRating _difference;
   _addVal = _setRating - _getRating;
   _unit addRating _addVal;
};
};


[1000,player] call BNRG_fnc_setRating//set player rating 1000</code>
[1000, player] call BNRG_fnc_setRating; // set player rating 1000
</sqf>
 
Using this example, no matter what the units rating was before, it will always set its rating to 1000.
Using this example, no matter what the units rating was before, it will always set its rating to 1000.
</dd>
}}
</dl>
<!-- DISCONTINUE Notes -->

Revision as of 15:13, 12 May 2022

Logo A0.png1.00ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
LALocalGEGlobal
Hover & click on the images for description

Description

Description:
Add a number to the rating of a unit - negative values can be used to reduce the rating.
This command is usually used to reward for completed mission objectives. The rating is given at the end of the mission and is automatically adjusted when killing enemies or friendlies.
When the rating gets below -2000, the unit's side switches to "ENEMY" (sideEnemy) and the unit is attacked by everyone.(see Rating Values)

See also: Arma_3:_Event_Handlers#HandleRating
Groups:
Object Manipulation

Syntax

Syntax:
unitName addRating rating
Parameters:
unitName: Object
rating: Number
Return Value:
Nothing

Examples

Example 1:
player addRating 2000;

Additional Information

See also:
Side relations Rating Values rating rank setUnitRank sideEnemy

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Benargee - c
Posted on Nov 16, 2014 - 19:11 (UTC)
Since there is no setRating command, its expected behaviour can scripted as such:
BNRG_fnc_setRating = { params ["_wantedRating", "_unit"]; private _currentRating = rating _unit; private _difference = _wantedRating - _currentRating; _unit addRating _difference; }; [1000, player] call BNRG_fnc_setRating; // set player rating 1000
Using this example, no matter what the units rating was before, it will always set its rating to 1000.
Retrieved from "https://community.bistudio.com/wiki?title=addRating&oldid=318427"