AMP 2.5.1 introduces some major new functionality, and several refinements to existing features. Unlike some previous updates, AMP 2.5.1 is backwards and forwards compatible with the 2.5.0 series (but some functionality won’t be available when accessing newer versions from older ADS versions) - which makes for smoother upgrades as it won’t be necessary to upgrade everything all at once.
Available to users of AMP Advanced and Enterprise Editions, our new analytics system gives you the data to help you grow and manage your community. See how long people are playing for, where in the world they’re coming from, how many people are joining and shortly leaving, and see at a glance the overall health of your community.
You can experiment with this feature on Standard/Pro using the demo data that it’ll generate instead of real data.
Automatic Mirror Selection
Previously we implemented download mirrors to let AMP fetch updates from different locations. Now we’ve taken that a step further and AMP will by default automatically select the appropriate mirror for you (but you can still override this if you want to choose manually)
Feature Changes
Improved Backwards/Forwards Compatibility
We’ve changed how compatibility between versions works, which is why ADS 2.5.1 can manage ADS 2.5.0.x instances and vice-versa. You’ll be limited to the feature set of the lower version when we are able to maintain compatibility between versions, but as mentioned before this should make for smoother upgrades.
Style/Appearance Tweaks
We’ve continued refining AMPs interface and use of colour to generally make it more pleasing to use and easier to navigate.
Other Changes
The ‘rate limited’ login error now also shows a link explaining why you have been rated limited, and common issues that may cause you to be erroneously limited and how to fix them.
Updated ‘Wake on Lan’ logic to use a different packet broadcast method.
Changed how plugin loading works to allow modules to suppress the loading of specific plugins. Now uses a default list of plugins with options to add extras and suppress specific defaults.
Added App.TelnetNewLineType which accepts Default, Windows, or Linux. This is useful for games that use an incorrect new line format when accepting Telnet commands (Soulmask).
Added App.RCONSelectIPMethod which accepts Default (current logic) or Localhost (127.0.0.1). This can be used to force AMP to use the localhost address for games that do not accept external RCON traffic.
Bug Fixes
Fixed not being able to compile Spigot due to AMP incorrectly thinking there was a bad character in the path.
Fixed notices for the requirements/recommendations regarding the use of containers on the create instance screen not showing under the correct situations.
Fixed game server first time update logic to prevent AMP from performing a second update while starting the app.
Fixed not being able to delete instances that used symlinks to directories outside of AMPs data storage area, as AMP would previously try to follow these symlinks. Now it deletes the links themselves.
Fixed backup sizes being incorrectly overwritten with the archive file size.
Fixed an issue where instances would randomly fail to be managed because the browser was filling in an invisible login form and AMP was trying to pick that form fill in automatically.
Fixed metrics/status reporting behaviour when using Docker containers for instances.
ADS correctly logs the service ports used rather than the initial port selected which was already in use.
Trivial patches addressing some minor layout and presentation issues, and better handling for internal connections (Namely the 172.16/12 range) for Analytics and the presentation of Demo mode for Analytics.
‘Community’ pages make it easier to share quick information about your server to players. Click the new ‘share’ icon in the buttons for an instance and give the resulting link to people you want to join your server or see basic information about it.
Generic App configs can now define a set of user actions that show up when a user is selected from the console. This might typically include Kick/Ban commands which are executed when clicked.
Added a “Run console command” which invokes a RCON/STDIO message as part of an update stage.
Generic Module can now reload its configuration on-the-fly, making it easier for config builders to test changes without having to restart AMP.
ADS now has a List View for Instances (and it remembers your preference)
Changed default backup discovery logic to not try and include a games own backups.
Changes and Fixes
Fixed the base URL being wrong when managing instances in their own tab or on remote targets. Fix only covers new instances (deploy-time issue)
Misc UI tweaks and improvements, including making the “Extra Steps” notice more visible when creating an instance.
Fixed the page not loading when a translation file was in use.
Scheduler GUI shows global variables as well as trigger-specific ones.
Tweaked Analytics to have better understanding of private networks.
Fixed search to not try and show icon names when showing categories.
Fixed the permission node lookup for access to Analytics (fixes non-admin users not being able to access it)
Clarified descriptions for Analytics settings
Fixed S3 backup uploads when using buckets with mixed-case names.
S3 backup uploads now include the backup metadata so AMP can query backups without having to download the whole thing.
Schedule Tasks can now retrieve information about the trigger used to fire them initially.
Message pushes are no longer logged in the browsers console.
Fixed 2FA issues when performing the first time setup.
Fixed “A user performed an action” trigger not firing in Minecraft module.
Fixed behaviour of socat when using terminal un-buffering on Linux.
Disabled users get specifically reported as such to the UI.
Updated MC regexes to accommodate Paper 1.21.
Instances automatically add their auth server as an approved reverse-proxy host. Addresses issues with login IPs not showing correctly.
20240724.5 Patch
Fix an issue with the Backup schedule task not being able to fire.
Fix the share button not working in the community page even though it’s visible
Move the new Geographic Location setting to the Community settings to make it easier to find.
HUGE thank you to recursiveGecko on Discord for solving a long-standing speed issue with AMP’s UI! Their research and results were presented in such a way there was no doubt they found something big. The most obvious effect of this change is greatly improved upload speeds when using File Manager. And that’s putting it lightly…
Before:
After:
We expect this change will impact other areas as well such as slow loading fonts.
New Features
Instance info includes analytics permissions so it can be accessed by other components
Increase authentication failure timeout window
Removed outdated GenericTemplates directory on new installs
Update Ace file editor to 1.35.4 and add support for additional file types
Community Pages can now use central analytics
Changes and Fixes
mHttp updated to .NET Standard fork including config change mentioned above
Fix Minecraft background image on Community Page
Switched to main font on Community Page to increase load speed
Fixed AppSettings not working when used in provisioning arguments
Branding background now covers the screen and adjusts to different screen sizes
Fixes a regression in the generic module that made it unable to write out config file lines that used global values that weren’t referenced by a config manifest entry.
Usable port ranges are being reset (AMP Service Port Ranges, Application Port Ranges, Application Port Exclusions). The current port ranges will be replaced with a single input that includes all standard ports (1024 - 65535). If you currently have port ranges you’d like to use, please note them before upgrading and place them in the new field after the upgrade is complete.
There are three new buttons in the main instances tab that can be used to start/stop/update all instances on a specific server. The buttons do not apply to the main ADS instance.
These buttons use the existing permission nodes for overall instance management. The start task will honor the start delay setting configured in ADS.
The /API endpoint has received an overhaul as well! You can now use your logged in session to get more details from this page. It also includes more detailed examples and information.
Port allocation first checks above the default port for any available, but then checks below if none are found
ChildPorts has been implemented for Generic templates.
Added clipboard copy for server address in community pages
Allow file uploads to be cancelled gracefully
Changes and Fixes
Multiple changes to Minecraft user tracking to improve on the accuracy of player join/leave. Some modded servers will no longer track player join/leave due to a bug that was causing duplicated join in most other servers. This will be accounted for in a future update.
Support for very old versions of Minecraft start, user join, and user leave messages
Fixed an issue with instance creation using invalid cache information
Console output will only be matched to one message handler to avoid multiple actions being applied to a single message. This required many changes to the Minecraft module. Please report any issues in scheduled tasks not triggering properly or console output that doesn’t appear correctly for any game server.
Logic fixed for getting port information used in callbacks. Previously only the primary port was returned
Datastores UI has had some changes to remove the right click menu and make it behave better on mobile.
Minor patch to fix AppSettings not applying when provided in a template. Affected newly created Don’t Starve Together, Terraria and Tmodloader instances.
This update mostly consists of some qualtiy of life improvements along with some bug fixes. This update retains backwards/forwards compatibility with ADS 2.5.x.
Scheduler Time Zone
It’s now possible to change which time-zone AMP usese for its scheduler. Existing triggers will not be updated or changed when you change this setting so they will need modifying.
Default mount binds for Docker instances
This allows you to have new mount bindings created for new instances automatically when they are inside a container, and make them specific to the instance by including the instance name.
You can now add “LOCAL/whatever” as a repo store for generic config templates in ADS to use just local files as a source for configurations rather than a git repository. It uses the same structure and the directory name used is LOCAL-whatever.
Console layout improvements
Servers that render tables as text in the logs will now display correctly, but longer lines will still wrap without overflowing.
Other Changes
Generic configs can now use . as a valid character for filenames in IncludeJSON beyond just the JSON extension. Allows for game.ports.json for example.
Updating generic instances in the UI will always update the template as well.
Generic MinAMPVersion setting now ensures the newly created instance and ADS are both the minimum version. This prevents feature mismatch when a new ADS feature is required to create the instance.
Fixed instance ports being reused for game server ports when fewer ports are available.
Updated documentation search to be better at handling partial matches.
Fixed a bug that could cause TelnetRCON to have high CPU usage.
Allow anonymous login for TelnetRCON.
Fixed an issue where a changed setting isn’t saved if the template merge file doesn’t exist yet.
Fixed the “Third Party Warning” showing up in inappropriate times (such as when clicking the SFTP button)
Fixed Java version enumeration in the Minecraft module if PATH or other variables have bad characters in them.
Fixed some obsolete context menu options still showing despite being replaced.
Fixed a brief stall on first ADS login caused by not pre-computing the application list server side during startup.
Minecraft version info refreshes each hour, no need to restart the instance.
Minecraft can now handle minimal player tracking for proxied servers that don’t display all connection info in the console.
Minecraft fix for Forge 1.12.2 specific console characters displaying extra garbage.
Breaking Change Warning 
