Skip to content

Home

Jump to bottom
goflishMC edited this page Jun 28, 2025 · 17 revisions

🧿 Divinity Wiki

Divinity is a modular Minecraft RPG plugin that handles items, stats, durability, refinement, upgrades, and loot. This wiki provides comprehensive documentation for everything you need to configure and integrate Divinity into your server.

📘 Getting Started

🔐 Integration & Permissions

  • Commands — A complete reference for all admin and player commands.
  • Permission — A list of all permission nodes for controlling access to commands and features.
  • PlaceholderAPI Placeholders — A guide to displaying Divinity data in other plugins like scoreboards and chat.
  • Supported Plugins — Lists all plugins and services that Divinity is designed to work with.

⚙️ Actions System

🛠️ Troubleshooting & Help

🗃️ Configuration Files

🧩 Modules

  • arrows — Manages custom arrow types, behaviors, and effects.
  • combat_log — Configure the in-game logging of combat events for players.
  • consumables — Create custom food, potions, and other items that are consumed on use.
  • custom_items — A guide to defining your own unique items with custom stats and lore.
  • dismantle — Configure how players can break down items into crafting materials.
  • drops — Control custom mob drops and loot tables.
  • essences — Defines magical essences used for enchanting or crafting.
  • extractor — Configure how players can extract gems or runes from socketed items.
  • fortify — Set up the system for strengthening and upgrading equipment.
  • gems — Create and manage gems that can be socketed into items for powerful bonuses.
  • identify — Configure the system for revealing the stats of unidentified items.
  • item_generator — Control the procedural generation of random loot and treasure.
  • item_hints — Manage the hints and lore that appear on item tooltips.
  • loot — Defines loot chests and other container-based rewards.
  • magic_dust — Configure the properties of dust used in refinement and enchanting.
  • money — Manages the server's economy and integrates with currency plugins.
  • party — Configure the settings for player parties and group mechanics.
  • refine — Control the item refinement process for improving equipment quality.
  • repair — Configure custom item repair costs, methods, and mechanics.
  • runes — Create and manage runes that grant special abilities when socketed.
  • sell — Configure how players can sell items to the server or NPC shops.
  • sets — A guide to creating item sets that provide powerful bonuses when worn together.
  • soulbound — Configure how items can be permanently bound to a player.

Root Files

  • config.yml
    • divinity — High-level plugin settings and version info.
    • data — Configure database connections and data saving intervals.
    • tiers — Define the different item rarity tiers (e.g., Common, Rare, Legendary).
    • modules — Enable or disable specific gameplay modules globally.
    • Item Definitions (Sub-Types & Groups) — Create custom categories and types for items.
    • core — Core settings that affect the entire plugin.
  • data.db — Information on the SQLite database file where local data is stored.
  • engine.yml
    • packets — Low-level settings for managing network packets to reduce lag.
    • compatibility — Settings for ensuring compatibility with other server plugins.
    • performance — Adjust settings to optimize plugin performance and reduce TPS loss.
    • attributes — Define custom player attributes and how they are handled.
    • combat — Configure the core combat mechanics, including damage formulas and effects.
    • lore — Control the format and appearance of item lore and tooltips.
  • worth.yml — Define the base monetary value for items and materials.

📁 item_stats/

  • ammo.yml — Defines stats specific to custom arrows and ammunition.
  • damage.yml — Configure all possible damage-related stats for weapons.
  • defense.yml — Configure all possible defense-related stats for armor.
  • hand.yml — Defines stats related to a player's main-hand and off-hand.
  • sockets.yml — Configure how gem and rune sockets are defined on items.
  • stats.yml — Defines all general player stats that can appear on gear (e.g., Strength, Health).

📁 lang/

📁 profiles/

  • gui.profile.yml — Configure the layout and design of player-facing GUIs, like the profile screen.
  • gui.profiles.yml — Manages the different available GUI profiles a server can use.
  • gui.settings.yml — Defines the options available in the GUI settings menu.
  • settings.yml — Configure the default player-specific settings.
Clone this wiki locally