HvsV

HvsV

Play as either the victim or the hunter. Someone must win.

This plugin adds a mini‑game in the form of a hunter and a victim. The victims must hide and, after a certain amount of time, take an axe and kill the hunter. The hunters must find all the victims and kill them.

• $ Versions 1.8.1-26+ are supported. It may be 1.7, but it has not been tested.
• $ Has been tested on versions: 1.8.8, 1.12.2, 1.16.5, 1.18.2, 1.21, 26+. The best performance was observed on these versions: 1.8.8, 1.12.2, and 1.16.5.
• $ Some plugin updates on SpigotMC.ru may be delayed.
• $ There may be a future FAQ about the plugin here. JParkour was created using an older version of this plugin.
• $ Attention! An additional plugin is required for the plugin to work. You can read the requirements below.
• $ The plugin requires the server to be shut down properly, as if the server is killed (Killed java) during a player's game, it may have an abnormal number of hearts.

Play as the victim. Hide, wait for the hatchet to take revenge on the hunter.

Play as a hunter. Find and kill all the victims before they do.

Win or accept defeat! Find out the winner and go home!

Requirements:

• FastAsyncWorldEdit (FAWE).
  • You can download it here: https://intellectualsites.github.io/download/fawe.html
  • GitHub: https://github.com/IntellectualSites/FastAsyncWorldEdit Supported:
• Support HEX (1.16+, it will also work on lower versions, but without displaying the correct colors), MiniMessage (1.18+)
• Languages:
  • en_US (English (US))
  • ru_RU (Russian)
  • de_DE (German)
  • Others (Don't forget to enable locales in the plugin configuration for language support)
    • $ You can find out the language code by clicking on the link below and looking at the In-Game section. Or you can find out your language code by running the command (don't forget to change the language on the client): /hvsv admin locale
    • $ https://minecraft.fandom.com/wiki/Language#Languages
    • $ You can configure locales in the plugin folder where the locales. The folder will be created when you enable locales in the plugin configuration. You can create your own files.
• Plugins:
  • PlaceholderAPI (The tops and scoreboard system).
    • You can download it here: https://github.com/PlaceholderAPI/PlaceholderAPI/releases
    • Don't forget to enable it in the plugin configuration.
    • Placeholders:
      • %hvsv_role% - Displays the player's role.
      • %hvsv_map% - Displays the name of the map.
      • %hvsv_id% - Displays the ID of the map.
      • %hvsv_status% - Displays the status of the map.
      • %hvsv_online% - Displays online this game.
      • %hvsv_maxonline% - Displays max online this game.
    • $ Ready-made configuration of scoreboards: https://github.com/mitriyf/HvsV/blob/main/downloads/tab/config.yml
• Checks:
  • Automatic check for new versions that contain important updates. However, if it is a release without important fixes, there will be no alert unless it is enabled in the plugin configuration.
  • Checking if there are any ready-made schematics. Automatic Downloading from GitHub if there are none: https://github.com/mitriyf/HvsV/tree/main/downloads
  • The plugin will automatically detect your server version so that it starts working correctly with your project.
  • Replacement of some parts of the configuration in case of their absence.
  • Checking for an old configuration version and updating to a new one.
  • Checking if a game with the same world name already exists.
  • Checking whether the player is in the game.
  • Checking if there is such an ID Map.
  • Permissions verification.
  • Fixing some user errors.
  • And much more... Functions:
• Command (/hvsv):
  • /hvsv status - Check the status of the plugin.
  • /hvsv join - Create or join any available room.
  • /hvsv join roomId - Attempt to connect to the room (if it is free).
  • /hvsv exit - Exit the game/queue.
  • /hvsv admin - Get a Admin Help.
    • /hvsv admin add playerName - Add a player to a random game.
    • /hvsv admin add playerName Map - Add a player to a specific game.
    • /hvsv admin item - Get a Item Help.
      • /hvsv admin item add default/schematicName player/victim/hunter slot itemName - Add the item in your hand to the selected schematic.
      • /hvsv admin item list - Get a list of schematics.
      • /hvsv admin item list default/schematicName player/victim/hunter - Get a list of items in the selected schematic.
      • /hvsv admin item info default/schematicName player/victim/hunter itemName - Get the item from the selected schematic.
      • /hvsv admin item remove default/schematicName player/victim/hunter itemName - Remove an item from the selected schematic.
    • /hvsv admin kick playerName - Kick the player out of the game.
    • /hvsv admin locale - Get the client's language code.
  • /hvsv reload - Reload the plugin configuration.
• Permissions:
  • hvsv.help - Can a player get help with subcommands?
  • hvsv.join - Can a player join/exit games?
  • hvsv.status - Can the player find out the status of the games?
  • hvsv.reload - Can the player reload the plugin configuration?
  • hvsv.admin - Can the player access item, and other commands? + Removing restrictions on commands and walking through worlds.
  • hvsv.item - Can the player access item settings?
• Actions:
  • [actionbar] message - Send the actionbar with your message. For 1.11+
  • [connect] server - Send a player to a specific BungeeCord server.
    • WARNING: Requires BungeeMessaging. This is present on BungeeCord and WaterFall.
    • On Velocity it might be disabled by default. Check your proxy config.
  • [message] message - Send a message to the player.
  • [room] message - Send a message to the room's players.
  • [broadcast] message - Send a message to all players.
  • [log] message - Send a message to the console.
  • [delay] ticks - Make a delay between actions. In ticks (20 ticks = 1 second).
  • [player] command - Run the command on behalf of the player.
  • [teleport] world;x;y;z;yaw;pitch;delay - Teleport the player to the specified coordinates. The delay is measured in ticks.
  • [console] command - Run the command on behalf of the console.
  • [title] title;subtitle;fadeIn;stay;fadeOut - Send the title to the player. For 1.8+
  • [sound] sound;volume;pitch;delay - Perform a sound for the player. The delay is measured in ticks.
    • Search for sounds here: https://helpch.at/docs/$version$/org/bukkit/Sound.html
    • // Replace $version$ with the version of your server, for example: https://helpch.at/docs/1.8.8/org/bukkit/Sound.html
  • [effect] type;duration;amplifier;delay - Give the effect to the player. The delay and duration is measured in ticks.
    • Find the types of effects here: https://helpch.at/docs/$version$/org/bukkit/potion/PotionEffectType.html
  • [explosion] power;setFire;breakBlocks;delay;addX;addY;addZ - Create an explosion. The delay is measured in ticks.
    • setFire, breakBlocks - set to false or true. addX, addY, addZ - double values that are added to the player's explosion location.
  • [bossbar] message;color;type;time;style;flag - Send a bossbar to a player with a message for a specific time. For 1.9+
    • Types:
      • stop - The bossbar will disappear after the time you specified in time (seconds)
      • time - Bossbar will animate the time that is running out.
    • Functions:
      • %time% - Seconds left.
    • You can find all the functions like color, style, and flag here: https://helpch.at/docs/$version$/org/bukkit/boss/BossBar.html
  • Info:
    • Messages sent to the console may not replace placeholders or perform certain actions above.
  • Built-in functions:
    • %player% - Get the player name.
    • %world% - Get the player world.
• Config:
  • Send actions to players using messages. (HEX support from 1.16+, MiniMessage support form 1.18+)
  • Settings for schematics, default maps, and more.
• Storage:
  • Backup of updated configurations after updating to a new plugin version.
  • Automatic loading of schematics if they are missing.
  • Automatic correction of broken configurations.
  • Automatic folder creation.
• ConfigUpdater:
  • The plugin will check all configuration conditions and update them as much as possible, and it will also create backups of previous ones. Configurations:
• You can view the configurations by going to src/main/resources/:
  • locales/ru_RU.yml
  • locales/en_US.yml
  • locales/de_DE.yml
  • config.yml
  • slots.yml
  • slots13.yml
  • schematics/default.yml
• or by following the link:
  • https://github.com/mitriyf/HvsV/blob/main/src/main/resources/locales/ru_RU.yml
  • https://github.com/mitriyf/HvsV/blob/main/src/main/resources/locales/en_US.yml
  • https://github.com/mitriyf/HvsV/blob/main/src/main/resources/locales/de_DE.yml
  • https://github.com/mitriyf/HvsV/blob/main/src/main/resources/config.yml
  • https://github.com/mitriyf/HvsV/blob/main/src/main/resources/slots.yml
  • https://github.com/mitriyf/HvsV/blob/main/src/main/resources/slots13.yml
  • https://github.com/mitriyf/HvsV/blob/main/src/main/resources/schematics/default.yml
• or here:

config.yml

version: 1.3

settings:
  translate: hex
  locales: false
  games:
    world: "hvsv-XIDX"server.
    amount: 999
    damageWaiters: false
    deleteWhenClosing: false
  updater:
    enabled: true
    settings:
      required: true
      release: false
  supports:
    placeholderAPI: false
messages:
  game:
    status:
      wait: "&fLaunching via: &e%time% &fsec."
      start: "&fLeft: &e%time%"
      stopped: "&fPlayers needed: &e%min_players%"
      winVictim: "&aThe victims have won!"
      winHunter: "&cThe hunters have won!"
    role:
      victim: "&aVictim"
      hunter: "&cHunter"
    actions:
      command:
        help:
          - "[message] &a[HVSV] Help &7(/hvsv help):"
          - "[message] &f"
          - "[message] &a/hvsv status &f- View the plugin status."
          - "[message] &a/hvsv join &f- Create or join any available room."
          - "[message] &a/hvsv join roomid &f- Attempt to connect to the room (if it is available)."
          - "[message] &a/hvsv exit &f- Leave the room."
          - "[message] &a/hvsv admin &f- Get a Admin Help."
          - "[message] &a/hvsv reload &f- Reload the plugin configuration."
          - "[message] &f"
        noperm:
          - "[message] &cYou don't have enough rights!"
      room:
        notfound:
          - "[message] &cThis map does not exist."
        started:
          - "[message] &cThe game has already started."
        connect:
          - "[message] &aConnecting to the room &e%room%..."
        waiter:
          - "[message] &aYou have been placed in queue."
          - "[message] &fExit the queue: &c/hvsv exit"
        exit:
          - "[message] &cYou have left the queue."
        noExit:
          - "[message] &cYou are not in the game."
      game:
        inGame:
          - "[message] &cYou are in the game!"
        end:
          - "[message] &cThe game is over."
        kicked:
          - "[message] &cYou have been kicked out of the game."
        join:
          - "[message] &aYou are connected to the game: &e%game%"
          - "[room] &aPlayer &e%player% &ahas joined the game &f(&e%amount%&f/&e%max_players%&f)"
        quit:
          - "[room] &cPlayer &e%player% &cleft the game &f(&e%amount%&f/&e%max_players%&f)"
        role:
          - "[message] &fYou %role%!"
          - "[title] &fRole:;%role%"
          - "[message] &cThe hunters &fwill be out soon. Hurry and hide!"
        killHunter:
          - "[message] &fThe victim &a%victim% &cneutralized&f the hunter &c%hunter%"
        killVictim:
          - "[message] &fThe hunter &c%hunter%&f, &ckilled&f the victim &a%victim%"
        exitHun:
          - "[message] &cThe hunters &fhave broken free from their confinement!"
          - "[title] &cThe hunters;&cThey're out!"
        startAxe:
          - "[message] &aAxe&f appeared!"
          - "[title] &aAxe;&fappeared!"
        getAxe:
          - "[message] &fPlayer &e%axe% &fpicked up the hatchet! &cRun, hunters!"
        winHunter:
          - "[message] &cThe hunters have won!"
          - "[title] &cThe hunters;&fhave won!"
        winVictim:
          - "[message] &aThe victims have won!"
          - "[title] &aThe victims;&fhave won!"

slots.yml

default:
  player:
    exit:
      slot: 8
      type: default
      exit: true
      item:
        name: "&cExit"
        lore:
          - ""
          - "&cExit&f, and what is it?"
          - ""
        type: BARRIER
  victim:
    kill:
      slot: 0
      type: default
      weapon: true
      item:
        type: IRON_AXE
  hunter:
    kill:
      slot: 0
      type: default
      weapon: true
      item:
        type: DIAMOND_SWORD
    helmet:
      slot: 39
      type: default
      item:
        type: MOB_SPAWNER
schematics:
  default:
    player: [ ]
    hunter: [ ]
    victim: [ ]

default.yml

version: '1.3'

schematic:
  name: '&fDefault'
  coords:
    x: 0
    y: 100
    z: 0
  category:
    A: "alt"
    H: "hause"
    T: "weapon"
    X: "spawn"
    N: "no"
  spawns: "N"
  items: "T"
  hunters: "X"
  map:
    - "X N H"
    - "N T N"
    - "A N H"
  pasteAir: false
  gameRules:
    - randomTickSpeed:0
game:
  players:
    min: 3
    medium: 5
    max: 8
  waitTime:
    min: 60
    medium: 30
    max: 1
  endTime: 241
  playersHun:
    - "8:3"
    - "5:2"
    - "3:1"
  role:
    victim:
      health: 6
      damage: 2
      hitHunterInventory: true
      spawnLocation:
        offsetX: "-2;2"
        offsetY: 1
        offsetZ: "-2;2"
        offsetPitch: "-35;35"
    hunter:
      health: 10
      damage: 2
      spawn: 60
      spawnLocation:
        offsetX: "-1;1"
        offsetY: 1
        offsetZ: "-1;1"
        offsetPitch: "-35;35"
    spectator:
      enabled: true
      flySpeed: 2
  fence:
    break: true
    list:
      - "6;1;13;9;4;13"
  axe:
    spawn: 120
    respawn: 5
  armorStand:
    standLocation: "-0.1;-0.3;0"
    blockLocation: "-1;1;0"
    rightFace: "-100;0;0"
rules:
  foodLevelChange: false
  fallDamage: true
  pickupItem: false
  consumeItem: false
  dropItem: false
  creatureSpawn: false
  entityExplode: false
  entityTarget: false
  itemSpawn: false
  placeBlock: false
  breakBlock: false
  burnBlock: false
  igniteBlock: false
  fromToBlock: false
  entityChangeBlock: false
  physicsBlock: true
  fadeBlock: false
  leavesDecay: false
  multiPlaceBlock: false
player:
  health: 6
  foodLevel: 10
  gameMode: ADVENTURE
  fullSlots: false
  exitTime: 100
messages:
  actions:
    end: [ ]
    kicked: [ ]
    join: [ ]
    quit: [ ]
    role: [ ]
    killHunter: [ ]
    killVictim: [ ]
    exitHun: [ ]
    startAxe: [ ]
    getAxe: [ ]
    winHunter: [ ]
    winVictim: [ ]

You can consider the rest of the possibilities when using the plugin.