AdvanceMMO Wiki

Ultimate RPG Documentation

Installation

This guide will walk you through installing AdvanceMMO on your Minecraft server.

System Requirements

  • Minecraft Version: 1.16.5 or higher (Spigot/Paper recommended)
  • Java Version: Java 11 or higher
  • RAM: Minimum 2GB recommended (more for larger servers, especially with dungeons)
  • Database: MySQL/MariaDB (recommended) or SQLite (default)
  • Dependencies: See Step 2 below for optional plugin dependencies
Note: For the Dungeon System, you need Multiverse-Core installed. The plugin will work without it, but dungeon features will be unavailable.

Installation Steps

Step 1: Download the Plugin

  1. Download the latest AdvanceMMO.jar file
  2. Ensure you have the correct version for your server

Step 2: Install Dependencies

AdvanceMMO supports optional integrations with other plugins. These are soft dependencies - the plugin will work without them, but certain features require them:

Required for Specific Features

  • Vault - Required for economy integration (money system, trading)
  • Multiverse-Core - Required for Dungeon System (instanced dungeon worlds)

Optional Integrations

  • LuckPerms - Enhanced permission system integration
  • Magic - Magic plugin integration (if used on your server)
  • Essentials / EssentialsX - Essentials plugin integration
  • MMOLib - MMOLib integration for additional MMO features
  • ItemsAdder - ItemsAdder integration for custom items
Important: If you want to use the Dungeon System, you must install Multiverse-Core. The dungeon system creates instanced worlds for each player and requires Multiverse-Core to function.

Install the required dependencies before using their respective features. The plugin will work without optional dependencies, but those features will be disabled.

Step 3: Place the Plugin

  1. Stop your Minecraft server
  2. Place the AdvanceMMO.jar file in your plugins/ directory
  3. Start your server

Step 4: Initial Configuration

On first startup, AdvanceMMO will:

  • Create the plugin directory structure
  • Generate default configuration files
  • Set up the database (SQLite by default)

Check the console for any error messages.

Step 5: Configure Database (Optional)

If you want to use MySQL instead of SQLite:

  1. Edit plugins/AdvanceMMO/config.yml
  2. Set database.type to mysql
  3. Configure database connection settings
  4. Restart the server

See the Database Guide for detailed instructions.

Step 6: Verify Installation

To verify the installation:

  1. Check the console for "AdvanceMMO has been enabled!" message
  2. Use /mmo command in-game
  3. Check that the plugin folder was created in plugins/AdvanceMMO/

Post-Installation

After installation, you should:

  1. Review the Configuration Guide
  2. Set up Permissions
  3. Configure language files if needed
  4. Test all features

Dependency Details

Vault

Purpose: Economy integration for the money system and trading features.

Download: SpigotMC - Vault

Required for: Economy system, trading, skill respeccing costs

Status: Required if you want to use economy features

Multiverse-Core

Purpose: World management for the Dungeon System. Creates and manages instanced dungeon worlds.

Download: Bukkit - Multiverse-Core

Required for: Dungeon System (all dungeon features)

Status: Required for Dungeon System functionality

Note: Without Multiverse-Core, dungeon commands will show an error message and dungeon worlds cannot be created. All other plugin features will work normally.

LuckPerms

Purpose: Enhanced permission system integration for better permission management.

Download: LuckPerms Website

Required for: Enhanced permission features (optional)

Status: Optional - plugin works with any permission system

Other Optional Plugins

  • Magic - Integration with Magic plugin (if used)
  • Essentials / EssentialsX - Integration with Essentials features
  • MMOLib - Additional MMO library features
  • ItemsAdder - Custom items integration

These plugins are optional and only provide additional integration features if installed.

Troubleshooting

If you encounter issues during installation:

  • Check that your server version is compatible (1.16.5+)
  • Ensure required dependencies are installed (Vault for economy, Multiverse-Core for dungeons)
  • Check the console for error messages and dependency warnings
  • Verify file permissions
  • If dungeon system doesn't work, ensure Multiverse-Core is installed and enabled
  • See the Troubleshooting Guide for more help
Success! If you see "AdvanceMMO has been enabled!" in your console, the plugin is installed correctly!