Skip to content

Document dedicated voting proxy setup - #12

Merged
BenCodez merged 1 commit into
mainfrom
agent/dedicated-proxy-docs
Aug 17, 2026
Merged

Document dedicated voting proxy setup#12
BenCodez merged 1 commit into
mainfrom
agent/dedicated-proxy-docs

Conversation

@BenCodez

Copy link
Copy Markdown
Owner

What changed

  • add a substantive Dedicated-Voting-Proxy.md setup and operations guide
  • add an exact SVG architecture diagram showing the dedicated proxy, regional player-facing proxies, the selected non-plugin-messaging transport, backend presence, and shared SQL
  • cross-link the new guide from Proxy-Setups.md
  • add the page to both sidebar.md (GitHub Wiki mirror) and .wikijs/navigation.json (Wiki.js)

Availability

This page documents an upcoming-release development feature, not released VotingPlugin 7.1.1 behavior.

Minimum verified development baseline:

  • backend-presence foundation: merged PR #1550, merge commit c916763e
  • dedicated routing: merged PR #1551, merge commit 6867c488
  • current development version: 7.1.2-SNAPSHOT

The page displays a prominent warning that 7.1.1 users do not have DedicatedVotingProxy.

Verified behavior documented

  • only one central voting proxy enables DedicatedVotingProxy
  • regional/player-facing proxies do not run VotingPlugin
  • MYSQL, REDIS, MQTT, and SOCKETS support backend presence
  • PLUGINMESSAGING is rejected for dedicated presence routing and falls back to normal proxy routing with a severe warning
  • SendVotesToAllServers retains normal behavior
  • confirmed online players route using backend-reported current-server state
  • unknown/offline players follow the existing cache path
  • completed recovery snapshots drain voter-keyed cached rewards for confirmed players
  • presence is memory-only and resynchronizes after startup
  • no additional presence secret or persistence file is required
  • each backend's unique configured Server name remains its trusted transport identity

Validation

  • Markdown links and exact-case local targets: passed
  • YAML examples: parsed successfully
  • Markdown code fences: balanced
  • Wiki.js navigation: 42 items, 42 unique IDs, one exact new target
  • SVG: valid XML, 1600×900 viewBox, title, description, connectors, and arrowheads
  • SVG preview: rendered at 1600×900 and visually inspected
  • git diff --check: passed
  • scope: five documentation/navigation/asset files; no plugin source changes

AI disclosure: This content was written with assistance from ChatGPT.

@BenCodez
BenCodez marked this pull request as ready for review August 17, 2026 00:23
@BenCodez
BenCodez merged commit c8ef502 into main Aug 17, 2026
@BenCodez
BenCodez deleted the agent/dedicated-proxy-docs branch August 17, 2026 00:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant