Quick Start Guide

How to get started with the Mineplex Studio.

Ready to get started with the Mineplex Studio? 🔗

These are the basic steps to get started!

1

Prerequisites

Before you can get started with the Mineplex Studio, you'll need to install the Studio CLI and GitHub CLI. You'll also need a GitHub account. Next, head to the Mineplex Studio and create a Studio developer account. You can also create and manage organizations from this site to share access across organizations. As part of the account creation process, you'll need to verify your email address and subscribe to one of our plans (this helps cover the cost of running development containers and hosting the rest of your infrastructure for free!).

2

Creating a Project

Once you've installed the Studio CLI and created a Studio Partner account, you're ready to create your first project. To do so, use the studio login and studio create-project commands. For details, see the CLI documentation.

3

Editing Your Project

When you open the project that the Studio CLI created, you'll see a few files and folders. The most important of these is the src folder, which contains the source code for your project. You can edit this code to customize your project. For example, you can add new abilities to your game, or change the behavior of existing abilities. While you have full access to the Spigot APIs from your project, we also provide a set of abstractions that make it easier to build games. For more information, see the Game API documentation. The CLI also adds a few .yaml files automatically that hold your game configuration. You can define things player count constraints, matchmaking rules, product offerings for players, and more in these files. For more information, see the configuration documentation.

4

Testing Your Project

Once you've made some changes to your project, you can test them in the Studio staging environment with the CLI hotswap command. This will build your project continuously based on file system changes and allow you to connect to a remote container IP and test your game. For more information, see the CLI documentation.

5

Deploying Your Project

Once you're happy with your changes, you can deploy them to Mineplex. By default, the Studio CLI creates a deployment action that runs via GitHub Actions in your repository whenever you push to the main branch. This action will build your project and deploy it to Mineplex. Additional features (such as publishing channels, change management, and more) are coming soon!