2023-07-08 02:14:36 +02:00
# BlockHunt
2013-07-27 14:10:51 +02:00
2018-01-16 08:47:17 +01:00
## Introduction
2022-10-12 00:55:32 +02:00
Hide and seek is a popular game mode on Minecraft that allows you to hide as blocks and disguise as normal props from
seekers. This plugin allows you to do that but with a lot more features added on such as: shops, stats etc...
2016-04-08 20:40:58 +02:00
2023-07-08 02:14:36 +02:00
This plugin has been heavily inspired from the game-mode "PropHunt", from the game, "Garry's Mod".
2016-04-08 20:40:58 +02:00
**Download and try this plugin out for yourself!**
2018-01-16 08:47:17 +01:00
### Downloads
2023-07-08 02:14:36 +02:00
| Branch | Plugin version | Compatible Minecraft version |
|---------|----------------|------------------------------|
| Release | **v0.5.0** | **v1.18+** |
2018-01-16 08:47:17 +01:00
2023-07-08 02:29:35 +02:00
#### This plugin requires you to download and install two additional plugins! ([Lib's Disguises](https://www.spigotmc.org/resources/libs-disguises.81/) and [ProtocolLib](https://www.spigotmc.org/resources/protocollib.1997/))
2016-04-08 20:40:58 +02:00
2018-01-16 08:47:17 +01:00
### Support
2016-04-08 20:40:58 +02:00
2023-07-08 02:14:36 +02:00
| Method | Link |
|-----------------------------|------------------------------------------------------------------------|
| **Issues/Tickets on Gitea** | [Click Here ](https://git.knarcraft.net/EpicKnarvik97/BlockHunt/issues ) |
2016-04-08 20:40:58 +02:00
2018-01-16 08:47:17 +01:00
### Features
2022-10-12 00:55:32 +02:00
2016-04-08 20:40:58 +02:00
* Custom wand for selection arena.
* Multiple arenas.
* **Join/Leave signs!**
* Arena full bypass.
* Configurable blocks.
* **Solid blocks like the Hives!**
* Enable commands per arena.
* Executing commands on win.
* **Shop with tokens!**
* Instant respawn.
* **_And more!_**
2022-10-12 00:55:32 +02:00
## Commands & Permissions
2016-04-08 20:40:58 +02:00
_**Note:** Instead of using /BlockHunt you could use:_
2022-10-12 00:55:32 +02:00
2016-04-08 20:40:58 +02:00
* /bh
* /hideandseek
* /seekandfind (from my old plugin)
< > = Required [] = Optional
2023-07-07 03:42:04 +02:00
| Command | Description | Permission | Default allowed |
|--------------------------------------------------------------------|---------------------------------------------------|-----------------------------|----------------------------------------------|
| `/BlockHunt [info/i]` | Displays the plugin's info. | blockhunt.info | All players have this permission by default. |
| `/BlockHunt <help/h>` | Shows a list of commands. | blockhunt.help | All players have this permission by default. |
| `/BlockHunt <reload/r>` | Reloads all configs. | blockhunt.reload | blockhunt.admin |
| `/BlockHunt <join/j> <arenaName>` | Joins a BlockHunt game. | blockhunt.join | blockhunt.player |
| `/BlockHunt <leave/l>` | Leave a BlockHunt game. | blockhunt.leave | blockhunt.player |
| `/BlockHunt <list/li>` | Shows a list of available arenas. | blockhunt.list | blockhunt.player |
| `/BlockHunt <shop/sh>` | Opens the BlockHunt shop. | blockhunt.shop | blockhunt.player |
| `/BlockHunt <start/go> <arenaName>` | Forces an arena to start. | blockhunt.start | blockhunt.moderator |
| `/BlockHunt <wand/w>` | Gives you the wand selection tool. | blockhunt.create | blockhunt.admin |
| `/BlockHunt <create/c> <arenaName>` | Creates an arena from your selection. | blockhunt.create | blockhunt.admin |
| `/BlockHunt <set/s> <arenaName>` | Opens a panel to set settings. | blockhunt.set | blockhunt.moderator |
| `/BlockHunt <setWarp/sw> <lobby/hiders/seekers/spawn> <arenaName>` | Sets warps for your arena. | blockhunt.setWarp | blockhunt.moderator |
| `/BlockHunt <remove/delete> <arenaName>` | Deletes an Arena. | blockhunt.remove | blockhunt.admin |
| `/BlockHunt <tokens/t> <set/add/take> <%playerName%> <amount>` | Change someones tokens. | blockhunt.tokens | blockhunt.admin |
| | Able to join full games. | blockhunt.joinfull | blockhunt.moderator |
| | Able to join/leave using join/leave signs. | blockhunt.joinsign | blockhunt.player |
| | Able to create a join/leave sign. | blockhunt.signcreate | blockhunt.moderator |
| | Gives you the BlockChooser. | blockhunt.shop.blockchooser | blockhunt.admin |
| | Gives you the ability to do all commands in-game. | blockhunt.allcommands | Operators |
2022-10-12 00:55:32 +02:00
### Other special permissions
2023-07-07 02:49:08 +02:00
| Permission | Description |
|-----------------------|--------------------------------------------------------------------|
| `blockhunt.*` | All BlockHunt permissions. |
| `blockhunt.player` | All player related permissions. |
| `blockhunt.moderator` | All moderator related permissions. |
| `blockhunt.admin` | All admin related permissions. |
| `*` | All permissions on your server, including BlockHunt's permissions. |
2022-10-12 00:55:32 +02:00
2023-07-06 21:37:31 +02:00
## How to set up?
2022-10-12 00:55:32 +02:00
2023-07-08 02:14:36 +02:00
See [this video ](https://www.youtube.com/watch?feature=player_embedded&v=msPQ1UMiHWg ) or use the textual guide below.
2023-07-07 02:49:08 +02:00
### Textual guide
2023-07-08 02:19:20 +02:00
#### Specifying the region
2023-07-07 02:49:08 +02:00
To start setting up your arena, start by using the `/bh wand` command to get the setup wand. Mark the corners of a
square containing your entire arena, like you'd create a WorldGuard region. Right-click with the wand on one corner,
and then left-click with the wand on the opposite corner. Make sure one corner is below the bottom of the arena, and
that the other is above the top of the arena.
2023-07-08 02:19:20 +02:00
#### Creating the arena
Use `/bh create <name>` to create your new arena with name \<name>.
#### Configuring the arena
Use `/bh set <name>` to get a GUI for setting the properties of the arena. See [this ](#arena-setup-menu-descriptions )
for information about the various settable values. When you've set the values as wanted, click the book. In the
inventory, put all blocks you want hiders to use.
#### Warps
The last step in the setup is to set the warps.
##### Lobby
Use `/bh sw lobby <name>` to set the lobby at your current location.
The lobby is the location players are teleported to after joining, before the arena starts.
2023-07-07 03:42:04 +02:00
2023-07-08 02:19:20 +02:00
##### Hiders
Use `/bh sw hiders <name>`
to set the hiders spawn. This is where hiders are teleported once the arena starts.
##### Seekers
Use `/bh sw seekers <name>`
2023-07-07 03:42:04 +02:00
to set the seekers location at your current location. The seekers location is where seekers are teleported when the
arena starts. Choose a place where they cannot reach or see the hiders, as they are teleported to the hiders warp once
2023-07-08 02:19:20 +02:00
they are allowed to start seeking.
##### Spawn
Use `/bh sw spawn <name>` to set the locations players will go to when exiting the arena.
#### Signs
2023-07-07 03:42:04 +02:00
You can set up a join sign, which also displays current players, by creating a sign like:
2023-07-07 03:44:25 +02:00
1. `[BlockHunt]`
2023-07-07 03:42:04 +02:00
2. \<name>
You can set up a leave sign, by creating a sign, in the arena and/or lobby, like:
2023-07-07 03:44:25 +02:00
1. `[BlockHunt]`
2023-07-07 03:42:04 +02:00
2. Leave
You can set up a shop sign, by creating a sign like:
2023-07-07 03:44:25 +02:00
1. `[BlockHunt]`
2023-07-07 03:42:04 +02:00
2. Shop
2023-07-07 03:47:20 +02:00
### Arena setup menu descriptions
2023-07-07 02:49:08 +02:00
#### maxPlayers
The maximum amount of players that can join this arena.
#### minPlayers
The minimum amount of players required for a round to start.
#### amountSeekersOnStart
The number of players made into seekers when the game starts.
#### timeInLobbyUntilStart
The amount of seconds to wait in the lobby until the game actually starts. During this time, players can use an item in
their inventory to choose their hide block. Other players can join during this time, until the game starts.
#### waitingTimeSeeker
The number of seconds seekers have to wait before they are allowed to start seeking. This is basically how long the
seekers count for until they start searching for the hiders.
#### gameTime
The amount of seconds a game will last. If the hiders are alive after this time, they win.
#### blockAnnouncerTime
2023-07-07 03:42:04 +02:00
The amount of seconds left when announcing the number of currently hiding players.
#### timeUntilHidersSword
The amount of seconds to wait before allowing hiders to defend themselves with a wooden sword.
#### hidersTokenWin
The number of tokens rewarded if the hiders win.
#### seekersTokenWin
The number of tokens rewarded if the seekers win.
2023-07-07 02:49:08 +02:00
2023-07-07 03:42:04 +02:00
#### killTokens
2023-07-07 02:49:08 +02:00
2023-07-07 03:42:04 +02:00
The number of tokens rewarded if a seeker kills a hider.
