Skip to content

Update Enjin Farmer sample game docs for Platform v3#30

Merged
Bradez merged 8 commits into
enjin:masterfrom
EtayM:docs/farmer-game-v3-update
Jun 25, 2026
Merged

Update Enjin Farmer sample game docs for Platform v3#30
Bradez merged 8 commits into
enjin:masterfrom
EtayM:docs/farmer-game-v3-update

Conversation

@EtayM

@EtayM EtayM commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Updates the Enjin Farmer setup guide and implementation breakdown for the v3 sample game (server rewritten in .NET on the Enjin Platform C# SDK; Unity client updated).

  • Implementation breakdown: C# SDK calls and the v3 CreateTransaction model in place of raw GraphQL; refreshed source links; appsettings config; new /api/setup/collection-id endpoint.
  • Setup guide: .NET 9 SDK prerequisite, appsettings.Local.json + dotnet run, v3 CLI Wallet Daemon, and the "Stamp Collection ID" Editor menu.
  • Setup troubleshooting: NuGet source, .NET 9 runtime, and Windows firewall notes.

EtayM and others added 8 commits June 22, 2026 16:49
The sample game client and server were updated to Enjin Platform v3
(enjin/platform-sample-game-server#6, enjin/platform-sample-game-client-unity#4).
The server was rewritten in .NET on the Enjin Platform C# SDK, so the
docs' raw-GraphQL snippets, env-var config, source links, and setup
steps were all stale.

Implementation breakdown:
- Reframe the server as a .NET 9 / C# SDK app; replace GraphQL snippets
  with the SDK's CreateTransaction / TransactionInput calls.
- Document the v3 single-CreateTransaction model, GetTransaction polling
  (no event subscriptions yet), managed-wallet provisioning + ENJ drip,
  and local SS58 address encoding.
- Swap env-var table for appsettings; add the /api/setup/collection-id
  endpoint; drop the removed /login and /wallet routes.
- Point all server source links at the new .cs files and the Unity
  links at the merged v3 commit.

Setup guide:
- Prerequisites: .NET 9 SDK instead of Node.js.
- Server config via appsettings.Local.json + dotnet run.
- Replace manual Collection ID paste with the new
  "Enjin > Stamp Collection ID" Editor menu.
- Reflect auto-drip in the funding note; drop the obsolete App Key reference.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…SDK check

- The server repo removed Enjin.ApiUrl (PLA-2449); the C# SDK now defaults
  to the platform host. Drop the setting from the config table and the
  server-config step, and bump server source links to the new commit
  (EnjinService.cs anchors shifted after the constructor change).
- Rewrite the Wallet Daemon setup for the v3 CLI daemon: download from
  enj.in/daemon, configure .env (PLATFORM_KEY + KEY_PASS), run the binary,
  and copy the printed Canary Matrixchain address. The old downloadable
  UI executable is gone.
- Add a .NET 9 SDK prerequisite check to Step 3 (verify with
  `dotnet --list-sdks`) to head off the "No .NET SDKs were found" error.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…ting

.NET 10 (or any SDK newer than 9) can build the net9.0 server, so don't
imply only 9.x works. Also note that first run restores dependencies
(including the now-public Enjin.Platform.Sdk) from NuGet and add a pointer
for the NU1100 "unable to resolve" failure (nuget.org source disabled/
unreachable), which is the actual blocker users hit, not a missing SDK.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Restore can fail with "No sources found" when a machine has no NuGet
source configured at all (not just disabled). Add the exact
`dotnet nuget add source` command so users can fix it directly.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
A newer SDK (e.g. .NET 10) can build the net9.0 server but can't run it
without the .NET 9 runtime — dotnet run fails with "You must install or
update .NET ... version '9.0.0'". Recommend installing the .NET 9 SDK
(bundles the runtime); note the --roll-forward Major alternative.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Add a note that Windows may prompt to allow network access on first
listen (click Allow; no restart needed). Also correct the "ready" signal
to the actual Kestrel output (Now listening on: http://[::]:3000 /
Application started) instead of the assumed line.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The generic download page surfaces the latest SDK (.NET 10), which builds
but can't run the net9.0 server. Link straight to the 9.0 page, matching
the Step 3 warning.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Drop the "v3 doesn't surface events" framing. State that the ID is
recovered via GetCollections, and point readers to WebSocket Events for
the production approach (listen for the event). Keeps the availability
detail on the events page so only that page needs updating later.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@Bradez Bradez merged commit 9ad8c76 into enjin:master Jun 25, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants