AtlasPractice

Overview

AtlasPractice is an open-source Minecraft practice plugin designed for competitive servers. It provides a complete out-of-the-box practice experience with no artificial limits — no arena caps, no kit caps, no edition tiers.

Installation

Requirements

Optional Dependencies

Installation Steps

First Setup Checklist

Arena System

AtlasPractice supports unlimited arenas with no cap. Arenas are linked to kits — a single kit can have multiple arenas, and the system picks one automatically when a match starts.

Arena Modes

Arena Commands

SlimeWorldManager Integration

AtlasPractice is built around SlimeWorldManager (SWM) for arena world management. SWM stores worlds in a compact slime format, enabling instant world loading, cloning, and deletion at runtime — eliminating the traditional Minecraft world folder bottleneck.

Creating a SWM Arena World

# Step 1 — Create a new SWM world
/swm create <worldname> file

# Step 2 — Teleport into it and build or paste your arena
/swm goto <worldname>

# Step 3 — When done, unload it to save
/swm unload <worldname>

# Step 4 — Register it in AtlasPractice
/arena create <arenaName> <runtimeWorldName> <slimeWorldName>

How Runtime Cloning Works

1. A match is created and needs an arena.
2. AtlasPractice clones the SWM template world into a new runtime world name.
3. Players are teleported into the cloned world.
4. After the match ends, the runtime world is deleted.
5. The template is never touched — it is always clean and ready for the next clone.

This means you can have dozens of simultaneous matches all running in independent worlds derived from the same single template.

Auto Arena Setup

The Auto Arena Setup wizard scans an existing arena structure and automatically detects and configures spawn points, boundary regions, and mode-specific settings — saving you from running every /arena set* command manually.

Requirements

Before running Auto Setup, your arena must meet the following requirements:

• Exactly 2 Beds must exist in the arena.
• Exactly 1 Red Wool block must exist.
• Exactly 1 Blue Wool block must exist.
• No additional beds or red/blue wool blocks should be placed anywhere in the arena.
• The arena should already be created using /arena create.

When to Use It

Use Auto Setup after you have built or pasted an arena and registered it with /arena create. The scanner works best when your arena follows a symmetric layout with clearly distinguishable team bases.

Running Auto Setup

# Start Auto Setup
/arenaautosetup <arenaName> yes

# Cancel
/arenaautosetup <arenaName> no

Special Arena Types — Setup Guide

Most arenas only need red/blue spawns. The following modes require additional setup steps.

Bridge

Players race to score goals in the enemy's portal/goal zone. First team to reach the score limit wins.

1. Create the arena with /arena create.
2. Set both team spawns.
3. Run /arena goalwand to receive a goal-marking wand.
4. Right-click the goal blocks for each team to register them.
5. Optionally configure auto-bridge blocks: /arena autobridgeblocks <name>.
6. Save and enable.

BattleRush

Team-based mode. Uses goal blocks similar to Bridge.

1. Set both team spawns.
2. Use /arena goalwand to mark goal zones.
3. Save and enable.

BedFight

Destroy the opponent's bed to eliminate their respawns, then eliminate the opponent.

1. Set both team spawns.
2. Stand at each bed and run /arena setbedred <name> and /arena setbedblue <name>.
3. Save and enable.

Fireball Fight

Players fight using clutching with fireballs & Tnts, Uses standard arena setup — Click [BF/FBF] button for arena creation.

Pearl Fight

Ender-pearl-focused combat. Standard two-spawn setup.

Boxing

Unarmed combat tracked by hit count. Standard two-spawn setup. No special configuration required.

BuildUHC

Players can place blocks during the match — terrain-altering.

1. Create the SWM template world.
2. Create the arena: /arena create <name> <runtimeWorld> <slimeWorldName>.
3. The system will automatically create a fresh clone per match.

Kit System

Kits define what gear players receive when a match starts. Each kit can have multiple arenas linked to it. Kits are fully customizable — items, enchantments, potions, and player-editable layout slots.

Kit Commands

Built-in Kit Presets

AtlasPractice ships with 22 built-in kit presets. Instead of building every kit manually from scratch, run /toolazytocreatekits to open a GUI and generate any preset kit instantly.

Queue System

Players join queues from the lobby hotbar. AtlasPractice runs periodic matchmaking and pairs players automatically when two players are in the same queue.

Lobby Hotbar

Ranked System

The ranked queue uses an ELO rating system. Each kit tracks ELO independently, and there is also a global ELO that aggregates all kit performance. Only kits configured as ranked-eligible (via /allowedrankedkits) appear in the ranked queue menu.

Party System

The party system allows groups of players to play together — either in private matches against each other, in a split 1v1, or in FFA within the party.

Party Commands

Party Match Types

Duels

Challenge any player in the lobby to a private 1v1 match on a specific kit and arena.

/duel <playerName>

The challenged player receives an invite. They can accept with /accept <yourName> or decline with /deny. Duels do not affect ELO.

Cosmetics

AtlasPractice includes a full cosmetics system. Players can equip cosmetics from the lobby by right-clicking the Chest item (slot 7) or running /cosmetics.

Cosmetic Categories

Cosmetics Command

/cosmetics

Player Settings

Players can configure personal preferences via the Settings menu (Redstone Comparator in slot 8) or via /settings command.

Progression System

Players earn XP and Coins by playing matches. XP accumulates into Levels, which can unlock cosmetics and display as colored level tags via PlaceholderAPI.

Admin Commands

Level Colors

Level color ranges are configured in level-colors.yml. Each level range can have a distinct color prefix displayed in scoreboards and holograms via the %atlaspractice_level% placeholder.

Replay System

AtlasPractice integrates with AtlasReplay (optional) to record and play back matches. When AtlasReplay is installed, matches are automatically recorded in the background with no player action required.

Viewing Replays

/replays

Use /replays to open a menu containing all available replays. You can browse through old and recent matches, select a replay, and view its details before playing it. Each replay shows information such as the players involved and the match duration.

Searching for a Replay

/replay search <player1> <player2>

You can search for an exact replay by entering the players who were in the match. This makes it easier to find a specific match without having to browse through the entire replay list.

Viewing a Replay

/atlasreplayview <replayId>

After a match ends, players receive a clickable button in chat to watch their replay directly. Replays can also be selected from the /replays menu or accessed by admins using the command above with a known replay ID.

Replay Details

• View the players who participated in the match.
• See how long the match lasted.
• Browse both recent and older replays.
• Select a replay directly from the menu to watch it.
• Search for specific matches using the player names.

Benefits

• Review your own movement, combos, and mistakes.
• Watch from any angle — not just first-person.
• Useful for catch/evidence gathering.
• No performance impact on players during the match.

Spectating

Staff and players with appropriate permissions can silently spectate any live match.

/spec <playerName>
/spectate <playerName>

Spectators are invisible to match participants and cannot interact with the world. Use /spawn to return to the lobby.

Leaderboards

AtlasPractice maintains cached leaderboard rankings for Kills, Deaths, Wins, Level, XP, and Coins. Leaderboard data refreshes periodically and is exposed via PlaceholderAPI for use in holograms or scoreboards.

Leaderboard Command

/atlasleaderboard
/lb
/leaderboards

This command is admin-only and is used to manage packet holograms that display leaderboard data.

PlaceholderAPI Leaderboard Placeholders

Pattern: %atlaspractice_top_<category>_<position>_<name|value>%
Categories: wins, kills, deaths, level, xp, coins

Commands Reference

Player Commands

Admin Commands

PlaceholderAPI

When PlaceholderAPI is installed, AtlasPractice registers a atlaspractice expansion automatically on startup. These placeholders work in any plugin that supports PAPI (TAB, HolographicDisplays, CMI, FeatherBoard, etc.).

Bot Practice

Permissions

Updates

Open Source

AtlasPractice is fully open source. There are no editions, no license keys, and no feature paywalls. The entire codebase is available for everyone.

FAQ

How do I install AtlasPractice?

Install SlimeWorldManager and Citizens first (required), then drop the AtlasPractice jar into your plugins/ folder and start the server. See the Installation section for the full step-by-step guide.

How many arenas can I create?

Unlimited. There is no arena cap. Create as many as your server hardware supports.

How do runtime arenas work?

When a match starts, AtlasPractice clones your SWM template world into a fresh runtime world in memory. Each match gets its own isolated world. When the match ends, the runtime world is deleted. The template is never modified.

Can I use PlaceholderAPI?

Yes. Install PlaceholderAPI and AtlasPractice will hook into it automatically on startup. See the PlaceholderAPI section for all available placeholders.

Does Replay require ProtocolLib?

No. Replay is powered by AtlasReplay, which is a separate optional dependency. ProtocolLib is not required by AtlasPractice.

Why is Bot Practice disabled?

Bot Practice is being completely rewritten using Citizens NPCs for better AI, pathfinding, and difficulty options. The feature will return in a future update. The /bot command is registered but currently non-functional.

How do I migrate arenas from another practice plugin?

You will need to recreate arenas manually. Build or paste your existing arena in a new SWM world, then register it with /arena create. Use the Auto Arena Setup wizard to detect spawn points automatically.

What happens to arena worlds when the server restarts?

Runtime worlds (active match clones) are automatically cleaned up when the plugin disables. Your SWM template worlds are preserved — they are stored by SlimeWorldManager and are not affected by restarts.

Can I run multiple matches on the same arena simultaneously?

Yes, for arenas configured as NORMAL or SHARED type. For terrain-altering modes (BuildUHC, Bridge, BedFight), each match clones its own separate world.

How do I enable a kit for ranked play?

Run /allowedrankedkits as an admin to open the GUI. Click a kit to toggle whether it appears in the ranked queue.