<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>Player</title><revhistory><revision><revnumber>24</revnumber><date>2015-08-03 20:39:43</date><authorinitials>tech</authorinitials></revision><revision><revnumber>23</revnumber><date>2015-02-21 09:19:35</date><authorinitials>LKD70</authorinitials></revision><revision><revnumber>22</revnumber><date>2014-02-10 18:57:23</date><authorinitials>Inanna</authorinitials><revremark>Renamed from 'ObjectPlayer'.</revremark></revision><revision><revnumber>21</revnumber><date>2014-02-10 18:57:16</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>20</revnumber><date>2013-08-04 21:53:08</date><authorinitials>tech</authorinitials></revision><revision><revnumber>19</revnumber><date>2013-08-04 21:52:23</date><authorinitials>tech</authorinitials></revision><revision><revnumber>18</revnumber><date>2013-08-02 16:26:08</date><authorinitials>tech</authorinitials></revision><revision><revnumber>17</revnumber><date>2013-07-31 04:02:21</date><authorinitials>tech</authorinitials></revision><revision><revnumber>16</revnumber><date>2013-07-31 04:01:28</date><authorinitials>tech</authorinitials></revision><revision><revnumber>15</revnumber><date>2013-07-31 02:38:38</date><authorinitials>tech</authorinitials></revision><revision><revnumber>14</revnumber><date>2013-07-31 02:35:33</date><authorinitials>tech</authorinitials></revision><revision><revnumber>13</revnumber><date>2013-07-31 02:31:13</date><authorinitials>tech</authorinitials></revision><revision><revnumber>12</revnumber><date>2012-12-04 18:35:20</date><authorinitials>Inanna</authorinitials><revremark>Renamed from 'Player'.</revremark></revision><revision><revnumber>11</revnumber><date>2012-12-04 18:35:10</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>10</revnumber><date>2012-10-24 20:17:36</date><authorinitials>Romulus</authorinitials></revision><revision><revnumber>9</revnumber><date>2012-10-23 20:18:38</date><authorinitials>Inanna</authorinitials><revremark>Renamed from 'PlayerVars'.</revremark></revision><revision><revnumber>8</revnumber><date>2012-10-23 20:18:30</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>7</revnumber><date>2012-10-23 14:54:37</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>6</revnumber><date>2012-10-23 14:52:53</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>5</revnumber><date>2012-10-23 14:52:01</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>4</revnumber><date>2012-10-23 14:50:44</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>3</revnumber><date>2012-10-23 13:47:41</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>2</revnumber><date>2012-10-23 13:47:27</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>1</revnumber><date>2012-10-23 13:07:35</date><authorinitials>Inanna</authorinitials></revision></revhistory></articleinfo><section><title>m_context.truced</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>m_context.truced </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>if m_context.truced echo &quot;This account is in truce&quot; </para></entry></row></tbody></tgroup></informaltable><para>returns Boolean (True/False) True if account is in truce </para></section><section><title>currentDateTime</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.currentDateTime </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.currentDateTime </para></entry></row></tbody></tgroup></informaltable><para>returns string containing the readable format of &quot;currentTime&quot; (see below) which is actually not current time, but time of last login. </para><para>example: echo player.currentDateTime </para><para>output: </para><para>2013.07.30 18.19.51 </para></section><section><title>currentTime</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.currentTime </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.currentTime </para></entry></row></tbody></tgroup></informaltable><para>this is not actually currentTime... this is time of last login (in UNIX timestamp format) </para></section><section><title>playerInfo.createrTime</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.createrTime </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.createrTime </para></entry></row></tbody></tgroup></informaltable><para>date the account was created, in UNIX timestamp format. </para><para>you can subtract that from timestamp of now and you have account age in milliseconds... you can divide that by (1k milliseconds * 60 seconds * 60 minutes * 24 hrs )= time in days</para><screen><![CDATA[echo "account is {floor((date().time-player.playerInfo.createrTime)/1000/60/60/24)} days old."]]></screen></section><section><title>playerInfo.office</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.office </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.office </para></entry></row></tbody></tgroup></informaltable><para>This will return a string containing current player office/ rank eg &quot;Civilian&quot;, &quot;Lieutenant&quot;,&quot;Captain&quot;,&quot;Major&quot;,&quot;Colonel&quot;,&quot;General&quot; </para></section><section><title>playerInfo.castleCount</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.castleCount </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.castleCount </para></entry></row></tbody></tgroup></informaltable><para>returns count of player's castles </para></section><section><title>playerInfo.honor</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.honor </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.honor </para></entry></row></tbody></tgroup></informaltable><para>returns player's honor points </para></section><section><title>playerInfo.levelId</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.levelId </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.levelId </para></entry></row></tbody></tgroup></informaltable><para>returns a number which represents position in alliance: </para><para>4 = Host </para><para>5 = Vice Host </para><para>6 = Presbyter </para><para>7 = Officer </para><para>8 = Member 0 = not in an alliance </para></section><section><title>playerInfo.medal</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.medal </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.medal </para></entry></row></tbody></tgroup></informaltable><para>returns number of cents on account </para></section><section><title>playerInfo.sex</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.sex </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.sex </para></entry></row></tbody></tgroup></informaltable><para>returns a boolean value indicating player sex. (0=Male, 1=Female) </para></section><section><title>playerInfo.accountName</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.accountName </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.accountName </para></entry></row></tbody></tgroup></informaltable><para>returns string containing login email address. </para></section><section><title>playerInfo.faceUrl</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.faceUrl </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.faceUrl </para></entry></row></tbody></tgroup></informaltable><para>returns string containing path to player avatar icon picture. </para></section><section><title>playerInfo.id</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.id </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.id </para></entry></row></tbody></tgroup></informaltable><para>returns number indicating player's internal ID on game database. </para></section><section><title>playerInfo.allianceLevel</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.allianceLevel </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.allianceLevel </para></entry></row></tbody></tgroup></informaltable><para>returns string containing player's position in alliance (or null if unallied) eg. &quot;Member&quot;,&quot;Officer&quot;,&quot;Presbyter&quot;,&quot;Vice Host&quot; or &quot;Host&quot;. </para></section><section><title>playerInfo.population</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.population </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.population </para></entry></row></tbody></tgroup></informaltable><para>returns number which indicates player's total population for all cities. </para></section><section><title>playerInfo.flag</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.flag </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.flag </para></entry></row></tbody></tgroup></informaltable><para>returns string containing player's flag. </para></section><section><title>playerInfo.prestige</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.prestige </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.prestige </para></entry></row></tbody></tgroup></informaltable><para>returns number containing player's prestige </para></section><section><title>playerInfo.userName</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.userName </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.userName </para></entry></row></tbody></tgroup></informaltable><para>Returns string containing player's lord name. </para></section><section><title>playerInfo.userId</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.userId </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.userId </para></entry></row></tbody></tgroup></informaltable><para>returns yet another internal Id number for the player on the game server. </para></section><section><title>playerInfo.titleId</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.titleId </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.titleId </para></entry></row></tbody></tgroup></informaltable><para>returns a number from 0-9 indicating player's current title. </para><para>example to return player's title in string format: </para><para>titleName=[&quot;Civilian,Knight,Baronet,Baron,Viscount,Earl,Marquis,Duke,Furstin,Prinzessin&quot;] </para><para>echo titleName[player.playerInfo.titleId] </para></section><section><title>playerInfo.ranking</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.ranking </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.ranking </para></entry></row></tbody></tgroup></informaltable><para>returns number indicating player's rank on server (according to prestige) ie: top prestige player on server is ranked 1 </para></section><section><title>playerInfo.alliance</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.alliance </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>player.playerInfo.alliance </para></entry></row></tbody></tgroup></informaltable><para>returns string containing player's alliance name (or null if unallied) </para></section><section><title>castleSignBeanArray</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>player.castleSignBeanArray </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>json_encode(player.castleSignBeanArray) </para></entry></row></tbody></tgroup></informaltable><para>Returns an array containing your saved coords (ID, Name, X coords, Y coords). </para><!--rule (<hr>) is not applicable to DocBook--><para> <ulink url="http://guide.neatportal.com/wiki/Player/wiki/ScriptObjects#">ScriptObjects</ulink> </para></section></article>