Property List

Default Property Types:

Property Types;

Double Property

• Double Properties consist of a complex number. They have the full capabilities like a Attribute has
• allowed jsons include
  • "propertyKey":5
  • "propertyKey":"5"
  • "propertyKey":"5*20*[material.density]"
  • "propertyKey":{ "operation": "**", "value": "0.5" }
  • "propertyKey":true -> this is equivalent to 1
• They are resolved like attributes, so first everything gets added, then all multipliers with "*" as Operation are added together, then all Multipliers with "**" are used to multiply the result.

Boolean Property

• behaves like a double Property, it is considered true if the total value is above 0

Full Property List

Esential Properties for Modules

Name Property

• java
• Key: name
• This property is a String.
• This property is REQUIRED on each module
• Example : "name": "blade_dagger",

Slot Property

• java
• Key: slots
• Example : "slots": { "0": { "allowed": ["sword_blade","sword_blade_small","sword_blade_large"], "transform": {"rotation": {"x": 0.0, "y": 0.0, "z": 0.0}, "translation": {"x": 3.0, "y": 3.0, "z": 0.0},"scale": {"x": 1.0, "y": 1.0, "z": 1.0}} } },
• this Property manages allowed submodules. its a Map by slotId(a Integer)
• Each moduleSlot has a List of allowed modules and a transform from the local position

Allowed Slots Property

• java
• Key: allowedInSlots
• Example : "allowedInSlots": ["sword_guard","polearm_blade"],
• This Property is a JSON array
• This is a List of Strings that Modules' Slots can allow for

Allowed Material Property

• java
• Key: allowedMaterial
• This property is a JSON Object.
• Example : "allowedMaterial": { "allowedMaterials": [ "wood", "stone", "metal", "crystal" ], "cost": 1 },
• the JSON key allowedMaterials is a List of allowed material keys/material group names.
• the Cost key is a number and describes how much of that material is needed.

Ability Properties

Abilities control Right Click behaviour of an Item

Ability Property

• java
• Key: abilities
• This Property is a List of String keys, it order determines the Order of Right Click Abilites
• Abilities set higher are tried first, f.e. abilities:[ "axe_ability", "throw"] this would use an axes Strip ability, but if not targeting anything it will try to throw the item instead

Block Ability Property

• java
• Key: blocking
• This Property is a complex Number
• Its main use is for scaling the Block Ability

Projectile Related Property

Airdrag Property

• java
• Key: air_drag
• This Property is a Double Property
• This Property scales how fast a Projectile looses Speed in air, needs to be between 0 and 1, values above 1 dont lose any speed.

Waterdrag Property

• java
• Key: water_drag
• This Property is a Double Property
• This Property scales how fast a Projectile looses Speed in Water, needs to be between 0 and 1, values above 1 dont lose any speed.

WaterGravity Property

• java
• Key: water_gravity
• This Property is a Double Property
• This Property scales how heavy a Player is considered under water and how fast he sinks

Arrow Property

• java
• Key: is_arrow
• This Property is a Boolean Property
• This Property determines if a Projectile is internally treated like an arrow or thrown Item, this changes some damage calculations

IsCrossbow Projectile Property

• java
• Key: crossbowAmmunition
• This Property is a Boolean Property
• If true lets Item be shot as a Crossbow Projectile

Enderpearl Property

• java
• Key: is_enderpearl
• This Property is a Boolean Property
• If true lets Projectiles behaves like an Enderpearl on impact, teleporting the player

Teleport Target Property

• java
• Key: teleport_target
• This Property is a Boolean Property
• If true lets Projectiles teleports the entity hit by this like it has eaten a Chorus Fruit

Enchantment Related Properties

Allowed Enchants Property

• java
• Key: enchantments
• This Property is a List of allowed or Forbidden Enchants
• Example "crafting_enchants":"allowed:"["minecraft:sharpness","minecraft:protection"]
• Alows for "allowed" and "forbidden" respecivly
• This Property determins if an Enchantment can be put onto an Item

Crafting Enchants Property

• java
• Key: crafting_enchants
• This Property is a Map of Enchantment Identifiers
• Example `"crafting_enchants":{"minecraft:sharpness":5,"minecraft:protection":3}
• This Property will enchant the Item on Craft with those Enchantments, if the Item allows for this Enchantment
• Respects This

Fake Enchants Property

• java
• Key: fake_enchant
• This Property is a Map of Enchantment Identifiers
• Example `"fake_enchant":{"minecraft:sharpness":5,"minecraft:protection":3}
• This Property will try to fake the Enchantment onto the item, no Glint or Tooltip will be seen, but in the Crafter GUI u should be able to see the Enchantment and the Effect should be applied
• Respects This

Other Properties

Attribute Property

• java
• Key: attributes
• this is a fairly complex Property that aims to allow the setting of any Attribute.
• It is a JSON array of individual Properties
• each entry in the array has the following Properties
  • attribute : this is the Identifier of the Attribute in question. this is required
  • value : this is a complex Number and the value of the Attribute . this is required
  • operation : This is the Operation used. allowed values are +,*,**. this is required
  • slot : The slot in witch the attribute should be active. this is required
  • uuid : the UUID of the attribute. Same UUID without `seperateOnItem = true' will be merged into a single add on the Item this is optional
  • seperateOnItem : a Boolean value, defaults to false. if set to true this Entry will be listed seperatly on the Item

Armor Penetration Property

• java
• Key: armor_pen
• This Property is a Double Property
• This Property is ingame scaled with a limited growth function so high values don't get ridiculous.

Armor Penetration Property

• java
• Key: equipmentSlot
• This Property is a Simple String Property
• Example: "equipmentSlot":"helmet"
• This Property should make the Item Equipable on the Equipment Slot. Its heavily recommneded to use an ItemId that is allowed on that slot as well

Food Exhaustion

• java
• Key: food_exhaustion
• This Property is a Double Property
• this property introduces a passive Food Drain onto the Player if a Item with this is worn

Fake Item Tag

• java
• Key: fake_item_tag
• This Property is a List if Tag Identifiers
• It tries to fake the Item tag onto the Item. This might cause issues with certain tags or mods and might not be detected Correctly

FireProof Property

• java
• Key: fireProof
• This Property is a Boolean Property
• if set to true items wont burn and behave like Netherite Items

Snow Walk Property

• java
• Key: canWalkOnSnow
• This Property is a Boolean Property
• if set to true and on Boots the player can walk over powdered snow like if hes wearing leather boots

Channeling Property

• java
• Key: channeling
• This Property is a Boolean Property
• If true lets Projectiles summon lightning on Impact like if it was enchanted with Channeling

Fortune Property

• java
• Key: fortune
• This Property is a Double Property
• this property increases the Fortune Level of the Item by its rounded value

Fracturing Property

• java
• Key: fracturing
• This Property is a Double Property
• this property increases Damage the lower Durability is

Current Health Damage Property

• java
• Key: healthPercent
• This Property is a Double Property
• this property increases Damage scaled with the current Health of the Target

IllagerBane Property

• java
• Key: illagerBane
• This Property is a Double Property
• this property increases Damage to illagers and other raid related Mobs

Immolate Property

• java
• Key: immolate
• This Property is a Double Property
• this property burns the holder, the target and so on (This will get reworked soon)

IsPiglinGold Property

• java
• Key: isPiglinGold
• This Property is a Boolean Property
• If set to true Piglins wont attack people wearing this as a Armor Module

ItemId Property

• java
• Key: itemId
• This Property is a simple Identifier String
• Any string here needs to be registered in Java and all defaults can be seen here

Leeching Property

• java
• Key: leeching
• This Property is a Double Property
• this property currently passivly eats a players XP to repair itself

Item Lore Property

• java
• Key: itemLore
• This Property allows for a list Item Lores.
• The "position" element can be "top" or "bottom". Top appears under item name, bottom appears above the advanced tooltip section.
• The "priority" element is optional, defaulting to 0. Lower numbers will make this appear above other text, higher numbers will make it appear below other text.
• The "text" element allows for this
• Example:

{
    "itemLore": [{
      "position" : "top",
      "text" : "TextElement"
    }]
  }

Luminous Learning Property

• java
• Key: luminiousLearning
• This Property is a Double Property
• this property increases Xp Drops from Blocks and Drops

Pillagers Guard Property

• java
• Key: pillagerGuard
• This Property is a Double Property
• this property decreases Damage from Pillagers and other Raid related Mobs

Priority Property

• java
• Key: priority
• This Property is a Double Property
• this property determins the Ordering in the GUI, lower Prio is sorted Higher

RepairPriority Property

• java
• Key: repairPriority
• This Property is a Double Property
• this property manages witch modules are allowed to contribute to the Repair Material, lower number means higher prio, all modules with the same number are allowed

Rarity Property

• java
• Key: rarity
• This Property allows you to set custom rarities, by default "common","uncommon","rare","epic", they are white, yellow,aqua and light purple respectivly

Riptide Property

• java
• Key: riptide
• This Property manges Riptide behaviour, to enable Riptide also use "riptide" in the Ability Property
• for an example look at the Trident Modules

Module Tag Property

• java
• Key: tag
• This Property is a List of String Tags. Its main use is to easily Identify groups of modules for synergies and other behaviour tweaks

Cryo Property

• java
• Key: cryo
• This Property is a Double Property
• This Property applies Cryo on ArrowHit if it is on the arrow. The higher the value, the longer and higher the applied Cryo effect is.
  For details check the Java implementation

Display Name Property

• java
• Key: displayName
• This Property is a simple String containing the Language key for the Items Displayname

Durability Property

• java
• Key: cryo
• This Property is a Double Property
• This Property determines the total Durability of the Item

Enchantments Property

• java
• Key: enchantments
• This Property contains an allowList and denyList of Enchantments, check the Java Implementations or example Modules for details

ToolOrWeaponProperty Property

• java
• Key: isWeapon
• This Property is a Boolean Property
• If set to true the Item will behave more like a Weapon(loose 2 dura on blockbreak, one on hitting sth, if false the reverse is true)

Mining Level Property

• java
• Key: mining_level
• This Property manages the Mining level
• it is a map mining_level:{"axe":"[material.mining_level]"}

Module Stats Property

• java
• Key: module_stats
• This Property supplies stats that are similar to material stat, reachable by "[module.custom_stat]"
• The idea is to give Synergies and Material Properties some guidance on for stats
• Same with the Material stats, if a stat is not set it defaults to 0
• For Obvious reasons of self reference no complex Numbers are allowed here
• the property is a simple JSON Map
• "[module.cost]" will always be redirected to the cost of the AllowedMaterials property
• Example:

{
    "module_stats": {
        "gem_size": 1,
        "power": 5
    }
  }

EquipmentSlot Property

• java
• Key: equipmentSlot
• This Property allows for a String for the prefered equipment slot, this is a bit wonky due to minecrafts behaviour sometimes, it is recommnended to stick to the slots the Itemclass behind the Id is registered for.

ApoliPower Property

• java
• Key: apoli_powers
• This Property allows for a list of apoli Powers.
• Example:

{
    "apoli_powers": [{
      "powerId" : "origins:fall_immunity",
      "slot" : "mainhand",
      "isHidden" : false,
      "isNegative" : false
    }]
  }

Crafting Condition Property Property

• java
• Key: crafting_condition
• this property contains 3 Conditions:
  • (optional <default: none>) visible: (Condition) if this module should be showen in the Crafting UI
  • (optional <default: none>) craftable: (Condition) if this module should be clickAble in the Crafting UI
  • (optional <default: none>) on_craft: (Condition) if this module should be Craftable in the Crafting UI