Merge branch 'master' of https://github.com/ExilProductions/PurrLobby

PurrLobby/appsettings.Production.json

@@ -4,11 +4,11 @@
       "Https": {
         "Url": "https://0.0.0.0:443",
         "Certificate": {
-          "Path": "C:\\certs\\purrlobby.pem",
+          "Path": "pemfile",
-          "KeyPath": "C:\\certs\\purrlobby.key"
+          "KeyPath": "keyfile"
         }
       }
     }
   },
-  "AllowedHosts": "purrlobby.exil.dev"
+  "AllowedHosts": "your.domain.com"
 }

README.md

@@ -1 +1,87 @@
 # PurrLobby
+
+Lightweight, fast lobby service for [PurrNet](https://github.com/PurrNet/PurrNet) multiplayer games. Alternative to Steam or Unity lobby lobby services.
+
+Dashboard: [https://purrlobby.exil.dev](https://purrlobby.exil.dev)
+API docs: [https://purrlobby.exil.dev/swagger](https://purrlobby.exil.dev/swagger)
+
+## Implementation Overview
+
+* **Multi-game scoping**: Each game has isolated lobbies via Game ID
+* **Real-time WebSocket events**: member join/leave, ready status, lobby data updates
+* **Custom lobby properties**: Store arbitrary key-value data per lobby
+* **Built-in stats**: Global & per-game player/lobby counts
+* **Rate limiting**: Protects against abuse by default
+* **Web dashboard + Swagger**: Monitor lobbies and test API
+
+## Quick Start
+
+```bash
+git clone https://github.com/ExilProductions/PurrLobby.git
+cd PurrLobby
+dotnet build
+dotnet run
+```
+
+## Configuration
+
+* `ASPNETCORE_ENVIRONMENT=Production`
+* `ASPNETCORE_URLS=https://localhost:7225;http://localhost:5123`
+* Cookie domain (production): `Program.cs → Domain = "your-domain.com"`
+
+## API Essentials
+
+Set game context (required):
+
+```bash
+curl -X POST "https://your-domain.com/session/game" \
+-H "Content-Type: application/json" \
+-d '{"gameId":"your-game-guid"}'
+```
+
+Create a lobby:
+
+```bash
+curl -X POST "https://your-domain.com/lobbies" \
+-H "Content-Type: application/json" \
+-H "Cookie: gameId=your-game-guid" \
+-d '{"ownerUserId":"player1","ownerDisplayName":"Player","maxPlayers":4,"properties":{"mode":"casual"}}'
+```
+
+Join/search lobbies using `/lobbies/{id}/join` and `/lobbies/search`.
+
+**WebSocket** (live updates):
+
+```javascript
+const ws = new WebSocket(`wss://your-domain.com/ws/lobbies/${lobbyId}?userId=${userId}`);
+ws.onmessage = e => console.log(JSON.parse(e.data));
+```
+
+## Deployment
+
+**Docker**
+
+```dockerfile
+FROM mcr.microsoft.com/dotnet/aspnet:8.0
+WORKDIR /app
+EXPOSE 80 443
+COPY . .
+ENTRYPOINT ["dotnet","PurrLobby.dll"]
+```
+
+**Reverse Proxy (nginx)**
+
+```nginx
+proxy_set_header X-Real-IP $remote_addr;
+proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+proxy_set_header X-Forwarded-Proto $scheme;
+proxy_set_header X-Forwarded-Host $host;
+```
+
+## Contributing
+
+Fork → branch → PR. Use tests & pass code analysis. Report issues on GitHub.
+
+## License
+
+MIT