Install LiricTNT with Advanced Slime Paper Setup

Learn how to install LiricTNT’s required dependencies, drop the JAR, and complete first-time setup of the lobby, waiting spawn, and arena templates.

LiricTNT depends on Advanced Slime Paper for world instancing, which means your server JAR itself must be an ASP build — you cannot simply add ASP as a plugin on top of standard Paper. Read through the dependencies section below before downloading anything, then follow the steps in order.

Dependencies

Dependency	Type	Purpose
AdvancedSlimePaper (ASP)	Required	Server JAR that powers Slime world cloning and instancing
PacketEvents	Required	Optimized network packet handling for hit detection
LuckPerms	Required	Tab list sorting by rank weight and chat format prefixes/suffixes
PlaceholderAPI	Optional	Enables dynamic placeholder values in the scoreboard and tab list
CraftEngine	Optional	Custom music playback during Sudden Death phases

Standard Paper or Purpur JARs are not compatible. Your server must run the AdvancedSlimePaper JAR, which is itself a Folia-based build. Check the ASP GitHub for the correct build for your Minecraft version.

Setup Steps

1. Install Advanced Slime Paper

   Download the AdvancedSlimePaper server JAR that matches your target Minecraft version and use it as your server.jar. Start the server once to generate the default configuration files, then shut it down.

   java -Xms2G -Xmx4G -jar AdvancedSlimePaper-1.21.jar --nogui
   
2. Install PacketEvents

   Download the latest PacketEvents-spigot-x.x.x.jar from the official SpigotMC or Modrinth page and drop it into your plugins/ folder. PacketEvents is required for the optimized hit-detection system used in TNT Tag.

3. Install LuckPerms

   Download LuckPerms-Bukkit-x.x.x.jar and place it in plugins/. LuckPerms powers the tab list rank sorting and the per-rank chat format system. Without it, the plugin will fail to load.

4. Install optional plugins (recommended)

   For the best player experience, also install the following:

   • PlaceholderAPI — enables %players%, %alive%, and other live placeholders in the scoreboard and tab list
   • CraftEngine — enables the custom music track that plays during Sudden Death in TNT Tag

   Both are optional but strongly recommended for event servers.

5. Drop LiricTNT.jar into plugins/

   Place LiricTNT.jar into the plugins/ directory.

   server/
   └── plugins/
       ├── LiricTNT.jar
       ├── PacketEvents-spigot-x.x.x.jar
       ├── LuckPerms-Bukkit-x.x.x.jar
       ├── PlaceholderAPI-x.x.x.jar    ← optional
       └── CraftEngine-x.x.x.jar       ← optional
   
6. Start or restart the server

   Start the server. LiricTNT generates its default configuration files on first launch:

   • plugins/LiricTNT/config.yml — scoreboard, tab, bossbar settings
   • plugins/LiricTNT/arena.yml — lobby, waiting spawn, and arena templates
   • plugins/LiricTNT/chat-format.yml — per-rank chat format
7. Set the main lobby

   Stand at the location you want players to return to after a match ends, then run:

   /tnt setup lobby
   

   This saves your current position as the mainLobby in arena.yml.

8. Set the waiting spawn

   Move to the waiting area where players congregate before a game starts, then run:

   /tnt setup waiting
   

   This saves your position as waitingSpawn in arena.yml.

9. Create arena templates

   For each map you want to use, register it as an arena template. The name must match the name of the .slime world file on disk (without the .slime extension), and type must be tag, run, or spleef.

   /tnt arena create MyTagMap tag
   /tnt arena addspawn MyTagMap
   

   Run /tnt arena addspawn <name> once for each player spawn point on the map. See the Commands reference for the full list of arena management commands.

After completing setup you can verify everything works by running /tnt iniciar <templateName>. LiricTNT clones the Slime world, moves all online players into the arena, and starts the game immediately.