🧿 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

• Installation & Setup — A step-by-step guide to get Divinity running on your server.
• Understanding Data Storage — Explains how and where player and plugin data is stored.

---

🔐 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

• Actions System Hub — Start here to understand how Divinity’s scripting engine works.
• Actions Config
• Action Executors
• Action Conditions
• Target Selectors
• Action Target Parameters

---

🛠️ Troubleshooting & Help

• Common Errors & Fixes — A guide to resolving the most frequently encountered issues.
• How to Report Bugs — Provides the correct format and procedure for submitting effective bug reports.

---

🗃️ 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/

• messages_en.yml — English language file for all player-facing messages.
• messages_cn.yml — Chinese language file for all player-facing messages.

📁 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.