Soldat Community Wiki - User contributions [en]

GetPlayerStat

2020-04-15T21:45:55Z

Gr0t: Fixed table

===From the Scripting Manual===
''function GetPlayerStat(ID: byte; Stat: string): variant;''

'''Parameter Info:'''
ID (Byte): Player ID to get the stat of.
Stat (String): See Description for more information.

'''Description:'''
This function will return some information about the specified player (ID).<br>

{| class="wikitable" width="40%"
! Stat || Result || Type
|-
| Kills || Player kills || Integer
|-
| Deaths || Player deaths || Integer
|-
| Ping || Player ping || Integer
|-
| Team || Player team || Byte
|-
| Active || Is in-game? || Boolean
|-
| IP || Player IP || String
|-
| Port || Player port || Integer
|-
| Name || Player name || String
|-
| Alive || Is player alive? || Boolean
|-
| Health || Player health || Integer
|-
| Primary || Primary weapon || Byte
|-
| Secondary || Secondary weapon || Byte
|-
| Ammo || Primary ammo || Byte
|-
| SecAmmo || Secondary ammo || Byte
|-
| Jets || Jet amount || Integer
|-
| Grenades || Grenade amount || Byte
|-
| X || Player X coordinate || Single
|-
| Y || Player Y coordinate || Single
|-
| Flagger || Player holding a flag? || Boolean
|-
| Time || Time in server (minutes) || Integer
|-
| Ground || Is player on ground || Boolean
|-
| Human || Is player human? || Boolean
|-
| VelX || X velocity || Single
|-
| VelY || Y velocity || Single
|-
| Vest || Vest amount || Integer
|-
| Direction || Player facing direction ('<' or '>') || Char
|-
| Mute || Is player muted? || Byte
|-
| Flags || Flag captures || Byte
|-
| TagID || Player's Portal TagID || String
|-
| Registered || Is player registered? || Boolean
|-
| WepCount || ? (unique weapons player used on a map ?) || ? (unsigned integer of some sort)
|-
| HWID || Player's Hardware ID || String (contains alphanumeric chars)
|}

==Examples==
<source lang="pascal">begin
WriteLn('Player1''s health is '+inttostr(GetPlayerStat(1,'health')));
WriteLn('Player1''s ping is '+inttostr(GetPlayerStat(1,'PiNg'))); //Case does not matter!
WriteLn('Player1''s IP is '+GetPlayerStat(1,'ip'));
end;
</source>

==External Links==
* [http://enesce.com/help/index.html?Functions/GetPlayerStat.html Scripting Manual page for GetPlayerStat]

[[Category:Server Scripting]][[Category:Server Scripting Functions]]

Soldat Community

2020-04-15T20:47:48Z

Gr0t: Fixing English grammatical issues.

Throughout time, the Soldat community has been an inseparable part of the game. Even though video-gaming culture is huge now, it's quite nontrivial that a small indie game, that was initially developed by one man for a good portion of time - gained such popularity back in the early 2000's.

Players were always involved in many aspects of creating sub-communities, [[Third-Party Tools| tools]], new content, media, streams & [[Scripts Database| scripts]]. Some members of the community even became also part of the beta, weapons and developers teams, for the sake of improving the game constantly.

Soldat couldn't have gotten this successful without each one of the above mentioned soldiers.

=Discord=
[[File:DiscordLogo.png|right|Discord's Logo]]
For many years the community has been using IRC (Internat Relay Chat) as their main platform to play chat and play gathers. Discord came along with a modern and slick layout, perfect for gaming communities of all sorts, and soldat has now migrated completely.

[[Soldat's Official Discord Server]] was initially created by '''''manofoneway''''' on 9th October 2016, '''''nosejj''''' joined the early efforts a week later. Within less than a year dozens of users turned into hundreds. Eventually, Soldat gather services and admins were ready to migrate. '''''XvayS (SyavX)''''' started working on a gather bot from scratch. And when gathers started, oldies started reappearing, as well as some new souls!

Unlike in the past when many communities were torn between private servers and forums, Soldat Discord aspires to create a communal hub, in which Soldat players of all sorts can be gathered to play, discuss and enjoy content related to Soldat. The goal of the Discord server is to create an active, united, vibrant and revitalized Soldat community. As well as provide quality services such as gather and servers rental. As of April 2020, the official discord has over 5500 members.

You can be a part of and enjoy with the following link: [https://discord.gg/soldat Soldat Discord Invite Link]

=IRC=
[[File:MIRCLogo.png|right|170px|mIRC Logo]]

Clans, gathers, services, communities & developers have all gathered in IRC (Internet Relay Chat). It was used from the early stages of Soldat (as in not too late after it's release).

The first gathers appeared around 2005-2006 in IRC in #Soldat.Gather by TomPenny & Suomip. Later on, many variations of gathers were created.

Due to its old-fashioned style and lack of features compared to other more modern chat clients, IRC has been mostly abandoned.

=Sub Gamemodes=
Here's a short list of sub game modes created by the Soldat community:
* [[Climb]]
* [[Dodgeball]]
* [[Domination]]
* [[Hide and Seek]]
* [[Knife Only]]
* [[OneShots]]
* [[Pirates vs Ninjas]]
* [[Realistic Soldat/Counter Strike]]
* [[TW]]
* [[TTW]]
* [[Zombie]]
* Last Stand
* Hexer
* MiracleMod
* OnSlaught

=Community Leagues=
* '''SCTFL''' - Soldat CTF League
* '''SCTFC''' - Soldat Capture The Flag Cup
* '''ASCTFL''' - Australian Soldat CTF League
* '''SRL''' - Soldat Realistic League'''
* '''SWC''' - Soldat World Cup'''
* '''SRWC''' - Soldat Realistic World Cup'''
* '''SVL''' - Soldat 1v1 League'''
* '''TNL''' - The Next League'''
* '''ESL''' - Soldat Ladder'''
* '''LoF''' - League of Friends'''
* '''TPC''' - The Pwnage Cup'''
* '''SaD Tournament'''
* '''OXiD L33t Cup'''

=Sub Communities=
* '''Selfkill'''
* '''Hexer'''
* '''CS Soldat Center'''
* '''Realistic United'''
* '''Soldat Eat-This!'''
* '''Fracs'''
* '''Climbing Soldiers'''

Soldat Community

2020-04-15T20:43:07Z

Gr0t: Fixing English grammatical issues.

Throughout time, the Soldat community has been an inseparable part of the game. Even though video-gaming culture is huge now, it's quite nontrivial that a small indie game, that was initially developed by one man for a good portion of time - gained such popularity back in the early 2000's.

Players were always involved in many aspects of creating sub-communities, [[Third-Party Tools| tools]], new content, media, streams & [[Scripts Database| scripts]]. Some members of the community even became also part of the beta, weapons and developers teams, for the sake of improving the game constantly.

Soldat couldn't have gotten this successful without each one of the above mentioned soldiers.

=Discord=
[[File:DiscordLogo.png|right|Discord's Logo]]
For many years the community has been using IRC (Internat Relay Chat) as their main platform to play chat and play gathers. Discord came along with a modern and slick layout, perfect for gaming communities of all sorts, and soldat has now migrated completely.

[[Soldat's Official Discord Server]] was initially created by '''''manofoneway''''' on 9th October 2016, '''''nosejj''''' joined the early efforts a week later. Within less than a year dozens of users turned into hundreds. Eventually, Soldat gather services and admins were ready to migrate. '''''XvayS (SyavX)''''' started working on a gather bot from scratch. And when gathers started, oldies started reappearing, as well as some new souls!

Unlike in the past when many communities were torn between private servers and forums, Soldat Discord aspires to create a communal hub, in which Soldat players of all sorts can be gathered to play, discuss and enjoy content related to Soldat. The goal of the Discord server is to create an active, united, vibrant and revitalized Soldat community. As well as provide quality services such as gather and servers rental.

You can be a part of and enjoy with the following link: [https://discord.gg/soldat Soldat Discord Invite Link]

=IRC=
[[File:MIRCLogo.png|right|170px|mIRC Logo]]

Clans, gathers, services, communities & developers have all gathered in IRC (Internet Relay Chat). It was used from the early stages of Soldat (as in not too late after it's release).

The first gathers appeared around 2005-2006 in IRC in #Soldat.Gather by TomPenny & Suomip. Later on, many variations of gathers were created.

Due to its old-fashioned style and lack of features compared to other more modern chat clients, IRC has been mostly abandoned.

=Sub Gamemodes=
Here's a short list of sub game modes created by the Soldat community:
* [[Climb]]
* [[Dodgeball]]
* [[Domination]]
* [[Hide and Seek]]
* [[Knife Only]]
* [[OneShots]]
* [[Pirates vs Ninjas]]
* [[Realistic Soldat/Counter Strike]]
* [[TW]]
* [[TTW]]
* [[Zombie]]
* Last Stand
* Hexer
* MiracleMod
* OnSlaught

=Community Leagues=
* '''SCTFL''' - Soldat CTF League
* '''SCTFC''' - Soldat Capture The Flag Cup
* '''ASCTFL''' - Australian Soldat CTF League
* '''SRL''' - Soldat Realistic League'''
* '''SWC''' - Soldat World Cup'''
* '''SRWC''' - Soldat Realistic World Cup'''
* '''SVL''' - Soldat 1v1 League'''
* '''TNL''' - The Next League'''
* '''ESL''' - Soldat Ladder'''
* '''LoF''' - League of Friends'''
* '''TPC''' - The Pwnage Cup'''
* '''SaD Tournament'''
* '''OXiD L33t Cup'''

=Sub Communities=
* '''Selfkill'''
* '''Hexer'''
* '''CS Soldat Center'''
* '''Realistic United'''
* '''Soldat Eat-This!'''
* '''Fracs'''
* '''Climbing Soldiers'''

Scripting basics

2018-12-02T16:10:16Z

Gr0t: Fixed English grammatical errors throughout

=History of Soldat Script Core=

The '''Soldat Server Scripting Core''' was programmed by [[EnEsCe]] to help other users creating scripts for their server.
It uses the Pascal Programming Language with '''Events''', '''Functions''' and '''Variables'''. You can find a list of examples [[Server_Scripting|here]].

=A Quick look at the Pascal Programming Language=
At a glance, Pascal is quite useful and easy to manage compared to eg. C and C++ languages.
It uses words (e.g. begin-end, if-or) instead of the symbols ({-}) used in C/C++ so it is easier to read by the user. Basic scripting requires little work, most text you can copy/paste, and it has very clear structure:
CONST
();
VAR
();
FUNCTION/PROCEDURE();
BEGIN
();
END;

Another big plus of Pascal is its speed. The Pascal compiler is lightning-fast and well-suited for teaching programming, as you can do more in a small time frame.
There is less overhead and fewer ways for a new user to crash a program. So as a first programming language, Pascal is a good choice.
Even in a world filled with use-cases for C++ and Java languages, Pascal, in its simplicity, is still one of the best programing language: Powerful and easy to handle.

=Tools for Writing a Scripts=
You probably expected that you would need lots of programs and a high-end PC to write Scripts for soldat, but don't worry, all you need is... Notepad.

'''Yes. All you need to write Scripts for [[Soldat]] is a simple text editor that is already installed to your system.'''

But to help you, and improve your work, we recommend downloading [http://notepad-plus-plus.org Notepad++] just click [http://notepad-plus-plus.org/download/ here] to get latest version. You can also use any other IDE.

Also to improve your work, we recommend downloading [http://forums.soldat.pl/index.php?action=dlattach;topic=40110.0;attach=27770 this file] to aid in your Pascal programming.

Download it and put in your Notepad++ folder in ..\plugins\APIs
:eg. C:\Program Files\Notepad++\plugins\APIs

And after you start program just select in ''Language'' Tab: ''P->Pascal''

;You can see what this small plug-in does here:

BEFORE:
[[File:Notepad plusplus 01.jpg]]
AFTER:
[[File:Notepad plusplus 02.jpg]]

It will massively improve your work with its syntax coloring and ability to hide/show selected code-blocks of your script (small + icons on the left)

=Online Pascal Tutorials=
:If you are interested in writing scripts for [[Soldat]] you should check few sites before you start messing with any '''Functions''' and '''Procedures''' :]

* [http://www.taoyue.com/tutorials/pascal/ Pascal tutorial in taoye.com]
* [http://www.algonet.se/%7Ekhaan/tutor/ Turbo Pascal programming ]

Note: Some tutorials may have references to functions that do not exist in the Soldat Scripting Core.

=Soldat Scripting Tutorials=

:Our [[Soldat Community]] have prepared few easy tutorials for beginners, that should prepare you to write your first scripts for [[Soldat]].
:But don't worry. If you encounter any problem you can ask for help in our [[Forum]] in [http://forums.soldat.pl/index.php?board=40.0 Scripting Discussions and Help] section.

Scripting basics

2018-12-02T16:07:46Z

Gr0t: Fixed English grammatical errors throughout

=History of Soldat Script Core=

The '''Soldat Server Scripting Core''' was programmed by [[EnEsCe]] to help other users creating scripts for their server.
It uses the Pascal Programming Language with '''Events''', '''Functions''' and '''Variables'''. You can find a list of examples [[Server_Scripting|here]].

=Quick look at the Pascal Programming Language=
At a glance, Pascal is quite useful and easy to manage compared to eg. C and C++ languages.
It uses words (e.g. begin-end, if-or) instead of the symbols ({-}) used in C/C++ so it is easier to read by the user. Basic scripting requires little work, most text you can copy/paste, and it has very clear structure:
CONST
();
VAR
();
FUNCTION/PROCEDURE();
BEGIN
();
END;

Another big plus of Pascal is its speed. The Pascal compiler is lightning-fast and well-suited for teaching programming, as you can do more in a small time frame.
There is less overhead and fewer ways for a new user to crash a program. So as a first programming language, Pascal is a good choice.
Even in a world filled with use-cases for C++ and Java languages, Pascal, in its simplicity, is still one of the best programing language: Powerful and easy to handle.

=Tools for Writing a Scripts=
You probably expected that you would need lots of programs and a high-end PC to write Scripts for soldat, but don't worry, all you need is... Notepad.

'''Yes. All you need to write Scripts for [[Soldat]] is a simple text editor that is already installed to your system.'''

But to help you, and improve your work, we recommend downloading [http://notepad-plus-plus.org Notepad++] just click [http://notepad-plus-plus.org/download/ here] to get latest version. You can also use any other IDE.

Also to improve your work, we recommend downloading [http://forums.soldat.pl/index.php?action=dlattach;topic=40110.0;attach=27770 this file] to aid in your Pascal programming.

Download it and put in your Notepad++ folder in ..\plugins\APIs
:eg. C:\Program Files\Notepad++\plugins\APIs

And after you start program just select in ''Language'' Tab: ''P->Pascal''

;You can see what this small plug-in does here:

BEFORE:[[File:Notepad plusplus 01.jpg]] AFTER:[[File:Notepad plusplus 02.jpg]]

It will massively improve your work with its syntax coloring and ability to hide/show selected code-blocks of your script (small + icons on the left)

=Online Pascal Tutorials=
:If you are interested in writing scripts for [[Soldat]] you should check few sites before you start messing with any '''Functions''' and '''Procedures''' :]

* [http://www.taoyue.com/tutorials/pascal/ Pascal tutorial in taoye.com]
* [http://www.algonet.se/%7Ekhaan/tutor/ Turbo Pascal programming ]

Note: Some tutorials may have references to functions that do not exist in the Soldat Scripting Core.

=Soldat Scripting Tutorials=

:Our [[Soldat Community]] have prepared few easy tutorials for beginners, that should prepare you to write your first scripts for [[Soldat]].
:But don't worry. If you encounter any problem you can ask for help in our [[Forum]] in [http://forums.soldat.pl/index.php?board=40.0 Scripting Discussions and Help] section.

Scripting basics

2018-12-02T16:04:56Z

Gr0t: Fixed English grammatical errors throughout

=Story of Soldat Script Core=

The '''Soldat Server Scripting Core''' was programmed by [[EnEsCe]] to help other users creating scripts for their server.
It use the Pascal coding language with '''Events''', '''Functions''' and '''Variables'''. You can find list of this coding part [[Server_Scripting|here]].

=Quick look at Pascal language=
In quick glance, Pascal is quite useful and easy to manage compared to eg. C and C++ languages.
It uses words (e.g. begin-end, if-or) instead of the symbols ({-}) used in C/C++ so it is easier to read by the user. For basic scripting it requires little work, most text you can copy/paste, and it has very clear structure:
CONST
();
VAR
();
FUNCTION/PROCEDURE();
BEGIN
();
END;

Another big plus of Pascal is its speed. The Pascal compiler is lightning-fast and well-suited for teaching programming, as you can do more in a small time frame.
There is less overhead and fewer ways for a new user to crash a program. So as a first programming language, Pascal is a good choice.
Even in a world filled with use-cases for C++ and Java languages, Pascal, in its simplicity, is still one of the best programing language: Powerful and easy to handle.

=Tools for Writing a Scripts=
You probably expected that you would need lots of programs and a high-end PC to write Scripts for soldat, but don't worry, all you need is... Notepad.

'''Yes. All you need to write Scripts for [[Soldat]] is a simple text editor that is already installed to your system.'''

But to help you, and improve your work, we recommend downloading [http://notepad-plus-plus.org Notepad++] just click [http://notepad-plus-plus.org/download/ here] to get latest version. You can also use any other IDE.

Also to improve your work, we recommend downloading [http://forums.soldat.pl/index.php?action=dlattach;topic=40110.0;attach=27770 this file] to aid in your Pascal programming.

Download it and put in your Notepad++ folder in ..\plugins\APIs
:eg. C:\Program Files\Notepad++\plugins\APIs

And after you start program just select in ''Language'' Tab: ''P->Pascal''

;You can see what this small plug-in does here:

BEFORE:[[File:Notepad plusplus 01.jpg]] AFTER:[[File:Notepad plusplus 02.jpg]]

It will massively improve your work with its syntax coloring and ability to hide/show selected code-blocks of your script (small + icons on the left)

=Online Pascal Tutorials=
:If you are interested in writing scripts for [[Soldat]] you should check few sites before you start messing with any '''Functions''' and '''Procedures''' :]

* [http://www.taoyue.com/tutorials/pascal/ Pascal tutorial in taoye.com]
* [http://www.algonet.se/%7Ekhaan/tutor/ Turbo Pascal programming ]

Note: Some tutorials may have references to functions that do not exist in the Soldat Scripting Core.

=Soldat Scripting Tutorials=

:Our [[Soldat Community]] have prepared few easy tutorials for beginners, that should prepare you to write your first scripts for [[Soldat]].
:But don't worry. If you encounter any problem you can ask for help in our [[Forum]] in [http://forums.soldat.pl/index.php?board=40.0 Scripting Discussions and Help] section.