> For the complete documentation index, see [llms.txt](https://mrobliviate.gitbook.io/masterduels-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mrobliviate.gitbook.io/masterduels-wiki/for-non-clients/introduction.md). # Introduction ## Why MasterDuels? Our philosophy is "**tons of features which have disable button**". MasterDuels has everything that you need and more. You can disable entire parts of it from the config file. Features of MasterDuels are works part-by-part. So each of these are perfectly removable. ### Simple from outside *"be simple to understand. have a complex backend."* MasterDuels is extremely simple for new players and extremely configurable for experienced players. A newbie can use `/duel ` to invite somebody straight away, or `/duel queue menu` to join a duel queue easily. Literally all attributes of duel matches are configurable in MasterDuels. Just use /duel creator to open advanced match builder. More details explained under features title. ### Performance Arena clearing is a huge problem for duel plugins. That is why MasterDuels has its own smart arena clearing mode, which deletes only the blocks players placed. This technique decreases 95%+ of set-block tasks. MasterDuels automatically optimizes duel worlds' mob spawns, random ticks, and more. *(We don't go into deep changes without permission. Turn on from config, to enable automatic optimizing).* ### Shape of your server *"tons of features which have disable button"* As we said before, MasterDuels is end-to-end configurable. It's available for mini-game servers, PvP servers, Factions servers, Survival servers, Skyblock servers, and derivatives! This say, does not only mean toggleable features. MasterDuels cares visuality. It never hesitate to use boss bars, scoreboards, titles, action bars, sounds, and GUIs.
Translation for Wizards ### L╎ᒲ╎ℸ ̣ ꖎᒷᓭᓭ d⚍ᒷꖎ ⊣ᔑᒲᒷᓭ 𝙹⎓ mᔑᓭℸ ̣ ᒷ∷d⚍ᒷꖎᓭ ╎ᓭ ᒷ ̇/ℸ ̣ ∷ᒷᒲᒷꖎ|| ᒷ ̇/ℸ ̣ ᒷリ↸ᔑʖꖎᒷ. 20⍊20 ↸⚍ᒷꖎᓭ, 5 ∷𝙹⚍リ↸ᓭ ↸⚍ᒷꖎ ⊣ᔑᒲᒷᓭ, ᓵ⚍ᓭℸ ̣ 𝙹ᒲ ⊣ᔑᒲᒷ ∷⚍ꖎᒷᓭ(リ𝙹 ʖ𝙹∴, リ𝙹 ⎓╎∷ᒷ, ᒷℸ ̣ ᓵ.), ᔑリ↸ ᒲ⚍ᓵ⍑ ᒲ𝙹∷ᒷ! i⎓ ||𝙹⚍ ∴ᔑリℸ ̣ ᔑリ||ℸ ̣ ⍑╎リ⊣, mᔑᓭℸ ̣ ᒷ∷d⚍ᒷꖎᓭ ╎ᓭ ∷ᒷᔑ↸|| ⎓𝙹∷ ╎ℸ ̣. ### pᒷ∷⎓𝙹∷ᒲᔑリᓵᒷ a∷ᒷリᔑ ᓵꖎᒷᔑ∷╎リ⊣ ╎ᓭ ᔑ ⍑⚍⊣ᒷ !¡∷𝙹ʖꖎᒷᒲ ⎓𝙹∷ ↸⚍ᒷꖎ !¡ꖎ⚍⊣╎リᓭ. T⍑ᔑℸ ̣ ╎ᓭ ∴⍑|| mᔑᓭℸ ̣ ᒷ∷d⚍ᒷꖎᓭ ⍑ᔑᓭ 3 ↸╎⎓⎓ᒷ∷ᒷリℸ ̣ ᔑ∷ᒷリᔑ ᓵꖎᒷᔑ∷ ᒲ𝙹↸ᒷᓭ. O⚍∷ ᓭᒲᔑ∷ℸ ̣ ᔑ∷ᒷリᔑ ᓵꖎᒷᔑ∷╎リ⊣ ᒲ𝙹↸ᒷ ↸ᒷꖎᒷℸ ̣ ᒷᓭ 𝙹リꖎ|| !¡ꖎᔑᓵᒷ↸ ʖꖎ𝙹ᓵꖌᓭ ⎓∷𝙹ᒲ !¡ꖎᔑ||ᒷ∷ᓭ. T⍑╎ᓭ ℸ ̣ ᒷᓵ⍑リ╎ᑑ⚍ᒷ ↸ᒷᓵ∷ᒷᔑᓭᒷᓭ 90%+ 𝙹⎓ ᓭᒷℸ ̣ -ʖꖎ𝙹ᓵꖌ ℸ ̣ ᔑᓭꖌᓭ. mᔑᓭℸ ̣ ᒷ∷d⚍ᒷꖎᓭ ᔑ⚍ℸ ̣ 𝙹ᒲᔑℸ ̣ ╎ᓵᔑꖎꖎ|| 𝙹!¡ℸ ̣ ╎ᒲ╎⨅ᒷᓭ ↸⚍ᒷꖎ ∴𝙹∷ꖎ↸ᓭ' ᒲ𝙹ʖ ᓭ!¡ᔑ∴リᓭ, ∷ᔑリ↸𝙹ᒲ ℸ ̣ ╎ᓵꖌᓭ, ᔑリ↸ ᒲ𝙹∷ᒷ. (wᒷ ↸𝙹リ'ℸ ̣ ⊣𝙹 ╎リℸ ̣ 𝙹 ↸ᒷᒷ!¡ ᓵ⍑ᔑリ⊣ᒷᓭ ∴╎ℸ ̣ ⍑𝙹⚍ℸ ̣ !¡ᒷ∷ᒲ╎ᓭᓭ╎𝙹リ. T⚍∷リ 𝙹リ ⎓∷𝙹ᒲ ᓵ𝙹リ⎓╎⊣, ℸ ̣ 𝙹 ᒷリᔑʖꖎᒷ ᔑ⚍ℸ ̣ 𝙹ᒲᔑℸ ̣ ╎ᓵ 𝙹!¡ℸ ̣ ╎ᒲ╎⨅╎リ⊣). ### s⍑ᔑ!¡ᒷ 𝙹⎓ ||𝙹⚍∷ ᓭᒷ∷⍊ᒷ∷ "ℸ ̣ 𝙹リᓭ 𝙹⎓ ⎓ᒷᔑℸ ̣ ⚍∷ᒷᓭ ∴⍑╎ᓵ⍑ ⍑ᔑ⍊ᒷ ↸╎ᓭᔑʖꖎᒷ ʖ⚍ℸ ̣ ℸ ̣ 𝙹リ" mᔑᓭℸ ̣ ᒷ∷d⚍ᒷꖎᓭ ╎ᓭ ᒷリ↸-ℸ ̣ 𝙹-ᒷリ↸ ᓵ𝙹リ⎓╎⊣⚍∷ᔑʖꖎᒷ. Iℸ ̣ ↸𝙹ᒷᓭリ'ℸ ̣ ⍑ᒷᓭ╎ℸ ̣ ᔑℸ ̣ ᒷ ℸ ̣ 𝙹 ⚍ᓭᒷ ʖ𝙹ᓭᓭ ʖᔑ∷ᓭ, ᓭᓵ𝙹∷ᒷʖ𝙹ᔑ∷↸ᓭ, ℸ ̣ ╎ℸ ̣ ꖎᒷᓭ, ᔑᓵℸ ̣ ╎𝙹リ ʖᔑ∷ᓭ, ᓭ𝙹⚍リ↸ᓭ, ᔑリ↸ guiᓭ. Iℸ ̣ 'ᓭ ᔑ⍊ᔑ╎ꖎᔑʖꖎᒷ ⎓𝙹∷ ᒲ╎リ╎-⊣ᔑᒲᒷ ᓭᒷ∷⍊ᒷ∷ᓭ, p⍊p ᓭᒷ∷⍊ᒷ∷ᓭ, fᔑᓵℸ ̣ ╎𝙹リᓭ ᓭᒷ∷⍊ᒷ∷ᓭ, s⚍∷⍊╎⍊ᔑꖎ ᓭᒷ∷⍊ᒷ∷ᓭ, sꖌ||ʖꖎ𝙹ᓵꖌ ᓭᒷ∷⍊ᒷ∷ᓭ, ᔑリ↸ ↸ᒷ∷╎⍊ᔑℸ ̣ ╎⍊ᒷᓭ!
## **Features** ### Multi Round Support If you're using MasterDuels, your players do not have to play only one round. ### Expandable Teams Your players can experience 2v2, 3v3, 5v5v5v5..., etc. games. Theoretically, MasterDuels can manage match that has unlimited team amount and unlimited team size.
### Spectators Players can spectate other duel games with "/duel spectate \" command. Spectators can change fly speed, get night vision effect and teleport to players.

hotbar of spectators

### Duel Rules Players can create custom ruled matches. All experienced server owners knows that PvP players want to rule their way. Leave the choices to the players! Seven rules ship with the plugin: `NO_SHIELD`, `NO_FIRE`, `NO_POTION`, `NO_ENDER_PEARL`, `NO_BOW`, `NO_GOLDEN_APPLE`, `NO_FISHING_ROD`. Damage, healing and consumable cooldowns are tunable per match too — see [Match Customization](/masterduels-wiki/for-clients/match-customization.md).

more details has explained under duel creator title

### Kits MasterDuels have 2 different kit mode for its games. Players are free to choose any of them. (Use duel creator to create highly configurable matches) **Various Kit Mode** -> All players can choose their own kit to play. **Mutual Kit Mode ->** All players will play with same kit. Also MasterDuels has an in-game kit editor for administrators. Visit [Kit Setup page](https://mrobliviate.gitbook.io/masterduels-wiki/for-clients/setup#kit-setup) to get more information. ### Limitations MasterDuels blocks command execution and item drop(pressing Q) during duel game. These features are so configurable. Server owners can add exceptions. Command Blocker system is game state based. So you can allow some commands during the game ending. Also server owners can allow dropped item pickupping between teammates. ### Scoreboard Show scoreboards to your players! The scoreboard is able to change for each state of duel matches. Does not depends to any scoreboard plugin and it is flickless. Visit [Scoreboard Configuration page](/masterduels-wiki/for-clients/configuration/scoreboards.md) to get more information.
### Boss Bar One of cool things in MasterDuels is boss bar support. MasterDuels draws them itself — no other plugin needed. Visit [Boss Bar Configuration page](/masterduels-wiki/for-clients/configuration/boss-bars.md) to get more information.
### Queues Join a duel queue and wait for another player to play. Players can play duel games with random players.
### Duel Histories Master Duels stores each duel match and it shows via GUI. Supports 13 internal statistic placeholders.
Placeholders * `{placed-blocks}` * `{broken-blocks}` * `{damage-dealt}` * `{damage-taken}` * `{jump}` * `{fall}` (*meters*) * `{sprint}` (*meters*) * `{click}` * `{hit-click}` * `{fish-hook-accuracy}` * `{melee-accuracy}` * `{bow-accuracy}` * `{regenerated-health}`
### Bug Protection (as much possible) MasterDuels have extra checks for potential bugs. For example, when a player places a block out of the arena zone, teleports back to the arena region. Also, when a player is teleported by MasterDuels, it checks the teleport result. ### Duel Creator If your server has MasterDuels, your players can organize their duel games end-to-end. Players can set game time, round amount, team size, team amount, duel rules, and much more! Do not forget, all features are able to disable by server owners. Duel Creator introduces advanced duel match management. If you want to compare MasterDuels with another Duel plugin, firstly you should lookup the Duel Creator.
### Arena Regeneration MasterDuels regenerates arenas with its own SMART algorithm, so you don't have to download any other dependency to use it. Two further modes are planned but **not implemented yet**. You can find a more detailed explanation on the [Arena Regeneration Page](/masterduels-wiki/for-clients/arena-regeneration.md). ### Beatiful Visuality MasterDuels uses GUIs to make its systems easy to use. Also it uses boss bars, scoreboards, titles, action bars and sounds to present good impression. ### Highly Customizable MasterDuels asks, doesn't insist. All complicated features can be disabled. All strings are editable as you wish. ### Increases Competitive MasterDuels stores player statistics and game histories. Sorts leaderboards. These increases competitive factory between players. ### Dependency Free MasterDuels doesn't have dependencies it has compatibilities. EssentialsX, CombatLogX, PvPManager, TAB, Vault and AdvancedReplay are all optional and the plugin runs unchanged without them. See [Plugin Compatibility](/masterduels-wiki/for-clients/plugin-compatibility.md). ### Presets and Rematches Not every player wants to walk the creator every time. Admins save a whole creator configuration with `/dueladmin preset save `, and players skip straight to it with `/duel invite `. After a match, `/duel rematch` offers the same fight again. ### Rejoin A player who disconnects mid-duel gets a window to come back with `/duel rejoin`. Every refusal explains itself — team eliminated, match already over, team full — rather than failing silently. ### Code Obfuscation MasterDuels doesn't have heavy obfuscation which sacrifices its performance and stability. Your wallet and server are safe. The shipped jar is obfuscated, but narrowly: only the shaded copy of the arena-core framework is renamed. MasterDuels' own classes are left alone, because the source is public and a readable stack trace from a server owner is worth more than the appearance of secrecy. The vendored GUI library, Kotlin and fsmgasm are left alone too. Nothing is shrunk or control-flow-optimised at that step, and line numbers are kept, so a stack trace you paste into an issue still points at a line of the public source. ### Lag MasterDuels does not know what lag term meaning. Full name of MasterDuels is Senior Speedy Fasty Velocity Quicky Rapidity Swifty MasterDuels.

"Speed. I am speed." -Lightning McQueen MasterDuels

## Do you need help? If you need pre-sale or after-sale help. Feel free to [contact the developer](https://www.spigotmc.org/conversations/add?to=_Obliviate_) from SpigotMC. ## Would you like to help? If you want to help us, please [contact the developer](https://www.spigotmc.org/conversations/add?to=_Obliviate_) from SpigotMC. We're looking for the language translator.