# Getting started

Canonical: https://splugins.net/docs/executablegems/questions-or-guides/tutorials/getting-started

# 🚀 Getting started

In 10 minutes you will install the plugin, place a forge and socket your first gem.

## 1. Install

Put these three files in your `plugins/` folder, then **stop and start** the server:

- `SCore`
- `ExecutableItems`
- `ExecutableGems`

The server must run [Paper](https://papermc.io/) 1.21.11 or newer. See [How to install correctly](/docs/executablegems/questions-or-guides/frequently-asked-questions/how-to-install-correctly) if something goes wrong.

In the console, you should see:

```
[ExecutableGems] Gems loaded: 37 in 7 categories, runewords: 12
[ExecutableGems] Ready. Gems run through ExecutableItems' activators.
```

## 2. Accept the resource pack

Join the server and **accept the resource pack**. It holds the gems, the forge and the menus.

## 3. Give yourself what you need

```
/give YourName netherite_sword
/eg give YourName vampire 5
/eg give YourName empower 3
/eg tool YourName socket_drill
/eg tool YourName gem_forge
```

Replace `YourName` with your name. A sword has one socket: the drill will add a second one.

## 4. Socket a gem in your inventory

Switch to **survival** (`/gamemode survival`), because the inventory method does not work in creative. Open your inventory, pick up the **Vampire Rune** and click on the sword.

At level 5, the Vampire Rune has an 85% chance of success, so a window asks you to confirm. If the gem shatters, give yourself another one: the sword is safe.

The sword now has a gem. Hover over it to see it:

![A gem on the cursor: the items it fits show the chance of success](https://media.ssomar.com/m/docs-img-eg-cursor-hints.jpg)

## 5. Place a forge

Hold the **Gem Forge** and right-click the top of a block. A jeweller appears next to it.

![A forge and its jeweller](https://media.ssomar.com/m/docs-img-eg-jeweller.jpg)

## 6. Use the forge

1. Hold the sword and **right-click the forge** to lay it down.
2. Hold the **Socket Drill** and right-click: the sword gets a second socket.
3. Hold the **Empower Support** and right-click: the ritual starts. When the ring turns gold, click again for a perfect strike.
4. Empty your hand and right-click to take the sword back.

![The panel of the forge](https://media.ssomar.com/m/docs-img-eg-forge-panel.jpg)

Hover over your sword. The Vampire Rune is boosted by the support next to it:

![A rune boosted by a support gem](https://media.ssomar.com/m/docs-img-eg-host-linked.png)

## 7. Test it

Spawn a training dummy. It never dies and shows each hit as a floating number:

```
/eg dummy
/eg luck YourName on
```

`/eg luck` makes every chance succeed, so you see the gem work at each hit. Turn it off afterwards with `/eg luck YourName off`.

## 8. Let your players use gems

> **DANGER**
**Give your players the permission `ei.item.*`**

A gem runs through ExecutableItems, which checks the permission of the item. A player who is not OP needs **`ei.item.*`**, or every gem shows "You do not have the permission to use eg_..." and does nothing.

With LuckPerms: `/lp group default permission set ei.item.* true`

Without a permission plugin, put this in the `permissions.yml` of your server and restart:

```yaml
ei.item.*:
  default: true
```

## 9. Choose what's next

- Read the [config](/docs/executablegems/configurations/general-configuration) to change the drop rates and prices.
- See the [list of gems](/docs/executablegems/gems/overview).
- [Create your first gem](/docs/executablegems/questions-or-guides/tutorials/your-first-gem).