> For the complete documentation index, see [llms.txt](https://pris.gitbook.io/prism-skyblock/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pris.gitbook.io/prism-skyblock/installation-guide.md).

# Installation Guide

Downloading and getting Prism Skyblock is a walk in the park, just follow these simple steps!

{% hint style="info" %}
If you don't want to bother setting up the server, feel free to purchase the Installation Addon. We will setup the server on whatever platform you prefer, and make sure it runs smoothly!
{% endhint %}

## Notes

* The setup is built on using **Nexo**, and it is <mark style="color:yellow;">strongly recommended</mark> to use said plugin. Using ItemsAdder is possible, but it will come with some drawbacks, refer to [Nexo vs ItemsAdder](https://pris.gitbook.io/prism-skyblock/nexo-vs-itemsadder.md).
* The setup doesn't natively support Bedrock.

## Requirements

<table><thead><tr><th width="282.921875" align="center">Plugins</th><th width="262.55859375" align="center">Note</th><th align="center">Required?</th></tr></thead><tbody><tr><td align="center"><a href="https://www.spigotmc.org/resources/%EF%B8%8F%E2%9A%94%EF%B8%8F-mmoitems-%E2%9A%94%EF%B8%8F-items-weapons-armor-sets-tiers-editor-gui-skills.39267/">MMOItems</a> (Paid)</td><td align="center">Use latest dev-build</td><td align="center">Yes</td></tr><tr><td align="center"><a href="https://www.spigotmc.org/resources/mmocore.70575/">MMOCore</a> (Paid)</td><td align="center">Use latest dev-build</td><td align="center">Yes</td></tr><tr><td align="center"><a href="https://www.spigotmc.org/resources/mmolib-mythiclib.90306/">Mythiclib</a> (Free)</td><td align="center">Use latest dev-build</td><td align="center">Yes</td></tr><tr><td align="center"><a href="https://mythiccraft.io/index.php?resources/mythic-dungeons.869/">MythicDungeon</a> (Paid)</td><td align="center">Use latest dev-buildYes</td><td align="center"></td></tr><tr><td align="center"><a href="https://ci.citizensnpcs.co/job/Citizens2/3994/">Citizens</a> (Free)</td><td align="center">Use the build in the link</td><td align="center">Yes</td></tr><tr><td align="center"><a href="https://www.spigotmc.org/resources/%E2%9A%94-mythicmobs-free-version-%E2%96%BAthe-1-custom-mob-creator%E2%97%84.5702/">MythicMobs</a> (Free)</td><td align="center"></td><td align="center">Yes</td></tr><tr><td align="center"><a href="https://ci.lib.co.nz/job/LibsDisguises/">LibsDisguise</a> (Free)</td><td align="center">Use latest dev-build</td><td align="center">Yes</td></tr><tr><td align="center"><a href="https://polymart.org/product/6901/nexo">Nexo</a> (Paid)</td><td align="center"></td><td align="center">Refer to below</td></tr><tr><td align="center"><a href="https://www.spigotmc.org/resources/%E2%9C%A8itemsadder%E2%AD%90emotes-mobs-items-armors-hud-gui-emojis-blocks-wings-hats-liquids.73355/">ItemsAdder</a> (Paid)</td><td align="center"></td><td align="center">Refer to below</td></tr></tbody></table>

{% hint style="info" %}
For Nexo and ItemsAdder, you only need **ONE** for your server to use our setup. **Nexo** is **highly recommended**.
{% endhint %}

## Installation Guide

{% stepper %}
{% step %}

### Download latest version of PrismSkyblock from BuiltByBit/VoxelStore.

Make sure you are on latest release. After downloading, extract the zipped folder.
{% endstep %}

{% step %}

### Download Paper 26.1 .jar file, and put it in the main folder. Rename it to `paper.jar`.

{% endstep %}

{% step %}

### Download and move all dependencies plugins into the plugins folder, including either Nexo/ItemsAdder.

**\[FOR ITEMSADDER ONLY]** copy all contents from ItemsAdder-Patch folder into the plugin folder. When prompted, select **replace**.
{% endstep %}

{% step %}

### Unzip the `world-spawn.zip` file.

Make sure the world-spawn folder is the root folder (no nested folder like world-spawn/world-spawn).
{% endstep %}

{% step %}

### Start the server using the included `run.bat`.

When starting the server for the first time, it may take a bit longer to download all the required libs/data.&#x20;

The console log may report some plugins update notice, but should be generally clean. If there are any errors, report by making a thread in the Support Thread in Discord.
{% endstep %}
{% endstepper %}
