About release streams.
AMP has 4 main release streams: LTS, Mainline, Preview, and Development. You can read more about them here:
Generally speaking, you should stick to the Mainline release stream unless there is a particular feature/fix that you need access to. If you have switched to a faster stream for a particular change, it’s generally advisable to switch back to Mainline once that change has been formally released.
Changing release streams
To change an instances release stream, you can run the following command:
ampinstmgr switch INSTANCENAME RELEASESTREAM
For example, to switch an instance called “Minecraft01” to the “Nightly” stream, you might run:
ampinstmgr switch Minecraft01 nightly
Bare in mind that builds in different release streams may not be compatible with each other. A nightly build may have a version number higher than Mainline with API changes that make it incompatible. As such it will be necessary to upgrade your ADS instance to the same stream.
You can do a bulk upgrade of all instances by using the following:
ampinstmgr switchall RELEASESTREAM
For example you can switch all instances to the Bleeding release stream by running:
ampinstmgr switchall bleeding
Switching to a slower release stream
If you need to switch from a faster release stream to a slower one (such as from Nightly back to Mainline) to need to override the normal check that makes this possible. This is simply done by adding true to the end of the ampinstmgr switch or ampinstmgr switchall commands, for example:
ampinstmgr switchall mainline true
Will revert all instances back to the Mainline release stream.
Development Testing
If you’re interested in helping create a better AMP for everyone by testing a release prior to reaching Mainline follow these steps. We recommend using the Preview stream for testing as Development can break your setup entirely if an unexpected bug gets through. The risk exists for Preview as well but is much lower as these tend to be closer to a release candidate.
The main location for feedback is the #development channel on Discord.
Linux - Download the preview ampinstmgr by copying the following into a ampdev.sh file and be sure to mark it executable with chmod +x ampdev.sh:
#!/bin/bash
set -euo pipefail
STREAM="Preview"
ARCH="$(uname -m)"
case "$ARCH" in
x86_64)
PLATFORM="x86_64"
;;
aarch64|arm64)
PLATFORM="aarch64"
;;
*)
echo "Error: Unsupported architecture '$ARCH'"
exit 1
;;
esac
cd /opt/cubecoders/amp
devBuildNum=$(wget -qO- https://downloads.cubecoders.com/AMP/manifest.json \
| jq -r --arg stream "$STREAM" --arg platform "$PLATFORM" '
.streams[$stream].versions[]
| select(.platform == $platform)
| .latestBuild
' | head -n1)
if [[ -z "$devBuildNum" ]]; then
echo "Error: Could not find latest build for platform $PLATFORM in stream $STREAM"
exit 1
fi
ZIPFILE="ampinstmgr_${PLATFORM}.zip"
rm -f "$ZIPFILE"
wget "https://downloads.cubecoders.com/AMP/${STREAM}/${devBuildNum}/${ZIPFILE}"
echo A | unzip -o "$ZIPFILE"
chmod +x ./ampinstmgr
echo "Installed AMP build $devBuildNum for platform $PLATFORM"
Windows - Download the preview installer by copying the following into an ampdev.ps1 file:
$manifest = Invoke-RestMethod "https://downloads.cubecoders.com/AMP/manifest.json"
$devBuildNum = $manifest.streams.Preview.versions[0].latestBuild
$msiPath = Join-Path $env:TEMP "AMPSetup.msi"
Start-BitsTransfer `
-Source "https://downloads.cubecoders.com/AMP/Preview/$devBuildNum/AMPSetup.msi" `
-Destination $msiPath
Start-Process msiexec.exe -ArgumentList "/i `"$msiPath`"" -Wait
In both cases, you’ll need to run the following commands to get the latest preview AMP version:
ampinstmgr stopall
ampinstmgr switchall preview
ampinstmgr upgradeall
ampinstmgr start ads01