Nightly Builds: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
(Rewrite most of this page)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Needs Checking|We don't have nightly installers anymore [[User:Qaisjp|- qaisjp]] ([[User talk:Qaisjp|talk]]) 23:53, 31 August 2018 (UTC)}}
{{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].}}
{{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].}}
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
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 [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 [https://buildinfo.mtasa.com 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).
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). -->


= Setting up nightly builds =
== How you can help ==
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" ===
You can help the MTA team by communicating with us [https://mtasa.com on Discord].
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
* '''Bugs and crashes''': please share any bugs and crashes you find [https://github.com/multitheftauto/mtasa-blue/issues/new/choose on GitHub]
* Full installer: the full installer that includes the data files and resource package
** 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


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.
For general scripting or server setup help, please refer to:
* [[Client Manual]]
* [[Server Manual]]
* [[admin|Setting up admin on your server]]
 
== Get nightly updates ==
 
=== Automatic ===
 
Users on the automatic "nightly" release stream are sent new builds at most once a day, but ''not'' every day.


=== Download the latest resources ===
==== 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.
 
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 should pick the resource archive with the '''highest revision number'''.
* You can find the latest available resources '''[https://mirror.mtasa.com/mtasa/resources/ 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.
 
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 [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 ===
These resources will update at most once every day. Ensure that you always have the latest resources package.
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
=== Manual ===
* https://forum.multitheftauto.com
* https://bugs.multitheftauto.com


For general scripting or server setup help, please refer to:
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.
* [[Client Manual]]
* [[Server Manual]]
* [[admin|Setting up admin on your server]]

Revision as of 16:32, 30 May 2019

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

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.

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.