Pages » Qrpg » Modules » Magicdust


Commands

Command Arguments Description Player only Permission(s)
/magicdust open -
[player]
[player] [force(true/false)]
Opens Magic Dust GUI.
Opens Magic Dust GUI to specified player.
Force opens Magic Dust GUI to specified player.
Yes
No
No
quantumrpg.magicdust.cmd.open
/magicdust get [id] [level] [amount] Get specified module item. Yes quantumrpg.admin
/magicdust give [player] [id] [level] [amount] Give specified module item to a player. No quantumrpg.admin
/magicdust drop [world] [x] [y] [z] [id] [level] [amount] Drop specified module item at specified location. No quantumrpg.admin
/magicdust list - List of all module items. No quantumrpg.admin

Permissions

Permission Description
quantumrpg.magicdust Full access to MagicDust module.
quantumrpg.magicdust.cmd Access to all MagicDust commands.
quantumrpg.magicdust.gui Allows to use Magic Dust GUI.

Settings.yml

general:
  # Custom Actions that will be executed when magic dust is successfully applied.
  actions-apply:
    default:
      target-selectors:
        self:
        - '[SELF]'
      conditions:
        list: []
        actions-on-fail: 'null'
      action-executors:
      - '[PARTICLE_SIMPLE] ~name: SPELL_WITCH; ~offset: 0.25,0.4,0.25; ~speed: 0.2; ~amount: 50; ~target: self;'
      - '[SOUND] ~name: BLOCK_NOTE_BLOCK_BELL; ~target: self;'
  # Custom Actions that will be executed when magic dust is unsuccessfully applied.
  actions-error:
    default:
      target-selectors:
        self:
        - '[SELF]'
      conditions:
        list: []
        actions-on-fail: 'null'
      action-executors:
      - '[SOUND] ~name: ENTITY_VILLAGER_NO; ~target: self;'


# Global module item format.
# All items inside the module has it's own config file with their own name and lore settings.
# When item is generated, it's name and lore will be replaced with these values.
# This allows you to have the same format for all module items without manually editing each item.
# Placeholders:
# - Tier Placeholders.
# - %ITEM_NAME% - Item name.
# - %ITEM_LORE% - Item lore.
# - %ITEM_LEVEL% - Item level number.
# - %ITEM_LEVEL_ROMAN% - Item level in Roman number.
# - %ITEM_UNTRADEABLE% - Applies Untradeable Attribute (must be enabled in Soulbound module).
# - %TARGET_LEVEL% - Applies and displays level requirement for the target item.
# - %TARGET_TYPE% - Applies and displays item type requirement for the target item.
# - %TARGET_MODULE% - Applies and displays module requirement for the target item.
item-format:
  name: '%TIER_COLOR%%ITEM_NAME% (Lv. %ITEM_LEVEL%)'
  lore:
  - '&8&m               &f  「 INFO 」  &8&m               '
  - '&7Tier: %TIER_NAME%'
  - '%ITEM_LORE%'
  - '&8&m         &f  「 REQUIREMENTS 」  &8&m        '
  - '%TARGET_LEVEL%'
  - '%TARGET_TYPE%'
  - '%TARGET_MODULE%'
  - '&8&m               &f 「 USAGE 」 &8&m               '
  - '&7Drag & drop onto item to apply.'

# Magic Dust GUI.
gui:
  # Paid GUI appears when using open command or interact with special NPC.
  paid:
    title: Enchant Rate Improvement
    size: 36
    item-slot: 4
    # Buttons to select the magic dust.
    dust-buttons:
      # Button identifier. Must be unique.
      dust_1_percent:
        material: GLOWSTONE_DUST
        amount: 1
        name: '&e&lAdd 1%'
        # Placeholders:
        # - %rate-max% - Success rate capacity for this magic dust.
        # - %rate-old% - Current item successful rate.
        # - %rate-new% - Item successful rate after applying magic dust.
        # - %cost% - Cost for applying magic dust.
        # - %balance% - Current player balance.
        lore:
        - '&cCapacity: &4%rate-max%%'
        - '&7'
        - '&6Result: &e%rate-old%% &6-> &a%rate-new%%'
        - '&6Cost: &e$%cost%'
        - '&6You have: &e$%balance%'
        # Amount of added successful rate to item per one usage.
        rate-amount: 1
        # Magic dust applying cost.
        rate-cost: 150
        # Max. possible successful rate this magic dust can apply.
        rate-max: 80
        slots: 19
        type: NONE
      dust_2_percent:
        material: GLOWSTONE_DUST
        amount: 2
        name: '&e&lAdd 2%'
        lore:
        - '&cCapacity: &4%rate-max%%'
        - '&7'
        - '&6Result: &e%rate-old%% &6-> &a%rate-new%%'
        - '&6Cost: &e$%cost%'
        - '&6You have: &e$%balance%'
        rate-amount: 2
        rate-cost: 300
        rate-max: 80
        slots: 21
        type: NONE
      dust_5_percent:
        material: GLOWSTONE_DUST
        amount: 5
        name: '&e&lAdd 5%'
        lore:
        - '&cCapacity: &4%rate-max%%'
        - '&7'
        - '&6Result: &e%rate-old%% &6-> &a%rate-new%%'
        - '&6Cost: &e$%cost%'
        - '&6You have: &e$%balance%'
        rate-amount: 5
        rate-cost: 750
        rate-max: 80
        slots: 23
        type: NONE
      dust_10_percent:
        material: GLOWSTONE_DUST
        amount: 10
        name: '&e&lAdd 10%'
        lore:
        - '&cCapacity: &4%rate-max%%'
        - '&7'
        - '&6Result: &e%rate-old%% &6-> &a%rate-new%%'
        - '&6Cost: &e$%cost%'
        - '&6You have: &e$%balance%'
        rate-amount: 10
        rate-cost: 1500
        rate-max: 80
        slots: 25
        type: NONE
    # Your other custom items.
    content:
      filler_black:
        material: BLACK_STAINED_GLASS_PANE
        name: '&7'
        slots: 2,6,9,18,27,11,20,29,13,22,31,15,24,33,17,26,35
        type: NONE
      filler_yellow:
        material: YELLOW_STAINED_GLASS_PANE
        name: '&7'
        slots: 10,28,12,30,14,32,16,34
        type: NONE
      filler_orange:
        material: ORANGE_STAINED_GLASS_PANE
        name: '&7'
        slots: 1,3,5,7
        type: NONE
      exit:
        material: RED_STAINED_GLASS_PANE
        name: '&cClose & Exit'
        slots: 0,8
        type: EXIT

Item Example

material: REDSTONE
name: '&cRed Magic Dust'
# Placeholders:
# - %rate-max% - Success rate capacity for this magic dust.
# - %rate-amount% - Amount of rate this magic dust will add.
lore: []

rate-increasing:
  # Max. possible successful rate value, until this magic dust can be applied.
  max-value: 80
  # Amount of added successful rate depends on the dust level.
  # Dust will always use the greatest key less than or equal to the dust level.
  values-by-level:
    '1': 1
    '2': 2
    '3': 3
    '4': 4
    '5': 5

# [Optional] Custom item model data from resourcepack.
model-data: 123

# [Optional] Item amount.
amount: 1

# [Optional] Item durability value.
durability: 10

# [Optional]
# Custom head texture. For player heads only.
# Some textures can be find here: https://minecraft-heads.com/
skull-hash: ''

# [Optional] 
# Adds random enchantment to make item glow.
enchanted: false

# [Optional]
# Item color for Leather armor and Potions.
# Syntax: R,G,B. -1 will define random color (0-255).
color: 255,255,255

# [Optional]
# Makes item unbreakable.
unbreakable: false

# [Optional]
# Item Flags. Use '*' to apply all flags.
# All flags you can find - HERE -
item-flags:
- HIDE_ATTRIBUTES
- HIDE_ENCHANTS

# [Required]
# Item Tier.
# If item missed this setting, it will throw an console error and won't be loaded.
tier: rare

# [Required]
# Item level.
level:
  min: 1
  max: 2

# [Optional]
# Defines how many times item can be used before it disappears.
# NOTE: When this setting is missed, item will have unlimited charges amount!
# Item will always use the greatest key less than or equal to the item level.
uses-by-level:
  '1': 1 # 1 charge at 1 level.
  '2': 3 # 3 charges at 2 levels 2-4.
  '5': 10 # 10 charges at level 5

# [Optional]
# This item will be applicable to the target item only if all the requirements are met.
target-requirements:
  # Item Group or Item Type or Material requirements.
  type:
  - 'armor'
  - 'sword'
  # Item level requirements.
  # Item will always use the greatest key less than or equal to the item level.
  # Allowed syntaxes:
  # - [level] - Exact level requirement.
  # - [min]:[max] - Exact ranged level requirement.
  # - [min~max] - Exact random level requirement.
  # - [min1~min2]:[max1] - Ranged random of two min. and one max. levels requirement and vice versa.
  # - [min1~min2]:[max1~max2] - Ranged random of two min. and two max. levels requirement.
  # Allowed placeholders:
  # - %ITEM_LEVEL% - Item level.
  level:
    '1': 10
    '2': '10:15'
    '3': '15~20'
  # Module requirements. Use '*' to include all the modules.
  # If target item is not from a QRPG module, this requirement will always fails.
  module:
  - '*'

Information
Empty Block

18+