AdvancedMarks - Asmodeus1354/VastPlugins GitHub Wiki

Description

A dynamic Minecraft plugin introducing the unique "Marks" system. Gain marks by defeating players and unlock powerful effects as you progress. Features custom spawn protection, configurable death bans, and an exclusive crafting system. Tailored for competitive gameplay, AdvancedMarks adds a thrilling layer of strategy and rewards.

Configuration

############################################################
# +------------------------------------------------------+ #
# |                 SETTINGS OVERVIEW                    | #
# +------------------------------------------------------+ #
############################################################

marks:
  # The initial number of marks a player has when they join.
  start: 1
  # The maximum number of marks a player can have.
  max: 8
  # The minimum number of marks a player can have. Can be negative.
  min: 0
  # Whether players lose marks when killed by mobs (true or false).
  drop_marks_on_mob_death: false
  # If true, all marks reset to zero upon death.
  reset_marks_on_death: true
  # If reset_marks_on_death is false, the number of marks to remove upon death.
  remove_amount: 1
  # The amount of marks dropped upon death. Can be a flat number or a percentage of the player's marks.
  drop_amount: 1
  # Players with this amount or fewer marks are banned upon death. Set to false to disable.
  death_ban: -4
  # Duration of the death ban in minutes.
  ban_time: 360
  # Allows players to enable or disable the ability to withdraw marks dynamically
  # (true or false).
  withdraw_marks: true

# The information displayed by the /am info command.
info_text:
  - "§aAdvancedMarks"
  - "§a2 Marks: Speed I"
  - "§a4 Marks: Speed II, Strength I"
  - "§a6 Marks: Speed II, Strength II, Glowing I, Resistance I"
  - "§a7 Marks: Speed II, Strength II, Glowing I, Resistance I, Message with coords every 120 minutes, Nice Try Ability"
  - "§a8 Marks: Speed II, Strength II, Glowing I, Resistance I, Message with coords every 60 minutes, Nice Try Ability"

############################################################
# +------------------------------------------------------+ #
# |                  Spawn Protection                    | #
# +------------------------------------------------------+ #
############################################################

spawn_protection:
  # Enables or disables spawn protection (true or false).
  enabled: true

  # Players with fewer marks than this value receive spawn protection.
  marks: 1

  # The duration of spawn protection in minutes.
  # Disappears when the player attacks another entity.
  timer: 10

  # If true, spawn protection ends when the player attacks another entity.
  deactivate_on_hit: true

############################################################
# +------------------------------------------------------+ #
# |                         ITEM                         | #
# +------------------------------------------------------+ #
############################################################

mark_item:
  # The material used as the mark item.
  material: DIAMOND

  # Optional custom model data for resource packs.
  custom_model_data: 0

  # The display name of the mark item.
  name: "&cMark Item"

  # The tooltip description of the mark item.
  lore:
    - "&aRight click to absorb the mark."

  # Makes the item unbreakable.
  unbreakable: true

  # Hides the "Unbreakable" tag in the item tooltip.
  hide_unbreakable: true

  # Allows or disallows dropping marks (true or false).
  allow_dropping: true

  # The crafting recipe for the mark item.
  crafting_recipe:
    shape:
      - "ABA" # First line of the recipe layout.
      - "BCB"
      - "ABA"
    ingredients:
      # Ingredient mappings for the recipe.
      A: NETHERITE_INGOT
      B: DIAMOND_BLOCK
      C: REDSTONE_BLOCK

############################################################
# +------------------------------------------------------+ #
# |                        Effects                       | #
# +------------------------------------------------------+ #
############################################################

effects:
  # Effects and abilities granted at 2 marks.
  2:
    effect1:
      name: SPEED # Effect name.
      amplifier: 0 # Effect strength.
      potion_particles: true # Whether effect particles are visible.
      ambient: true # Whether effect appears ambient.

  # Effects and abilities granted at 4 marks.
  4:
    effect1:
      name: SPEED
      amplifier: 0
      potion_particles: true
      ambient: true
    effect2:
      name: STRENGTH
      amplifier: 0
      potion_particles: true
      ambient: true

  # Effects and abilities granted at 6 marks.
  6:
    effect1:
      name: SPEED
      amplifier: 0
      potion_particles: true
      ambient: true
    effect2:
      name: STRENGTH
      amplifier: 0
      potion_particles: true
      ambient: true
    effect3:
      name: RESISTANCE
      amplifier: 0
      potion_particles: true
      ambient: true

  # Effects and abilities granted at 7 marks.
  7:
    effect1:
      name: SPEED
      amplifier: 1
      potion_particles: true
      ambient: true
    effect2:
      name: STRENGTH
      amplifier: 0
      potion_particles: true
      ambient: true
    effect3:
      name: RESISTANCE
      amplifier: 0
      potion_particles: true
      ambient: true
    effect4:
      name: GLOWING
      amplifier: 0
      potion_particles: true
      ambient: true
    effect5:
      special: true # Marks a special effect.
      name: BROADCAST
      timer: 120 # Broadcast interval in minutes.
      message: "§c%player%§a has§c %marks%§a marks! He is at§c %coords%!"
    effect6:
      special: true
      # is activating if the player has less than 2 Hearts
      # pushes the enemy away
      # the player receives protection.
      name: NICE_TRY
      # cooldown in seconds
      cooldown: 120
      # the cost of marks
      cost: 1
      # the damage of the effect for the enemy
      damage: 2
      # the duration of protection in seconds
      # disappears when hitting other players!
      protection_time: 10

  # Effects and abilities granted at 8 marks.
  8:
    effect1:
      name: SPEED
      amplifier: 1
      potion_particles: true
      ambient: true
    effect2:
      name: STRENGTH
      amplifier: 1
      potion_particles: true
      ambient: true
    effect3:
      name: RESISTANCE
      amplifier: 0
      potion_particles: true
      ambient: true
    effect4:
      name: GLOWING
      amplifier: 0
      potion_particles: true
      ambient: true
    effect5:
      special: true
      name: BROADCAST
      timer: 60
      message: "§c%player%§a has§c %marks%§a marks! He is at§c %coords%!"
    effect6:
      special: true
      name: NICE_TRY
      cooldown: 120
      damage: 2
      cost: 1
      protection_time: 15


############################################################
# +------------------------------------------------------+ #
# |                      Messages                        | #
# +------------------------------------------------------+ #
############################################################
messages:
  absorb: "§c%player% has absorbed §l1 mark!"
  gain: "§aYou gained §c1§a mark! You now have §c%marks%§a marks!"
  max: "§cYou have reached the maximum amount of marks! You now have §c%marks%§a marks!"
  death: "§cYou have lost 1 mark! You now have %marks% marks!"
  join: "§aYou have %marks% marks! You can gain marks by killing other players!"
  max_error: "§cYour mark count has been capped to %max_marks%. Marks have been dropped!"
  command_mark: "§aYou have §c%marks%§a marks!"
  drop: "§cYou can not drop marks!"
  death_ban: "§c%player% §7has been banned for not having enough marks!"
  reset: "§cYou have lost all your marks! You now have §c0§a marks!"
  death_ban_player: "§cYou have been banned for not having enough marks! Time left: %time% minutes"
  spawn_protection_removed: "§cSpawn protection has been removed!"
  nice_try_activate: "§c%attacked% sacrificed one mark to protect himself! He has 15 seconds spawn protection!"
  nice_try: "§cYou offered a drop of your blood to the demons for protection! In return, they granted you 15 seconds of spawn protection. Avoid attacking anyone during this time!"
  spawn_protection_over: "§cTime is up! Spawn protection has been removed!"

############################################################
# +------------------------------------------------------+ #
# |                Banlist - Don't touch!                | #
# +------------------------------------------------------+ #
############################################################
banlist: []

Installation

To successfully install the AdvancedMarks plugin, follow these steps:

Step 1: Download the Plugin

Step 2: Place the File

  • Move the downloaded .jar file into your server's plugins folder.
    • The path typically looks like this: /container/plugins/

Step 3: Restart the Server

  • Restart your Minecraft server to load the new plugin. This can usually be done by using the following command in your server console: restart
    • Alternatively, you can stop the server and start it again manually.

Step 4: Verify Installation

  • Ensure the plugin loaded correctly by running the command pl or plugins in your server console.
    • Check if AdvancedMarks appears in green.

Step 5: Configure the Plugin (Optional)

Here is the updated command documentation with actual examples and the usage section removed:

Command Documentation

/am marks

Displays the current marks of the player using this command.

  • Permission: advancedmarks.command.mark
  • Example: /am marks – Shows your current marks, e.g., "You have 10 marks!"

/am reload

Reloads the plugin configuration.

  • Permission: advancedmarks.command.reload
  • Example: /am reload – Reloads the plugin configuration, e.g., "Configuration reloaded!"

/am help

Shows a list of available commands and their descriptions.

  • Example: /am help – Displays this help message with all available commands.

/am info

Displays information from the plugin configuration.

  • Example: /am info – Shows info text from the config, e.g., "AdvancedMarks v1.0 - Enjoy marking players!"

/am banlist

Displays a list of banned players.

  • Example: /am banlist – Lists banned players, e.g., "Player1, Player2"

/am ban <player>

Bans a player and adds them to the banlist.

  • Permission: advancedmarks.command.ban
  • Example: /am ban player123 – Bans player123 and adds them to the banlist.

/am unban <player>

Unbans a player and removes them from the banlist.

  • Permission: advancedmarks.command.unban
  • Example: /am unban player123 – Unbans player123 and removes them from the banlist.

/am reset <player>

Resets the marks for a specific player.

  • Permission: advancedmarks.command.reset
  • Example: /am reset player123 – Resets the mark for player123, e.g., "The mark key for player123 has been reset to 0!"

/am marks <player>

Shows the marks of a specific player.

  • Permission: advancedmarks.command.marks
  • Example: /am marks player123 – Shows the marks for player123, e.g., "player123 has 5 marks!"

/am add <player> <amount>

Adds a specified amount of marks to a player.

  • Permission: advancedmarks.command.add
  • Example: /am add player123 10 – Adds 10 marks to player123, e.g., "player123 now has 15 marks!"

/am give <player> <amount>

Gives a player the specified amount of mark items.

  • Permission: advancedmarks.command.give
  • Example: /am give player123 5 – Gives 5 mark items to player123, e.g., "player123 has been given 5 mark items!"

/am remove <player> <amount>

Removes a specified amount of marks from a player.

  • Permission: advancedmarks.command.remove
  • Example: /am remove player123 3 – Removes 3 marks from player123, e.g., "player123 now has 12 marks!"

/am set <player> <amount>

Sets the marks of a specific player to a specified amount.

  • Permission: advancedmarks.command.set
  • Example: /am set player123 20 – Sets the marks for player123 to 20, e.g., "The mark key for player123 has been set to 20!"

/am withdraw <amount>

Withdraws marks and drops mark items.

  • Permission: advancedmarks.command.withdraw
  • Example: /am withdraw 5 – Withdraws 5 marks and drops 5 mark items, e.g., "You have withdrawn 5 marks!"

FAQ

If you encounter any issues, join our discord and open a ticket here.

⚠️ **GitHub.com Fallback** ⚠️