Skip to content

Installation

Jump to bottom
goflishMC edited this page Jun 30, 2025 · 1 revision

Installation

This page covers how to install Genesis on your Minecraft server, including its dependencies, supported platforms, and optional integrations.

✅ Requirements

  • Minecraft Server: Spigot, Paper, Purpur, or Folia
  • Java Version: Java 17 or higher (Java 21 recommended)
  • Genesis Version: Latest release or snapshot from Spigot

📦 Installation Steps

  1. Download Genesis

  2. Place it in your server

    • Drop the Genesis.jar file into your server’s /plugins/ folder.

  3. Start the server

    • Boot your server. Genesis will generate the default configuration files under: 
      /plugins/Genesis/

  4. Edit configuration files

    • You can configure menus under /plugins/Genesis/shops/.
    • Global settings: config.yml, messages.yml, pagelayout.yml, etc.
    • See the wiki for detailed configuration options.

⚙️ Recommended Dependencies

Genesis works out of the box, but the following plugins unlock additional features:

Plugin Purpose
Vault Required for money-based prices
PlaceholderAPI Enables dynamic placeholders
PlayerPoints Adds support for point-based pricing
TokenManager Token support for prices and rewards
MythicMobs Placeholder and integration support
ItemsAdder Display and item formatting support
VotingPlugin Enables voting-based rewards
Jobs Allows job-based shop conditions
Kingdoms Enables kingdom-based logic
Gringotts Item-based currency integration
BungeeCord Enables shop support across servers
Folia Adds async scheduler compatibility

Some plugin hooks require that the plugin is present at runtime. Others (like EpicSpawners) may require you to manually add the JAR during build time if you're compiling Genesis from source.

🔌 Genesis Addons

If you want to extend Genesis with custom functionality, you can install Genesis Addons. These are standalone plugins placed in the /plugins/ folder just like Genesis itself.

See Genesis Addons & Supported Plugins and Addon Integration for more info.

🔍 Troubleshooting

  • Missing PlaceholderAPI values?
    Ensure you have PlaceholderAPI installed and the correct expansions enabled (e.g., /papi ecloud download Vault and /papi reload).

  • Menus not loading?
    Check the server console for YAML errors. Invalid formatting in your .yml files will prevent the shop from loading.

  • Using Folia?
    Genesis has built-in support via a scheduler bridge. No additional setup is needed.

📁 Generated File Structure

Upon first startup, Genesis will create the following directory:

/plugins/Genesis/
├── addons/               # Drop-in addons for Genesis
├── lang/                 # Multi-language files
├── shops/                # All custom menus and shops
├── BugFinder.yml         # Debugging config
├── config.yml            # Main plugin settings
├── messages.yml          # Message and prefix customization
├── pagelayout.yml        # GUI layout, pagination controls
├── ItemDataStorage.yml   # Item format/load/save settings
└── data/                 # Runtime cache and player data

Clone this wiki locally