NightExpress's Plugins Wiki

Powerful fully random item generator. Generate items with randomized stats, damage, defense, sockets, enchants and more.

Generator:

  • Tier name and color
  • Random item name prefix and suffix.
  • Prefix and suffix chance.
  • List of black/white listed materials.
  • Material/Model data list for item textures.
  • Player level requirements depends on item level.
  • Player class requirements.
  • Randomized Item Stats, Damage and Defense.
  • Min. and max. amount of Item Stats, Damage and Defense Types.
  • Min. and max. amount of enchantments with randomized levels.
  • Item stat modifiers depends on item type, like axes have +20% damage, etc
  • Item stat modifiers depends on item level. Modifier is unique for each stat.
  • Randomized weapon hand types.
  • Randomized bow ammo types.
  • Min. and max. amount of sockets.
  • Randomized item sockets.

Settings.yml

Default module settings are described HERE.

Tiers

Resources

Resources are item prefixes and suffixes which are can be randomly added to the item name.

All resources are stored in /resources/ folder. There are will be 2 folders: prefixes and suffixes. Each one contains 3 folders: tiers, types and materials. Each folder will contains .txt files where you can add your own prefixes/suffixes, each one must be on new line.

Folders Info:

  • tiers - .txt files auto-generates with the names of existing tiers. When using %tier_prefix% or %tier_suffix% in item name, it will gets the suffixes and prefixes from the [tier_name].txt file.
  • types - .txt files auto-generates with the names of existing Item Sub Types. When using %type_prefix% or %type_suffix% in item name, it will gets the suffixes and prefixes from the [item_type_name].txt file.
  • materials - .txt files auto-generates with the material names from Item Groups. When using %material_prefix% or %material_suffix% in item name, it will gets the suffixes and prefixes from the [material_name].txt file.


Items

Name Placeholders:

  • %c% - Tier color.
  • %prefix_tier% - Tier prefix.
  • %prefix_type% - Item Sub Type prefix.
  • %prefix_material% - Material prefix.
  • %suffix_tier% - Tier suffix.
  • %suffix_type% - Item Sub Type suffix.
  • %suffix_material% - Material suffix.

Lore Placeholders:

  • %prefix_tier% - Tier prefix.
  • %prefix_type% - Item Sub Type prefix.
  • %prefix_material% - Material prefix.
  • %suffix_tier% - Tier suffix.
  • %suffix_type% - Item Sub Type suffix.
  • %suffix_material% - Material suffix.
  • %TYPE% - Item type. Uses name from Item Sub Types.
  • %MATERIAL% - Item material full name.
  • %TIER% - Tier name.
  • %SOULBOUND% - Add item soulbound.
  • %UNTRADEABLE% - Make item untradeable.
  • %CLASS% - Player class requirements (if any was provided).
  • %LEVEL% - Player level requirements.
  • %ENCHANTS% - Displays item enchants with levels.
  • %ARMOR_TYPES% - Displays item defense types.
  • %DAMAGE_TYPES% - Displays item damage types.
  • %AMMO_TYPE% - Displays bow Ammo Type.
  • %HAND_TYPE% - Displays the Hand Type.
  • %ITEM_STAT% - Displays the Item Stat value. Where ITEM_STAT is valid Item Stat name.
  • %SET% - Displays the set info and bonuses if item name and material are the same as in some set.
  • %SOCKET_TYPE% - Displays the free socket. Where SOCKET_TYPE is valid Socket Type name.

# Default item settings.
name: '%c%%prefix_tier% %prefix_material% %prefix_type% %itemtype% %suffix_material% %suffix_type% %suffix_tier%'
lore:
- '&7Type: &f%TYPE%'
- '&7Tier:%c% %TIER%'
- '&7Level: &f%level%'
- '%AMMO_TYPE%'
- '%HAND_TYPE%'
- '%ENCHANTS%'
- ''
- '%CLASS%'
- '%LEVEL%'
- ''
- '%ARMOR_TYPES%'
- '%DAMAGE_TYPES%'
- ''
- '%DIRECT_DAMAGE%'
- '%AOE_DAMAGE%'
- '%CRITICAL_RATE%'
- '%CRITICAL_DAMAGE%'
- '%ACCURACY_RATE%'
- '%DODGE_RATE%'
- '%BLOCK_RATE%'
- '%BLOCK_DAMAGE%'
- '%LOOT_RATE%'
- '%MOVEMENT_SPEED%'
- '%ATTACK_SPEED%'
- '%MAX_HEALTH%'
- '%PENETRATION%'
- '%VAMPIRISM%'
- '%BURN_RATE%'
- ''
- '%DURABILITY%'
- '%SET%'
- '%GEM%'
- '%ESSENCE%'
- '%RUNE%'
color: -1,-1,-1
min-level: 1
max-level: 50
unbreakable: true
item-flags:
- '*'

# Generator settings.
generator:
  # Tier name
  name: Common
  # Tier color
  color: '&a&f'
  # Prefix and suffix chance.
  prefix-chance: 100.0
  suffix-chance: 100.0
  
  materials:
    # When true makes black-list work as white-list.
    reverse: false
    # Materials list.
    black-list:
    - DIAMOND*
    - IRON*
    - CHAINMAIL*
  
  # Material/Model data for custom item textures.
  material-data:
    # When true makes black-list work as white-list.
    reverse: true
    # Data values
    black-list:
    - 1
    - 2
    - 3
    # Custom data for specified Materials
    special:
      DIAMOND_SWORD:
      - 10
      - 11
      GOLD_SWORD:
      - 12
      - 13
  
  restrictions:
    # Player level requirements depends on item level.
    # Format Item Level : Player Level Requirements.
    # Put zero (0) level requirement to disable item requirements.
    # Non-numeric values will make player level requirement equals to item level.
    player-level-by-item-level:
      '1': 1-10
      '11': 11-25
      '26': 26-35
      '36': 36-40
      '40': item # Level requirement will equals to item level.
      '45': 0 # No level requirements
    # Player class requirements
    classes:
    - Warrior
    - Cleric
    
    # Min. and max. amount of item stats.
    min-item-stats: 1
    max-item-stats: 4
    min-damage-types: 1
    max-damage-types: 2
    min-defense-types: 1
    max-defense-types: 2
    
    # Stat modifiers by item Material or Item Type or Item Group
    # You can put negative values to disable specified stats from being applied on items.
    material-modifiers:
      # Material / SubType / Item Group name
      iron_sword:
        # Modifiers for damage types
        damage-types:
          physical: 1.15
      iron_helmet:
        # Modifiers for defense types
        defense-types:
          physical: 1.25
      axe:
        # Modifiers for Item Stats
        item-stats:
          CRITICAL_DAMAGE: 1.5
  
  enchants:
    # Min. and max. enchants amount.
    min: 1
    max: 2
    # When true only 'safe' enchantments will be applied.
    safe-only: false
    # Enchantment list.
    # Format: Enchant_name:MinLvl:MaxLvl
    list:
    - sharpness:1:2
    - knockback:1:2
    - efficiency:1:2
    - silk_touch:0:1
    - smite:1:2
  
  # Chances for bow Ammo Types.
  ammo-types:
    ARROW: 100.0
    
  # Chances for weapon Hand Types.
  hand-types:
    ONE: 70.0
    TWO: 30.0
  
  # Damage Types
  damage-types:
    # Damage Type name
    physical:
      # Chance this type will be applied.
      chance: 100.0
      # Scling damage value by item level
      scale-by-level: 1.025
      # Min. and max values.
      min: 2.6
      max: 5.8
  armor-types:
    physical:
      chance: 100.0
      scale-by-level: 1.025
      min: 3.25
      max: 8.75
  
  # Settings for Item Stats.
  item-stats:
    CRITICAL_RATE:
      default:
        chance: 20.0
        scale-by-level: 1.025
        min: 3.0
        max: 6.25
    CRITICAL_DAMAGE:
      default:
        chance: 20.0
        scale-by-level: 1.025
        min: 1.1
        max: 1.25
    DODGE_RATE:
      default:
        chance: 10.0
        scale-by-level: 1.025
        min: 2.5
        max: 4.0
    ACCURACY_RATE:
      default:
        chance: 10.0
        scale-by-level: 1.025
        min: 4.5
        max: 7.5
    BLOCK_RATE:
      default:
        chance: 10.0
        scale-by-level: 1.025
        min: 1.5
        max: 7.0
    BLOCK_DAMAGE:
      default:
        chance: 10.0
        scale-by-level: 1.025
        min: 3.0
        max: 10.0
    VAMPIRISM:
      default:
        chance: 5.0
        scale-by-level: 1.025
        min: 1.5
        max: 4.5
    BURN_RATE:
      default:
        chance: 8.0
        scale-by-level: 1.025
        min: 4.5
        max: 12.5
    DURABILITY:
      default:
        chance: 100.0
        scale-by-level: 1.025
        min: 150
        max: 700
    PENETRATION:
      default:
        chance: 6.0
        scale-by-level: 1.025
        min: 4.5
        max: 10.0
    LOOT_RATE:
      default:
        chance: 7.5
        scale-by-level: 1.025
        min: 2.0
        max: 10.0
    MOVEMENT_SPEED:
      default:
        chance: 3.5
        scale-by-level: 1.025
        min: 7.5
        max: 15.0
    ATTACK_SPEED:
      default:
        chance: 4.75
        scale-by-level: 1.025
        min: 5.0
        max: 10.0
    MAX_HEALTH:
      default:
        chance: -1
        scale-by-level: 1.025
        min: 5.0
        max: 10.0
    DIRECT_DAMAGE:
      default:
        chance: -1
        scale-by-level: 1.025
        min: 5.0
        max: 10.0
    AOE_DAMAGE:
      default:
        chance: 5
        scale-by-level: 1.025
        min: 5.0
        max: 10.0
    RANGE:
      default:
        chance: 20.0
        scale-by-level: 1.025
        min: 5.0
        max: 25.0
        
  # Settings for Socket Types.
  sockets:
    GEM:
      chance: 35.0
      min: 0
      max: 2
    ESSENCE:
      chance: 0.0
      min: 0
      max: 1
    RUNE:
      chance: 0.0
      min: 0
      max: 1
Navigation