> ## Documentation Index
> Fetch the complete documentation index at: https://mbcz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Gamesmith

> Build your own minigames in-game with a GUI editor. Nine ready-to-play games, arenas included.

![A Color Drop match: a colour is called, the other tiles fall away and the last player standing wins](https://mintcdn.com/mbcz/QkWCVhRsXYrGqZUc/images/gamesmith/colordrop.gif?s=79a0aabe8fba68398076bdd50de706f1)

**Gamesmith** lets you build minigames in-game. A game is an arena, its spawns and zones, a few phases, and rules like "when a player falls below Y 5, eliminate them". You click those together in a chest-menu editor, press **Test**, and you are in a match with a countdown, a boss bar timer, a live scoreboard and rewards at the end.

Nine games ship ready to play. `/gs create` builds one at your feet, arena included. When a match ends, every player gets their inventory, XP, health, effects and location back, and the arena is put back block for block.

## Get Gamesmith

> [card] Gamesmith PRO
>
> Available on Voxel Shop. Unlimited games, MythicMobs, Typewriter, money and command rewards, leaderboards, placeholders and fresh-world matches.

> [card] Gamesmith Lite
>
> The free edition: the full editor and all nine presets, up to three games. Coming soon.

PRO needs a licence key. You claim it in Discord with `/claim GAMESMITH`. See [Installation](https://mbcz.mintlify.site/gamesmith/installation.md).

## What you get

* **Nine games on day one:** Sumo, Color Drop, Lava Rising, Sky Sprint, Domination, Outpost Raid, Spleef, King of the Hill and Mob Waves. Six bring a complete themed map.
* **A real editor:** every preset is built with the same editor you get, so you can open any of them and change anything.
* **Rules without code:** 12 triggers and 17 actions. King of the Hill is three rules.
* **Teams, kits, win rules and rewards:** free-for-all or up to eight coloured teams, four ways to win, rewards for winners and for everyone.
* **Nothing breaks your world:** players and arenas come back as they were after every match, and a crash mid-match does not lose them.
* **Plays with your stack:** MythicMobs bosses, Typewriter entries, Vault money and PlaceholderAPI (PRO).

## Lite vs PRO

| | Gamesmith Lite (free) | Gamesmith PRO |
| - | - | - |
| GUI editor, 12 triggers, nine presets | Yes | Yes |
| Actions | 15 | 17 (adds console command and Typewriter entry) |
| Games on the server | 3, presets included | Unlimited |
| Mobs | Vanilla | Vanilla and MythicMobs (`mythic:<id>`) |
| Rewards | XP and items | XP, items, Vault money and console commands |
| `/gs top` leaderboards | No | Yes |
| PlaceholderAPI placeholders | No | Yes |
| Arena reset | Put blocks back | Put blocks back, or a fresh world per match on AdvancedSlimePaper |
| Licence key | Not needed | Required |

Lite still records wins and games played. Players see their wins on each game in the `/gs` menu.

## Compatibility

* **Server software:** Paper `1.20.6` through `26.3`. Spigot and Folia are not supported.
* **Java:** 21 or newer. Paper `26.x` servers need Java 25.
* **Required plugins:** none.
* **Optional plugins:** MythicMobs, Typewriter, Vault with an economy plugin, PlaceholderAPI and AdvancedSlimePaper (all used by PRO features). Multiverse-Core, Hyperverse, MultiWorld and MyWorlds load before Gamesmith when present, so arenas in their worlds work.
* **Editor input:** a native input form on `1.21.6` and newer, one chat line on older servers.

> [!NOTE]
>
> Gamesmith PRO checks its licence key on every startup, so the server needs internet access. See [Installation](https://mbcz.mintlify.site/gamesmith/installation.md#claim-your-licence-key).

## Quick commands

```text theme={null}
/gs                         pick a game from the menu
/gs join <game>             join a game
/gs create lava lavarise    build Lava Rising at your feet
/gs edit lava               open the editor
/gs list                    every game and its state
```

## Documentation sections

> [card] [Installation](https://mbcz.mintlify.site/gamesmith/installation.md)
>
> Drop the jar, claim the PRO key, make your first game.

> [card] [Preset games](https://mbcz.mintlify.site/gamesmith/presets.md)
>
> The nine ready-to-play games and how each one works.

> [card] [Build a game](https://mbcz.mintlify.site/gamesmith/build-a-game.md)
>
> King of the Hill from a blank game, step by step.

> [card] [The editor](https://mbcz.mintlify.site/gamesmith/editor.md)
>
> Every menu: arena, teams, kit, phases, rules, win, settings.

> [card] [Rules](https://mbcz.mintlify.site/gamesmith/rules.md)
>
> All 12 triggers and 17 actions, with their settings.

> [card] [Arenas](https://mbcz.mintlify.site/gamesmith/arenas.md)
>
> Regions, markers, zones, protection and arena resets.

> [card] [Matches](https://mbcz.mintlify.site/gamesmith/matches.md)
>
> Lobby, countdown, scoring, eliminations, restores.

> [card] [Integrations](https://mbcz.mintlify.site/gamesmith/integrations.md)
>
> MythicMobs, Typewriter, Vault, PlaceholderAPI, AdvancedSlimePaper.

> [card] [Commands](https://mbcz.mintlify.site/gamesmith/commands.md)
>
> Player and admin `/gs` commands.

> [card] [Permissions](https://mbcz.mintlify.site/gamesmith/permissions.md)
>
> `gamesmith.play`, `gamesmith.admin` and `gamesmith.bypass`.

> [card] [Configuration](https://mbcz.mintlify.site/gamesmith/configuration.md)
>
> `config.yml`, `messages.yml`, `editor.yml` and game files.

> [card] [Placeholders](https://mbcz.mintlify.site/gamesmith/placeholders.md)
>
> PRO PlaceholderAPI placeholders for wins, games and scores.

> [card] [FAQ](https://mbcz.mintlify.site/gamesmith/faq.md)
>
> Licence, limits, resets, Lite cap and troubleshooting.

## Support

> [card] [Discord](https://discord.gg/kgHNjJsB2t)
>
> Claim your PRO key with `/claim GAMESMITH` and get support.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.