Engram icon

Engram 3.9.4

Decipher Engrams to get special items!!!

The official support is provided here.

This is the re-implementation of "Engram" plugin featured in SSundee's Faction Series Youtube video:



A player can be given an engram, which encodes the chance to win some special goodies.  (You can use a number of different ways to give out the engram such as crates, lucky mining, donation rewards, etc)

Once the user gets the engram, s/he will hand it over to the EngramNPC, which will decipher your engram for you, and find out and give you the special item/rewards!

The server owners can define many different tiers of engrams, each of which encodes different special items (or commands to be executed) with their own chance of successfully obtaining).

Test Server: testserver.vk2gpz.com

Commands:
  • /engram help : displays this help menu.
  • /engram reload : reloads config file.
    • permission: "engram.reload"
  • /engram debug : turn on / off the debug mode."
    • permission: "engram.debug"
  • /engram setnpc : create an Engram NPC, which is defined in config.yml.
    • permission: "engram.npc.create"
  • /engram give : give of engram.
    • permission: "engram.give"

Permissions:
  • engram.use : use engrams.

Configuration:

[dropdown=config.yml]

Messages:
  ErrorMsg : "&c[Engram] : Some error occured."
  Prefix: '&8&l(&6Engram&8&l)&7'
  PlayerOffline: "&c[Engram] : Player (&e%player%&c) is offline."
  EngramKeyGiven: "&c[Engram] : You were given %amount% of %type% key."
  EngramKeyGave: "&c[Engram] : You gave %player% %amount% of %type% key."
  NoEngramFound: "&c[Engram] : Engram (&e%type%&c) was not found."
  NeedEngram: "&c[Engram] : You need to hold an engram!"
  WrongRubix: "&c[Engram] : You need to take this to %rubix%."

HelpMessages:
  banner:
    msg: "=== &e[&aEngram Commands List (%version%)&e] &r==="  
  help:
    msg: "&a/engram help : displays this help menu."
  reload:
    msg: "&a/engram reload : reloads config file."
    permission: "engram.reload"
  debug:
    msg: "&a/engram debug  : turn on / off the debug mode."
    permission: "engram.debug"
  setnpc:
    msg: "&a/engram setnpc   : create an Engram NPC."
    permission: "engram.npc.create"
  give:
    msg: "&a/engram give    : give   of  engram."
    permission: "engram.give"
  giveall:
    msg: "&a/engram giveall   : give  of  engram."
    permission: "engram.giveall"

CommandAliases:
  - "eng"
  - "eg"

# this option is for the target outlet of the messages to go.
MessageOutlet:
  Title: false
  SubTitle: false
  ActionBar: false
  Chat: true

# adjust these event priority if those event processes from this plugin
# interfere with other plugins' event processes.
EventPriorityMap:
  NPCDamageByEntityEvent: "NORMAL"
  NPCRightClickEvent: "NORMAL"
  NPCLeftClickEvent: "NORMAL"
  InventoryClickEvent: "LOWEST"
  InventoryCloseEvent: "NORMAL"
  PlayerQuitEvent: "NORMAL"
  PlayerInteractEntityEvent: "HIGHEST"

EngramGUITitle: "§cDeciphering %type%"
EngramInfoTitle: "%type%"# &bEngram Rewards"

ParticleEffect:
  enabled: true
  particle: lava

EncryptedEngram:
  title: "%type% Engram"
  material: PAPER
  data: 0
  enchanted: true
  lore:
    - "&b&oTake this to Rubix at"
    - "&b&ospawn for decoding to"
    - "&b&ocollect your reward!"

Sound:
  movingSound: WOOD_CLICK
  prizeSound: SUCCESSFUL_HIT
  closeInventorySound: LEVEL_UP

EngramNPC:
  Rubix:
    name: "&cRubix"
    type: MAGMA_CUBE
  CitiRubix:
    name: "&eCity Rubix"
    type: WITHER

Tiers:
  - Common
  - Rare
  - Uncommon
  - Legendary
  - Exotic
  - Voting
[/dropdown]

Engram Tiers:

[dropdown=Common.yml]

Common:
  Decipher: Rubix
  Name: "&7[&d&oCommon&7]"
  ParticleEnabled: true
  Particle: "lava"
  Items:
    1:
      name: "&aDiamonds"
      chance: 0.35
      item: "DIAMOND"
      amount: 10
      lore:
        - "&aTest"
        - "&bhi"
      commands:
        - msg:&7You have received Diamonds
    2:
      name: "&aIron Ingots"
      chance: 0.38
      item: "DIAMOND"
      amount: 5
      commands:
        - msg:&7You have received Iron
    3:
      name: "&aEmeralds"
      chance: 0.38
      item: "388"
      amount: 10
      commands:
        - msg:&7You have received Emeralds
    4:
      name: "&aGold Ingots"
      chance: 0.38
      item: "GOLD_INGOT"
      amount: 10
      commands:
        - msg:&7You have received Gold
    5:
      name: "&aEnder Pearls"
      chance: 0.34
      item: "ENDER_PEARL"
      amount: 16
      lore:
        - "&aTest"
        - "&bhi"
      commands:
        - msg:&7You have received Ender Pearls
    6:
      name: "&aFire Aspect"
      keepTitle: true
      chance: 0.26
      item: "BOOK"
      amount: 1
      enchantments:
        FireAspect:
          mode: +
          min: 2
          max: 2
      success:
        min: 0.4
        max: 1.0
      destroy:
        min: 0.05
        max: 0.1

      commands:
        - msg:&7You have received an Enchanted Book
    7:
      name: "&aUnbreaking"
      chance: 0.23
      item: "BOOK"
      amount: 1
      enchantments:
        Unbreaking:
          mode: +
          min: 3
          max: 3
      commands:
        - msg:&7You have received an Enchanted Book
    8:
      name: "&aObsidian"
      chance: 0.31
      item: "OBSIDIAN"
      amount: 200
      commands:
        - msg:&7You have received Obsidian
    9:
      name: "&aGunpowder"
      chance: 1.0
      item: "289"
      amount: 64
      virtual: true
      commands:
        - eco give 1000
    10:
      name: "&dIron Golem"
      chance: 1.0
      item: "MOB_SPAWNER"
      amount: 1
      virtual: true
      commands:
        - msg:&7You have received a Iron Golem Spawner[color=#a9b7c6][size=2][font="JetBrains Mono", monospace][/font][/size][/color]
[/dropdown]

[dropdown=Exotic.yml]
Exotic:
  Name: "&7[&6&oExotic&7]"
  ParticleEnabled: true
  Particle: "spell"
  Items:
    1:
      name: "&aDiamonds"
      chance: 0.35
      item: "DIAMOND"
      amount: 10
      commands:
        - msg:&7You have received Diamonds
    2:
      name: "&aIron Ingots"
      chance: 0.38
      item: "IRON_INGOT"
      amount: 10
      commands:
        - msg:&7You have received Iron
    3:
      name: "&aEmeralds"
      chance: 0.38
      item: "388"
      amount: 10
      commands:
        - msg:&7You have received Emeralds
    4:
      name: "&aGold Ingots"
      chance: 0.38
      item: "GOLD_INGOT"
      amount: 10
      commands:
        - msg:&7You have received Gold
    5:
      name: "&aEnder Pearls"
      chance: 0.34
      item: "ENDER_PEARL"
      amount: 16
      commands:
        - msg:&7You have received Ender Pearls
    6:
      name: "&aFire Aspect"
      chance: 0.26
      item: "BOOK"
      amount: 1
      enchantments:
        FireAspect:
          mode: +
          min: 2
          max: 2
      commands:
        - msg:&7You have received an Enchanted Book
    7:
      name: "&aUnbreaking"
      chance: 0.23
      item: "BOOK"
      amount: 1
      enchantments:
        Unbreaking:
          mode: +
          min: 3
          max: 3
      commands:
        - msg:&7You have received an Enchanted Book
    8:
      name: "&aObsidian"
      chance: 0.31
      item: "OBSIDIAN"
      amount: 200
      commands:
        - msg:&7You have received Obsidian
    9:
      name: "&aGunpowder"
      chance: 0.3
      item: "289"
      amount: 64
      commands:
        - msg:&7You have received Gunpowder
[/dropdown]

[dropdown=Legendary.yml]

Legendary:
  Name: "&7[&9&oLegendary&7]"
  ParticleEnabled: true
  Particle: "spell"
  Items:
    1:
      name: "&aDiamonds"
      chance: 0.08
      item: "DIAMOND_BLOCK"
      amount: 20
      commands:
        - msg:&7You have received Diamonds
    2:
      name: "&aIron Blocks"
      chance: 0.1
      item: "IRON_BLOCK"
      amount: 20
      commands:
        - msg:&7You have received Iron
    3:
      name: "&aEmeralds"
      chance: 0.1
      item: "133"
      amount: 20
      commands:
        - msg:&7You have received Emeralds
    4:
      name: "&aGold Blocks"
      chance: 0.1
      item: "GOLD_BLOCK"
      amount: 20
      commands:
        - msg:&7You have received Gold
    5:
      name: "&aFortune"
      chance: 0.09
      item: "BOOK"
      target: "DIAMOND_PICKAXE"
      amount: 1
      enchantments:
        Fortune:
          mode: +
          min: 3
          max: 3
      commands:
        - msg:&7You have received an Enchanted Book
    6:
      name: "&aLeggings"
      chance: 0.07
      item: "DIAMOND_LEGGINGS"
      amount: 1
      enchantments:
        Protection:
          mode: +
          min: 5
          max: 5
      commands:
        - msg:&7You have received Diamond Leggings
    7:
      name: "&aAxe"
      chance: 0.06
      item: "DIAMOND_AXE"
      amount: 1
      enchantments:
        Sharpness:
          mode: +
          min: 5
          max: 5
        Unbreaking:
          mode: +
          min: 3
          max: 3
      commands:
        - msg:&7You have received a Diamond Axe

[/dropdown]