Unvanquished - User contributions [en-gb]

Making an awesome mod

2021-03-21T14:32:42Z

Gireen: Created page with "= Build the game = We start with an idea, like having grangers shoot rockets made out of cake. Apply the changes and Compiling the source Depending on the changes we ne..."

= Build the game =
We start with an idea, like having grangers shoot rockets made out of cake.

Apply the changes and [[Compiling the source]]

Depending on the changes we need to build the client and server vms (cgame and sgame).

= Package Manually =
After building the game we have following needed files in the build folder
cgame-x86.nexe
cgame-x86_64.nexe
sgame-x86.nexe
sgame-x86_64.nexe

cgame-x86_64-stripped.nexe
cgame-x86-stripped.nexe
sgame-x86_64-stripped.nexe
sgame-x86-stripped.nexe

Copy one of the sets and remove -stripped from the names if there.

Now create a text file named DEPS witch contains
unvanquished
and place it in the same folder as your .nexe files

You can now place other assets in that folder to overwrite any original files.

Keep the folder structure in mind. See the original assets for that
unvanquished_src.dpkdir https://github.com/UnvanquishedAssets/unvanquished_src.dpkdir
res-ambient_src.dpkdir https://github.com/UnvanquishedAssets/res-ambient_src.dpkdir
res-buildables_src.dpkdir https://github.com/UnvanquishedAssets/res-buildables_src.dpkdir
res-legacy_src.dpkdir https://github.com/UnvanquishedAssets/res-legacy_src.dpkdir
res-players_src.dpkdir https://github.com/UnvanquishedAssets/res-players_src.dpkdir
res-soundtrack_src.dpkdir https://github.com/UnvanquishedAssets/res-soundtrack_src.dpkdir
res-voices_src.dpkdir https://github.com/UnvanquishedAssets/res-voices_src.dpkdir
res-weapons_src.dpkdir https://github.com/UnvanquishedAssets/res-weapons_src.dpkdir

Now zip the folder and rename it to
mod-superawesomemod_0.0.1.dpk
more naming infos at the [[Packaging Version Guidelines]]

= Run a Mod =

Place your mod now into the pak folder

And when starting the game or server you use following command
./daemon -set fs_extrapaks superawesomemod

Server/Map rotation

2019-11-04T21:44:22Z

Gireen: /* Basic Format */

maprotation.cfg holds a [[Server/Running|server's]] default map rotation.

= Basic Format =

This list will indefinitely loop

maprotation1 {
atcs
tremor
niveus {
//execute console commands on mapstart
cp "Impotant Message for everyone"
}
karith {
//load the map with one of the layouts
layouts myfavoritelayout mysecondfavoritelayout
}
}

= Advanced Logic =

#label

Labels are used as location markers. They can bee 'seeked' to using a goto statement:

goto #label

For more advanced logic IF statements can be used.
if STATEMENT then ACTION

Where STATEMENT is one of:
* numClients ( > or < or = ) (number)
* lastwin (aliens or humans)
* random

...and ACTION is either a map or label to goto.

Example:

tremor

#mainloop
if numClients > 8 lightning
if numClients < 4 nano
psuedopolis
ankh-morpork

if lastwin humans #mainloop
humanmurder

= Misc Notes =
* If you want to reverse a 'goto', use 'return'
* 'goto' can go to a label in another rotation, and 'resume' will return to the last rotation.

Main Page

2014-11-23T17:25:02Z

Gireen: works again

* If you need help with anything, jump onto the [[IRC]] or the [https://www.unvanquished.net/forum forums].
* Build the wiki! Contribute guides, information, corrections and improvements.

<div class="mainPageNewBox">

<h2> [[Basics]] </h2>
* Installation
* Bug-reporting
* Weekly gaming events
* Getting help

</div>

<div class="mainPageNewBox">

<h2> [[Lore]] </h2>
* Weapons, buildings, alien classes
* Guides and tactics
* User-contributed stories
* History

</div>

<div class="mainPageNewBox">

<h2> [[Configuration]] </h2>
* Variables and cvars
* Text colours
* Server administration
* Runtime parameters

</div>

<div class="mainPageNewBox">

<h2> [[Making and modding]] </h2>
* Mapping
* Sound and music
* Modelling
* Texturing
* Translation
* Gameplay modification

</div>

<div class="mainPageNewBox">

<h2> [[Coding]] </h2>
* Source code
** Getting the source
** Compiling from source
* Guides
** How to contribute
** Coding conventions
* Reference materials

</div>
<div class="mainPageNewBox">

<h2> [[Projects|Tools and projects]] </h2>
* Unv. specific tools
* Stikked
* Wiki project
* Unv. around the web

</div>

<div style="clear: both;"></div>

<div style="text-align: center;">{{NUMBEROFEDITS}} edits to {{NUMBEROFPAGES}} pages with {{NUMBEROFFILES}} uploaded files</div>

<div style="height: 150px; width: 100%; overflow:hidden; align:centre;">

[[File:Dir inpackage.png|x150px]][[File:Egg concept.png|x150px]] [[File:Om concept.png|x150px]] [[File:Librocket test custom menuscreen.png|x150px]] [[File:Netrad common.png|x150px]] [[File:Colourgrade_2.png|x150px]] [[File:Parpax upper.png|x150px]] [[File:Niveus brushesSelected.jpeg|x150px]] [[File:Mgturret render 300x240.png|x150px]] [[File:Barricade.png|x150px]]

</div>

__NOTOC__

UI/Wish list

2014-04-10T17:36:16Z

Gireen:

*onsubmit function to combinde all values except with ignore attribute, [https://github.com/Unvanquished/Unvanquished/blob/da0088f10243b012b23b2fa320b78fba38a4231c/main/ui/dialogs/editplayer.rml usage example]
* [http://www.w3schools.com/cssref/sel_before.asp :before] and [http://www.w3schools.com/cssref/sel_after.asp :after] Selector with [http://www.w3schools.com/cssref/pr_gen_content.asp content] property for rss
*if tag
<if cvar="name" is con="bob">
display this only when cvar name = bob
</if>

<if cvar="name" not ccvar="anothercvar">
display this only when value of name and anothercvar ar not the same
</if>

other attributes could be bigger and smaller to comare numbers
*reload menu and keep focus(scroll position)
=Data Sources=
*map rotation with mapname and image
*maplog with mapname, image, time, winning team/mapvote/defeat/timelimit
or
*map rotation and maplog combined to one data source showing: last 3, current and next 3 maps

UI/Wish list

2014-04-03T20:08:58Z

Gireen: Created page with "*onsubmit function to combinde all values except with ignore attribute, [https://github.com/Unvanquished/Unvanquished/blob/da0088f10243b012b23b2fa320b78fba38a4231c/main/ui/dia..."

*onsubmit function to combinde all values except with ignore attribute, [https://github.com/Unvanquished/Unvanquished/blob/da0088f10243b012b23b2fa320b78fba38a4231c/main/ui/dialogs/editplayer.rml usage example]
*if tag
<if cvar="name" is con="bob">
display this only when cvar name = bob
</if>

<if cvar="name" not ccvar="anothercvar">
display this only when value of name and anothercvar ar not the same
</if>

other attributes could be bigger and smaller to comare numbers
*reload menu and keep focus(scroll position)
=Data Sources=
*map rotation with mapname and image
*maplog with mapname, image, time, winning team/mapvote/defeat/timelimit

Tools/Blender

2013-05-20T14:58:57Z

Gireen: /* Import/Export */

[[Category:Modeling]]
Blender is a very large and complex piece of software. For working on Unvanquished, we suggest using the latest version. If you are still using 2.4 because you are comfortable with its GUI, make the switch! There are too many new features to take advantage of not to, and it will be easier to work with other artists on the team if you do.

==Organizing Large Files==

===Vertex Groups===

<ul>
<li>Keep your vertex groups organized by name. If there are too many vertex groups to do this by hand, open a python console and use the following command at the prompt after selecting the object whose vertex group names are to be sorted:
<pre>
>>> bpy.ops.object.vertex_group_sort()
</pre>
</li>
<li>Do not create vertex groups for bones that are not intended to deform the mesh.</li>
<li>When parenting an armature to a mesh, '''do not''' select "With Automatic Weights". This may save you the time of creating vertex groups, but you will likely have groups that you do not want, such as for pose bones (i.e., those that manipulate other bones indirectly with constraints but are not intended to deform the mesh), or will assign too many vertex weights to vertices. (The daemon engine, for performance reasons, only supports four weights per vertex.)
</ul>

===Naming Conventions for Objects===

Name objects using a period-delimited (<code>.</code>) hierarchy. Generally speaking, name datablocks with the same name as the object but with a <code>.d</code> suffix to distinguish them from objects.

For example:

* Leg.Upper.Left
* Leg.Upper.Right
* Leg.Lower.Left
* Leg.Lower.Right

You are free to organize this hierarchy however you see fit, but please be consistent.

In some instances, using the suffixes <code>_L</code> and <code>_R</code> instead of <code>.Left</code> and <code>.Right</code> may be necessary for certain features to work. This is also acceptable.

===Managing Textures===

Place all textures in a subdirectory named "Textures". Ensure that your file paths in Blender use the matching case so that users on case-sensitive filesystems will not have problems.

Use [[#relative|relative file paths]] for textures, and the following naming convention:

<span style="color:#74B6C7;">Name</span>_<span style="color:#CAB527;">TextureType</span>[_<span style="color:#CA274D;">AlternateResolution</span>].<span style="color:#79D263">format</span>

<ul>
<li>'''Name''' — (Required) The name of the model. If the model is a character class or weapon, use that name.</li>
<li>'''TextureType''' — (Required) A name indicating the type of information the texture contains. Please use one of the following:
{| class="wikitable"
! <var>TextureType</var>
! Description
|-
| <code>Alpha</code>
| An alpha map.
|-
| <code>Diffuse</code>
| The diffuse (albedo) color.
|-
| <code>DiffuseAlpha</code>
| A diffuse map with an alpha channel.
|-
| <code>Glow</code>
| A glow map.
|-
| <code>Normal</code>
| A normal map.
|-
| <code>SpecValue</code>
| A specular color map.
|-
| <code>SpecHilight</code>
| A specular hilight map.
|-
|}
</li>
<li>'''AlternateResolution''' — (Optional) The resolution of the texture in the form <span style="color:#74B6C7;">Width</span>x<span style="color:#CAB527;">Height</span>. Only include the resolution of the texture in the name if there are multiple resolutions to choose from.
<li>'''format''' — (Required) The format of the image. For JPEG images, the <code>jpg</code> extension is preferred over <code>jpeg</code> for consistency.</li>
</ul>

====Do's and Don'ts====

* '''Don't''' create a diffuse texture without appending <code>_Diffuse</code> to the name.
* '''Don't''' create a stand-alone alpha map that is not in greyscale; if you create a stand-alone alpha map with an alpha channel containing alpha, the filesize will only be larger (if only slightly).

==Tips and Tricks==

<ul>
<li>The desired playback framerate can be set under Properties → Render → Dimensions → Frame Rate.</li>
<li>{{Anchor|relative}}When sharing work between computers, use relative filepaths. Start a pathname with "//" and Blender looks starting relative to the folder that the .blend file is in.</li>
</ul>

==Troubleshooting==

===White marks are visible around the edges of alpha-mapped textures===

Enable "Premultiply Alpha".

==Python Scripting==

Please see the [[Blender Python Scripting|full article]].

==Extensions==

===Blender 2.4===

* [http://wiki.blender.org/index.php/Extensions:2.4/Py/Scripts/249_Extensions A collection of Blender 2.4 extensions]

===Blender 2.5/2.6===

* [http://wiki.blender.org/index.php/Extensions:2.6/Py/Scripts 2.6 scripts catalog]

Note that the Blender Python API is constantly in flux, so these may or may not work with newer versions of Blender than they were written for.

====Import/Export====

{| class="wikitable sortable"
|-
! Purpose
! Format
! Last updated
! Known to work with
! Link
! Notes
|-
| Export
| MD5
| class="none" | Unknown
| class="nowrap" | 2.59 (partially)
| class="nowrap" | [http://www.katsbits.com/smforum/index.php?topic=178.0 katsbits.com]
| <span style="color:#f00;">Warning: this exporter does not work with newer versions of Blender, and never worked very well to begin with!</span> There is a newer exporter that you should use instead. Please see the [[Exporting_Models#Acquiring_and_installing_the_exporter|exporting guide]] for more information.
|-
| Import
| MD5
| class="none" | Unknown
| class="none" | Unknown
| class="nowrap" | [http://www.katsbits.com/smforum/index.php?topic=358.0 katsbits.com]
| None.
|-
| Export
| MD3
| class="none" | Unknown
| class="none" | Unknown
| class="nowrap" | [http://sourceforge.net/projects/md3exporter/ xembie.com]
| None.
|-
|}

==Resources==

* Modeling
* Rigging
* Unwrapping/Texturing
** [http://www.katsbits.com/tutorials/blender/baking-normal-maps-from-models.php Baking normal maps]
* Blender Python API Docs
** Release Notes
*** [http://wiki.blender.org/index.php/Dev:Ref/Release_Notes/2.62/Python Blender 2.62 Python Release Notes]
*** [http://wiki.blender.org/index.php/Dev:Ref/Release_Notes/2.61/Python Blender 2.61 Python Release Notes]
*** [http://wiki.blender.org/index.php/Dev:Ref/Release_Notes/2.60/Python Blender 2.60 Python Release Notes]
** API reference
*** [http://www.blender.org/documentation/blender_python_api_2_66_release/ API reference for Blender 2.66.0] (nothing changed in this release)
*** [http://www.blender.org/documentation/blender_python_api_2_65_3/ API reference for Blender 2.65.3] ([http://www.blender.org/documentation/blender_python_api_2_65_3/change_log.html#to-2-65 changelog])
*** [http://www.blender.org/documentation/blender_python_api_2_64_5/ API reference for Blender 2.64.5] ([http://www.blender.org/documentation/blender_python_api_2_64_5/change_log.html#to-2-64 changelog])
*** [http://www.blender.org/documentation/blender_python_api_2_63_7/ API reference for Blender 2.63.7] ([http://www.blender.org/documentation/blender_python_api_2_63_7/change_log.html#to-2-63 changelog])
*** [http://www.blender.org/documentation/blender_python_api_2_62_1/ API reference for Blender 2.62.1] ([http://www.blender.org/documentation/blender_python_api_2_62_1/change_log.html#to-2-62 changelog])
*** [http://www.blender.org/documentation/blender_python_api_2_61_0/ API reference for Blender 2.61.0] ([http://www.blender.org/documentation/blender_python_api_2_61_0/change_log.html#to-2-61 changelog])
*** [http://www.blender.org/documentation/blender_python_api_2_59_0/ API reference for Blender 2.59.0] ([http://www.blender.org/documentation/blender_python_api_2_59_0/change_log.html#to-2-59 changelog])
** [http://wiki.blender.org/index.php/Dev:2.5/Py/Scripts/Cookbook/Code_snippets Code snippets]
** [http://wiki.blender.org/index.php/User:Kilon/Python_book_of_magic A user's collection of code snippets]