Soldat Community Wiki - User contributions [en]

Mod.ini

2016-02-25T00:19:51Z

Calp:

With Soldat 1.7.0 we introduced a new mod.ini file which controls how some things are displayed. There are two different sections in this file: [SCALE] and [GOSTEK].

==Scale==

The purpose of this section is to solve a problem that came along with the new HD rendering support: we needed to decouple pixel units from in-game map/world units. Without this, all new HD images would show up huge.

In this '''[SCALE] section''' you may have a '''DefaultScale''' entry and as many '''file/folder''' specific entries as needed. Here's an example:

[SCALE]
DefaultScale=4.5
interface-gfx/cursor.png=10 # file specific
interface-gfx=2 # directory specific[/code]

For any given image file, it first tries to find an entry for that specific file. If there is none it will try to find an entry for the directory where the file is contained. If that's not there either it will use the DefaultScale value (or 1 if it doesn't exist). Note that directory entries do '''not''' apply to sub-directories.

'''Custom interfaces and mods need their own mod.ini file.''' If they don't have this file it is assumed that it's an old interface/mod and the scale for the images it contains will default to 1. The file/folder paths are always relative to where the mod.ini file is located.

The scale value defines how many pixels of the image fit in 1 map/world unit (another way to think of it is how much bigger the image is compared to the old version). If you design an image for a specific resolution, you can '''calculate the scale value''' with a simple formula:

scale = resolution height / 480

That's because map units are 1:1 with pixels when using 640x480 resolution and the bigger the resolution, the more pixels a map unit will cover. The width of the resolution doesn't matter because it only affects the field of view.

== Gostek ==

The soldier is composed of a skeleton and a number of''' sprites that are hooked to specific skeleton points'''. That hook is defined by '''3 properties''':

* A point from the skeleton used for the sprite position.
* A reference point from the skeleton used for the rotation angle of the sprite.
* An anchor point (or center point) for the sprite.

[[File:Mod.inMod.inii.png|200px|thumb|right|alt text]]The '''[GOSTEK] section''' from mod.ini provides the ability to '''change the anchor point of each sprite''', which is the point from where the sprite is positioned and rotated in relation to the main skeleton hook point. This anchor point is expressed in normalized coordinates going from (0,0) to (1,1). You can see a visualization of how that works on the right:

Most of the images in gostek-gfx/ and weapons-gfx/ have a flipped version with "2" or "-2" suffix. These flipped images should have the same size as the non-flipped one, otherwise the sprite alignment will be different when the soldier is looking to the left.

For now there is '''no way to setup different alignment values for the "team2" gostek '''graphics, so it's best to keep those with the same size and similar shape as main gostek graphics.

'''Attached is a list of all the soldier sprites that can be tweaked''' from the mod.ini file, along with the image file they are related to. The actual entry that goes in the [GOSTEK] section is the sprite name with a "_CenterX"/"_CenterY" suffix.

'''Online tool for editing and previewing the alignment values''':
http://urraka.github.io/soldat-gostek/

You can '''drop a zip with gostek-gfx/ and weapons-gfx/ folders''' to load custom graphics. The soldier looks slightly different in this tool because it doesn't account for some skeleton modifications done by the game logic (like aiming), but it looks close enough to be helpful. A '''mod.ini file can be loaded/saved''' with the buttons on top of the table on the right.
The '''mod.ini file you save from there is [u]not[/u] intended to directly replace the one you have in soldat''', as it won't have any scale information.

Note: This tool hasn't been updated to load scale information from the mod.ini file. It still relies on the scale.ini file which was used during the alpha/beta versions of Soldat 1.7.0, so if you drop a zip with the graphics it should have a scale.ini file inside each directory.

Mod.ini

2016-02-25T00:19:06Z

Calp:

With Soldat 1.7.0 we introduced a new mod.ini file which controls how some things are displayed. There are two different sections in this file: [SCALE] and [GOSTEK].

==Scale==

The purpose of this section is to solve a problem that came along with the new HD rendering support: we needed to decouple pixel units from in-game map/world units. Without this, all new HD images would show up huge.

In this '''[SCALE] section''' you may have a '''DefaultScale''' entry and as many '''file/folder''' specific entries as needed. Here's an example:

[SCALE]
DefaultScale=4.5
interface-gfx/cursor.png=10 # file specific
interface-gfx=2 # directory specific[/code]

For any given image file, it first tries to find an entry for that specific file. If there is none it will try to find an entry for the directory where the file is contained. If that's not there either it will use the DefaultScale value (or 1 if it doesn't exist). Note that directory entries do '''not''' apply to sub-directories.

'''Custom interfaces and mods need their own mod.ini file.''' If they don't have this file it is assumed that it's an old interface/mod and the scale for the images it contains will default to 1. The file/folder paths are always relative to where the mod.ini file is located.

The scale value defines how many pixels of the image fit in 1 map/world unit (another way to think of it is how much bigger the image is compared to the old version). If you design an image for a specific resolution, you can '''calculate the scale value''' with a simple formula:

scale = resolution height / 480

That's because map units are 1:1 with pixels when using 640x480 resolution and the bigger the resolution, the more pixels a map unit will cover. The width of the resolution doesn't matter because it only affects the field of view.

== Gostek ==

The soldier is composed of a skeleton and a number of''' sprites that are hooked to specific skeleton points'''. That hook is defined by '''3 properties''':

* A point from the skeleton used for the sprite position.
* A reference point from the skeleton used for the rotation angle of the sprite.
* An anchor point (or center point) for the sprite.

The '''[GOSTEK] section''' from mod.ini provides the ability to '''change the anchor point of each sprite''', which is the point from where the sprite is positioned and rotated in relation to the main skeleton hook point. This anchor point is expressed in normalized coordinates going from (0,0) to (1,1). Here is a visualization of how it works:

[[File:Mod.inMod.inii.png|200px|thumb|right|alt text]]

Most of the images in gostek-gfx/ and weapons-gfx/ have a flipped version with "2" or "-2" suffix. These flipped images should have the same size as the non-flipped one, otherwise the sprite alignment will be different when the soldier is looking to the left.

For now there is '''no way to setup different alignment values for the "team2" gostek '''graphics, so it's best to keep those with the same size and similar shape as main gostek graphics.

'''Attached is a list of all the soldier sprites that can be tweaked''' from the mod.ini file, along with the image file they are related to. The actual entry that goes in the [GOSTEK] section is the sprite name with a "_CenterX"/"_CenterY" suffix.

'''Online tool for editing and previewing the alignment values''':
http://urraka.github.io/soldat-gostek/

You can '''drop a zip with gostek-gfx/ and weapons-gfx/ folders''' to load custom graphics. The soldier looks slightly different in this tool because it doesn't account for some skeleton modifications done by the game logic (like aiming), but it looks close enough to be helpful. A '''mod.ini file can be loaded/saved''' with the buttons on top of the table on the right.
The '''mod.ini file you save from there is [u]not[/u] intended to directly replace the one you have in soldat''', as it won't have any scale information.

Note: This tool hasn't been updated to load scale information from the mod.ini file. It still relies on the scale.ini file which was used during the alpha/beta versions of Soldat 1.7.0, so if you drop a zip with the graphics it should have a scale.ini file inside each directory.

Mod.ini

2016-02-25T00:17:02Z

Calp:

With Soldat 1.7.0 we introduced a new mod.ini file which controls how some things are displayed. There are two different sections in this file: [SCALE] and [GOSTEK].

==Scale==

The purpose of this section is to solve a problem that came along with the new HD rendering support: we needed to decouple pixel units from in-game map/world units. Without this, all new HD images would show up huge.

In this '''[SCALE] section''' you may have a '''DefaultScale''' entry and as many '''file/folder''' specific entries as needed. Here's an example:

[SCALE]
DefaultScale=4.5
interface-gfx/cursor.png=10 # file specific
interface-gfx=2 # directory specific[/code]

For any given image file, it first tries to find an entry for that specific file. If there is none it will try to find an entry for the directory where the file is contained. If that's not there either it will use the DefaultScale value (or 1 if it doesn't exist). Note that directory entries do '''not''' apply to sub-directories.

'''Custom interfaces and mods need their own mod.ini file.''' If they don't have this file it is assumed that it's an old interface/mod and the scale for the images it contains will default to 1. The file/folder paths are always relative to where the mod.ini file is located.

The scale value defines how many pixels of the image fit in 1 map/world unit (another way to think of it is how much bigger the image is compared to the old version). If you design an image for a specific resolution, you can '''calculate the scale value''' with a simple formula:

scale = resolution height / 480

That's because map units are 1:1 with pixels when using 640x480 resolution and the bigger the resolution, the more pixels a map unit will cover. The width of the resolution doesn't matter because it only affects the field of view.

== Gostek ==

The soldier is composed of a skeleton and a number of''' sprites that are hooked to specific skeleton points'''. That hook is defined by '''3 properties''':

[list]
[li]A point from the skeleton used for the sprite position.[/li]
[li]A reference point from the skeleton used for the rotation angle of the sprite.[/li]
[li]An anchor point (or center point) for the sprite.[/li]
[/list]

The '''[GOSTEK] section''' from mod.ini provides the ability to '''change the anchor point of each sprite''', which is the point from where the sprite is positioned and rotated in relation to the main skeleton hook point. This anchor point is expressed in normalized coordinates going from (0,0) to (1,1). Here is a visualization of how it works:

[[File:Mod.inMod.inii.png|200px|thumb|right|alt text]]

Most of the images in gostek-gfx/ and weapons-gfx/ have a flipped version with "2" or "-2" suffix. These flipped images should have the same size as the non-flipped one, otherwise the sprite alignment will be different when the soldier is looking to the left.

For now there is '''no way to setup different alignment values for the "team2" gostek '''graphics, so it's best to keep those with the same size and similar shape as main gostek graphics.

'''Attached is a list of all the soldier sprites that can be tweaked''' from the mod.ini file, along with the image file they are related to. The actual entry that goes in the [GOSTEK] section is the sprite name with a "_CenterX"/"_CenterY" suffix.

'''Online tool for editing and previewing the alignment values''':
http://urraka.github.io/soldat-gostek/

You can '''drop a zip with gostek-gfx/ and weapons-gfx/ folders''' to load custom graphics. The soldier looks slightly different in this tool because it doesn't account for some skeleton modifications done by the game logic (like aiming), but it looks close enough to be helpful. A '''mod.ini file can be loaded/saved''' with the buttons on top of the table on the right.
The '''mod.ini file you save from there is [u]not[/u] intended to directly replace the one you have in soldat''', as it won't have any scale information.

Note: This tool hasn't been updated to load scale information from the mod.ini file. It still relies on the scale.ini file which was used during the alpha/beta versions of Soldat 1.7.0, so if you drop a zip with the graphics it should have a scale.ini file inside each directory.

Mod.ini

2016-02-25T00:15:56Z

Calp: /* Gostek */

With Soldat 1.7.0 we introduced a new mod.ini file which controls how some things are displayed. There are two different sections in this file: [SCALE] and [GOSTEK].

==Scale==

The purpose of this section is to solve a problem that came along with the new HD rendering support: we needed to decouple pixel units from in-game map/world units. Without this, all new HD images would show up huge.

In this '''[SCALE] section''' you may have a '''DefaultScale''' entry and as many '''file/folder''' specific entries as needed. Here's an example:

[SCALE]
DefaultScale=4.5
interface-gfx/cursor.png=10 # file specific
interface-gfx=2 # directory specific[/code]

For any given image file, it first tries to find an entry for that specific file. If there is none it will try to find an entry for the directory where the file is contained. If that's not there either it will use the DefaultScale value (or 1 if it doesn't exist). Note that directory entries do '''not''' apply to sub-directories.

'''Custom interfaces and mods need their own mod.ini file.''' If they don't have this file it is assumed that it's an old interface/mod and the scale for the images it contains will default to 1. The file/folder paths are always relative to where the mod.ini file is located.

The scale value defines how many pixels of the image fit in 1 map/world unit (another way to think of it is how much bigger the image is compared to the old version). If you design an image for a specific resolution, you can '''calculate the scale valu'''e with a simple formula:

scale = resolution height / 480

That's because map units are 1:1 with pixels when using 640x480 resolution and the bigger the resolution, the more pixels a map unit will cover. The width of the resolution doesn't matter because it only affects the field of view.

== Gostek ==

The soldier is composed of a skeleton and a number of''' sprites that are hooked to specific skeleton points'''. That hook is defined by '''3 properties''':

[list]
[li]A point from the skeleton used for the sprite position.[/li]
[li]A reference point from the skeleton used for the rotation angle of the sprite.[/li]
[li]An anchor point (or center point) for the sprite.[/li]
[/list]

The '''[GOSTEK] section''' from mod.ini provides the ability to '''change the anchor point of each sprite''', which is the point from where the sprite is positioned and rotated in relation to the main skeleton hook point. This anchor point is expressed in normalized coordinates going from (0,0) to (1,1). Here is a visualization of how it works:

[[File:Mod.inMod.inii.png|200px|thumb|right|alt text]]

Most of the images in gostek-gfx/ and weapons-gfx/ have a flipped version with "2" or "-2" suffix. These flipped images should have the same size as the non-flipped one, otherwise the sprite alignment will be different when the soldier is looking to the left.

For now there is '''no way to setup different alignment values for the "team2" gostek '''graphics, so it's best to keep those with the same size and similar shape as main gostek graphics.

'''Attached is a list of all the soldier sprites that can be tweake'''d from the mod.ini file, along with the image file they are related to. The actual entry that goes in the [GOSTEK] section is the sprite name with a "_CenterX"/"_CenterY" suffix.

'''Online tool for editing and previewing the alignment values''':
http://urraka.github.io/soldat-gostek/

You can '''drop a zip with gostek-gfx/ and weapons-gfx/ folders''' to load custom graphics. The soldier looks slightly different in this tool because it doesn't account for some skeleton modifications done by the game logic (like aiming), but it looks close enough to be helpful. A '''mod.ini file can be loaded/saved''' with the buttons on top of the table on the right.
The '''mod.ini file you save from there is [u]not[/u] intended to directly replace the one you have in soldat''', as it won't have any scale information.

Note: This tool hasn't been updated to load scale information from the mod.ini file. It still relies on the scale.ini file which was used during the alpha/beta versions of Soldat 1.7.0, so if you drop a zip with the graphics it should have a scale.ini file inside each directory.

Mod.ini

2016-02-25T00:14:58Z

Calp: /* Gostek */

With Soldat 1.7.0 we introduced a new mod.ini file which controls how some things are displayed. There are two different sections in this file: [SCALE] and [GOSTEK].

==Scale==

The purpose of this section is to solve a problem that came along with the new HD rendering support: we needed to decouple pixel units from in-game map/world units. Without this, all new HD images would show up huge.

In this '''[SCALE] section''' you may have a '''DefaultScale''' entry and as many '''file/folder''' specific entries as needed. Here's an example:

[SCALE]
DefaultScale=4.5
interface-gfx/cursor.png=10 # file specific
interface-gfx=2 # directory specific[/code]

For any given image file, it first tries to find an entry for that specific file. If there is none it will try to find an entry for the directory where the file is contained. If that's not there either it will use the DefaultScale value (or 1 if it doesn't exist). Note that directory entries do '''not''' apply to sub-directories.

'''Custom interfaces and mods need their own mod.ini file.''' If they don't have this file it is assumed that it's an old interface/mod and the scale for the images it contains will default to 1. The file/folder paths are always relative to where the mod.ini file is located.

The scale value defines how many pixels of the image fit in 1 map/world unit (another way to think of it is how much bigger the image is compared to the old version). If you design an image for a specific resolution, you can '''calculate the scale valu'''e with a simple formula:

scale = resolution height / 480

That's because map units are 1:1 with pixels when using 640x480 resolution and the bigger the resolution, the more pixels a map unit will cover. The width of the resolution doesn't matter because it only affects the field of view.

== Gostek ==

The soldier is composed of a skeleton and a number of''' sprites that are hooked to specific skeleton points'''. That hook is defined by '''3 properties''':

[list]
[li]A point from the skeleton used for the sprite position.[/li]
[li]A reference point from the skeleton used for the rotation angle of the sprite.[/li]
[li]An anchor point (or center point) for the sprite.[/li]
[/list]

The '''[GOSTEK] section''' from mod.ini provides the ability to '''change the anchor point of each sprite''', which is the point from where the sprite is positioned and rotated in relation to the main skeleton hook point. This anchor point is expressed in normalized coordinates going from (0,0) to (1,1). Here is a visualization of how it works:

[[File:Mod.inMod.inii.png|200px|thumb|left|alt text]]

Most of the images in gostek-gfx/ and weapons-gfx/ have a flipped version with "2" or "-2" suffix. These flipped images should have the same size as the non-flipped one, otherwise the sprite alignment will be different when the soldier is looking to the left.

For now there is '''no way to setup different alignment values for the "team2" gostek '''graphics, so it's best to keep those with the same size and similar shape as main gostek graphics.

'''Attached is a list of all the soldier sprites that can be tweake'''d from the mod.ini file, along with the image file they are related to. The actual entry that goes in the [GOSTEK] section is the sprite name with a "_CenterX"/"_CenterY" suffix.
[u][size=12pt]
'''Online tool for editing and previewing the alignment values''':[/size][/u]
http://urraka.github.io/soldat-gostek/

You can '''drop a zip with gostek-gfx/ and weapons-gfx/ folders''' to load custom graphics. The soldier looks slightly different in this tool because it doesn't account for some skeleton modifications done by the game logic (like aiming), but it looks close enough to be helpful. A '''mod.ini file can be loaded/saved''' with the buttons on top of the table on the right.
The '''mod.ini file you save from there is [u]not[/u] intended to directly replace the one you have in soldat''', as it won't have any scale information.

Note: This tool hasn't been updated to load scale information from the mod.ini file. It still relies on the scale.ini file which was used during the alpha/beta versions of Soldat 1.7.0, so if you drop a zip with the graphics it should have a scale.ini file inside each directory.

File:Mod.inMod.inii.png

2016-02-25T00:13:56Z

Calp: [GOSTEK] section of Soldat/mod.ini file explained.

[GOSTEK] section of Soldat/mod.ini file explained.

Mod.ini

2016-02-25T00:12:50Z

Calp:

With Soldat 1.7.0 we introduced a new mod.ini file which controls how some things are displayed. There are two different sections in this file: [SCALE] and [GOSTEK].

==Scale==

The purpose of this section is to solve a problem that came along with the new HD rendering support: we needed to decouple pixel units from in-game map/world units. Without this, all new HD images would show up huge.

In this '''[SCALE] section''' you may have a '''DefaultScale''' entry and as many '''file/folder''' specific entries as needed. Here's an example:

[SCALE]
DefaultScale=4.5
interface-gfx/cursor.png=10 # file specific
interface-gfx=2 # directory specific[/code]

For any given image file, it first tries to find an entry for that specific file. If there is none it will try to find an entry for the directory where the file is contained. If that's not there either it will use the DefaultScale value (or 1 if it doesn't exist). Note that directory entries do '''not''' apply to sub-directories.

'''Custom interfaces and mods need their own mod.ini file.''' If they don't have this file it is assumed that it's an old interface/mod and the scale for the images it contains will default to 1. The file/folder paths are always relative to where the mod.ini file is located.

The scale value defines how many pixels of the image fit in 1 map/world unit (another way to think of it is how much bigger the image is compared to the old version). If you design an image for a specific resolution, you can '''calculate the scale valu'''e with a simple formula:

scale = resolution height / 480

That's because map units are 1:1 with pixels when using 640x480 resolution and the bigger the resolution, the more pixels a map unit will cover. The width of the resolution doesn't matter because it only affects the field of view.

== Gostek ==

The soldier is composed of a skeleton and a number of''' sprites that are hooked to specific skeleton points'''. That hook is defined by '''3 properties''':

[list]
[li]A point from the skeleton used for the sprite position.[/li]
[li]A reference point from the skeleton used for the rotation angle of the sprite.[/li]
[li]An anchor point (or center point) for the sprite.[/li]
[/list]

The '''[GOSTEK] section''' from mod.ini provides the ability to '''change the anchor point of each sprite''', which is the point from where the sprite is positioned and rotated in relation to the main skeleton hook point. This anchor point is expressed in normalized coordinates going from (0,0) to (1,1). Here is a visualization of how it works:

[[File:http://forums.soldat.pl/index.php?action=dlattach;topic=44266.0;attach=32521;image]]

Most of the images in gostek-gfx/ and weapons-gfx/ have a flipped version with "2" or "-2" suffix. These flipped images should have the same size as the non-flipped one, otherwise the sprite alignment will be different when the soldier is looking to the left.

For now there is '''no way to setup different alignment values for the "team2" gostek '''graphics, so it's best to keep those with the same size and similar shape as main gostek graphics.

'''Attached is a list of all the soldier sprites that can be tweake'''d from the mod.ini file, along with the image file they are related to. The actual entry that goes in the [GOSTEK] section is the sprite name with a "_CenterX"/"_CenterY" suffix.
[u][size=12pt]
'''Online tool for editing and previewing the alignment values''':[/size][/u]
http://urraka.github.io/soldat-gostek/

You can '''drop a zip with gostek-gfx/ and weapons-gfx/ folders''' to load custom graphics. The soldier looks slightly different in this tool because it doesn't account for some skeleton modifications done by the game logic (like aiming), but it looks close enough to be helpful. A '''mod.ini file can be loaded/saved''' with the buttons on top of the table on the right.
The '''mod.ini file you save from there is [u]not[/u] intended to directly replace the one you have in soldat''', as it won't have any scale information.

Note: This tool hasn't been updated to load scale information from the mod.ini file. It still relies on the scale.ini file which was used during the alpha/beta versions of Soldat 1.7.0, so if you drop a zip with the graphics it should have a scale.ini file inside each directory.

Mod.ini

2016-02-25T00:11:35Z

Calp: /* Scale */

With Soldat 1.7.0 we introduced a new mod.ini file which controls how some things are displayed. There are two different sections in this file: [SCALE] and [GOSTEK].

==Scale==

The purpose of this section is to solve a problem that came along with the new HD rendering support: we needed to decouple pixel units from in-game map/world units. Without this, all new HD images would show up huge.

In this '''[SCALE] section''' you may have a '''DefaultScale''' entry and as many '''file/folder''' specific entries as needed. Here's an example:

[SCALE]
DefaultScale=4.5
interface-gfx/cursor.png=10 # file specific
interface-gfx=2 # directory specific[/code]

For any given image file, it first tries to find an entry for that specific file. If there is none it will try to find an entry for the directory where the file is contained. If that's not there either it will use the DefaultScale value (or 1 if it doesn't exist). Note that directory entries do '''not''' apply to sub-directories.

'''Custom interfaces and mods need their own mod.ini file.''' If they don't have this file it is assumed that it's an old interface/mod and the scale for the images it contains will default to 1. The file/folder paths are always relative to where the mod.ini file is located.

The scale value defines how many pixels of the image fit in 1 map/world unit (another way to think of it is how much bigger the image is compared to the old version). If you design an image for a specific resolution, you can '''calculate the scale valu'''e with a simple formula:

scale = resolution height / 480

That's because map units are 1:1 with pixels when using 640x480 resolution and the bigger the resolution, the more pixels a map unit will cover. The width of the resolution doesn't matter because it only affects the field of view.

== Gostek ==

The soldier is composed of a skeleton and a number of''' sprites that are hooked to specific skeleton points'''. That hook is defined by '''3 properties''':

[list]
[li]A point from the skeleton used for the sprite position.[/li]
[li]A reference point from the skeleton used for the rotation angle of the sprite.[/li]
[li]An anchor point (or center point) for the sprite.[/li]
[/list]

The '''[GOSTEK] section''' from mod.ini provides the ability to '''change the anchor point of each sprite''', which is the point from where the sprite is positioned and rotated in relation to the main skeleton hook point. This anchor point is expressed in normalized coordinates going from (0,0) to (1,1). Here is a visualization of how it works:

[img width=586 height=586]http://forums.soldat.pl/index.php?action=dlattach;topic=44266.0;attach=32521;image[/img]

Most of the images in gostek-gfx/ and weapons-gfx/ have a flipped version with "2" or "-2" suffix. These flipped images should have the same size as the non-flipped one, otherwise the sprite alignment will be different when the soldier is looking to the left.

For now there is '''no way to setup different alignment values for the "team2" gostek '''graphics, so it's best to keep those with the same size and similar shape as main gostek graphics.

'''Attached is a list of all the soldier sprites that can be tweake'''d from the mod.ini file, along with the image file they are related to. The actual entry that goes in the [GOSTEK] section is the sprite name with a "_CenterX"/"_CenterY" suffix.
[u][size=12pt]
'''Online tool for editing and previewing the alignment values''':[/size][/u]
http://urraka.github.io/soldat-gostek/

You can '''drop a zip with gostek-gfx/ and weapons-gfx/ folders''' to load custom graphics. The soldier looks slightly different in this tool because it doesn't account for some skeleton modifications done by the game logic (like aiming), but it looks close enough to be helpful. A '''mod.ini file can be loaded/saved''' with the buttons on top of the table on the right.
The '''mod.ini file you save from there is [u]not[/u] intended to directly replace the one you have in soldat''', as it won't have any scale information.

Note: This tool hasn't been updated to load scale information from the mod.ini file. It still relies on the scale.ini file which was used during the alpha/beta versions of Soldat 1.7.0, so if you drop a zip with the graphics it should have a scale.ini file inside each directory.

Mod.ini

2016-02-25T00:11:05Z

Calp: /* /Scale */

With Soldat 1.7.0 we introduced a new mod.ini file which controls how some things are displayed. There are two different sections in this file: [SCALE] and [GOSTEK].

==Scale==

The purpose of this section is to solve a problem that came along with the new HD rendering support: we needed to decouple pixel units from in-game map/world units. Without this, all new HD images would show up huge.

In this '''[SCALE] section''' you may have a '''DefaultScale''' entry and as many '''file/folder''' specific entries as needed. Here's an example:

[SCALE]
DefaultScale=4.5
interface-gfx/cursor.png=10 # file specific
interface-gfx=2 # directory specific[/code]

For any given image file, it first tries to find an entry for that specific file. If there is none it will try to find an entry for the directory where the file is contained. If that's not there either it will use the DefaultScale value (or 1 if it doesn't exist). Note that directory entries do '''not''' apply to sub-directories.

'''Custom interfaces and mods need their own mod.ini file.''' If they don't have this file it is assumed that it's an old interface/mod and the scale for the images it contains will default to 1. The file/folder paths are always relative to where the mod.ini file is located.

The scale value defines how many pixels of the image fit in 1 map/world unit (another way to think of it is how much bigger the image is compared to the old version). If you design an image for a specific resolution, you can '''calculate the scale valu'''e with a simple formula:

[code]scale = resolution height / 480[/code]

That's because map units are 1:1 with pixels when using 640x480 resolution and the bigger the resolution, the more pixels a map unit will cover. The width of the resolution doesn't matter because it only affects the field of view.

== Gostek ==

The soldier is composed of a skeleton and a number of''' sprites that are hooked to specific skeleton points'''. That hook is defined by '''3 properties''':

[list]
[li]A point from the skeleton used for the sprite position.[/li]
[li]A reference point from the skeleton used for the rotation angle of the sprite.[/li]
[li]An anchor point (or center point) for the sprite.[/li]
[/list]

The '''[GOSTEK] section''' from mod.ini provides the ability to '''change the anchor point of each sprite''', which is the point from where the sprite is positioned and rotated in relation to the main skeleton hook point. This anchor point is expressed in normalized coordinates going from (0,0) to (1,1). Here is a visualization of how it works:

[img width=586 height=586]http://forums.soldat.pl/index.php?action=dlattach;topic=44266.0;attach=32521;image[/img]

Most of the images in gostek-gfx/ and weapons-gfx/ have a flipped version with "2" or "-2" suffix. These flipped images should have the same size as the non-flipped one, otherwise the sprite alignment will be different when the soldier is looking to the left.

For now there is '''no way to setup different alignment values for the "team2" gostek '''graphics, so it's best to keep those with the same size and similar shape as main gostek graphics.

'''Attached is a list of all the soldier sprites that can be tweake'''d from the mod.ini file, along with the image file they are related to. The actual entry that goes in the [GOSTEK] section is the sprite name with a "_CenterX"/"_CenterY" suffix.
[u][size=12pt]
'''Online tool for editing and previewing the alignment values''':[/size][/u]
http://urraka.github.io/soldat-gostek/

You can '''drop a zip with gostek-gfx/ and weapons-gfx/ folders''' to load custom graphics. The soldier looks slightly different in this tool because it doesn't account for some skeleton modifications done by the game logic (like aiming), but it looks close enough to be helpful. A '''mod.ini file can be loaded/saved''' with the buttons on top of the table on the right.
The '''mod.ini file you save from there is [u]not[/u] intended to directly replace the one you have in soldat''', as it won't have any scale information.

Note: This tool hasn't been updated to load scale information from the mod.ini file. It still relies on the scale.ini file which was used during the alpha/beta versions of Soldat 1.7.0, so if you drop a zip with the graphics it should have a scale.ini file inside each directory.

Mod.ini

2016-02-25T00:09:28Z

Calp: /* /Scale */

With Soldat 1.7.0 we introduced a new mod.ini file which controls how some things are displayed. There are two different sections in this file: [SCALE] and [GOSTEK].

==/Scale==

The purpose of this section is to solve a problem that came along with the new HD rendering support: we needed to decouple pixel units from in-game map/world units. Without this, all new HD images would show up huge.

In this '''[SCALE] section''' you may have a '''DefaultScale''' entry and as many '''file/folder''' specific entries as needed. Here's an example:

[code][SCALE]
DefaultScale=4.5
interface-gfx/cursor.png=10 # file specific
interface-gfx=2 # directory specific[/code]

For any given image file, it first tries to find an entry for that specific file. If there is none it will try to find an entry for the directory where the file is contained. If that's not there either it will use the DefaultScale value (or 1 if it doesn't exist). Note that directory entries do '''not''' apply to sub-directories.

'''Custom interfaces and mods need their own mod.ini file.''' If they don't have this file it is assumed that it's an old interface/mod and the scale for the images it contains will default to 1. The file/folder paths are always relative to where the mod.ini file is located.

The scale value defines how many pixels of the image fit in 1 map/world unit (another way to think of it is how much bigger the image is compared to the old version). If you design an image for a specific resolution, you can '''calculate the scale valu'''e with a simple formula:

[code]scale = resolution height / 480[/code]

That's because map units are 1:1 with pixels when using 640x480 resolution and the bigger the resolution, the more pixels a map unit will cover. The width of the resolution doesn't matter because it only affects the field of view.

== Gostek ==

The soldier is composed of a skeleton and a number of''' sprites that are hooked to specific skeleton points'''. That hook is defined by '''3 properties''':

[list]
[li]A point from the skeleton used for the sprite position.[/li]
[li]A reference point from the skeleton used for the rotation angle of the sprite.[/li]
[li]An anchor point (or center point) for the sprite.[/li]
[/list]

The '''[GOSTEK] section''' from mod.ini provides the ability to '''change the anchor point of each sprite''', which is the point from where the sprite is positioned and rotated in relation to the main skeleton hook point. This anchor point is expressed in normalized coordinates going from (0,0) to (1,1). Here is a visualization of how it works:

[img width=586 height=586]http://forums.soldat.pl/index.php?action=dlattach;topic=44266.0;attach=32521;image[/img]

Most of the images in gostek-gfx/ and weapons-gfx/ have a flipped version with "2" or "-2" suffix. These flipped images should have the same size as the non-flipped one, otherwise the sprite alignment will be different when the soldier is looking to the left.

For now there is '''no way to setup different alignment values for the "team2" gostek '''graphics, so it's best to keep those with the same size and similar shape as main gostek graphics.

'''Attached is a list of all the soldier sprites that can be tweake'''d from the mod.ini file, along with the image file they are related to. The actual entry that goes in the [GOSTEK] section is the sprite name with a "_CenterX"/"_CenterY" suffix.
[u][size=12pt]
'''Online tool for editing and previewing the alignment values''':[/size][/u]
http://urraka.github.io/soldat-gostek/

You can '''drop a zip with gostek-gfx/ and weapons-gfx/ folders''' to load custom graphics. The soldier looks slightly different in this tool because it doesn't account for some skeleton modifications done by the game logic (like aiming), but it looks close enough to be helpful. A '''mod.ini file can be loaded/saved''' with the buttons on top of the table on the right.
The '''mod.ini file you save from there is [u]not[/u] intended to directly replace the one you have in soldat''', as it won't have any scale information.

Note: This tool hasn't been updated to load scale information from the mod.ini file. It still relies on the scale.ini file which was used during the alpha/beta versions of Soldat 1.7.0, so if you drop a zip with the graphics it should have a scale.ini file inside each directory.

Mod.ini

2016-02-25T00:08:54Z

Calp: /* Scale */

With Soldat 1.7.0 we introduced a new mod.ini file which controls how some things are displayed. There are two different sections in this file: [SCALE] and [GOSTEK].

== /Scale ==

The purpose of this section is to solve a problem that came along with the new HD rendering support: we needed to decouple pixel units from in-game map/world units. Without this, all new HD images would show up huge.

In this '''[SCALE] section''' you may have a '''DefaultScale''' entry and as many '''file/folder''' specific entries as needed. Here's an example:

[code][SCALE]
DefaultScale=4.5
interface-gfx/cursor.png=10 # file specific
interface-gfx=2 # directory specific[/code]

For any given image file, it first tries to find an entry for that specific file. If there is none it will try to find an entry for the directory where the file is contained. If that's not there either it will use the DefaultScale value (or 1 if it doesn't exist). Note that directory entries do '''not''' apply to sub-directories.

'''Custom interfaces and mods need their own mod.ini file.''' If they don't have this file it is assumed that it's an old interface/mod and the scale for the images it contains will default to 1. The file/folder paths are always relative to where the mod.ini file is located.

The scale value defines how many pixels of the image fit in 1 map/world unit (another way to think of it is how much bigger the image is compared to the old version). If you design an image for a specific resolution, you can '''calculate the scale valu'''e with a simple formula:

[code]scale = resolution height / 480[/code]

That's because map units are 1:1 with pixels when using 640x480 resolution and the bigger the resolution, the more pixels a map unit will cover. The width of the resolution doesn't matter because it only affects the field of view.

== Gostek ==

The soldier is composed of a skeleton and a number of''' sprites that are hooked to specific skeleton points'''. That hook is defined by '''3 properties''':

[list]
[li]A point from the skeleton used for the sprite position.[/li]
[li]A reference point from the skeleton used for the rotation angle of the sprite.[/li]
[li]An anchor point (or center point) for the sprite.[/li]
[/list]

The '''[GOSTEK] section''' from mod.ini provides the ability to '''change the anchor point of each sprite''', which is the point from where the sprite is positioned and rotated in relation to the main skeleton hook point. This anchor point is expressed in normalized coordinates going from (0,0) to (1,1). Here is a visualization of how it works:

[img width=586 height=586]http://forums.soldat.pl/index.php?action=dlattach;topic=44266.0;attach=32521;image[/img]

Most of the images in gostek-gfx/ and weapons-gfx/ have a flipped version with "2" or "-2" suffix. These flipped images should have the same size as the non-flipped one, otherwise the sprite alignment will be different when the soldier is looking to the left.

For now there is '''no way to setup different alignment values for the "team2" gostek '''graphics, so it's best to keep those with the same size and similar shape as main gostek graphics.

'''Attached is a list of all the soldier sprites that can be tweake'''d from the mod.ini file, along with the image file they are related to. The actual entry that goes in the [GOSTEK] section is the sprite name with a "_CenterX"/"_CenterY" suffix.
[u][size=12pt]
'''Online tool for editing and previewing the alignment values''':[/size][/u]
http://urraka.github.io/soldat-gostek/

You can '''drop a zip with gostek-gfx/ and weapons-gfx/ folders''' to load custom graphics. The soldier looks slightly different in this tool because it doesn't account for some skeleton modifications done by the game logic (like aiming), but it looks close enough to be helpful. A '''mod.ini file can be loaded/saved''' with the buttons on top of the table on the right.
The '''mod.ini file you save from there is [u]not[/u] intended to directly replace the one you have in soldat''', as it won't have any scale information.

Note: This tool hasn't been updated to load scale information from the mod.ini file. It still relies on the scale.ini file which was used during the alpha/beta versions of Soldat 1.7.0, so if you drop a zip with the graphics it should have a scale.ini file inside each directory.

Mod.ini

2016-02-25T00:07:35Z

Calp:

With Soldat 1.7.0 we introduced a new mod.ini file which controls how some things are displayed. There are two different sections in this file: [SCALE] and [GOSTEK].

== Scale ==

The purpose of this section is to solve a problem that came along with the new HD rendering support: we needed to decouple pixel units from in-game map/world units. Without this, all new HD images would show up huge.

In this '''[SCALE] section''' you may have a '''DefaultScale''' entry and as many '''file/folder''' specific entries as needed. Here's an example:

[code][SCALE]
DefaultScale=4.5
interface-gfx/cursor.png=10 # file specific
interface-gfx=2 # directory specific[/code]

For any given image file, it first tries to find an entry for that specific file. If there is none it will try to find an entry for the directory where the file is contained. If that's not there either it will use the DefaultScale value (or 1 if it doesn't exist). Note that directory entries do '''not''' apply to sub-directories.

'''Custom interfaces and mods need their own mod.ini file.''' If they don't have this file it is assumed that it's an old interface/mod and the scale for the images it contains will default to 1. The file/folder paths are always relative to where the mod.ini file is located.

The scale value defines how many pixels of the image fit in 1 map/world unit (another way to think of it is how much bigger the image is compared to the old version). If you design an image for a specific resolution, you can '''calculate the scale valu'''e with a simple formula:

[code]scale = resolution height / 480[/code]

That's because map units are 1:1 with pixels when using 640x480 resolution and the bigger the resolution, the more pixels a map unit will cover. The width of the resolution doesn't matter because it only affects the field of view.

== Gostek ==

The soldier is composed of a skeleton and a number of''' sprites that are hooked to specific skeleton points'''. That hook is defined by '''3 properties''':

[list]
[li]A point from the skeleton used for the sprite position.[/li]
[li]A reference point from the skeleton used for the rotation angle of the sprite.[/li]
[li]An anchor point (or center point) for the sprite.[/li]
[/list]

The '''[GOSTEK] section''' from mod.ini provides the ability to '''change the anchor point of each sprite''', which is the point from where the sprite is positioned and rotated in relation to the main skeleton hook point. This anchor point is expressed in normalized coordinates going from (0,0) to (1,1). Here is a visualization of how it works:

[img width=586 height=586]http://forums.soldat.pl/index.php?action=dlattach;topic=44266.0;attach=32521;image[/img]

Most of the images in gostek-gfx/ and weapons-gfx/ have a flipped version with "2" or "-2" suffix. These flipped images should have the same size as the non-flipped one, otherwise the sprite alignment will be different when the soldier is looking to the left.

For now there is '''no way to setup different alignment values for the "team2" gostek '''graphics, so it's best to keep those with the same size and similar shape as main gostek graphics.

'''Attached is a list of all the soldier sprites that can be tweake'''d from the mod.ini file, along with the image file they are related to. The actual entry that goes in the [GOSTEK] section is the sprite name with a "_CenterX"/"_CenterY" suffix.
[u][size=12pt]
'''Online tool for editing and previewing the alignment values''':[/size][/u]
http://urraka.github.io/soldat-gostek/

You can '''drop a zip with gostek-gfx/ and weapons-gfx/ folders''' to load custom graphics. The soldier looks slightly different in this tool because it doesn't account for some skeleton modifications done by the game logic (like aiming), but it looks close enough to be helpful. A '''mod.ini file can be loaded/saved''' with the buttons on top of the table on the right.
The '''mod.ini file you save from there is [u]not[/u] intended to directly replace the one you have in soldat''', as it won't have any scale information.

Note: This tool hasn't been updated to load scale information from the mod.ini file. It still relies on the scale.ini file which was used during the alpha/beta versions of Soldat 1.7.0, so if you drop a zip with the graphics it should have a scale.ini file inside each directory.

Mod.ini

2016-02-25T00:05:03Z

Calp: Created page with "With Soldat 1.7.0 we introduced a new mod.ini file which controls how some things are displayed. There are two different sections in this file: [SCALE] and [GOSTEK]. [u][size..."

With Soldat 1.7.0 we introduced a new mod.ini file which controls how some things are displayed. There are two different sections in this file: [SCALE] and [GOSTEK].

[u][size=14pt][b]Scale[/b][/size][/u]

The purpose of this section is to solve a problem that came along with the new HD rendering support: we needed to decouple pixel units from in-game map/world units. Without this, all new HD images would show up huge.

In this [b][SCALE] section[/b] you may have a [b]DefaultScale[/b] entry and as many [b]file/folder[/b] specific entries as needed. Here's an example:

[code][SCALE]
DefaultScale=4.5
interface-gfx/cursor.png=10 # file specific
interface-gfx=2 # directory specific[/code]

For any given image file, it first tries to find an entry for that specific file. If there is none it will try to find an entry for the directory where the file is contained. If that's not there either it will use the DefaultScale value (or 1 if it doesn't exist). Note that directory entries do [b]not[/b] apply to sub-directories.

[b]Custom interfaces and mods need their own mod.ini file.[/b] If they don't have this file it is assumed that it's an old interface/mod and the scale for the images it contains will default to 1. The file/folder paths are always relative to where the mod.ini file is located.

The scale value defines how many pixels of the image fit in 1 map/world unit (another way to think of it is how much bigger the image is compared to the old version). If you design an image for a specific resolution, you can [b]calculate the scale valu[/b]e with a simple formula:

[code]scale = resolution height / 480[/code]

That's because map units are 1:1 with pixels when using 640x480 resolution and the bigger the resolution, the more pixels a map unit will cover. The width of the resolution doesn't matter because it only affects the field of view.

[u][b][size=14pt][b]Gostek[/b][/size][/b][/u]

The soldier is composed of a skeleton and a number of[b] sprites that are hooked to specific skeleton points[/b]. That hook is defined by [b]3 properties[/b]:

[list]
[li]A point from the skeleton used for the sprite position.[/li]
[li]A reference point from the skeleton used for the rotation angle of the sprite.[/li]
[li]An anchor point (or center point) for the sprite.[/li]
[/list]

The [b][GOSTEK] section[/b] from mod.ini provides the ability to [b]change the anchor point of each sprite[/b], which is the point from where the sprite is positioned and rotated in relation to the main skeleton hook point. This anchor point is expressed in normalized coordinates going from (0,0) to (1,1). Here is a visualization of how it works:

[img width=586 height=586]http://forums.soldat.pl/index.php?action=dlattach;topic=44266.0;attach=32521;image[/img]

Most of the images in gostek-gfx/ and weapons-gfx/ have a flipped version with "2" or "-2" suffix. These flipped images should have the same size as the non-flipped one, otherwise the sprite alignment will be different when the soldier is looking to the left.

For now there is [b]no way to setup different alignment values for the "team2" gostek [/b]graphics, so it's best to keep those with the same size and similar shape as main gostek graphics.

[b]Attached is a list of all the soldier sprites that can be tweake[/b]d from the mod.ini file, along with the image file they are related to. The actual entry that goes in the [GOSTEK] section is the sprite name with a "_CenterX"/"_CenterY" suffix.
[u][size=12pt]
[b]Online tool for editing and previewing the alignment values[/b]:[/size][/u]
http://urraka.github.io/soldat-gostek/

You can [b]drop a zip with gostek-gfx/ and weapons-gfx/ folders[/b] to load custom graphics. The soldier looks slightly different in this tool because it doesn't account for some skeleton modifications done by the game logic (like aiming), but it looks close enough to be helpful. A [b]mod.ini file can be loaded/saved[/b] with the buttons on top of the table on the right.
The [b]mod.ini file you save from there is [u]not[/u] intended to directly replace the one you have in soldat[/b], as it won't have any scale information.

Note: This tool hasn't been updated to load scale information from the mod.ini file. It still relies on the scale.ini file which was used during the alpha/beta versions of Soldat 1.7.0, so if you drop a zip with the graphics it should have a scale.ini file inside each directory.

Main Page

2016-02-25T00:04:46Z

Calp: /* Tutorials */

{| style="color:black; background-color:#ffcccc;" cellpadding="10" class="wikitable"
|The old Soldat Devs wiki has become plagued with spam and other problems. We are working on migrating all content to this new wiki, but you can find the old content at http://devs-old.soldat.pl for now. Please feel free to register and copy pages over! We need all the help we can get.
|}
__NOTOC__
== Welcome to the Soldat Wiki ==

Here you'll find reference to most of the common topics discussed in the [irc://irc.quakenet.org/#soldat.devs channel] and [http://forums.soldat.pl Forum]. If you found bugs or have suggestions please contact us on [irc://irc.quakenet.org/#soldat.devs #soldat.devs at QuakeNet]. Latest information about Soldat can be always found at the [http://forums.soldat.pl Official Soldat Forum]. This wiki is intended as a location for the more specific and more technical knowledge about Soldat, including running Servers, writing Scripts or checking Tutorials about every aspect of game.

{| width=100%
| style="width: 50%; vertical-align: top" |

===Server General===
*[[Server|Introduction]]
*[[Server Configuration]]
*[[Commands|Commands Reference]]
*[[Logging|Logging]]
*[[BattlEye|BattlEye Anti-Cheat Engine]]

===Server Scripting===
*[[Scripting_basics|Introduction]]
*[[Server Scripting]]
*[[Script Core 3]]
*[[Scripts Database]]

===General Technical Information===
*[[Ports|About Ports, Protocols and Forwarding]]
*[[Testing your connectivity|Testing Your Connectivity]]
*[[Refresh|Using the REFRESH Packet]]
*[[Refreshx|Using the REFRESHX (eXtended) Packet]]
*[[Raw_commands|RAW Commands]]
*[[Command line arguments|Command Line Arguments]]
*[[Map|Map File Structure]]
*[[Download_thread|Map/Files Downloading]]
*[[Lobby Protocol]]
*[[Bandwidth|About Bandwidth]]

| style="width: 50%; vertical-align: top" |

===Soldat General===
*[[Soldat|Introduction]]
*[[Soldat History]]
*[[Soldat Community]]
*[[Version History]]

=== Tutorials ===
*[[First Server|Your First Server - Know How]]
*[[Mapping Tutorial|First steps in Polyworks]]
*[[Advanced Mapping Tutorial|Advanced Mapping Tutorial]]
*[[Map Sceneries|All Basic Information about sceneries]]
*[[Map Waypoints|Basic Information about Waypoints]]
*[[Mod.ini|Modding information on how to use the mod.ini file]]

=== Game and Gameplay ===
*[[Game Settings|Information about Soldat configuration]]
*[[Ingame Settings| Information about Ingame options]]
*[[Lobby Overview| Lobby Overview]]
*[[Profiles and Taunts| Information about Profiles and Taunts]]
*[[Game Types| Types of Games in Soldat]]
|}