summaryrefslogtreecommitdiffstats
path: root/README.md
blob: 63e8a6b5bebca12fa46122c1ceb8ba2cd968d19b (plain)
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
[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/LMBishop/Quests.svg)](http://isitmaintained.com/project/LMBishop/Quests "Average time to resolve an issue") [![Percentage of issues still open](http://isitmaintained.com/badge/open/LMBishop/Quests.svg)](http://isitmaintained.com/project/LMBishop/Quests "Percentage of issues still open")
## About Quests
This plugin will allow your players to do quests in-game to earn rewards. This can all be configured.

## Downloads/Building
The latest release version of Quests can be found on [Spigot](https://www.spigotmc.org/resources/▶-quests-◀-set-up-goals-for-players.23696/)

Alternatively, you can build Quests via Maven using ``mvn clean package``.
## Contributors
- LMBishop
- Reinatix
- ToastedCoconut
- nicuch
- RodneyMKay

## Support
For support please open a [GitHub issue](https://github.com/LMBishop/Quests/issues) or join our [Discord server](https://discord.gg/8amrJnX). Please provide information of the issue, any errors that may come up and make sure you are using the latest version of the plugin.

### Issue Tracker
**This is the perferred method of bug reporting & feature requests**. Please use one of the two templates which are provided. If it is neither a bug report or a feature request and is a question, Discord would be a better place to asked this instead. **Follow the template in the issue tracker**. There is nothing more frustrating than people not reporting a bug correctly by missing out vital steps to reproduce the bug or an incomplete description. If the issue is not correctly formated, it will be closed and ignored.

### Discord
**This is the perferred method for general questions about Quests or the development of the project**. Join the Discord server and go to the relative support channel (in this case: #quests-support). Please provide steps to reproduce and a good enough description of the bug and include any errors you may see in console.

### Language
Please speak English and do not use any vulgar or harmful language. Insulting myself or any other contributors will lead to you being blocked, please remember this is a *voulenteer driven project*.

## Configuration Assistance
The configuration documentation can be found at the [wiki](https://github.com/LMBishop/Quests/wiki/Creating-A-Quest-Or-Category).

## Developing Alongside Quests
Creating new Task Types within Quests is supported, [see the wiki](https://github.com/LMBishop/Quests/wiki/New-Task-Type) for help.

## Contributing To Quests
Fork and make a pull request. Please be consistent with the formatting of the file, please state what you have changed, please test what you have changed before submitting a pull request to make sure it works. Include your DiscordTag if you want a 'contributors' role in our [Discord server](https://discord.gg/8amrJnX).

### Contribution Guildlines
Make sure to format your file using *spaces* not *tabs*. This is how the rest of the project is and it will remain that way. When committing, please follow normal convention which is to have a ~50 character summary on the first line, a blank line then (if applicable) a more detailed description either in bullet points (using a dash as the bullet) or as paragraphs.

Example commit message:
```
Added guidelines to README.md

- Added information on using Maven to build Quests.
- Added information on how to use the Issue Tracker effectively to communcate bugs.
- Made sure to elaborate on how to format files and commit messages.
```
Make sure your changes actually work before submitting a pull request by building the project and testing it on a Spigot server using the latest version.