MythicSkywars

MythicSkyWars

A modern, high-performance SkyWars plugin built for Spigot and Paper servers, supporting Minecraft versions from 1.8 up to 26.1.2.

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.

---

✨ Overview

MythicSkyWars is designed for both standalone servers and large proxy networks. It focuses on: - Low resource usage - Fast setup - High configurability - Seamless player experience

---

🚀 Core Features

- Multi-arena support with solo and team modes - Full proxy compatibility (BungeeCord and Velocity) - Advanced cage system with customizable spawn cages (including schematic cages via WorldEdit) - Configurable chest loot system (basic, normal, overpowered + center variants) - Voting system (time, weather, chest type, modifiers, health) - Spectator mode with full controls - Scoreboards with PlaceholderAPI support (5 different states) - Kit system with in-game creation and voting - Game events (EnderDragon, Wither, MobSpawn, CrateDrop, ChestRefill, DeathMatch, ArrowRain, AnvilRain, ShrinkingBorder, and more) - Party system - MySQL support - Holographic leaderboards (DecentHolograms) - Particle effects, projectile trails, taunts, kill/win sounds, glass colors - Player statistics (wins, kills, losses, deaths, games played, XP, level, K/D, W/L) - 100% configurable messages

---

🔥 MythicSkyWars Enhancements

Gameplay & Systems

- Easy Arena Setup — reconnect to active matches after disconnect (`/rejoin`) - Easy Arena Setup — optional Lucky Block mode with NTD-LuckyBlock, custom drops, hand items, and dedicated menus - Easy Arena Setup — multiple prestige tiers with requirements (level, kills, permissions), custom prefixes, and database tracking - Easy Arena Setup — full progression with configurable XP rewards per action, progress bars, level-up reward commands - Easy Arena Setup — Hypixel-style soul well with animated spinning, rarity tiers (legendary/rare/common), soul currency - Easy Arena Setup — automatic distribution of unselected players across teams - Easy Arena Setup — mobs spawned via spawn eggs are friendly to the owner and their team, auto-target enemies - Easy Arena Setup — configurable water portal regions in lobby that auto-join players to games - Easy Arena Setup — bundled starter kit configurations - Easy Arena Setup — streamlined arena creation workflow

Visual & UX Improvements

- Cosmetics Reorganization — visual indicators with timers for chest refills - Cosmetics Reorganization — hide join/quit/death messages, water portal system - Cosmetics Reorganization — legacy-compatible cosmetics - Cosmetics Reorganization — clean directory structure

Backend & Developer Features

- Developer API Events — safely syncs bundled config updates without overwriting existing values - Developer API Events — import full player data from UltraSkyWars (kills, wins, XP, souls, levels, cosmetics, prestige) - Developer API Events — SkyWarsDeathEvent, SkyWarsJoinEvent, SkyWarsKillEvent, SkyWarsLeaveEvent, SkyWarsWinEvent, SkyWarsMatchStateChangeEvent, SkyWarsVoteEvent, SkyWarsSelectKitEvent, SkyWarsSelectTeamEvent, SkyWarsReloadEvent, SkyWarsReloadPreLoadEvent, SkywarsGameEventTriggerEvent, SkywarsGameEventAnnounceEvent

New Commands

| Command | Permission | Description | |---------|-----------|-------------| | `/sw prestige` | `sw.prestige` | Open prestige selection menu | | `/rejoin` | `sw.rejoin` | Rejoin previous match if still available | | `/leave` | `sw.leave` | Leave current match (standalone) | | `/sw soulwell` | `sw.admin` | Configure soul well location | | `/sw migrateusw` | `sw.migrateusw` | Import stats from UltraSkyWars MongoDB |

New Permissions

| Permission | Description | |-----------|-------------| | `sw.rejoin` | Use /rejoin command | | `sw.leave` | Use /leave command | | `sw.prestige` | Use prestige menu | | `sw.soulwell` | Use Soul Well from options menu | | `sw.migrateusw` | Run UltraSkyWars migration |

New Placeholders (PlaceholderAPI)

| Placeholder | Description | |-------------|-------------| | `%swr_souls%` | Total souls | | `%swr_soulwell_usages%` | Soul well spins | | `%swr_soulwell_legendaries%` | Legendary drops received | | `%swr_soulwell_rares%` | Rare drops received | | `%swr_soulwell_souls_gathered%` | Souls collected from gameplay | | `%swr_soulwell_souls_purchased%` | Souls bought with currency | | `%swr_prestige_prefix%` | Prestige tier prefix | | `%swr_prestige_id%` | Current prestige ID | | `%swr_level_display_prefix%` | Combined level + prestige display | | `%swr_players_playing_solo%` | Solo players currently in-game | | `%swr_players_playing_team%` | Team players currently in-game | | `%swr_players_waiting_solo%` | Solo players waiting | | `%swr_players_waiting_team%` | Team players waiting |

New Config Files

- `luckyblocks.yml` — XP rewards, level definitions, progress bar settings, prestige tiers, level-up rewards - `luckyblocks.yml` — Lucky Block mode settings, custom drops, hand items, chest loot integration

---

📦 Supported Versions

| Minecraft | NMS Module | |-----------|-----------| | 1.8.8 | v1_8_R3 | | 1.9.x | v1_9_R1, v1_9_R2 | | 1.10.2 | v1_10_R1 | | 1.11.2 | v1_11_R1 | | 1.12.2 | v1_12_R1 | | 1.13.2 | v1_13_R2 | | 1.14.4 | v1_14_R1 | | 1.15.1 | v1_15_R1 | | 1.16.x | v1_16_R1, v1_16_R2, v1_16_R3 | | 1.17 | v1_17_R1 | | 1.18.2 | v1_18_R2 | | 1.19 | v1_19_R1 | | 1.20.6 | v1_20_R1 | | 1.21.1 | v1_21_R1 | | 26.1.2 | v26_1_R1 |

---

⚙️ Requirements

Required

- WorldEdit

Optional

- Vault (economy support) - DecentHolograms (hologram leaderboards) - PlaceholderAPI (placeholder support) - Multiverse-Core (world management) - PartyAndFriends (BungeeCord party support) - LuckyBlocksNTD (Lucky Block mode)

---

🛠 Installation

1. Build or download the plugin jar 2. Place the jar into your `plugins` folder 3. Start the server to generate configs 4. Set lobby spawn with `/sw setspawn` 5. Create arenas and configure settings 6. Restart and enjoy

---

📋 Commands

Registered Base Commands

| Command | Aliases | Description | |---------|---------|-------------| | `/skywars` | `/sw` | Main plugin command | | `/leave` | — | Leave current match (standalone) | | `/rejoin` | — | Rejoin previous match | | `/swparty` | `/swp` | Party commands | | `/swkit` | `/swk` | Kit commands | | `/swmap` | `/swm` | Map commands |

Player Commands (`/sw ...`)

| Command | Description | |---------|-------------| | `/sw join` | Join a SkyWars match | | `/sw joinmenu [solo|team]` | Open the join menu | | `/sw quit` | Quit from the current game | | `/sw lobby` | Return to lobby | | `/sw spectate [player/map]` | Spectate a game | | `/sw stats [player]` | View player stats | | `/sw top [stat]` | Display leaderboard | | `/sw options` | Open options menu | | `/sw prestige` | Open prestige selection menu | | `/sw winsound` | Open win sound menu | | `/sw killsound` | Open kill sound menu | | `/sw glass` | Open glass color menu | | `/sw taunt` | Open taunt menu | | `/sw particle` | Open particle effect menu | | `/sw projectile` | Open projectile effect menu | | `/sw bypasslobbyslots` | Bypass lobby slot limits |

Admin Commands (`/sw ...`)

| Command | Description | |---------|-------------| | `/sw setspawn` | Set the lobby spawn | | `/sw reload` | Reload SkyWars | | `/sw start` | Force start a match | | `/sw stat [player] [stat] [method] [amount]` | Modify player stats | | `/sw clearstats [player]` | Clear a player's stats | | `/sw chestadd [type] [method] [%]` | Add items to chest loot | | `/sw chestedit` | Edit chest loot in-game | | `/sw updatetop` | Force update leaderboards | | `/sw hologram [stat] [format]` | Add a hologram leaderboard | | `/sw holoremove` | Remove closest hologram | | `/sw soulwell` | Configure soul well location | | `/sw lobbywaterportal` | Configure lobby water portals | | `/sw migrateusw` | Import stats from UltraSkyWars MongoDB | | `/sw send` | Send a player to a game | | `/sw select` | Select an arena |

Map Commands (`/swmap ...`)

| Command | Description | |---------|-------------| | `/swmap create [name]` | Create a new map | | `/swmap edit [name]` | Open map for editing | | `/swmap save [name]` | Save an open map | | `/swmap register [name]` | Register map for play | | `/swmap unregister [name]` | Remove map from play | | `/swmap delete [name]` | Delete a map | | `/swmap list` | List available maps | | `/swmap arenas` | Open Arena GUI | | `/swmap spawn [type] [team]` | Add spawn (player/spec/deathmatch/look) | | `/swmap chesttype [name]` | Toggle chest type (normal/center) | | `/swmap checkchest` | Verify chest placements | | `/swmap minimum [name] [num]` | Set minimum players | | `/swmap name [name] [display]` | Set display name | | `/swmap creator [name] [creator]` | Set creator name | | `/swmap teamsize [name] [size]` | Set team size | | `/swmap refresh [name]` | Reload map data file | | `/swmap legacyload [name]` | Import legacy beacon-based map | | `/swmap leave` | Leave map editor | | `/swmap debug` | Debug map info |

Kit Commands (`/swkit ...`)

| Command | Description | |---------|-------------| | `/swkit create [name]` | Create kit from inventory | | `/swkit update [name]` | Update kit with current inventory | | `/swkit enable [name]` | Toggle kit enabled/disabled | | `/swkit icon [name]` | Set kit icon to held item | | `/swkit lockicon [name]` | Set locked icon to held item | | `/swkit name [name] [display]` | Set display name | | `/swkit lore [name] [line] [text]` | Set lore line (1-16 or "locked") | | `/swkit position [name] [pos]` | Set menu position (0-44) | | `/swkit perm [name]` | Toggle permission requirement | | `/swkit list` | List all kits | | `/swkit load [name]` | Preview kit in inventory |

Party Commands (`/swparty ...`)

| Command | Description | |---------|-------------| | `/swparty create [name]` | Create a party | | `/swparty invite [player]` | Invite a player | | `/swparty accept` | Accept invite | | `/swparty decline` | Decline invite | | `/swparty leave` | Leave party | | `/swparty disband` | Disband party | | `/swparty info` | View party info | | `/swparty name [name]` | Change party name |

---

🔑 Permissions

Group Permissions

| Permission | Description | |-----------|-------------| | `sw.*` | All SkyWars permissions | | `sw.admin` | All admin commands | | `sw.maps` | All map commands | | `sw.kits` | All kit commands | | `sw.parties` | All party commands | | `sw.player` | All player commands |

Player Permissions

| Permission | Description | |-----------|-------------| | `sw.join` | Join games | | `sw.joinmenu` | Use join menu | | `sw.quit` | Quit games | | `sw.leave` | Use /leave command | | `sw.rejoin` | Use /rejoin command | | `sw.spectate` | Spectate games | | `sw.stats` | View stats | | `sw.top` | View leaderboard | | `sw.prestige` | Use prestige menu | | `sw.soulwell` | Use Soul Well | | `sw.soulwell.xezbethluck` | Soul well luck bonus | | `sw.votemenu` | Open vote menu | | `sw.chestvote` | Vote on chest type | | `sw.healthvote` | Vote on health | | `sw.timevote` | Vote on time | | `sw.weathervote` | Vote on weather | | `sw.modifiervote` | Vote on modifier | | `sw.winsound` | Win sound menu | | `sw.killsound` | Kill sound menu | | `sw.glass` | Glass color menu | | `sw.taunt` | Taunt menu | | `sw.projectile` | Projectile effect menu | | `sw.particle` | Particle effect menu | | `sw.colorchat` | Use color codes in chat | | `sw.signs` | Break/place SkyWars signs | | `sw.vip1` – `sw.vip5` | VIP multiplier tiers | | `sw.kit.[filename]` | Unlock specific kits | | `sw.pareffect.[name]` | Unlock particle effects | | `sw.proeffect.[name]` | Unlock projectile effects | | `sw.glasscolor.[name]` | Unlock glass colors | | `sw.killsound.[name]` | Unlock kill sounds | | `sw.winsound.[name]` | Unlock win sounds | | `sw.taunt.[name]` | Unlock taunts |

Admin Permissions

| Permission | Description | |-----------|-------------| | `sw.setspawn` | Set lobby spawn | | `sw.reload` | Reload plugin | | `sw.start` | Force start match | | `sw.stat` | Modify player stats | | `sw.clearstats` | Clear player stats | | `sw.chestadd` | Add chest loot | | `sw.chesttype` | Change chest type | | `sw.updatetop` | Update leaderboards | | `sw.migrateusw` | Run UltraSkyWars migration | | `sw.send` | Send player to game | | `sw.select` | Select arena | | `sw.allowcommands` | Use commands while in-game | | `sw.admin.joinBypass` | Bypass full game restrictions | | `sw.alterlobby` | Modify lobby | | `sw.opteleport` | OP teleport | | `sw.partychatspy` | Spy on party chat |

Map Permissions

| Permission | Description | |-----------|-------------| | `sw.map.arenas` | Use Arenas GUI | | `sw.map.create` | Create arenas | | `sw.map.edit` | Edit arenas | | `sw.map.delete` | Delete arenas | | `sw.map.list` | List arenas | | `sw.map.save` | Save arenas | | `sw.map.register` | Register arenas | | `sw.map.unregister` | Unregister arenas | | `sw.map.minimum` | Set minimum players | | `sw.map.name` | Set display name | | `sw.map.creator` | Set creator | | `sw.map.refresh` | Reload map data |

Kit Permissions

| Permission | Description | |-----------|-------------| | `sw.kit.create` | Create kits | | `sw.kit.update` | Update kits | | `sw.kit.enable` | Enable/disable kits | | `sw.kit.icon` | Set kit icon | | `sw.kit.lockicon` | Set locked icon | | `sw.kit.perm` | Toggle permission | | `sw.kit.load` | Load/preview kits | | `sw.kit.list` | List kits | | `sw.kit.lore` | Set kit lore | | `sw.kit.name` | Set kit name | | `sw.kit.position` | Set menu position |

Party Permissions

| Permission | Description | |-----------|-------------| | `sw.party.create` | Create parties | | `sw.party.invite` | Invite players | | `sw.party.accept` | Accept invites | | `sw.party.decline` | Decline invites | | `sw.party.leave` | Leave party | | `sw.party.disband` | Disband party | | `sw.party.info` | View party info |

---

📊 Placeholders

For PlaceholderAPI (use between `%` `%`):

| Placeholder | Description | |-------------|-------------| | `swr_wins` | Total wins | | `swr_losses` | Total losses | | `swr_kills` | Total kills | | `swr_deaths` | Total deaths | | `swr_xp` | XP amount | | `swr_level` | XP level | | `swr_elo` | ELO rating | | `swr_games_played` | Games played | | `swr_kill_death` | K/D ratio | | `swr_win_loss` | W/L ratio |

Scoreboard Placeholders

In-game: `{wins}` `{losses}` `{kills}` `{deaths}` `{xp}` `{level}` `{killdeath}` `{winloss}` `{balance}` In-game: `{players_needed}` `{waitingtimer}` `{nextevent_time}` `{nextevent_name}` `{kills}` `{mapname}` `{time}` `{aliveplayers}` `{players}` `{maxplayers}` `{winner}` `{winner1..8}` `{restarttime}` `{chestvote}` `{timevote}` `{healthvote}` `{weathervote}` `{modifiervote}`

---

🧑‍💻 Building

For developers (with Nexus access)

```bash git clone <repo-url> cd MythicSkyWars mvn clean package -DskipTests ```

Output: `target/MythicSkywars-<version>.jar`

📁 Project Structure

``` MythicSkywarsCore/ Main plugin logic v1_8_R3/ NMS 1.8.8 v1_9_R1/ NMS 1.9.2 v1_9_R2/ NMS 1.9.4 v1_10_R1/ NMS 1.10.2 v1_11_R1/ NMS 1.11.2 v1_12_R1/ NMS 1.12.2 v1_13_R2/ NMS 1.13.2 v1_14_R1/ NMS 1.14.4 v1_15_R1/ NMS 1.15.1 v1_16_R1/ NMS 1.16.1 v1_16_R2/ NMS 1.16.2 v1_16_R3/ NMS 1.16.4 v1_17_R1/ NMS 1.17 v1_18_R2/ NMS 1.18.2 v1_19_R1/ NMS 1.19 v1_20_R1/ NMS 1.20.6 v1_21_R1/ NMS 1.21.1 v26_1_R1/ NMS 26.1.2 mythicskywars-assembly/ Shaded build module build.bat Build + deploy to server deploy-to-nexus.ps1 Upload BuildTools artifacts to Nexus ```

---

📜 License

This project originates from MythicSkywars. All original code remains under its respective license. New modifications and additions are maintained independently by the Mythical team.