Trusted Official ASA: Server API 2.11

ASA: Server API v2.11
Plugin recovery and alerts

• Added an optional essential-plugin list for missing-offset or bitfield failures.
• Non-essential plugins can be skipped during initialization when the failure can be safely recovered, allowing the server to start without them.
• Missing-offset failures that still crash the server can quarantine the affected non-essential plugin for the next startup. It is automatically retried when its DLL changes or the missing entry becomes available in the cache.
• Added optional Discord webhook reports for skipped plugins, automatic retries and missing-offset crashes.
• Improved cleanup after failed plugin initialization and fixed a crash when unloading plugins through RCON.

Configuration

Merge these settings entries into your existing ShooterGame/Binaries/Win64/config.json, keeping your other settings. Restart the server afterwards.

JSON:Copy to clipboard

{
  "settings": {
    "EssentialPlugins": {
      "Enable": true,
      "Plugins": ["Permissions", "ArkShop"]
    },
    "PluginFailureWebhook": ""
  }
}

• Disabled by default: all plugins remain essential. With Enable: true, only listed plugins remain essential; an empty list makes all plugins non-essential.
• Use DLL names without .dll (case-insensitive). This example keeps Permissions and ArkShop essential.
• Set PluginFailureWebhook to your Discord webhook URL to enable reports. Leave it empty to disable them.

A runtime missing-offset failure can still stop the server. Quarantine takes effect on the next startup and is recorded in OffsetCrash.json inside the plugin's folder. Update the plugin or cache before forcing a retry.

ASA: Server API v2.1

Server Owners

• Updated the API for the Unreal Engine 5.8 game update.
• Added an additional cache download mirror in Asia.

Plugins also need to be updated for UE 5.8. Use versions explicitly updated by their developers; loading successfully does not guarantee that an older plugin works correctly.

Developers

• Rebuilt and expanded the ARK and Unreal headers, adding previously missing classes, structs, enums, functions and globals.
• Added cached native class resolution for StaticClass() and GetPrivateStaticClass(), with garbage collection protection and cleanup during engine shutdown.
• Improved script struct lookup, including support for fully qualified paths and rejection of ambiguous names.
• Fixed reflected struct alignment typing and improved size/alignment validation when allocating structs.
• Updated changed function signatures, including dino spawning and taming, item crafting/repair cancellation and map bounds checks.
• Fixed FString::Reserve and the GetBitmaskForBuffs parameter signature.
• Added the proper FActorInstanceHandle definition.

Recompile plugins against the updated headers in master branch and review any affected hooks or function calls.

• Remove plugin commands automatically and callbacks on unload by @Fonzie584 in #77
• Missing offset errors now name the plugin that asked by @Fonzie584 in #76

• cached_offsets.txt is now extracted on cache download.
• Added fallback cache cdn urls so if main one fails or is not available for someone, the other urls should work.
• Added more randomness to ServerID generation to avoid some weird instances where the ID for multiple maps would come out as the same number.
• Some header updates and cleanups
• Added a config entry:

JSON:Copy to clipboard

"AutomaticCacheDownload": {
"DownloadCacheURLs": [
    "https://cdn.pelayori.com/cache/",
    "https://cdn.shadowhunter.co.za/cache/",
    "https://cdn.shadowhunter-systems.co.za/cache/"
  ]
}

• Fixed an issue on HTTP Requests on some plugins

• Reworked cache so it works without PDB now

• Fixed error 5 in hooks (err=5)
• Added more info on HTTP errors to better identify which hostnames are having an issue

# AsaApi 1.20 Changelog

Compare:

Comparing 1.19...c7c0f81d7a726fdc35bf863ae34bc29012cab87f · ArkServerApi/AsaApi

Contribute to ArkServerApi/AsaApi development by creating an account on GitHub.

github.com

## Server Owners

• Plugin loading is now improved for better .PDB and extra .DLL files (no need to move PDB/extra DLL files to Win64 anymore)
• Plugin unload now automatically removes hooks owned by that plugin so the server doesn't crash after unload
• Added optional "ExtendedDebug": false in config.json for more detailed hook installation, rebuild, and unload logging.
• Missing AsaApiUtils and missing plugin dependency errors now log clearer messages.
• Dumping process made faster (about ~90% faster). High end dump cache in seconds while lower end takes just 4 minutes.

However, with our cache server, which does it on the cloud, this usually is not needed hence not direct impact on daily usage

## Developers

• The hook system was overhauled for safer and better handling, and unloading
• Hook removal now rebuilds surviving chains more safely and adds optional extended debug output.
• The MS DIA / PDB reader was updated to be faster and to resolve richer parameter types more accurately.
• Requests.cpp now correctly applies the receive timeout instead of reusing the connect timeout.

• UE 5.5 update fixes
• Header updates for developers

Important: There's a new file called msvcp140.dll, you need to copy that too for this release.

Server Owners
You can now set CPU Affinity via a command line launch parameter.
Here are some examples:

-affinity="2,3" would set the map to only use cores 2 and 3
-affinity="3" would set the map to only use core 3
-affinity="" would set the map to use all cores
Not using the setting would set the map to use all cores

Click to expand...

Developers
Check the change log for all changes from 1.17 to 1.18

Comparing 1.17...1.18 · ArkServerApi/AsaApi

Contribute to ArkServerApi/AsaApi development by creating an account on GitHub.

github.com

Permissions 1.03 Included in this release.

Alternative API Loader - This will enable launching the "ArkAscendedServer.exe" directly just like the old ASE API.

Release ASA Version.dll Loader · ArkServerApi/AsaApiLoader

The following files can be placed in the "ShooterGame\Binaries\Win64" folder. This will enable launching the "ArkAscendedServer.exe" directly just like the old ASE API. If your operating system doe...

github.com