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.

The victim is watching the hunter. The victim watches as the hunter finds her. The victim is already trying to grab the axe, but the hunter is already running after him! Demonstration of entering the game.

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

The hunter is watching the game. The hunter has found the victim and is trying to stop her. The hunter found the victim and is tormenting her.

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

Spectator mode. The hunters won. The victims have won. Demonstration of exiting the game after winning.

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:
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.

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details