aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMyles <43725835+MylesAndMore@users.noreply.github.com>2022-12-13 11:49:07 -0600
committerGitHub <noreply@github.com>2022-12-13 11:49:07 -0600
commitae3d7842ba4f261add8d5beb207d613515ee6602 (patch)
tree649061137630bb66ff1415a1f2adfae4502ecab5
parentfca9ec1f9235fe8f9c2941c99997f11c88177cce (diff)
downloadTumble-ae3d7842ba4f261add8d5beb207d613515ee6602.tar.gz
Tumble-ae3d7842ba4f261add8d5beb207d613515ee6602.tar.bz2
Tumble-ae3d7842ba4f261add8d5beb207d613515ee6602.zip
update versioning, config, and readme for pre-release
-rw-r--r--README.md53
-rw-r--r--src/main/resources/config.yml12
-rw-r--r--src/main/resources/plugin.yml2
3 files changed, 59 insertions, 8 deletions
diff --git a/README.md b/README.md
index 8559810..909880e 100644
--- a/README.md
+++ b/README.md
@@ -20,4 +20,55 @@ If you've never heard of it, [Tumble](https://minecraft-archive.fandom.com/wiki/
## Setup
-...
+1. Simply [download]() **add link to download** the plugin's JAR file and place it in your server's plugins directory.
+
+ - *Note: Multiverse is also required for the plugin to run, you may download it [here](https://www.spigotmc.org/resources/multiverse-core.390/).*
+
+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]() **add this guide** 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 into Multiverse. This can be done with the command ```/mv import <your-world-name> normal```.
+5. Now you need to tell Tumble which world is your lobby and which world is your game arena. You can do this with ```/tumble:link <your-lobby-world> lobby``` and ```/tumble:link <your-game-world> game``` respectively.
+6. You're done! You can now start games with the command ```/tumble:start```.
+
+Scroll down for more options to configure your game.
+
+## Commands
+
+- ```/tumble:reload```
+
+ - *Description:* Reloads the plugin's configuration.
+ - *Usage:* ```/tumble:reload```
+ - *Permission:* ```tumble.reload```
+- ```/tumble:link```
+ - *Description:* Links a world on the server as a lobby or game world.
+ - *Usage:* ```/tumble:link <world> (lobby|game)```
+ - *Permission:* ```tumble.link```
+- ```/tumble:start```
+ - *Description:* Force starts a Tumble match (with an optional game type).
+ - *Usage:* ```/tumble:start [game-type]```
+ - *Permission:* ```tumble.start```
+- ```/tumble:winlocation```
+ - *Description:* Sets the location to teleport the winning player of a game. Uses the player's location if no arguments are specified.
+ - *Usage:* ```/tumble:winlocation [x] [y] [z]```
+ - *Permission:* ```tumble.winlocation```
+- ```/tumble:autostart```
+ - *Description:* Configures the auto start functions of Tumble.
+ - *Usage:* ```/tumble:autostart <playerAmount> [enable|disable]```
+ - *Permission:* ```tumble.autostart```
+
+## Configuration
+
+- ```gameMode```
+ - Customize the default game mode of Tumble.
+ - Acceptable options include: shovels, snowballs, mixed
+ - *Default:* ```mixed```
+
+- ```hideJoinLeaveMessages```
+ - Hides join/leave messages in public chat.
+ - *Default:* ```false```
+
+- ```permissionMessage```
+ - Customize the message that displays when the player does not have permission to execute a command from this plugin.
diff --git a/src/main/resources/config.yml b/src/main/resources/config.yml
index bc68c35..ee2a2c7 100644
--- a/src/main/resources/config.yml
+++ b/src/main/resources/config.yml
@@ -1,3 +1,8 @@
+# Customize the default game mode of Tumble
+# Acceptable options include: shovels, snowballs, mixed
+# Default is mixed
+gameMode: mixed
+
# Hides join/leave messages in public chat
# Default is false
hideJoinLeaveMessages: false
@@ -5,13 +10,8 @@ hideJoinLeaveMessages: false
# Customize the message that displays when the player does not have permission to execute a command from this plugin
permissionMessage: You do not have permission to perform this command!
-# Customize the game mode of Tumble
-# Acceptable options include: shovels, snowballs, mixed
-# Default is mixed
-gameMode: mixed
-
# Customize the auto start feature of Tumble
-# Defaults are disabled and two players
+# Defaults are false and two players
# Players can be up to 8
autoStart:
enabled: false
diff --git a/src/main/resources/plugin.yml b/src/main/resources/plugin.yml
index ac394bf..c78eece 100644
--- a/src/main/resources/plugin.yml
+++ b/src/main/resources/plugin.yml
@@ -1,6 +1,6 @@
main: com.MylesAndMore.tumble.Main
name: tumble
-version: 0.0.1-SNAPSHOT
+version: 1.0.0
description: 'A Minecraft: Java Edition plugin recreating the Tumble minigame from Minecraft Legacy Console Edition.'
api-version: 1.19
load: STARTUP