From 4346191c55ccf877aa2756d7601b5224798d54a7 Mon Sep 17 00:00:00 2001 From: Ixrec Date: Wed, 29 Apr 2026 20:10:26 +0100 Subject: [PATCH] Docs: Add a warning to world api.md#events that you want StatusUpdate, not events, for actually sending the goal (#5957) --- docs/world api.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/world api.md b/docs/world api.md index 4e23549304..4d3a248b86 100644 --- a/docs/world api.md +++ b/docs/world api.md @@ -327,6 +327,11 @@ reject the placement of an item there. ### Events (or "generation-only items/locations") +> **Warning:** If you're trying to tell the Archipelago server that the player has achieved their goal, you want to send +a [StatusUpdate packet](network%20protocol.md#statusupdate), or however [your client library](network%20protocol.md) +wraps it. Despite the popularity of "victory events" during generation, events have nothing to do with how goals are +triggered during gameplay. + An event item or location is one that only exists during multiworld generation; the server is never made aware of them. Event locations can never be checked by the player, and event items cannot be received during play.