module fortify - magemonkeystudio/divinity GitHub Wiki

๐Ÿ›ก Fortify Module

The Fortify module lets players strengthen gear by applying Fortify items to increase attributes like item level or stats. Server owners can configure which items can be fortified, how fortify items behave, and how many uses are available.


๐Ÿ“ File Locations

plugins/Divinity/modules/fortify/
  • items/ โ€” Defines Fortify tools (used to apply upgrades)
  • settings.yml (not found in code) โ€” Not currently used

๐Ÿ”ง Fortify Items

Each Fortify item is defined in:

plugins/Divinity/modules/fortify/items/

These items allow strengthening of specific gear. They support level scaling and filtering using requirements.


๐Ÿงช Example

material: NETHERITE_UPGRADE_SMITHING_TEMPLATE
name: '&dFortify Core'
tier: epic
enchanted: true
item-flags:
  - '*'

level:
  min: 1
  max: 2

uses-by-level:
  '1': 1
  '2': 2

target-requirements:
  type:
    - ARMOR
    - WEAPON
  level:
    '1': '1:10'
    '2': '11:20'
  module:
    - '*'

๐Ÿ” Field Breakdown

Field Description
material Minecraft item used as the base (e.g., NETHERITE_UPGRADE_SMITHING_TEMPLATE)
name Display name with color codes
tier Optional tier label used by some modules
enchanted Adds glowing visual effect
item-flags Controls hidden visual attributes ('*' hides all)
level Minimum and maximum levels for the fortify item
uses-by-level Number of times this item can be used at each level
target-requirements Filters which items can be fortified, by type, level, and module

๐ŸŽฏ Valid type Values

These values control what item categories the fortify tool applies to:

  • ALL
  • ARMOR
  • WEAPON
  • TOOL
  • SHIELD

โš™๏ธ Behavior

  • Players drag the Fortify item onto a compatible item.
  • The plugin checks all target-requirements.
  • If valid, the item is fortified (e.g., increases item level or unlocks power).
  • The fortify item loses a use.
  • There is no GUI, success rate, or failure logic by default.

๐Ÿชจ Example Fortify Stones

These pages provide working examples:

Each one represents a file placed under modules/fortify/items/.


๐Ÿ“‹ Commands & Permissions

Command Description Permission
/fortify fortify <item> <level> Fortifies an item with a specified level divinity.fortify.fortify
/fortify unfortify Removes fortify state from an item divinity.fortify.unfortify
/fortify help Show help page divinity.fortify.help
/fortify get <id> [level] [amount] Get a fortify item divinity.fortify.get
/fortify give <player> <id> [level] [amount] Give fortify item to a player divinity.fortify.give
/fortify drop <world> <x> <y> <z> <id> [level] [amount] Drop a fortify item at coordinates divinity.fortify.drop
/fortify list [page] List defined fortify items divinity.fortify.list
/fortify reload Reload the module divinity.fortify.reload

๐Ÿ“š Related Pages

โš ๏ธ **GitHub.com Fallback** โš ๏ธ