Nightly Builds: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Create nightly builds page (broken syntax atm))
 
(Update things a bit more)
Line 1: Line 1:
#summary Instructions on how to run the latest nightly developer build
__NOTOC__
<table>
{{Note_box|If you already know what you're doing, you can just [https://nightly.mtasa.com get the '''nightly installer''' you want from here].}}
<tr>
<td width="48%" valign="top" cellspacing=10>
= Introduction =
= Introduction =
Nightly builds are experimental builds and thus do not work straight out-of-the-box, as they exclude a few files that rarely change but are necessary to work. This is because of size and bandwidth issues, and the fact that they are meant as incremental updates for those that already have the necessary files installed.
Nightly builds are experimental builds and thus do not work straight out-of-the-box, as they exclude a few files that rarely change but are necessary to work. This is because of size and bandwidth issues, and the fact that they are meant as incremental updates for those that already have the necessary files installed.


Please bear in mind that these builds are developer builds and will be
Please bear in mind that these builds are developer builds and will be
unstable. For a list of changes for each revision, head over to our
unstable. For a list of changes for each revision, head over to our [https://buildinfo.mtasa.com buildinfo page] for a commit breakdown of each build.
project page for more information.
 
Our automated build server takes care of building (and subsequently uploading) the latest revision. The current status of our automated builds can be seen in the widget to the right. The integration build starts at certain intervals during the day to check for build errors while the nightly build is built at 23:00 (GMT/DST).
 
</td>
<td width="4%"></td>
<td width="48%" valign="top" cellspacing=10>
= Already know how to get Nightly builds running? =
If you know what you're doing, you can get the files you need from here:
 
*[http://code.google.com/p/multitheftauto/downloads/list Go to the Google Code download page]* _for data, and files required to build locally_
 
[http://code.google.com/p/mtasa-resources/downloads/list Go to the resources download page] _for the latest resource packages_
 
[http://nightly.multitheftauto.com/ Go to the nightly builds] _for the latest MTA nightly build_
 
<wiki:gadget url="http://www.mtasa.com/gadget/nightly.xml" height="150" width="610" border="0" />
</td>


</tr>
Our automated build server takes care of building (and subsequently uploading) the latest commit. The integration build starts at certain intervals during the day to check for build errors while the nightly build is built at 23:00 (GMT/DST).
</table>


= Setting up nightly builds =
= Setting up nightly builds =
Nightly builds are designed in a manner in which minimal updates are required in order to install a new nightly.  This however means that you *must* first follow some specific steps to get your nightly build working.
Nightly builds are designed in a manner in which minimal updates are required in order to install a new nightly.  This however means that you *must* first follow some specific steps to get your nightly build working.


=== Step 1: Download the latest nightly build ===
=== Download the latest nightly build "full installer" ===
First off you should download the latest available nightly build.
First off you should download the latest available nightly build. For Windows, two different installers are available: a nightly installer and a full installer.
  * You should pick the nightly with the *highest revision number*.
  * You can find all available nightly builds here: * http://nightly.multitheftauto.com/ *
  * Run the installer


=== Step 2: Download the run dependencies ===
* Nightly installer: a minimal installer that excludes data files that rarely change and the resources package
You must also download and install run dependencies.  These are files which are required by MTA to run, but usually do not change and therefore are not included in the nightly build.
* Full installer: the full installer that includes the data files and resource package
  * You can find the latest available data archive *[http://code.google.com/p/mtasa-blue/downloads/list?q=label:Data here.]*
  * Run the installer, ensuring it correctly points to your MTA: San Andreas installation directory.


_Run dependencies rarely need to be updated. If your build starts malfunctioning for any reason it may be because you need to update your dependencies.  They are updated whenever needed._
These data files are dependencies that rarely need to be updated. If your build starts malfunctioning for any reason it may be because you need to update your dependencies.  They are updated whenever needed. Just run the full installer and install it to the correct folder.


=== Step 3: Download the latest resources ===
=== Download the latest resources ===
The latest resources are also available.   These components are only required if you wish to run a server or the map editor.  Default resources from previous versions of MTASA are outdated, and will not function.
The latest resources are also available, you probably don't need this when you're using the full installer. These components are only required if you wish to run a server or the map editor.  Default resources from previous versions of MTASA are outdated, and will not function.
   * You should pick the resource archive with the *highest revision number*.
   * You should pick the resource archive with the *highest revision number*.
   * You can find the latest available resources *[http://code.google.com/p/mtasa-resources/downloads/list here]*.
   * You can find the latest available resources *[https://mirror.mtasa.com/mtasa/resources/ here]*.
   * The contents of the archive should be placed inside your *MTA San Andreas\server\mods\deathmatch\resources* directory. You will need to create a resources directory if you do not already have one.
   * The contents of the archive should be placed inside your *MTA San Andreas\server\mods\deathmatch\resources* directory. You will need to create a resources directory if you do not already have one.


_Resources should also be updated fairly frequently.  They are built at 2300GMT, depending on changes that are made during that day.  You should always ensure you always have the latest resourecs package._
Resources should also be updated fairly frequently.  They are built at 2300GMT, depending on changes that are made during that day.  You should always ensure you always have the latest resourecs package.


=== Optional: Download DirectX ===  
=== Optional: Download DirectX ===  
Line 59: Line 32:


=== Step 4: Start the game ===
=== Step 4: Start the game ===
You have now installed all the components required to run a nightly build. You should now be able to run both the client and the server, or join any servers that may be available.
You have now installed all the components required to run a nightly build. You should now be able to run both the client and the server, or join any servers that may be available.


Bugs, suggestions or feedback can go in either our forums or the bugtracker
Bugs, suggestions or feedback can go in either our forums or the bugtracker
   * http://forum.multitheftauto.com
   * https://forum.multitheftauto.com
   * http://bugs.multitheftauto.com
   * https://bugs.multitheftauto.com


For general scripting or server setup help, please refer to our [http://wiki.multitheftauto.com wiki]:
For general scripting or server setup help, please refer to:
   * [http://wiki.multitheftauto.com/wiki/Deathmatch_Client_Manual Client Manual]
   * [https://wiki.multitheftauto.com/index.php?title=Deathmatch_Client_Manual Client Manual]
   * [http://wiki.multitheftauto.com/wiki/Deathmatch_Server_Manual Server Manual]
   * [https://wiki.multitheftauto.com/index.php?title=Deathmatch_Server_Manual Server Manual]
   * [http://wiki.multitheftauto.com/wiki/Admin Setting up admin on your server]
   * [https://wiki.multitheftauto.com/index.php?title=Admin Setting up admin on your server]

Revision as of 21:41, 22 August 2015

This template is no longer in use as it results in poor readability.

Introduction

Nightly builds are experimental builds and thus do not work straight out-of-the-box, as they exclude a few files that rarely change but are necessary to work. This is because of size and bandwidth issues, and the fact that they are meant as incremental updates for those that already have the necessary files installed.

Please bear in mind that these builds are developer builds and will be unstable. For a list of changes for each revision, head over to our buildinfo page for a commit breakdown of each build.

Our automated build server takes care of building (and subsequently uploading) the latest commit. The integration build starts at certain intervals during the day to check for build errors while the nightly build is built at 23:00 (GMT/DST).

Setting up nightly builds

Nightly builds are designed in a manner in which minimal updates are required in order to install a new nightly. This however means that you *must* first follow some specific steps to get your nightly build working.

Download the latest nightly build "full installer"

First off you should download the latest available nightly build. For Windows, two different installers are available: a nightly installer and a full installer.

  • Nightly installer: a minimal installer that excludes data files that rarely change and the resources package
  • Full installer: the full installer that includes the data files and resource package

These data files are dependencies that rarely need to be updated. If your build starts malfunctioning for any reason it may be because you need to update your dependencies. They are updated whenever needed. Just run the full installer and install it to the correct folder.

Download the latest resources

The latest resources are also available, you probably don't need this when you're using the full installer. These components are only required if you wish to run a server or the map editor. Default resources from previous versions of MTASA are outdated, and will not function.

 * You should pick the resource archive with the *highest revision number*.
 * You can find the latest available resources *here*.
 * The contents of the archive should be placed inside your *MTA San Andreas\server\mods\deathmatch\resources* directory. You will need to create a resources directory if you do not already have one.

Resources should also be updated fairly frequently. They are built at 2300GMT, depending on changes that are made during that day. You should always ensure you always have the latest resourecs package.

Optional: Download DirectX

You need DirectX (March 2009) installed. If you haven't updated DirectX since then, install this - it only takes a minute or so.

Step 4: Start the game

You have now installed all the components required to run a nightly build. You should now be able to run both the client and the server, or join any servers that may be available.

Bugs, suggestions or feedback can go in either our forums or the bugtracker

 * https://forum.multitheftauto.com
 * https://bugs.multitheftauto.com

For general scripting or server setup help, please refer to:

 * Client Manual
 * Server Manual
 * Setting up admin on your server