Getting Started - magemonkeystudio/divinity GitHub Wiki

πŸ“˜ Installation & Setup

Welcome to Divinity, a modular Minecraft RPG plugin designed for high customization and control over item mechanics, stats, and loot. This guide walks you through how to install Divinity and get it running on your server.

βœ… Requirements

Before you begin, make sure your server meets the following:

  • Minecraft Version: 1.16.5 or higher (tested up to 1.20.4+)
  • Server Software: Spigot or Paper
  • Java Version: 17 or higher
  • Required Dependency: Codex (Spigot Page) ← replace with actual link

πŸ“¦ Installing the Plugin

  1. Download the latest version of Divinity from its Spigot Page.
  2. Download the latest version of Codex from its Spigot Page.
  3. Place both .jar files into your server’s /plugins directory.
  4. Start the server to generate default configuration files.

πŸ’‘ Need the latest dev builds? Join our Discord server to access unreleased builds, previews, and community support.

πŸ“ Generated Files

On first load, Divinity will create the following files and folders in /plugins/Divinity:

  • config.yml – Main plugin configuration
  • engine.yml – Core logic and module toggles
  • worth.yml – Economy and pricing values
  • data.db – Local SQLite database
  • Configuration folders:
    • item_stats/
    • lang/
    • profiles/
    • modules/

πŸ”„ Updating

To update:

  1. Download the latest .jar files from Spigot or our Discord.
  2. Replace the existing jars in /plugins.
  3. Restart your server.
  4. Compare your config files with any new defaults using a diff tool.

❗ Common Issues

  • Plugin doesn’t load: Make sure Java 17+ is installed and Codex is present.
  • Missing folders/configs: Delete the Divinity folder and restart to regenerate them.
  • Unsupported environments: Only Spigot and Paper are officially supported.

❓ Need help or want to suggest a feature? Join our Discord server.