aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: a0346296289fc57dbe5bfe7950dd8009a2d3feb6 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
# Tumble  

## Overview  

Tumble is a Spigot/Paper plugin that aims to recreate the Tumble minigame from the bygone era of the Minecraft Legacy Console Editions.  

## What *is* Tumble?

If you've never heard of it, [Tumble](https://minecraft.wiki/w/Tumble) is a twist on the classic Minecraft minigame of spleef, where the objective is to break the blocks under your opponents. But in Tumble, you play on randomly generated layers of blocks, using shovels, snowballs, or both to try and eliminate your opponents.

## Features  

- Choose from three different game modes present in the original game--shovels, snowballs, and mixed  
- Four types of random layer generation  
- 15 unique, themed layer varieties
- Quick and easy setup and use
- Support for 2-8 players  
- Highly customizable  
- Open-source codebase  
- Multiple arenas and concurrent games

## Setup

1. Simply [download](https://github.com/MylesAndMore/Tumble/releases) the plugin's JAR file and place it in your server's plugins directory.
2. Make sure that you have at least two worlds in your world directory! One is for your lobby world, and the other is for your game arena.  

    - If you would like an experience similar to the original game, see [my guide](https://github.com/MylesAndMore/tumble/blob/main/og-guide.md) for using the original worlds.  

3. Start your server. The plugin will generate a couple of warnings, these are normal.
4. Ensure that you have imported your worlds using a plugin like Multiverse. This can be done with the command ```/mv import <your-world-name> normal```.
5. Now you need to tell Tumble where your lobby is and where your game arena is. You can do this by going to the center positions and running  ```/tumble-config set lobbyWorld``` and ```/tumble-config add <arenaname>``` respectively.
6. **VERY IMPORTANT:** The plugin will teleport players to the world and generate the game's blocks around the point you set. Ensure that your spawn points are clear of any obstructions, and that a 20x20x20 cube is cleared out **Any blocks in this area will be destroyed when the game begins.**
7. You're done! You can now start games with the command ```/tumble-start <arenaname> mixed```.

Scroll down for more options to configure your game.  

## Commands/Permissions

- **tumble-join**:
  - Description: Joins a Tumble match.
  - Usage: `/tumble-join <arenaName> [gameType]`
  - Permission: tumble.join
- **tumble-leave**:
  - Description: Quits a Tumble match.
  - Usage: `/tumble-leave`
  - Permission: tumble.leave
- **tumble-forcestart**:
  - Description: Force starts a Tumble match.
  - Usage: `/tumble-forcestart [arenaName]`
  - Permission: tumble.forcestart
- **tumble-forcestop**:
  - Description: Force stops a Tumble match.
  - Usage: `/tumble-forcestop [arenaName]`
  - Permission: tumble.forcestop
- **tumble-config**:
  - Description: Modify arenas and worlds.
  - Usage: `/tumble-config <add|set|disable|delete> <data>`
  - Permission: tumble.config
- **tumble-reload**:
  - Description: Reloads the plugin's config.
  - Usage: `/tumble-reload`
  - Permission: tumble.reload

## Configuration  
Use `/tumble-config` for modifying the config in-game. See available options with the tab auto complete feature

See the comments inside config,yml for manual editing

## Issues & Feedback  

Feel free to report any bugs, leave feedback, ask questions, or submit ideas for new features on our [GitHub issues page](https://github.com/MylesAndMore/tumble/issues/new)!