diff options
| author | Myles <43725835+MylesAndMore@users.noreply.github.com> | 2022-12-13 11:49:07 -0600 | 
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-12-13 11:49:07 -0600 | 
| commit | ae3d7842ba4f261add8d5beb207d613515ee6602 (patch) | |
| tree | 649061137630bb66ff1415a1f2adfae4502ecab5 | |
| parent | fca9ec1f9235fe8f9c2941c99997f11c88177cce (diff) | |
| download | Tumble-ae3d7842ba4f261add8d5beb207d613515ee6602.tar.gz Tumble-ae3d7842ba4f261add8d5beb207d613515ee6602.tar.bz2 Tumble-ae3d7842ba4f261add8d5beb207d613515ee6602.zip | |
update versioning, config, and readme for pre-release
| -rw-r--r-- | README.md | 53 | ||||
| -rw-r--r-- | src/main/resources/config.yml | 12 | ||||
| -rw-r--r-- | src/main/resources/plugin.yml | 2 | 
3 files changed, 59 insertions, 8 deletions
| @@ -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 | 
