Nightly Builds: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Create nightly builds page (broken syntax atm))
 
m (tweak newline)
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
#summary Instructions on how to run the latest nightly developer build
__NOTOC__ {{Note|If you already know what you're doing, you can just [https://nightly.mtasa.com get the '''nightly installer''' you want from here].}}
<table>
<tr>
<td width="48%" valign="top" cellspacing=10>
= 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 '''unstable''' builds intended for developers or early birds that would like to test out new features and bugfixes.


Please bear in mind that these builds are developer builds and will be
For a list of changes for each revision, head over to our [https://buildinfo.mtasa.com buildinfo page] — each revision is broken down into individual commits.
unstable. For a list of changes for each revision, head over to our
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).
Our automated build server takes care of building and deploying 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). -->


</td>
== How you can help ==
<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_
You can help the MTA team by communicating with us [https://mtasa.com on Discord].


[http://code.google.com/p/mtasa-resources/downloads/list Go to the resources download page] _for the latest resource packages_
* '''Bugs and crashes''': please share any bugs and crashes you find [https://github.com/multitheftauto/mtasa-blue/issues/new/choose on GitHub]
** Scripters — please try to narrow down the problem to a small script. Sharing these resources on GitHub Issues helps us reproduce and fix your problem.
* '''Suggestions''':  Bugs, suggestions or feedback can go in either [https://forum.mtasa.com our forums] or GitHub Issues


[http://nightly.multitheftauto.com/ Go to the nightly builds] _for the latest MTA nightly build_
For general scripting or server setup help, please refer to:
* [[Client Manual]]
* [[Server Manual]]
* [[admin|Setting up admin on your server]]


<wiki:gadget url="http://www.mtasa.com/gadget/nightly.xml" height="150" width="610" border="0" />
== Get nightly updates ==
</td>


</tr>
=== Automatic ===
</table>


= Setting up nightly builds =
Users on the automatic "nightly" release stream are sent new builds at most once a day, but ''not'' every day.
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 ===
# Make sure you have MTA installed. This can be a regular release version.
First off you should download the latest available nightly build.
# Open MTA and navigate to "Settings -> Advanced"
  * You should pick the nightly with the *highest revision number*.
# Change build stream from "Default" to "Nightly"
  * You can find all available nightly builds here: * http://nightly.multitheftauto.com/ *
  * Run the installer


=== Step 2: Download the run dependencies ===
==== Download the latest resources ====
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.
  * 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._
The auto-updater does not update server ''resources''. These components are only required if you wish to run a server or the map editor.


=== Step 3: Download the latest resources ===
These resources may use features only available in nightlies. Default resources from previous versions of MTASA are outdated, and may not function.
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.
  * 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]*.
  * 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._
* You should pick the resource archive with the '''highest revision number'''.
* 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.


=== Optional: Download DirectX ===
These resources will update at most once every day. Ensure that you always have the latest resources package.
You need DirectX (March 2009) installed. If you haven't updated DirectX since then, install [http://www.microsoft.com/downloads/details.aspx?FamilyId=2DA43D38-DB71-4C1B-BC6A-9B6652CD92A3&displaylang=en this] - it only takes a minute or so.


=== Step 4: Start the game ===
=== Manual ===
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
You can download any nightly installer from [https://nightly.mtasa.com nightly.mtasa.com]. Just download and run the installer. These usually update once a day at 2AM GMT.
  * http://forum.multitheftauto.com
  * http://bugs.multitheftauto.com
 
For general scripting or server setup help, please refer to our [http://wiki.multitheftauto.com wiki]:
  * [http://wiki.multitheftauto.com/wiki/Deathmatch_Client_Manual Client Manual]
  * [http://wiki.multitheftauto.com/index.php?title=Deathmatch_Server_Manual Server Manual]
  * [http://wiki.multitheftauto.com/wiki/Admin Setting up admin on your server]

Latest revision as of 08:30, 7 September 2019

[[{{{image}}}|link=|]] Note: If you already know what you're doing, you can just get the nightly installer you want from here.

Nightly builds are experimental unstable builds intended for developers or early birds that would like to test out new features and bugfixes.

For a list of changes for each revision, head over to our buildinfo page — each revision is broken down into individual commits.

Our automated build server takes care of building and deploying the latest commit.

How you can help

You can help the MTA team by communicating with us on Discord.

  • Bugs and crashes: please share any bugs and crashes you find on GitHub
    • Scripters — please try to narrow down the problem to a small script. Sharing these resources on GitHub Issues helps us reproduce and fix your problem.
  • Suggestions: Bugs, suggestions or feedback can go in either our forums or GitHub Issues

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

Get nightly updates

Automatic

Users on the automatic "nightly" release stream are sent new builds at most once a day, but not every day.

  1. Make sure you have MTA installed. This can be a regular release version.
  2. Open MTA and navigate to "Settings -> Advanced"
  3. Change build stream from "Default" to "Nightly"

Download the latest resources

The auto-updater does not update server resources. These components are only required if you wish to run a server or the map editor.

These resources may use features only available in nightlies. Default resources from previous versions of MTASA are outdated, and may 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.

These resources will update at most once every day. Ensure that you always have the latest resources package.

Manual

You can download any nightly installer from nightly.mtasa.com. Just download and run the installer. These usually update once a day at 2AM GMT.