DynamoLedger

DynamoLedger connects your game to Amazon DynamoDB without a separate backend or web layer. Save profiles, inventories, unlocks, settings and stats per player, and read leaderboards, straight from Blueprints or C++.

Items cross the Blueprint boundary as plain JSON strings. Struct To JSON turns any Blueprint struct into an item, JSON To Struct turns it back, and numbers keep their exact value. Write {IdentityId} in a key or value and DynamoLedger fills in the player's Amazon Cognito identity id, so an IAM policy with dynamodb:LeadingKeys can limit every player to their own items.

Put Item, Get Item, Update Item and Delete Item support condition expressions, and a failed condition arrives on its own On Condition Failed pin together with the current item - ideal for "only if the player has enough gold" or "create only once". Query and Scan read partitions, filters and secondary indexes page by page. Batch Get and Batch Write handle hundreds of items in one node and retry throttled entries with exponential back-off. Transact Write runs up to 100 puts, updates, deletes and checks that succeed or fail together, and tells you which operation cancelled it. Increment Counter adds to currencies and stats atomically and returns the new value, and Get Top Scores reads a leaderboard from a secondary index.

Players get credentials from an Amazon Cognito identity pool: as guests, or signed in with a token from a Cognito user pool, Google, Apple, Facebook or any OpenID provider through Set Login Token. Static keys and the default AWS credential chain are available for development, dedicated servers and tools. Requests run on background worker threads with automatic retries, so the game thread never blocks, and every result arrives back on the game thread.

DynamoLedger is part of the Alpha XP AWS collection for Unreal Engine 4.27 and 5.8. It includes the AWS SDK for C++ prebuilt for Win64, Linux and Android and ships with styled HTML documentation, an example table design, a leaderboard index and a ready-to-use IAM policy.

Key features

• Put Item, Get Item, Update Item, Delete Item with condition expressions and an On
• Query and Scan with key conditions, filters, secondary indexes, paging and parallel
• Batch Get (100 keys per request) and Batch Write (25 writes per request) with
• Transact Write: up to 100 operations, all or nothing, with readable cancellation
• Increment Counter: atomic add on top-level or nested number attributes, returns the
• Get Top Scores: leaderboard helper over a secondary index, highest or lowest first
• Plain JSON in and out: S, N, BOOL, NULL, L and M map to JSON; sets and binary values
• {IdentityId} token for per-player security with dynamodb:LeadingKeys
• Amazon Cognito identity pools for guest and signed-in players (Set Login Token for any
• Static keys (development and servers) and the default AWS credential chain
• Table name prefix and consistent-read default in the project settings
• Struct To JSON, JSON To Struct, Get JSON Field and Make Key JSON helpers
• Background worker threads, automatic retries with back-off, timeouts, custom endpoints
• Cancellable latent nodes; all results delivered on the game thread

Blueprint & C++ API

Every call is reachable from more than one place — pick the entry point that fits your project:

Callable runs when executed · Pure no exec pin, returns a value · LatentAsync finishes later and fires its outputs

DynamoLedger 2

Config 3

Identity 5

JSON 4

Events & delegates

Bind these in Blueprint (drag off the object → Bind Event) or with AddDynamic in C++.

Project settings

Configure once under Project Settings › Plugins › DynamoLedger — values are saved to the project's config .ini, so they travel with the project and your build.

Options & enums

Compatibility

One ready-made build per engine version is included in the download — copy the one that matches your project.

Technical details

What's in the download

Quick start

1. Unzip the download and pick the build that matches your engine (4.27 · 5.8).
2. Copy the DynamoLedger folder into your project's Plugins/ folder (create it if needed).
3. Open the project, enable DynamoLedger under Edit › Plugins and restart the editor.
4. Fill in Project Settings › Plugins › DynamoLedger.
5. Right-click in any Blueprint graph and search DynamoLedger — or include the public headers from C++.
6. Package for your target platform (Windows, Linux, Android).

Good to know