Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jeremynoesen/volleyball

A simple volleyball minigame plugin for Spigot Minecraft servers
https://github.com/jeremynoesen/volleyball

bukkit bukkit-plugin gradle java minecraft minecraft-plugin minigame minigame-plugin paper plugin spigot spigot-plugin volleyball

Last synced: about 2 months ago
JSON representation

A simple volleyball minigame plugin for Spigot Minecraft servers

Host: GitHub
URL: https://github.com/jeremynoesen/volleyball
Owner: jeremynoesen
License: gpl-3.0
Created: 2019-07-19T19:46:06.000Z (over 5 years ago)
Default Branch: main
Last Pushed: 2024-04-25T22:35:21.000Z (8 months ago)
Last Synced: 2024-10-12T11:08:46.830Z (2 months ago)
Topics: bukkit, bukkit-plugin, gradle, java, minecraft, minecraft-plugin, minigame, minigame-plugin, paper, plugin, spigot, spigot-plugin, volleyball
Language: Java
Homepage: https://www.spigotmc.org/resources/volleyball-a-simple-game-for-your-world.74552/
Size: 21.7 MB
Stars: 12
Watchers: 1
Forks: 2
Open Issues: 3
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# VolleyBall

## About
VolleyBall is a minigame that emulates volleyball for a Spigot Minecraft server. Players can serve a ball on a volleyball court and punch it to volley it. Volleys are counted when the ball goes over the net. Multiple courts can be created and modified with this plugin.

## Purpose
VolleyBall was originally written for a tropical island themed event on a Minecraft server. This was to add more player interactive content to the build to make it feel more lively. From there, this plugin has grown more complex to allow other servers to enjoy the features of VolleyBall for themselves.

## Usage

- `/volleyball help` and `/volleyball court help` - Show the help messages
- `/volleyball reload` - Reload all configs and delete volleyball entities
- `/volleyball court create ` - Create a new court using a world edit selection
- `/volleyball court remove ` - Delete a court
- `/volleyball court select ` - Select a court with WorldEdit
- `/volleyball court info ` - Get info about the court
- `/volleyball court set net` - Set the net bounds with WorldEdit
- `/volleyball court set bounds` - Set the court bounds with WorldEdit
- `/volleyball court set restrictions ` - Enable or disable ball court restrictions
- `/volleyball court set animations ` - Enable or disable ball animations
- `/volleyball court set enabled ` - Enable or disable a court
- `/volleyball court set texture ` - Set the ball texture based on a Minecraft skin texture url
- `/volleyball court set speed ` - Set the ball speed, default is 1.0
- `/volleyball court set name ` - Change a court's name

### Playing
- Press and release your sneak key to serve the ball when on a court
- Punch when the ball is close to you
- Try to keep the ball from hitting the ground and get it over the net

## Requirements
- Spigot or Paper 1.13 - 1.18
- Java 8 or higher
- WorldEdit 7.2.8

## Installation
1. Download the latest release.
2. Put the jar in your plugins folder.
3. Start or restart your server.

## Configuration
There is no main configuration, all configuring is done in-game.

- Use the `court create` command to create a court. The court will be created, but not enabled.
- Use WorldEdit to select a cuboid region to set as the bounds. Include the floor and the air above it, not just the floor! run the `court set bounds` command with this selected.
- Select the net with WorldEdit. Do not include the air under the net. Run the ` court set net` command to set this as the net.
- Use the other court commands to customize your court to your liking.
- Once you are finished, run the `court set enabled` command with `true` to enable your court. This court can not have its blocks modified while it is enabled, so make sure you make build edits before enabling!

Do not modify the courts config, as you can possibly break your saved courts!

For the message configuration, you can use color codes. You can also use the placeholders used per message, as shown in the default configuration. The messages and their names should explain what they are used for.

### Permissions
- `volleyball.help` - Allow using the main help command
- `volleyball.reload` - Allow reloading the plugin
- `volleyball.court.create` - Allow creating a court
- `volleyball.court.remove` - Allow removing a court
- `volleyball.court.info` - Allow seeing info about courts
- `volleyball.court.list` - Allow seeing the list of courts
- `volleyball.court.select` - Allow selecting a court
- `volleyball.court.help` - Allow seeing court help
- `volleyball.court.set.animations` - Allow setting ball animations
- `volleyball.court.set.speed` - Allow setting ball speed
- `volleyball.court.set.texture` - Allow setting ball texture
- `volleyball.court.set.bounds` - Allow setting court bounds
- `volleyball.court.set.enabled` - Allow setting court enabled
- `volleyball.court.set.net` - Allow setting net
- `volleyball.court.set.name` - Allow setting court name
- `volleyball.court.set.restrictions` - Allow ball setting restrictions

## Demonstration

## Building
Due to the fact that this plugin uses some NMS code, the build instructions are a little more complicated than usual:

1. Clone or download this repository.
2. Download a copy of the Spigot 1.13.2 jar.
3. Modify `build.gradle` to link to this Spigot jar.
4. Run `./gradlew shadowJar` in the directory of the project.
5. `/build/libs/VolleyBall.jar` should have been generated.

You can also grab `VolleyBall.jar` from the latest releases.

## Troubleshooting
Ball not spawning?
- If you are using world guard, enable armor stand spawning in the region the court is in.
- Also make sure block-plugin-spawning is set to false in the world guard config.
- If you are using EssentialsProtect, make sure to not block armor stand spawning.

## Notice
This project is no longer in development.