> ## Documentation Index
> Fetch the complete documentation index at: https://diggercreations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Rift Velocity

> This guide is on how to install the Rift Velocity Setup

<img src="https://mintcdn.com/diggercreations/zzGxnki_-x9j0KW6/images/234324324.png?fit=max&auto=format&n=zzGxnki_-x9j0KW6&q=85&s=182086546bd22b2a23bd4c29b54ea362" alt="234324324 Pn" width="2048" height="1024" data-path="images/234324324.png" />

Resource Link: [Rift Velocity](https://builtbybit.com/resources/rift-velocity.68511/)\
Supported Versions: `1.7 - 1.21.5`\
Supported Software: `Velocity`

<Info>
  View our [detailed general setup installation guide](/server-setup/) to install your setup!
</Info>

## Dependencies

* [Velocity .jar file](https://papermc.io/downloads/velocity)

## Setup with Ace Lobby

Linking the Ace Lobby setup is simple, as it’s already preconfigured for seamless integration.

### Add the server to velocity.toml

```json velocity.toml theme={null}
[servers]
# Configure your servers here. Each key represents the server's name, and the value
# represents the IP address of the server to connect to.
lobby = "127.0.0.1:30066"

# In what order we should try servers when a player logs in or is kicked from a server.
try = [
  "lobby",
]
```

### Setup the /hub command

Go to `plugins/velocity-tools/config.yml`

```yaml config.yml theme={null}
  hub:
    enabled: true
    servers:
      - "lobby" # Use the lobby server name from velocity.toml
```

### Secure your server

Secure your backend servers to prevent players from joining them directly and bypassing the proxy. For a detailed guide [click here](https://docs.papermc.io/velocity/security/).

<Tip>
  If you get stuck at any point, I recommend checking [Velocity's official documentation.](https://docs.papermc.io/velocity/)
</Tip>

## FAQs

<AccordionGroup>
  <Accordion title="How can I change the server icon?" icon="image" iconType="regular">
    Simply replace the `server-icon.png` file with your own 64x64 icon, then restart your server.
  </Accordion>

  <Accordion title="How to turn on Maintenance on/off?" icon="pickaxe">
    Use `/maintenance toggle`
  </Accordion>

  <Accordion title="How to write in the Staff Chat?" icon="helmet-safety">
    There are three levels of staff chat: staff, developer, and admin. Use the following commands to send messages in each:

    * `/sc <message>` for staff chat
    * `/dc <message>` for developer chat
    * `/ac <message>` for admin chat
  </Accordion>

  <Accordion title="How can I add my own build to the Auth Lobby" icon="house-chimney">
    Replace the `world.nbt` file in the \*\*LimboAuth \*\*plugin with your custom schematic.

    <Tip>
      To create a .nbt schematic, copy your build using WorldEdit and run the command: `//schem save world structure`
    </Tip>

    After that, position the lobby below the player by updating the world coordinates in the config:

    ```yaml config.yml theme={null}
      world-coords:
        x: -12
        y: 110
        z: -13
    ```
  </Accordion>

  <Accordion title="How to edit ranks/permissions?" icon="medal">
    This setup uses LuckPerms. If you haven’t merged the databases with your backend (Spigot servers), use `/luckpermsvelocity` to edit permissions and ranks.\
    \
    Since the Tab plugin runs on the proxy, you need to manage prefixes there, because prefixes from the backend servers won’t be applied. To simplify this, you can create a single MySQL database shared between the proxy and backend servers. This isn’t mandatory, but it makes managing ranks easier since you only need to update them once instead of twice.
  </Accordion>
</AccordionGroup>
