Phantom RPGs ($10)

Infinite RPGs, Optional packet particles, optimized and endless configuration

Introducing Phantom RPGs, designed to bring an immersive RPG experience to your server, particularly for prison servers. This plugin allows you to create unlimited custom RPGs with full flexibility, including packet-based particles and multi-reward currency integration. Coded with performance in mind, Phantom RPGs ensures smooth gameplay even for large player bases, all while offering extensive customization options for messages, effects, and more. Keep your players engaged and enhance retention without compromising on server performance!

Example Default Configuration

Shown below if the default configuration you will generate upon a fresh install of Phantom RPGs, you can modify all the configurations below to your liking!

##################################################
################## Phantom RPGs ##################
##################################################

LICENSE: 'YOUR_LICENSE_HERE'

#### Placeholders available:
#### %ammo% - The amount of ammo left in the RPG
#### %rarity% - The rarity of the RPG, depends on ur config name.

ParticleSystem: 'Bukkit'  # New option: 'Packets' for PacketEvents particles or 'Bukkit' for Bukkit particles

RPG:
  Common:
    Material: WOODEN_HOE
    Name: '&7&lCommon RPG'
    Lore:
      - '&8ʀᴘɢ ɪᴛᴇᴍ'
      - '&7&oThis is an RPG item, which can be used'
      - '&7&oon your private mine to cause destruction'
      - '&7&oto the blocks around you.'
      - '&7'
    ModelData: 0
    Settings:
      RocketItem:
        Material: 'PLAYER_HEAD'
        SkullUrl: 'd89dcc55b48e270872d28576a79005540bed5f0ae53015cfdc95b751d16fa9e2' ## Not base64, its the URL value.
      Ammo: 20
      ExplosionRadius: 5
      VelocityPower: 1.5
      PacketParticles:  # Only used if 'Packet' is selected
        Particle: 'REDSTONE'
        Amount: 2
        Offset: 0.5
        Speed: 0.1
        Radius: 0.5
        Dust:  # Only use if option is 'REDSTONE' or it will cause errors
          Red: 3
          Green: 255
          Blue: 3
      BukkitParticles: # Only used if 'Bukkit' is selected
        Particle: 'REDSTONE'
        Amount: 2
        Offset: 0.5
        Speed: 0.1
        Dust:
          Red: 3
          Green: 255
          Blue: 3
    Rewards:
      'gems':
        Enabled: true
        CurrencyMath: '%utils_parse_edprison_random_{edprison_calc_{edprison_level_rankup}*%blocks%*8}|{edprison_level_rankup}*%blocks%*10%'
        AffectMulti: true
      'tokens':
        Enabled: true
        CurrencyMath: '%utils_parse_edprison_random_{edprison_calc_{edprison_level_rankup}*%blocks%*8}|{edprison_level_rankup}*%blocks%*10%'
        AffectMulti: true
    RewardMessage: '&6&l+ &e&l%edprison_singlenotation_%tokens%% &6&lTokens &8&l| &d&l+ &6&l%edprison_singlenotation_%gems%% &d&lGems'

  Rare:
    Material: IRON_HOE
    Name: '&9&lRare RPG &8(&7%ammo% Shots&8)'
    Lore:
      - '&8ʀᴘɢ ɪᴛᴇᴍ'
      - '&7&oThis is an RPG item, which can be used'
      - '&7&oon your private mine to cause destruction'
      - '&7&oto the blocks around you.'
      - '&7'
      - '&9&lInformation'
      - '&1 → &9Rarity: &f%rarity%'
      - '&1 → &9Ammo: &f%ammo%'
    ModelData: 0
    Settings:
      RocketItem:
        Material: 'PLAYER_HEAD'
        SkullUrl: 'd89dcc55b48e270872d28576a79005540bed5f0ae53015cfdc95b751d16fa9e2' ## Not base64
      Ammo: 30
      ExplosionRadius: 7
      VelocityPower: 2
      PacketParticles:  # Only used if 'Packet' is selected
        Particle: 'REDSTONE'
        Amount: 2
        Offset: 0.5
        Speed: 0.1
        Radius: 0.5
        Dust:  # Only use if option is 'REDSTONE' or it will cause errors
          Red: 3
          Green: 255
          Blue: 3
      BukkitParticles: # Only used if 'Bukkit' is selected
        Particle: 'REDSTONE'
        Amount: 2
        Offset: 0.5
        Speed: 0.1
        Dust:
          Red: 3
          Green: 255
          Blue: 3
    Rewards:
      ## Economnies are support by this format
      ## Inside of the ' ' you need to put the exact edp currency as shown below.
      ## For example, if you put 'pickaxeblocks' as the currency, it will generate a placeholder called '%pickaxeblocks%' and you can use it in your final message!
      ## AffectMulti (true/false) if multipliers should be applied to the final given amount
      ##
      ## Placeholders (%blocks%) amount of blocks that got nuked in the mine.
      'gems':
        Enabled: true
        CurrencyMath: '%utils_parse_edprison_random_{edprison_calc_{edprison_level_rankup}*%blocks%*8}|{edprison_level_rankup}*%blocks%*10%'
        AffectMulti: true
      'tokens':
        Enabled: true
        CurrencyMath: '%utils_parse_edprison_random_{edprison_calc_{edprison_level_rankup}*%blocks%*8}|{edprison_level_rankup}*%blocks%*10%'
        AffectMulti: true
    RewardMessage: '&6&l+ &e&l%edprison_singlenotation_%tokens%% &6&lTokens &8&l| &d&l+ &6&l%edprison_singlenotation_%gems%% &d&lGems'



  Legendary:
    Material: GOLDEN_HOE
    Name: '&6&lLegendary RPG &8(&7%ammo% Shots&8)'
    Lore:
      - '&8ʀᴘɢ ɪᴛᴇᴍ'
      - '&7&oThis is an RPG item, which can be used'
      - '&7&oon your private mine to cause destruction'
      - '&7&oto the blocks around you.'
      - '&7'
      - '&6&lInformation'
      - '&e → &6Rarity: &f%rarity%'
      - '&e → &6Ammo: &f%ammo%'
    ModelData: 0
    Settings:
      RocketItem:
        Material: 'PLAYER_HEAD'
        SkullUrl: 'd89dcc55b48e270872d28576a79005540bed5f0ae53015cfdc95b751d16fa9e2' ## Not base64
      Ammo: 40
      ExplosionRadius: 10
      VelocityPower: 2
      PacketParticles:  # Only used if 'Packet' is selected
        Particle: 'REDSTONE'
        Amount: 2
        Offset: 0.5
        Speed: 0.1
        Radius: 0.5
        Dust:  # Only use if option is 'REDSTONE' or it will cause errors
          Red: 3
          Green: 255
          Blue: 3
      BukkitParticles: # Only used if 'Bukkit' is selected
        Particle: 'REDSTONE'
        Amount: 2
        Offset: 0.5
        Speed: 0.1
        Dust:
          Red: 3
          Green: 255
          Blue: 3
    Rewards:
      ## Economnies are support by this format
      ## Inside of the ' ' you need to put the exact edp currency as shown below.
      ## For example, if you put 'pickaxeblocks' as the currency, it will generate a placeholder called '%pickaxeblocks%' and you can use it in your final message!
      ## AffectMulti (true/false) if multipliers should be applied to the final given amount
      ##
      ## Placeholders (%blocks%) amount of blocks that got nuked in the mine.
      'gems':
        Enabled: true
        CurrencyMath: '%utils_parse_edprison_random_{edprison_calc_{edprison_level_rankup}*%blocks%*8}|{edprison_level_rankup}*%blocks%*10%'
        AffectMulti: true
      'tokens':
        Enabled: true
        CurrencyMath: '%utils_parse_edprison_random_{edprison_calc_{edprison_level_rankup}*%blocks%*8}|{edprison_level_rankup}*%blocks%*10%'
        AffectMulti: true
    RewardMessage: '&6&l+ &e&l%edprison_singlenotation_%tokens%% &6&lTokens &8&l| &d&l+ &6&l%edprison_singlenotation_%gems%% &d&lGems'



  Mythical:
    Material: DIAMOND_HOE
    Name: '&b&lMythical RPG &8(&7%ammo% Shots&8)'
    Lore:
      - '&8ʀᴘɢ ɪᴛᴇᴍ'
      - '&7&oThis is an RPG item, which can be used'
      - '&7&oon your private mine to cause destruction'
      - '&7&oto the blocks around you.'
      - '&7'
      - '&b&lInformation'
      - '&3 → &bRarity: &f%rarity%'
      - '&3 → &bAmmo: &f%ammo%'
    ModelData: 0
    Settings:
      RocketItem:
        Material: 'CRYING_OBSIDIAN'
        SkullUrl: '' ## Not base64
      Ammo: 50
      ExplosionRadius: 12
      VelocityPower: 2
      PacketParticles:  # Only used if 'Packet' is selected
        Particle: 'REDSTONE'
        Amount: 2
        Offset: 0.5
        Speed: 0.1
        Radius: 0.5
        Dust:  # Only use if option is 'REDSTONE' or it will cause errors
          Red: 3
          Green: 255
          Blue: 3
      BukkitParticles: # Only used if 'Bukkit' is selected
        Particle: 'REDSTONE'
        Amount: 2
        Offset: 0.5
        Speed: 0.1
        Dust:
          Red: 3
          Green: 255
          Blue: 3
    Rewards:
      'gems':
        Enabled: true
        CurrencyMath: '%utils_parse_edprison_random_{edprison_calc_{edprison_level_rankup}*%blocks%*8}|{edprison_level_rankup}*%blocks%*10%'
        AffectMulti: true
      'tokens':
        Enabled: true
        CurrencyMath: '%utils_parse_edprison_random_{edprison_calc_{edprison_level_rankup}*%blocks%*8}|{edprison_level_rankup}*%blocks%*10%'
        AffectMulti: true
    RewardMessage: '&6&l+ &e&l%edprison_singlenotation_%tokens%% &6&lTokens &8&l| &d&l+ &6&l%edprison_singlenotation_%gems%% &d&lGems'

Messages:
  Prefix: "&6&lPhantom&e&lRPGs &8» "
  RELOAD:
    Sound:
      Enable: true
      Value: ENTITY_PLAYER_LEVELUP;1.0;1.0
    Message:
      Enable: true
      Value: '&aYou have reloaded the plugin!'
  RPG_GIVEN:
    Sound:
      Enable: true
      Value: ENTITY_PLAYER_LEVELUP;1.0;1.0
    Message:
      Enable: true
      Value: '&eYou have gave &6%player% &f%amount% %rpg_display%&e!'
  RPG_RECEIVE:
    Sound:
      Enable: true
      Value: ENTITY_PLAYER_LEVELUP;1.0;1.0
    Message:
      Enable: true
      Value: '&eYou have received &6%amount% %rpg_display%&e!'
  RPG_OUT_OF_AMMO:
    Sound:
      Enable: true
      Value: BLOCK_ANVIL_DESTROY;1.0;1.0
    Message:
      Enable: true
      Value: '&cYour %rpg_id% RPG has broken!'
  RPG_EXPLOSION:
    Sound:
      Enable: true
      Value: ENTITY_GENERIC_EXPLODE;1.0;1.0
  INVALID_RPG:
    Sound:
      Enable: true
      Value: ENTITY_PLAYER_LEVELUP;1.0;1.0
    Message:
      Enable: true
      Value: '&cInvalid RPG Type!'
  NO_PERMISSION:
    Sound:
      Enable: true
      Value: ENTITY_PLAYER_LEVELUP;1.0;1.0
    Message:
      Enable: true
      Value: '&cYou do not have permission to use this command!'
  INVALID_COMMAND:
    Sound:
      Enable: true
      Value: ENTITY_PLAYER_LEVELUP;1.0;1.0
    Message:
      Enable: true
      Value: '&cInvalid Command!'

# This section is for the new rpg expansions!

  GIVE_EXPANSION_ITEM:
    Sound:
      Enable: true
      Value: ENTITY_PLAYER_LEVELUP;1.0;1.0
    Message:
      Enable: true
      Value: '&eYou have gave &6%player% &f%amount%x &e%expansion_type%&e Expansion Item(s)!'
  RECEIVE_EXPANSION_ITEM:
    Sound:
      Enable: true
      Value: ENTITY_PLAYER_LEVELUP;1.0;1.0
    Message:
      Enable: true
      Value: '&eYou have received &6%amount%x &e%expansion_type%&e Expansion Item(s)!'
  EXTRA_AMMO_EXPANSION:
    Sound:
      Enable: true
      Value: ENTITY_PLAYER_LEVELUP;1.0;1.0
    Message:
      Enable: true
      Value: '&eSuccessfully added &6%amount%x &eExtra Ammo to your &f%rpg_id%&e!'

RPG Abilities Settings (settings.yml)

World-Blacklist:
  - "world_nether"


Abilities:
  StormScatter:
    Chance: 100
    Bombs: 20
    Velocity: 0.50
    ExplosionRadius: 5
    CircleRadius: 6.0
    HeightOffset: 1
    AngleIncrement: 2.33
  CycloneHammer:
    Chance: 100
  ContrabandCache:
    Chance: 100
    LootTable:
      1:
        Chance: 20
        Message: "&6&lContraband &e&lCache &8&l→ &eYou received &f1x &dDiamond&e! &8(&720%&8)"
        Amount: 1
        Commands:
          - "give %player% minecraft:diamond %amount%"
      2:
        Chance: 10
        Message: "&6&lContraband &e&lCache &8&l→ &eYou received &f1x &fIron Ingot&e! &8(&710%&8)"
        Amount: 1
        Commands:
          - "give %player% minecraft:iron_ingot %amount%"
      3:
        Chance: 30
        Message: "&6&lContraband &e&lCache &8&l→ &eYou received &f1x &6Gold Ingot&e! &8(&730%&8)"
        Amount: 1
        Commands:
          - "give %player% minecraft:gold_ingot %amount%"

Placeholders

RPG Item:
  %rarity% -> Displays the rarity of the RPG you gave it, example "Mythical"
  %ammo% -> Will return the shots remaining on the RPG (up dates in real time)

Messages:
  %rpg_id% -> Returns the RPG ID, which from the example config above, would be "Mythical"
  %rpg_display% -> Returns the Display Name of the RPG given
  %amount% -> The amount of the RPG given
  %player% -> The player you gave the RPG to
  %ammo% -> The ammo from the config

Features

• Performance friendly

• Supports 1.16 - 1.21.1

• Hex Color support (#4493fe) and legacy support (&6Example)

• Packet Based Particles

• Infinite RPGs

• Reload - Instantly flushes cache, and re-caches momentum boosts, ensuring they're applied to all players

• Ammo tracking, with lore updates

• Entirely configuration

• Custom multi-reward parsing combined into 1 message!

How to add abilities to RPGs (Example)

  Divine:
    Material: NETHERITE_HOE
    Name: '&c&lDivine &4&lRPG &8(&7%ammo% Shots&8)'
    Lore:
      - '&8ʀᴘɢ ɪᴛᴇᴍ'
      - '&7&oThis is an RPG item, which can be used'
      - '&7&oon your private mine to cause destruction'
      - '&7&oto the blocks around you.'
      - '&7'
      - '&c&lInformation'
      - '&4 → &cRarity: &f%rarity%'
      - '&4 → &cAmmo: &f%ammo%'
      - '&7'
      - '&c&lAbility'
      - '&4 → &cType: &fStorm Scatter'
      - '&7   &8(&7This ability shoots additional &cScatter &4Bomb(s)&8)'
      - '&7'
      - '&7&o(( &f&oRight-Click&7&o to shoot this RPG! ))'
    ModelData: 0
    Settings:
      RocketItem:
        Material: 'ANVIL'
        SkullUrl: ''
      Ammo: 100
      ExplosionRadius: 12
      VelocityPower: 2
      Ability:
        Enabled: true
        Type: 'StormScatter' # Between "StormScatter", "CycloneHammer", "ContrabandCache"
        # You can configure the options / settings for these in settings.yml!
      PacketParticles:
        Particle: 'SNOWFLAKE'
        Amount: 4
        Offset: 0.25
        Speed: 0.05
        Radius: 1
        Dust:
          Red: 200
          Green: 20
          Blue: 10
      BukkitParticles:
        Particle: 'BUBBLE_COLUMN_UP'
        Amount: 2
        Offset: 0.5
        Speed: 0.1
        Dust:
          Red: 3
          Green: 255
          Blue: 3
    Rewards:
      'gems':
        Enabled: true
        CurrencyMath: '%blocks%'
        AffectMulti: true
      'tokens':
        Enabled: true
        CurrencyMath: '%blocks%'
        AffectMulti: true
    RewardMessage: '&6&l+ &e&l%edprison_singlenotation_%tokens%% &6&lTokens &8&l| &d&l+ &6&l%edprison_singlenotation_%gems%% &d&lGems'