# MythicSkyWars<\/p>\n
A modern, high-performance SkyWars plugin built for Spigot and Paper servers, supporting Minecraft versions from 1.8 up to 26.1.2.<\/p>\n
This project started as a hard fork of MythicSkywars but has evolved into a fully independent and heavily extended solution focused on performance, scalability, and modern features.<\/p>\n
—<\/p>\n
## \u2728 Overview<\/p>\n
MythicSkyWars is designed for both standalone servers and large proxy networks. It focuses on:
\n– Low resource usage
\n– Fast setup
\n– High configurability
\n– Seamless player experience<\/p>\n
—<\/p>\n
## \ud83d\ude80 Core Features<\/p>\n
– Multi-arena support with solo and team modes
\n– Full proxy compatibility (BungeeCord and Velocity)
\n– Advanced cage system with customizable spawn cages (including schematic cages via WorldEdit)
\n– Configurable chest loot system (basic, normal, overpowered + center variants)
\n– Voting system (time, weather, chest type, modifiers, health)
\n– Spectator mode with full controls
\n– Scoreboards with PlaceholderAPI support (5 different states)
\n– Kit system with in-game creation and voting
\n– Game events (EnderDragon, Wither, MobSpawn, CrateDrop, ChestRefill, DeathMatch, ArrowRain, AnvilRain, ShrinkingBorder, and more)
\n– Party system
\n– MySQL support
\n– Holographic leaderboards (DecentHolograms)
\n– Particle effects, projectile trails, taunts, kill\/win sounds, glass colors
\n– Player statistics (wins, kills, losses, deaths, games played, XP, level, K\/D, W\/L)
\n– 100% configurable messages<\/p>\n
—<\/p>\n
## \ud83d\udd25 MythicSkyWars Enhancements<\/p>\n
### Gameplay & Systems
\n– **Rejoin System** \u2014 reconnect to active matches after disconnect (`\/rejoin`)
\n– **Lucky Block Integration** \u2014 optional Lucky Block mode with NTD-LuckyBlock, custom drops, hand items, and dedicated menus
\n– **Prestige System** \u2014 multiple prestige tiers with requirements (level, kills, permissions), custom prefixes, and database tracking
\n– **Level & XP System** \u2014 full progression with configurable XP rewards per action, progress bars, level-up reward commands
\n– **Soul Well** \u2014 Hypixel-style soul well with animated spinning, rarity tiers (legendary\/rare\/common), soul currency
\n– **Team Balancing** \u2014 automatic distribution of unselected players across teams
\n– **Summoned Mob System** \u2014 mobs spawned via spawn eggs are friendly to the owner and their team, auto-target enemies
\n– **Water Portal Joining** \u2014 configurable water portal regions in lobby that auto-join players to games
\n– **Default Kit Files** \u2014 bundled starter kit configurations
\n– **Easy Arena Setup** \u2014 streamlined arena creation workflow<\/p>\n
### Visual & UX Improvements
\n– **Chest Refill Visuals** \u2014 visual indicators with timers for chest refills
\n– **Lobby Enhancements** \u2014 hide join\/quit\/death messages, water portal system
\n– **Glass Color Options** \u2014 legacy-compatible cosmetics
\n– **Cosmetics Reorganization** \u2014 clean directory structure<\/p>\n
### Backend & Developer Features
\n– **Config Auto-Merge** \u2014 safely syncs bundled config updates without overwriting existing values
\n– **MongoDB Migration** \u2014 import full player data from UltraSkyWars (kills, wins, XP, souls, levels, cosmetics, prestige)
\n– **Developer API Events** \u2014 SkyWarsDeathEvent, SkyWarsJoinEvent, SkyWarsKillEvent, SkyWarsLeaveEvent, SkyWarsWinEvent, SkyWarsMatchStateChangeEvent, SkyWarsVoteEvent, SkyWarsSelectKitEvent, SkyWarsSelectTeamEvent, SkyWarsReloadEvent, SkyWarsReloadPreLoadEvent, SkywarsGameEventTriggerEvent, SkywarsGameEventAnnounceEvent<\/p>\n
### New Commands
\n| Command | Permission | Description |
\n|———|———–|————-|
\n| `\/sw prestige` | `sw.prestige` | Open prestige selection menu |
\n| `\/rejoin` | `sw.rejoin` | Rejoin previous match if still available |
\n| `\/leave` | `sw.leave` | Leave current match (standalone) |
\n| `\/sw soulwell` | `sw.admin` | Configure soul well location |
\n| `\/sw migrateusw` | `sw.migrateusw` | Import stats from UltraSkyWars MongoDB |<\/p>\n
### New Permissions
\n| Permission | Description |
\n|———–|————-|
\n| `sw.rejoin` | Use \/rejoin command |
\n| `sw.leave` | Use \/leave command |
\n| `sw.prestige` | Use prestige menu |
\n| `sw.soulwell` | Use Soul Well from options menu |
\n| `sw.migrateusw` | Run UltraSkyWars migration |<\/p>\n
### New Placeholders (PlaceholderAPI)
\n| Placeholder | Description |
\n|————-|————-|
\n| `%swr_souls%` | Total souls |
\n| `%swr_soulwell_usages%` | Soul well spins |
\n| `%swr_soulwell_legendaries%` | Legendary drops received |
\n| `%swr_soulwell_rares%` | Rare drops received |
\n| `%swr_soulwell_souls_gathered%` | Souls collected from gameplay |
\n| `%swr_soulwell_souls_purchased%` | Souls bought with currency |
\n| `%swr_prestige_prefix%` | Prestige tier prefix |
\n| `%swr_prestige_id%` | Current prestige ID |
\n| `%swr_level_display_prefix%` | Combined level + prestige display |
\n| `%swr_players_playing_solo%` | Solo players currently in-game |
\n| `%swr_players_playing_team%` | Team players currently in-game |
\n| `%swr_players_waiting_solo%` | Solo players waiting |
\n| `%swr_players_waiting_team%` | Team players waiting |<\/p>\n
### New Config Files
\n– **`levels.yml`** \u2014 XP rewards, level definitions, progress bar settings, prestige tiers, level-up rewards
\n– **`luckyblocks.yml`** \u2014 Lucky Block mode settings, custom drops, hand items, chest loot integration<\/p>\n
—<\/p>\n
## \ud83d\udce6 Supported Versions<\/p>\n
| Minecraft | NMS Module |
\n|———–|———–|
\n| 1.8.8 | v1_8_R3 |
\n| 1.9.x | v1_9_R1, v1_9_R2 |
\n| 1.10.2 | v1_10_R1 |
\n| 1.11.2 | v1_11_R1 |
\n| 1.12.2 | v1_12_R1 |
\n| 1.13.2 | v1_13_R2 |
\n| 1.14.4 | v1_14_R1 |
\n| 1.15.1 | v1_15_R1 |
\n| 1.16.x | v1_16_R1, v1_16_R2, v1_16_R3 |
\n| 1.17 | v1_17_R1 |
\n| 1.18.2 | v1_18_R2 |
\n| 1.19 | v1_19_R1 |
\n| 1.20.6 | v1_20_R1 |
\n| 1.21.1 | v1_21_R1 |
\n| 26.1.2 | v26_1_R1 |<\/p>\n
—<\/p>\n
## \u2699\ufe0f Requirements<\/p>\n
### Required
\n– WorldEdit<\/p>\n
### Optional
\n– Vault (economy support)
\n– DecentHolograms (hologram leaderboards)
\n– PlaceholderAPI (placeholder support)
\n– Multiverse-Core (world management)
\n– PartyAndFriends (BungeeCord party support)
\n– LuckyBlocksNTD (Lucky Block mode)<\/p>\n
—<\/p>\n
## \ud83d\udee0 Installation<\/p>\n
1. Build or download the plugin jar
\n2. Place the jar into your `plugins` folder
\n3. Start the server to generate configs
\n4. Set lobby spawn with `\/sw setspawn`
\n5. Create arenas and configure settings
\n6. Restart and enjoy<\/p>\n
—<\/p>\n
## \ud83d\udccb Commands<\/p>\n
### Registered Base Commands
\n| Command | Aliases | Description |
\n|———|———|————-|
\n| `\/skywars` | `\/sw` | Main plugin command |
\n| `\/leave` | \u2014 | Leave current match (standalone) |
\n| `\/rejoin` | \u2014 | Rejoin previous match |
\n| `\/swparty` | `\/swp` | Party commands |
\n| `\/swkit` | `\/swk` | Kit commands |
\n| `\/swmap` | `\/swm` | Map commands |<\/p>\n
### Player Commands (`\/sw …`)
\n| Command | Description |
\n|———|————-|
\n| `\/sw join` | Join a SkyWars match |
\n| `\/sw joinmenu [solo|team]` | Open the join menu |
\n| `\/sw quit` | Quit from the current game |
\n| `\/sw lobby` | Return to lobby |
\n| `\/sw spectate [player\/map]` | Spectate a game |
\n| `\/sw stats [player]` | View player stats |
\n| `\/sw top [stat]` | Display leaderboard |
\n| `\/sw options` | Open options menu |
\n| `\/sw prestige` | Open prestige selection menu |
\n| `\/sw winsound` | Open win sound menu |
\n| `\/sw killsound` | Open kill sound menu |
\n| `\/sw glass` | Open glass color menu |
\n| `\/sw taunt` | Open taunt menu |
\n| `\/sw particle` | Open particle effect menu |
\n| `\/sw projectile` | Open projectile effect menu |
\n| `\/sw bypasslobbyslots` | Bypass lobby slot limits |<\/p>\n
### Admin Commands (`\/sw …`)
\n| Command | Description |
\n|———|————-|
\n| `\/sw setspawn` | Set the lobby spawn |
\n| `\/sw reload` | Reload SkyWars |
\n| `\/sw start` | Force start a match |
\n| `\/sw stat [player] [stat] [method] [amount]` | Modify player stats |
\n| `\/sw clearstats [player]` | Clear a player’s stats |
\n| `\/sw chestadd [type] [method] [%]` | Add items to chest loot |
\n| `\/sw chestedit` | Edit chest loot in-game |
\n| `\/sw updatetop` | Force update leaderboards |
\n| `\/sw hologram [stat] [format]` | Add a hologram leaderboard |
\n| `\/sw holoremove` | Remove closest hologram |
\n| `\/sw soulwell` | Configure soul well location |
\n| `\/sw lobbywaterportal` | Configure lobby water portals |
\n| `\/sw migrateusw` | Import stats from UltraSkyWars MongoDB |
\n| `\/sw send` | Send a player to a game |
\n| `\/sw select` | Select an arena |<\/p>\n
### Map Commands (`\/swmap …`)
\n| Command | Description |
\n|———|————-|
\n| `\/swmap create [name]` | Create a new map |
\n| `\/swmap edit [name]` | Open map for editing |
\n| `\/swmap save [name]` | Save an open map |
\n| `\/swmap register [name]` | Register map for play |
\n| `\/swmap unregister [name]` | Remove map from play |
\n| `\/swmap delete [name]` | Delete a map |
\n| `\/swmap list` | List available maps |
\n| `\/swmap arenas` | Open Arena GUI |
\n| `\/swmap spawn [type] [team]` | Add spawn (player\/spec\/deathmatch\/look) |
\n| `\/swmap chesttype [name]` | Toggle chest type (normal\/center) |
\n| `\/swmap checkchest` | Verify chest placements |
\n| `\/swmap minimum [name] [num]` | Set minimum players |
\n| `\/swmap name [name] [display]` | Set display name |
\n| `\/swmap creator [name] [creator]` | Set creator name |
\n| `\/swmap teamsize [name] [size]` | Set team size |
\n| `\/swmap refresh [name]` | Reload map data file |
\n| `\/swmap legacyload [name]` | Import legacy beacon-based map |
\n| `\/swmap leave` | Leave map editor |
\n| `\/swmap debug` | Debug map info |<\/p>\n
### Kit Commands (`\/swkit …`)
\n| Command | Description |
\n|———|————-|
\n| `\/swkit create [name]` | Create kit from inventory |
\n| `\/swkit update [name]` | Update kit with current inventory |
\n| `\/swkit enable [name]` | Toggle kit enabled\/disabled |
\n| `\/swkit icon [name]` | Set kit icon to held item |
\n| `\/swkit lockicon [name]` | Set locked icon to held item |
\n| `\/swkit name [name] [display]` | Set display name |
\n| `\/swkit lore [name] [line] [text]` | Set lore line (1-16 or “locked”) |
\n| `\/swkit position [name] [pos]` | Set menu position (0-44) |
\n| `\/swkit perm [name]` | Toggle permission requirement |
\n| `\/swkit list` | List all kits |
\n| `\/swkit load [name]` | Preview kit in inventory |<\/p>\n
### Party Commands (`\/swparty …`)
\n| Command | Description |
\n|———|————-|
\n| `\/swparty create [name]` | Create a party |
\n| `\/swparty invite [player]` | Invite a player |
\n| `\/swparty accept` | Accept invite |
\n| `\/swparty decline` | Decline invite |
\n| `\/swparty leave` | Leave party |
\n| `\/swparty disband` | Disband party |
\n| `\/swparty info` | View party info |
\n| `\/swparty name [name]` | Change party name |<\/p>\n
—<\/p>\n
## \ud83d\udd11 Permissions<\/p>\n
### Group Permissions
\n| Permission | Description |
\n|———–|————-|
\n| `sw.*` | All SkyWars permissions |
\n| `sw.admin` | All admin commands |
\n| `sw.maps` | All map commands |
\n| `sw.kits` | All kit commands |
\n| `sw.parties` | All party commands |
\n| `sw.player` | All player commands |<\/p>\n
### Player Permissions
\n| Permission | Description |
\n|———–|————-|
\n| `sw.join` | Join games |
\n| `sw.joinmenu` | Use join menu |
\n| `sw.quit` | Quit games |
\n| `sw.leave` | Use \/leave command |
\n| `sw.rejoin` | Use \/rejoin command |
\n| `sw.spectate` | Spectate games |
\n| `sw.stats` | View stats |
\n| `sw.top` | View leaderboard |
\n| `sw.prestige` | Use prestige menu |
\n| `sw.soulwell` | Use Soul Well |
\n| `sw.soulwell.xezbethluck` | Soul well luck bonus |
\n| `sw.votemenu` | Open vote menu |
\n| `sw.chestvote` | Vote on chest type |
\n| `sw.healthvote` | Vote on health |
\n| `sw.timevote` | Vote on time |
\n| `sw.weathervote` | Vote on weather |
\n| `sw.modifiervote` | Vote on modifier |
\n| `sw.winsound` | Win sound menu |
\n| `sw.killsound` | Kill sound menu |
\n| `sw.glass` | Glass color menu |
\n| `sw.taunt` | Taunt menu |
\n| `sw.projectile` | Projectile effect menu |
\n| `sw.particle` | Particle effect menu |
\n| `sw.colorchat` | Use color codes in chat |
\n| `sw.signs` | Break\/place SkyWars signs |
\n| `sw.vip1` \u2013 `sw.vip5` | VIP multiplier tiers |
\n| `sw.kit.[filename]` | Unlock specific kits |
\n| `sw.pareffect.[name]` | Unlock particle effects |
\n| `sw.proeffect.[name]` | Unlock projectile effects |
\n| `sw.glasscolor.[name]` | Unlock glass colors |
\n| `sw.killsound.[name]` | Unlock kill sounds |
\n| `sw.winsound.[name]` | Unlock win sounds |
\n| `sw.taunt.[name]` | Unlock taunts |<\/p>\n
### Admin Permissions
\n| Permission | Description |
\n|———–|————-|
\n| `sw.setspawn` | Set lobby spawn |
\n| `sw.reload` | Reload plugin |
\n| `sw.start` | Force start match |
\n| `sw.stat` | Modify player stats |
\n| `sw.clearstats` | Clear player stats |
\n| `sw.chestadd` | Add chest loot |
\n| `sw.chesttype` | Change chest type |
\n| `sw.updatetop` | Update leaderboards |
\n| `sw.migrateusw` | Run UltraSkyWars migration |
\n| `sw.send` | Send player to game |
\n| `sw.select` | Select arena |
\n| `sw.allowcommands` | Use commands while in-game |
\n| `sw.admin.joinBypass` | Bypass full game restrictions |
\n| `sw.alterlobby` | Modify lobby |
\n| `sw.opteleport` | OP teleport |
\n| `sw.partychatspy` | Spy on party chat |<\/p>\n
### Map Permissions
\n| Permission | Description |
\n|———–|————-|
\n| `sw.map.arenas` | Use Arenas GUI |
\n| `sw.map.create` | Create arenas |
\n| `sw.map.edit` | Edit arenas |
\n| `sw.map.delete` | Delete arenas |
\n| `sw.map.list` | List arenas |
\n| `sw.map.save` | Save arenas |
\n| `sw.map.register` | Register arenas |
\n| `sw.map.unregister` | Unregister arenas |
\n| `sw.map.minimum` | Set minimum players |
\n| `sw.map.name` | Set display name |
\n| `sw.map.creator` | Set creator |
\n| `sw.map.refresh` | Reload map data |<\/p>\n
### Kit Permissions
\n| Permission | Description |
\n|———–|————-|
\n| `sw.kit.create` | Create kits |
\n| `sw.kit.update` | Update kits |
\n| `sw.kit.enable` | Enable\/disable kits |
\n| `sw.kit.icon` | Set kit icon |
\n| `sw.kit.lockicon` | Set locked icon |
\n| `sw.kit.perm` | Toggle permission |
\n| `sw.kit.load` | Load\/preview kits |
\n| `sw.kit.list` | List kits |
\n| `sw.kit.lore` | Set kit lore |
\n| `sw.kit.name` | Set kit name |
\n| `sw.kit.position` | Set menu position |<\/p>\n
### Party Permissions
\n| Permission | Description |
\n|———–|————-|
\n| `sw.party.create` | Create parties |
\n| `sw.party.invite` | Invite players |
\n| `sw.party.accept` | Accept invites |
\n| `sw.party.decline` | Decline invites |
\n| `sw.party.leave` | Leave party |
\n| `sw.party.disband` | Disband party |
\n| `sw.party.info` | View party info |<\/p>\n
—<\/p>\n
## \ud83d\udcca Placeholders<\/p>\n
For PlaceholderAPI (use between `%` `%`):<\/p>\n
| Placeholder | Description |
\n|————-|————-|
\n| `swr_wins` | Total wins |
\n| `swr_losses` | Total losses |
\n| `swr_kills` | Total kills |
\n| `swr_deaths` | Total deaths |
\n| `swr_xp` | XP amount |
\n| `swr_level` | XP level |
\n| `swr_elo` | ELO rating |
\n| `swr_games_played` | Games played |
\n| `swr_kill_death` | K\/D ratio |
\n| `swr_win_loss` | W\/L ratio |<\/p>\n
### Scoreboard Placeholders<\/p>\n
**Lobby:** `{wins}` `{losses}` `{kills}` `{deaths}` `{xp}` `{level}` `{killdeath}` `{winloss}` `{balance}`
\n**In-game:** `{players_needed}` `{waitingtimer}` `{nextevent_time}` `{nextevent_name}` `{kills}` `{mapname}` `{time}` `{aliveplayers}` `{players}` `{maxplayers}` `{winner}` `{winner1..8}` `{restarttime}` `{chestvote}` `{timevote}` `{healthvote}` `{weathervote}` `{modifiervote}`<\/p>\n
—<\/p>\n
## \ud83e\uddd1\u200d\ud83d\udcbb Building<\/p>\n
### For developers (with Nexus access)<\/p>\n
“`bash Output: `target\/MythicSkywars- ## \ud83d\udcc1 Project Structure<\/p>\n “` —<\/p>\n ## \ud83d\udcdc License<\/p>\n This project originates from MythicSkywars. All original code remains under its respective license. New modifications and additions are maintained independently by the Mythical team.<\/p>\n","protected":false},"excerpt":{"rendered":" The best and most up to date free skywars plugin.<\/p>\n","protected":false},"featured_media":108425,"template":"","meta":{"_minecraft_slug":"mythicskywars","_minecraft_project_id":"1aEhXtiy","_minecraft_author":"NaysKutzu","_minecraft_license":"MIT","_minecraft_downloads":60,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mythicskywars.zip","_minecraft_size_bytes":111024071,"_minecraft_version_count":28,"_minecraft_updated_at":"2026-05-15T21:11:23.370066Z","_minecraft_date_created":"2026-05-08T00:01:36.070778Z","_minecraft_date_modified":"2026-05-06T15:09:08.805799Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mythicskywars","_minecraft_icon_attachment_id":108425,"_minecraft_imported_at":"2026-06-06T06:29:34+00:00","_minecraft_import_hash":"8544f25ca3d72f428323ce7ea42c4b55","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,43,844,88,866,127,128,867,129,92,992],"mod_loader":[130,132,133,134,993],"minecraft_version":[341,360,385,449,114,117,48,50,53,58,102,41,38,31,864,83,167,163],"class_list":["post-108424","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-cursed","mod_category-economy","mod_category-equipment","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_category-waterfall","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","mod_loader-waterfall","minecraft_version-1-10-2","minecraft_version-1-11-2","minecraft_version-1-12-2","minecraft_version-1-13-2","minecraft_version-1-14-4","minecraft_version-1-15-2","minecraft_version-1-16-5","minecraft_version-1-17-1","minecraft_version-1-18-2","minecraft_version-1-19-4","minecraft_version-1-20-6","minecraft_version-1-21-11","minecraft_version-1-21-4","minecraft_version-1-8-9","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\ngit clone
\ncd MythicSkyWars
\nmvn clean package -DskipTests
\n“`<\/p>\n
\nMythicSkywarsCore\/ Main plugin logic
\nv1_8_R3\/ NMS 1.8.8
\nv1_9_R1\/ NMS 1.9.2
\nv1_9_R2\/ NMS 1.9.4
\nv1_10_R1\/ NMS 1.10.2
\nv1_11_R1\/ NMS 1.11.2
\nv1_12_R1\/ NMS 1.12.2
\nv1_13_R2\/ NMS 1.13.2
\nv1_14_R1\/ NMS 1.14.4
\nv1_15_R1\/ NMS 1.15.1
\nv1_16_R1\/ NMS 1.16.1
\nv1_16_R2\/ NMS 1.16.2
\nv1_16_R3\/ NMS 1.16.4
\nv1_17_R1\/ NMS 1.17
\nv1_18_R2\/ NMS 1.18.2
\nv1_19_R1\/ NMS 1.19
\nv1_20_R1\/ NMS 1.20.6
\nv1_21_R1\/ NMS 1.21.1
\nv26_1_R1\/ NMS 26.1.2
\nmythicskywars-assembly\/ Shaded build module
\nbuild.bat Build + deploy to server
\ndeploy-to-nexus.ps1 Upload BuildTools artifacts to Nexus
\n“`<\/p>\n