🌍 VC_WorldArena — Valorant Map Manager for ValoCraft

Instantly download and load real Valorant maps into your Minecraft server.
One command. Six iconic maps. Zero manual setup.

---

📖 What is VC_WorldArena?

VC_WorldArena is a companion plugin for ValoCraft that handles everything related to arena worlds.
It automatically downloads, extracts, and loads pre-built Valorant map replicas as Minecraft worlds — ready to be used as arenas in your tactical matches.

No more copying folders, no manual world loading, no configuration headaches.
Just type one command and your map is live.

---

🗺️ Available Maps

Six iconic Valorant maps are available out of the box, hosted and ready to download:

| Map | Sites | Description |
|-----|-------|-------------|
| 🏛️ Haven | A · B · C | Three-site classic — the iconic map with a middle courtyard |
| 🌊 Pearl | A · B | Underwater city with long sightlines and tight corridors |
| 🌿 Lotus | A · B · C | Ancient ruins with rotating doors and three-site chaos |
| 🏙️ Ascent | A · B | Open mid with mechanical doors — the fan favourite |
| 🕳️ Abyss | A · B | No outer walls — fall off the edge and you're gone |
| ⚡ Fracture | A · B | Unique H-shaped layout with dual attacker entry points |

Maps are built by the community and hosted on ommo.me.

---

⚡ Quick Start

# 1 — See all available maps
/vcw templates

# 2 — Download and load a map (async, progress shown in real time)
/vcw create my_haven haven

# 3 — Teleport into the world to set up spawns
/vcw tp my_haven

# 4 — Link to a ValoCraft arena
/vcw link my_haven haven_arena

That's it. Your map is downloaded, extracted, and registered as a Bukkit world in seconds.

---

🛠️ Commands

| Command | Description |
|---------|-------------|
| /vcw create <name> <template> | Download a map and load it as a world |
| /vcw templates | List all available map templates with aliases |
| /vcw list | Show all managed worlds and their status |
| /vcw tp <name> | Teleport into a world (auto-loads if needed) |
| /vcw link <world> <arena> | Link a world to a ValoCraft arena |
| /vcw load <name> | Load a previously created world |
| /vcw unload <name> | Unload a world (keeps the folder) |
| /vcw delete <name> confirm | Permanently delete a world |
| /vcw info <name> | Detailed info — template, size, players, linked arena |
| /vcw cache clear | Clear cached ZIP files to free disk space |

Aliases: /vw, /vcarena

---

🔒 World Protection

Arena worlds are automatically protected:

• ❌ Block breaking and placing are disabled for non-admins
• 🛡️ Fall damage, fire damage, and void damage are cancelled outside of matches
• 💤 No mob spawning, no weather cycle, no daylight cycle
• 💾 Auto-save is disabled — worlds stay clean between sessions

---

📦 How Downloads Work

When you run /vcw create, the plugin:

1. Downloads the map ZIP from ommo.me in an async thread — the server never lags
2. Shows real-time progress in your action bar (Downloading... 234 / 890 KB)
3. Extracts the ZIP directly into your server's world container folder
4. Flattens the folder structure automatically (no nested folders)
5. Cleans up uid.dat and session.lock for a fresh world
6. Loads the world on the main thread and teleports you in

Downloaded ZIPs are cached — if you recreate a world from the same template, no re-download is needed.

---

🔗 ValoCraft Integration

VC_WorldArena is designed to work hand-in-hand with ValoCraft:

# After creating your world and setting up spawns:
/vc arene create haven_arena
/vcw link my_haven haven_arena

# Set attacker and defender spawns (stand on the spot):
/vc arene setattaquespawn haven_arena
/vc arene setdefancespawn haven_arena

# Define bomb sites with the zone selector axe:
/vc arene setzone haven_arena 1
/vc arene setzone haven_arena 2
/vc arene setzone haven_arena 3

# Start the match:
/vc forcestart my_haven

---

📋 Requirements

| | |
|--|--|
| Server software | Paper 1.21.1+ |
| Java | 21+ |
| Required dependency | ValoCraft |
| Internet access | Required for first download of each map |
| Disk space | ~50–150 MB per map |

---

🧩 Part of the ValoCraft Plugin Suite

| Plugin | Description |
|--------|-------------|
| ValoCraft | Core plugin — agents, weapons, rounds, spike |
| VC_pack | Resource pack manager — custom textures for all items |
| VC_WorldArena | ← You are here — world and map manager |

---

📄 License & Credits

• Plugin developed by sti_moi
• Valorant maps built by the community, hosted by ommo.me
• Valorant is a trademark of Riot Games — this plugin is a fan-made project with no affiliation

---

Made by sti_moi