Installation

Requirements

• Server: Spigot or Paper, Minecraft 1.21.x

• Java: Version 17+ (recommended)

• Permissions: Access to your server’s plugins/ folder

---

1. Download CoreItems

Head to the latest release page (SpigotMC or GitHub) and download CoreItems.jar.

---

2. Install the Plugin

1. Stop your server

2. Copy CoreItems-x.jar into your server’s plugins/ directory

3. Start or restart the server

On startup, CoreItems will:

• Generate a config.yml under plugins/CoreItems/

• Create the plugins/CoreItems/customs/ folder

---

3. Default Folder Structure

After installation, you should see:

• plugins/CoreItems/config.yml

• plugins/CoreItems/customs/

  • (empty until you add namespaces)

---

4. Create Your First Namespace

1. Inside plugins/CoreItems/customs/, make a new folder. This is your namespace (e.g., weapons, tools).

2. In that folder, create customs.yml

3. Open customs.yml and add your item definitions (see Configuration page)

---

5. Verifying Installation

• In the server console, you’ll see a log line like “CoreItems has loaded successfully.”

• In-game, run /coreitems list to see if the plugin responds

• Open /coreitems menu to launch the item browser GUI

---

6. Troubleshooting

• Plugin didn’t load?

  • Ensure the JAR is in the correct plugins/ folder

  • Confirm your server version and Java version meet requirements

• No default config or folder generated?

  • Check console for startup errors

  • Verify file-system permissions allow CoreItems to write

• Commands not recognized?

  • Make sure you ran /coreitems reload after install

  • Check you have the coreitems.command.* or OP permissions

---

Next Steps

Once installed and verified:

1. Proceed to Configuration to tailor global settings and namespace behavior

2. Visit Commands & Permissions to assign users access

3. Head to Creating Custom Items to start defining your own items