ACTORVIA - PILOT
================

Nine steps. You will never be asked for a key, a token, or a password.


1. Install Actorvia for Windows
   Run ActorviaSetup-0.1.0-alpha.4-x64.exe.

   These pilot builds are not code-signed yet, so Windows may show
   "Unknown publisher" or a SmartScreen prompt. Choose More info ->
   Run anyway.

2. Sign in
   Open Actorvia and sign in with your account.

3. Create or select a project
   A project is the thing your Roblox place connects to.

4. Install the Actorvia Studio plugin
   Unzip Roblox\Actorvia-Studio-Plugin-1.0.0-alpha.4.zip.
   In Roblox Studio: right-click your Plugins folder ->
   "Show in Explorer", then copy bdg-studio-plugin.rbxmx into it and
   restart Studio.

   The zip also contains a ready-made starter place and the runtime, plus
   QUICKSTART.md if you would rather follow the longer version.

5. Turn on HTTP requests in Studio
   File -> Game Settings -> Security -> Allow HTTP Requests: on.
   Studio cannot reach Actorvia without this. The plugin will tell you if
   you forget.

6. Get your pairing code
   In Actorvia, generate a pairing code for your project. It is twelve
   characters and looks like ABCD-EFGH-JKLM.

7. Enter the code in Studio
   Open the Actorvia plugin from the Studio toolbar and type the code in.
   Case, spaces and hyphens do not matter. The letters people misread -
   O for 0, I or L for 1, U for V - are corrected for you.

8. Press Connect
   The plugin does the rest. It exchanges the code for a credential that
   belongs to your project alone and stores it server-side, where players
   can never reach it. You do not see it and never need to.

   Codes are single-use and expire. If one does not work, generate a
   fresh one rather than retrying it.

9. Try it
   Save the place, press Play, and talk to the greeter. Try
   "welcome me to the lobby".

   Type /greeterhosted in the chat to see whether that turn was answered
   by Actorvia or handled locally.


IF SOMETHING IS WRONG
   Roblox\ contains TROUBLESHOOTING.md. The two most common causes are
   Allow HTTP Requests being off, and opening a COPY of a place - a copy
   does not inherit the connection, so connect it with a new code.

TURNING IT OFF
   Select ServerScriptService.AgentRuntime and clear ProvidersEnabled.
   Every request stops immediately, with no code change. The greeter
   keeps working; it just answers locally.

VERIFYING YOUR DOWNLOAD
   SHA256SUMS.txt lists the checksum of every file here.
