Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/blackoutburst/hitw-plugin
Hole in the wall plugin for practice / tournament / community game modes using spigot/bukkit Paper/Spigot version 1.8.8 (v1_8_R3)
https://github.com/blackoutburst/hitw-plugin
hypixel java minecraft minecraft-plugin spigot spigot-plugin
Last synced: 3 days ago
JSON representation
Hole in the wall plugin for practice / tournament / community game modes using spigot/bukkit Paper/Spigot version 1.8.8 (v1_8_R3)
- Host: GitHub
- URL: https://github.com/blackoutburst/hitw-plugin
- Owner: Blackoutburst
- License: wtfpl
- Created: 2020-12-10T21:39:49.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-06-30T13:18:56.000Z (over 1 year ago)
- Last Synced: 2023-06-30T14:33:54.182Z (over 1 year ago)
- Topics: hypixel, java, minecraft, minecraft-plugin, spigot, spigot-plugin
- Language: Java
- Homepage: https://www.blackoutburst.com/hitw.html
- Size: 28.8 MB
- Stars: 4
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](LICENSE)
[](https://github.com/Blackoutburst/HitW-plugin/releases)
[](https://www.codacy.com/gh/Blackoutburst/HitW-plugin/dashboard?utm_source=github.com&utm_medium=referral&utm_content=Blackoutburst/HitW-plugin&utm_campaign=Badge_Grade)
[
](https://www.blackoutburst.com/hitw.html)
# Hole in the Wall Plugin
## DISCLAIMER
I do not own any permission over the real Hole in the Wall game created by Hypixel, this plugin is only made for the Hole in the Wall community on Hypixel.\
This plugin do not re create the game Hole in the Wall the way it work on Hypixel (by that i mean no pre lobby and a full game with 14 player).\
This plugin is designed as a core plugin for our Hole in the Wall community server so by itself you will probably be unable to do anything without the rest of the server files.
## Features
### Hole in the Wall game
It work exactly like Hypixel with one exception wall are not moving toward the player. (reason: on high level gameplay it's not noticeable and for a new player it's less stressful so they can focus more on playing well instead of rushing).\
### Duel
[Implementation footage](https://youtu.be/3O-An6CLEao) **FLASHING LIGHTS**
`/duel player` make you able to duel anyone\
When you use this command, it open this menu where you can select to type of game you want (Qualification on the left or Finals on the right).\
Once you click a game type the opponent will receive a duel request free to him to accept it or not.\
If the opponent accepts your request, you will be teleported to a special area and the game will start (classic game only).\
It's possible to play with all modification available in the configuration menu for that the player sending the duel request must enable them first. (note only right sided walls is player dependant so one player can play left sided while the other one play right sided).
### Party / Coop system
Basically work like Hypixel for the available commands and how it works.\
`/p player` | `/party player` | `/coop player` Send a party invitation to a player.
Some commands are just not implemented as they don't really serve a purpose on this server.\
While in a party every player in the party will be able to build the current wall, only the party leader can start a game.\
The game will always take the party leader configuration.\
Song, glass color, fly, title, brush lag are player dependant (wall color depends on the last player who flicked the lever).\
### Game area system
This plugin uses a system of game area, so you are free to move around the map and you can only start a game when you are inside a game area leaving a game area make you instantly finish your game but this is optional as seen later.
### Play mode
`/play` start a game with endless time to play you can stop the game either by leaving the game are or using `/l` | `/leave`.\
`/play score [value]` play a game until you reach the specified score.\
`/play time [value]` play a game for a spcified time (in seconds).\
`/play classic` play a game using Hypixel rule set (best way to know what your score would be on Hypixel).
### Configuration menu
This is where you toggle most game modifier or settings, when joining the server you get a nether start and this item is used to open this menu.\
From left to right and bottom to top:
#### Walls animation
This setting bring back the old walls animation that used to be on Hypixel.
#### Right sided walls
This setting is really special and concern only a few players but it flip the walls to make them right sided, I'm not going to provide explanation on what a right sided or left sided wall is here.
#### Blind mode
As explained in the screenshot you have a customisable amount of time to memorize the wall and then you need to build it from memory.
#### Break mode
This game mode basically inverts the usual gameplay, instead of placing block you have to break them.
#### Auto leave
This setting make you automatically end the game when you step out of your game area, disabling it can be useful for players who move a lot and could potentially end their game by mistake.
#### Title
If enabled message such as countdown, perfect wall and game end will show as Minecraft title else they will just appear as chat messages.
#### Fly
Make you able to fly or not if you prefer playing no fly and don't want to fly by mistake.
#### Song
Open a sub menu with multiple songs to select from. This is the song you will hear while playing a game, or ou can just chose to not play any song while playing.
#### Glass color
Open a sub menu when you can select the glass color you want to play with.
#### Wall color
Open a sub menu when you can select the wall color you want to play with.
#### Brushing lag
This settings only exist because Hypixel and this server are not hosted in the same country at all so it's used to simulate your Hypixel ping. (it's mainly important for high-level player).
#### Memory time
Use this to change how much time you have to memorize the wall while playing blind mode.
#### Lever delay
Change how much time the lever is disabled after using it, this settings only affect endless games as other type of game (score, time, classic) use Hypixel lever delay.
### Scoreboard
This scoreboard shows current game information such as:
- The stage you are playing.
- How long are you playing (or how much time remaining for time and classic).
- The number of perfect walls you made.
- The wall you are currently building.
- You current score.
- How many holes you didn't filled.
- How much block you placed that weren't holes.
- How much time you placed a block outside your play area.
### Wall informations
Everytime you pull the lever you get a chat message looking like this.\
It tells you how much score you made and tell you what type of mistake you made if you made at least 1.\
This message also shows how much time you needed to complete the wall.
### Game summary
Show all the information of what happened in the game such as score, time, number of walls and mistakes.\
### Rank from Hypixel API
When a player join, they get a rank skill by 50+ division (and sub 25+ for the plus color) using their Hypixel Hole in the Wall best score (Qualification or Finals).\
Here is the rank list, rank, and rank color are based on the Hole in the Wall discord server.\
### NPCS
This plugin manages 3 groups of NPC, the hall of fame of every notable Hole in the Wall player.\
Tournament winner NPC.\
Warps NPC used to navigate through different area in the server such as Spawn, Qualification and Finals.\
### Custom wall size
As long as you build a rectangle it will work so you can make tiny or giant wall it's not a problem
### API
This plugin does run an internal API
#### How to use it and what does it answer
Well it's actually simple to perform a request just create a TCP socket and connect to the server, send the uuid of the requested player and the server will answer in JSON format
##### Request exemple
```java
Socket socket = new Socket("Server IP", 00000);
BufferedReader in = new BufferedReader(new InputStreamReader(socket.getInputStream(), "UTF-8"));
OutputStream out = socket.getOutputStream();
out.write(uuid.getBytes("UTF-8"));
String data = in.readLine();
socket.close();
in.close();
out.close();
return (data);
```
##### API possible return
If the player exist
```JSON
{
"scores":{
"qualification":0,
"finals":0,
"wide_qualification":0,
"lobby":0
}
}
```
if the player doesn't exist
```
Unknown player
```
### Tournament system
The tournament system got discontinued and removed when this plugin got reworked due to the lack of tournament in the community, it might come back one day if tournament activity is revived.
## Special Thanks
Flame_Frost_ : for introducing me to this awesome community.\
HammyInTheWall : for creating the community like we know it today.\
MasonMC : for helping me in the early day with this server.
And to all the cool people and friend I've met along the way
- Simown
- Puffleman
- Cosmic
- Khantrast
- Winday
- Fuby
- Ugy
- Mars
- Jaq
- Dobg
- Arcxire
- Lapis
- Glampkoo
- Bertje
- Venom
- Ueku
- Audero
- Norrie
- HMT
And many more thanks you all ❤️