Minecraft Plugins

Zander's plugin suite connects your Minecraft servers directly to the Zander platform. Each module is purpose-built for a specific server role — install only what you need, and everything talks back to the same central API.

The suite consists of four modules:

Module	Platform	Install On
zander-addon	Paper/Spigot 1.21+	Each game server
zander-auth	Paper/Spigot 1.19+	Your dedicated auth server
zander-hub	Paper/Spigot 1.19+	Your hub server
zander-velocity	Velocity proxy	Your Velocity proxy

---

zander-addon

Platform: Paper / Spigot 1.21+
Install on: Each game server
Purpose: Adds in-game commands for server policies, social media links, and player freeze — giving staff a quick tool to pause a player mid-session while investigating.

Commands

Command	Usage	Permission	Description
/policy	/policy <tos|rules|privacy|refund>	None	Opens the relevant server policy in chat
/social	/social	None	Displays configured social media links
/freeze	/freeze <player>	zander.command.freeze	Freezes or unfreezes a player in place

Configuration

# plugins/zander-addon/config.yml
BaseAPIURL: "https://example.com/api"
APIKey: "your-api-key"
features:
  policyBook:
    enabled: false
    slot: 8
  socialPaper:
    enabled: false
    slot: 7

policyBook and socialPaper are optional GUI items placed in the player's hotbar. Set enabled: true and choose a slot (0–8) to activate them.

---

zander-auth

Platform: Paper / Spigot 1.19+
Install on: A dedicated auth server
Purpose: When a player joins your network for the first time, they are routed to the auth server. zander-auth handles the account-linking step — creating or retrieving their Zander profile and forwarding them to the main network once linked. This ensures every player on your network has a connected web account before they can play.

The plugin operates entirely through event listeners — no player-facing commands are needed.

Configuration

# plugins/zander-auth/config.yml
BaseAPIURL: "https://example.com/api"
APIKey: "your-api-key"
MOTDTopLine: "&e&lMy &2&nMinecraft&r &6&oAUTH Server"

MOTDTopLine is displayed as the first line of the auth server's MOTD. Supports & colour codes.

---

zander-hub

Platform: Paper / Spigot 1.19+
Install on: Your hub server
Dependencies: PremiumVanish, ProtocolLib
Purpose: Full hub server management — sets and enforces the hub spawn, manages flight for donors and staff, and gives players a one-command way to connect to any server on the network.

Commands

Command	Usage	Permission	Description
/fly	/fly	zander.fly	Toggles flight for the player in the hub world
/connect	/connect <server>	None	Connects the player to the specified server

Permissions

Permission	Default	Description
zander.fly	op	Toggle hub flight
zanderhub.administrator	op	Full hub administrator access
zanderhub.build	op	Enable build mode in the hub

Configuration

# plugins/zander-hub/config.yml
velocitymultiplier: 3
hub:
  world: 'world'
  x: 0.5
  y: 33.0
  z: 0.5
  yaw: -180.0
  pitch: 0.0
messages:
  join: '&7%p% joined.'
  leave: '&7%p% left.'
misc:
  always_first_join: false
  slot_hub_compass: 4

Key	Description
velocitymultiplier	Horizontal velocity multiplier applied in the hub world
hub.world	World name for the hub spawn
hub.x/y/z/yaw/pitch	Exact spawn coordinates and rotation
messages.join / .leave	Network-wide messages; %p% is replaced with the player name
misc.always_first_join	When true, the first-join experience triggers on every login
misc.slot_hub_compass	Hotbar slot (0–8) for the hub compass item

tip

Set hub.x/y/z/yaw/pitch to your desired hub spawn location. The yaw value controls which direction the player faces on spawn — -180 faces north.

---

zander-velocity

Platform: Velocity proxy
Install on: Your Velocity proxy
Purpose: The network's backbone on Velocity — provides private messaging between players, rotating tip announcements in chat, MOTD management, and a set of useful commands accessible from any server on the proxy.

Commands

Private Messaging

Command	Aliases	Permission	Description
/message <player> <message>	/m, /msg, /w, /whisper, /tell, /t	zander.command.message	Send a private message to an online player
/reply <message>	/r	zander.command.reply	Reply to the last private message you received or sent
/ignore add <player>	—	zander.command.ignore	Add a player to your ignore list
/ignore remove <player>	—	zander.command.ignore	Remove a player from your ignore list
/ignore list	—	zander.command.ignore	View your ignored players
/togglemessages	/toggle-messages	zander.command.togglemessages	Turn incoming private messages on or off

Private messaging respects both the recipient's toggle setting and your personal ignore list. Ignore lists are stored by UUID and persist across proxy restarts. Conversation history is held in memory only and resets when the proxy restarts.

Network Utility

Command	Description
/discord	Posts a link to your Discord server
/ping	Shows the player's current network latency
/report	Links to the player report page
/rules	Links to the server rules
/website	Links to the network website

Staff Moderation

Command	Description
/clearchat	Clears the network chat for all players
/freezechat	Freezes network-wide chat

Announcements

zander-velocity reads live announcements from the Zander API and surfaces them in two ways:

• MOTD — The second line of the Minecraft server list. Pulled from announcements with type motd.
• Tips — Rotating in-chat messages from announcements with type tip.

Configuration

# velocity/plugins/zander-velocity/config.yml
config-version: 1
BaseAPIURL: "https://example.com/api"
APIKey: "your-api-key"
announcementMOTDTopLine: "&e&lMy &2&nMinecraft&r &6&oServer"
announcementTipPrefix: "&7&l[&6&lTIP&7&l]&r "
announcementTipInterval: 10

Key	Description
announcementMOTDTopLine	First line of the server MOTD (static)
announcementTipPrefix	Text prepended to each rotating tip message
announcementTipInterval	How often (in seconds) tips rotate