DUXPLIMA Documentation

A network

Geyser on a backend, on the Velocity proxy, or standalone, and how the pack reaches it.

Where Geyser runsWhat you installHow the pack reaches Geyser
On a Paper serveruxmBedrock and the extension on that serverThe extension reads plugins/uxmBedrock/output beside it
On the Velocity proxyuxmBedrock on every server, the extension in the proxy's Geyser, uxmBedrock-Velocity on the proxyEach server sends its build to the proxy over the network; the proxy makes one pack from all of them
On the proxy without uxmBedrock-Velocity, or Geyser StandaloneuxmBedrock on every server, the extension with source.folder = player-connectionThe next Bedrock player to join carries what changed over their own connection

One pack for the network

With uxmBedrock-Velocity, a player downloads the pack once and keeps it when they change servers. Each server's build arrives in plugins/uxmbedrock/servers/<server>/ on the proxy; the proxy asks only for files it does not already have, checks each by its hash, and makes the network pack in plugins/uxmbedrock/output, where the extension finds it with source.folder = auto.

PartMerged
Packs built the same on several serversInto one pack: JSON key by key, language files line by line, glyph pages pixel by pixel; any other file keeps the first server's copy
Packs only one server hasKept as they are
Custom itemsJoined, each Bedrock identifier once
Blocks, names, font slotsJoined key by key
HeadsAll of them
A player's choicesFrom the server that wrote them last

pack.order in the proxy's config.conf names the servers whose copy wins; the console names the files two servers hold differently.

Setting it up

  1. Put uxmBedrock-Velocity in the proxy's plugins/ and start the proxy. It writes plugins/uxmbedrock/config.conf and, in direct mode, secrets.conf with one secret per server.
  2. On each server, set server-name to the server's name in velocity.toml in lower case, network.mode = "direct", and network.secret to that server's secret. Restart the server.
  3. The proxy's console says The build ... from <server> is in and The network pack is made from ....

With Redis, set network.mode = "redis" and the same redis-uri on the proxy and every server; no secrets are needed. The proxy uses port 25591, beside uxmChat's 25590. See velocity config.

A player's choices and the glyph slots follow them across servers only when every server shares one database; see Database.

Proxy commands

uxmBedrock-Velocity adds the first argument values of the proxy's own commands (server names, player names) to the command list Bedrock players get, as the servers do for theirs. It asks Floodgate on the proxy, or Geyser, who plays Bedrock.