Cross Server Shops [LightmansCurrency]

Cross Server Shops:

Cross Server Shops links Lightman's Currency shops across multiple Minecraft worlds through one always-on Node relay. Players buy from another world's shop in Lightman's own trader screen, opened from a Trading Terminal. The buyer pays on their world. The shop owner is paid on the world that holds the stock. No database, proxy, or Velocity setup is required. Created for CTE2 Servers

Cross-Server Shops:

• Shops from every linked world show on the Trading Terminal, tagged with that world's display name
• Sale trades are shared. A shop buying from a player, and barter trades, stay on the world that owns them.
• Out-of-stock sales are hidden, and return after a restock syncs
• A world that goes quiet drops off the list, and its shops return when it connects again
• The first buyer locks the stock. If they cannot pay, or the hold runs out, the items go back on the shelf
• Payment uses the coin slots, the wallet, and the bank account
• Shops whose owner has not played on that world for the configured number of days are hidden, and return the next time they play there
• Team shops with no single player owner stay visible
• Optional limit so only shops with a network upgrade are synced

Bulk Buy:

• Scroll up over a sale to raise the amount, and scroll down to lower it
• The amount starts at 1
• The cap is the stock in the shop, the money the player can pay, and maxBuysPerClick
• The server's maxBuysPerClick wins when the client config is higher
• Works on local shops and shops from other worlds
• Shop purchases and barter stay one at a time

Cross-Server Auctions:

• Optional. Turn crossServerAuctions on for the client and every linked world
• Auction listings from other worlds show in the local auction house
• Bids are paid on the bidder's world
• A higher bid refunds the previous bidder on their world
• Won items are delivered to that player's auction storage on their world
   

Relay:

• One Node process stays online while the Minecraft worlds restart
• Every world dials out to it, so paid hosts do not need a port forward
• Raw TCP on the relay port. Leave it off HTTP reverse proxies
• Console and shop.log lines for connect, disconnect, shops, purchases, and auctions
• The shared secret is never written to the log

1. Install Lightman's Currency and this mod on the client and on every Minecraft server. Use the same jar everywhere.
2. Pick one hub. Use a Node server, or use one of your own Minecraft servers.
3. Set crossServerAuctions to true on the client and every linked server if auction listings should be shared.
4. Stop each Minecraft server before replacing the jar or the config, then start it again.

Node Server:

• Open the mod jar and copy the relay folder out. It contains server.js, config.json, and package.json
• In that config.json, set a private secret and the port (7778). Start it with node server.js from the app folder
• Open that TCP port to the relay machine
• On each Minecraft server, edit config/cross_server_shops-common.toml. Give each world its own serverId and displayName. Use the same sharedSecret as the relay. Set hubAddress to the relay host, hubPort to 7778, and listen to false
• The relay stays up while the Minecraft worlds restart

Using Minecraft Server:

• That server is the hub. It forwards shop lists, purchases, and auction bids between the worlds connected to it
• On the hub server, set listen to true, and leave hubAddress and peers empty. Give it its own serverId and displayName
• Forward TCP 7778 to that machine. This is the shop link, separate from the Minecraft port
• On every other server, set listen to false, set hubAddress to the hub server's public address, and keep hubPort at 7778
• Use the same sharedSecret everywhere
• While the hub server is down for a restart, the other worlds lose the link and each other's shops drop off until it is back