Velocitab/docs/Setup.md
William 6f140e4708
feat: Add support for Minecraft 1.21.2/3 (#228)
* First step for 1.21.2

* fix

* feat: start preparing 1.21.2 support

bumps gradle and various build deps

* build: now requires Velocity 3.4.0

* build: use Velocity 3.4.0 from maven

* refactor: cleanup, fix wrong protocol ver in 765

* refactor: minor code cleanup & reformat

* refactor: further code cleanup

* refactor: more minor refactoring work

* docs: document prerequisites for using the plugin message API

* Fixed team packet mapping problem
Fixed problems with SortingOrder packet
Changed scoreboard logic to skip team packets for 1.21.2+ players if nametag is empty

* docs: further grammar fixes to plugin message API docs

* refactor: adjust PPB version checking logic

* build: simplify PPB test logic

* refactor: remove unused code

* refactor: adjust formatting

* refactor: make nametag empty by default

* refactor: suppress warning

* fix: `ConfigurationException` deserializing minimum PPB version string

* refactor: remove unused import

* Bug fixes

* Removed tablist order from all TabPlayer instances when a player leaves

* Fixed problem with data structure

* Removed synchronized

* fix: subscriber order not taking effect

* refactor: minor code style tweaks

---------

Co-authored-by: AlexDev_ <56083016+alexdev03@users.noreply.github.com>
2024-10-28 18:17:36 +00:00

2.0 KiB

This page will walk you through installing Velocitab on a Velocity proxy server.

Requirements

  • A Velocity proxy server (running Velocity 3.4.0 or newer)
  • Backend Minecraft servers. The following Minecraft server versions are fully supported:
    • Minecraft 1.8—1.8.9
    • Minecraft 1.12.2—latest

Servers that support clients with versions not listed are bit supported, as Velocitab relies on dispatching protocol-compatible packets and modern 1.16 RGB chat color formatting. Users attempting to connect on earlier versions may cause errors to display in your proxy server console.

Installation

  1. Download the latest version of Velocitab
  2. Drag the plugin into the /plugins/ folder on your Velocity proxy server
  3. Download and install additional optional dependencies on your proxy and backend servers as needed:
    1. If you'd like Velocitab to display user roles from LuckPerms, ensure LuckPerms is installed on your Velocity proxy as well, and configured to synchronise role information over your database
    2. If you'd like to use PlaceholderAPI placeholders, install PAPIProxyBridge on both your Velocity proxy and Spigot-based Minecraft servers. Also ensure PlaceholderAPI is installed on your spigot servers
    3. If you'd like to use MiniPlaceholders placeholders, install MiniPlaceholders on your Velocity proxy.
  4. Restart your proxy to let Velocitab generate its configuration file
  5. Stop your proxy server, modify the config.yml file to your liking, and start your server

Velocitab should now be successfully installed on your proxy.

Next Steps