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

# Brandings

> Customize your Lifesteal server with available branding elements.

## Overview

The Lifesteal setup includes extensive branding capabilities through RocketPlaceholders. Customize your server's social links, server information, voting links, and more with dedicated configuration files for maximum flexibility.

## Configuration Files

<AccordionGroup>
  <Accordion icon="server" title="Server Information">
    **File:** `plugins/RocketPlaceholders/placeholders/server-info.yml`

    Configure core server information that displays to players.

    **Available Customizations:**

    * **server\_name** - Your server's display name
    * **server\_ip** - Server IP address for players to connect
    * **website** - Your official website URL
    * **store** - Your server store/shop link
    * **vote** - Main voting link
    * **discord** - Your Discord server link
    * **discord\_vanity** - Custom Discord vanity URL

    These placeholders are used in welcomes, MOTD, and various plugin messages.
  </Accordion>

  <Accordion icon="share-nodes" title="Socials Configuration">
    **File:** `plugins/RocketPlaceholders/placeholders/socials.yml`

    Configure your social media links to display throughout your server.

    **Available Customizations:**

    * **Twitch** - Your Twitch channel link
    * **YouTube** - Your YouTube channel link
    * **Facebook** - Your Facebook page link
    * **Instagram** - Your Instagram profile link
    * **TikTok** - Your TikTok profile link

    Use these placeholders in chat, messages, or scoreboard displays to promote your social media.
  </Accordion>

  <Accordion icon="ballot" title="Voting Configuration">
    **File:** `plugins/RocketPlaceholders/placeholders/voting.yml`

    Configure up to 5 different voting sites that players can vote on.

    **Available Customizations:**

    * **vote\_1\_name** & **vote\_1\_link** - First voting site name and link
    * **vote\_2\_name** & **vote\_2\_link** - Second voting site name and link
    * **vote\_3\_name** & **vote\_3\_link** - Third voting site name and link
    * **vote\_4\_name** & **vote\_4\_link** - Fourth voting site name and link
    * **vote\_5\_name** & **vote\_5\_link** - Fifth voting site name and link

    Display multiple voting options to encourage players to vote for your server.
  </Accordion>

  <Accordion icon="discord" title="Discord Integration (DiscordSRV)">
    **File:** `plugins/DiscordSRV/config.yml`

    Configure Discord integration for your server players.

    **Available Customizations:**

    * **DiscordInviteLink** (Line 36) - Your Discord server invitation link shown to players when using `/discord` command and displayed to unlinked players when linking is enforced

    **Example Configuration:**

    ```yaml theme={null}
    # Invitation link shown to players when using /discord and on the message shown to unlinked players when linking is enforced
    DiscordInviteLink: "https://discord.gg/servername"
    ```

    Players can join your Discord server directly through an in-game command or prompt.

    **Reload and Test**

    * Run `/discordsrv reload` or restart the server to apply changes and test in-game
  </Accordion>

  <Accordion icon="message" title="Essentials (MoTD)">
    **File:** `plugins/Essentials/motd.txt`

    Customize the welcome message displayed when players join your server.

    **Available Customizations:**

    * **discord** - Your Discord server link/invite
    * **store** - Your server store link
    * **website** - Your official website URL

    This file displays at player login and is perfect for promoting your social channels and services.
  </Accordion>

  <Accordion icon="film" title="TAB Animations">
    **File:** `plugins/TAB/animations.yml`

    Create animated text effects in your TAB list using colorful gradient animations. The default Lifesteal animations use a red-to-purple gradient with primary color **#FF0F40** and secondary color **#FF4497**.

    **Available Customizations:**

    * **Server Name Animation** - Animated display name with gradient effects (default change-interval: 100ms)
    * **IP Animation** - Animated IP address with scrolling colors (default change-interval: 50ms)
    * **change-interval** - Speed of animation in milliseconds (lower = faster)
    * **texts** - Array of color variations for smooth animation frames

    ## How to Create Animations with AnimTab Generator

    Follow these steps to generate custom animations:

    <Steps>
      <Step title="Visit the Generator">
        Go to [AnimTab Generator](https://www.birdflop.com/resources/animtab/)
      </Step>

      <Step title="Enter Your Text">
        In the **Input Text** field, type what you want to animate (e.g., "Lifesteal" or "play.yourserver.net")
      </Step>

      <Step title="Choose Colors">
        Under the **Colors** section:

        * Set **Color 1** to your primary color (e.g., #FF0F40 for red)
        * Set **Color 2** to your secondary color (e.g., #FF4497 for purple)
        * Adjust **Gradient Length** for how many color steps (24 is recommended)
        * Adjust **Characters per color** to control gradient smoothness (1 is recommended)
      </Step>

      <Step title="Configure Animation Settings">
        In the **Output** section:

        * Set **Animation Interval (ms)** to your desired speed (100 for name, 50 for IP)
        * Keep **Animation Style** as "Normal (Left → Right)" for standard animation
        * Set **Color Format** to "\&#rrggbbdd" for Minecraft color codes
      </Step>

      <Step title="Generate Code">
        Click Generate and the tool will create all animation frames
      </Step>

      <Step title="Copy Output">
        Click **Copy** to copy the generated RGB text code
      </Step>

      <Step title="Paste into animations.yml">
        Open `plugins/TAB/animations.yml` and paste the output under the appropriate section (Lifesteal or IP)
      </Step>

      <Step title="Format the YAML">
        The copied code needs to be formatted as:

        ```yaml theme={null}
        Lifesteal:
          change-interval: 100
          texts:
          - "&#FF0F40&lL&#FF164B&lI&#FF1C56&lF..." # Copy each generated line here
          - "&#FF164B&lL&#FF0F40&lI&#FF164B&lF..."
          # ... continue with all frames
        ```

        ```yaml theme={null}
        IP:
          change-interval: 50
          texts:
          - "&#FF2450ᴘ&#FF2755ʟ&#FF2A59ᴀ&#FF2D5Eʏ..." # Copy each generated line here
          - "&#FF2755ᴘ&#FF2450ʟ&#FF2755ᴀ&#FF2A59ʏ..."
          # ... continue with all frames
        ```
      </Step>

      <Step title="Reload and Test">
        Run `/tab reload` or restart the server to apply changes and test in-game
      </Step>
    </Steps>

    <Tip>
      **Pro Tips:**

      * Use Primary Color **#FF0F40** and Secondary Color **#FF4497** for the default Lifesteal red-to-pink gradient
      * Lower change-interval values (50-75ms) create faster animations
      * Higher gradient lengths (20-30) create smoother color transitions
      * Test animations in-game before deploying to ensure they look correct
      * For **small caps text** in animations, use [**Small Caps Generator**](https://smallcaps.app) to convert your text before adding it to the AnimTab Generator
    </Tip>
  </Accordion>
</AccordionGroup>

## Quick Setup

<Steps>
  <Step title="Navigate to Files">
    Go to `plugins/RocketPlaceholders/placeholders/` in your server
  </Step>

  <Step title="Edit Socials">
    Open `socials.yml` and add your social media links
  </Step>

  <Step title="Configure Server Info">
    Open `server-info.yml` and set your server details
  </Step>

  <Step title="Set Voting Sites">
    Open `voting.yml` and add your 5 voting site links
  </Step>

  <Step title="Configure Discord Integration">
    Open `plugins/DiscordSRV/config.yml` and set your DiscordInviteLink on line 36 (e.g., `https://discord.gg/servername`)
  </Step>

  <Step title="Configure MOTD">
    Open `motd.txt` in the `plugins/Essentials/` folder and add your Discord, store, and website links
  </Step>

  <Step title="Create TAB Animations (Optional)">
    Use the [AnimTab Generator](https://www.birdflop.com/resources/animtab/) to create custom animations. Generate code with primary color #FF0F40 and secondary color #FF4497, then paste into `plugins/TAB/animations.yml`
  </Step>

  <Step title="Reload">
    Run `/rp reload`, `/tab reload`, and `/discordsrv reload` or restart the server to apply all branding changes
  </Step>

  <Step title="Test In-Game">
    Join your server to verify all links, MOTD, and animations display correctly
  </Step>
</Steps>

## Tips & Best Practices

<Note>
  All four configuration files (Server Info, Socials, Voting, and MOTD) work together to create a comprehensive branding system. Keep your links and information up-to-date to ensure players always have current contact information.
</Note>

* **Keep URLs Current** - Update links if social media or store pages change
* **Use Short Links** - Consider using URL shorteners for better appearance
* **Test All Links** - Verify each link works before deployment
* **Update Regularly** - Add new socials or voting sites as needed
* **Reload After Changes** - Remember to reload the plugin to see updates in-game

<Tip>
  Use placeholders throughout your server in scoreboards, motd, and chat to maximize engagement with your branding!
</Tip>
