addon-challenges/README.md

68 lines
4.2 KiB
Markdown
Raw Normal View History

2019-02-12 15:16:14 +01:00
# Challenges Addon
[![Discord](https://img.shields.io/discord/272499714048524288.svg?logo=discord)](https://discord.bentobox.world)
2019-02-13 10:21:07 +01:00
[![Build Status](https://ci.codemc.org/buildStatus/icon?job=BentoBoxWorld/Challenges)](https://ci.codemc.org/job/BentoBoxWorld/job/Challenges/)
2019-02-13 10:21:30 +01:00
2019-02-12 15:16:14 +01:00
Add-on for BentoBox to provide challenges for any BentoBox GameMode.
2019-02-13 10:21:07 +01:00
## Where to find
Currently Challenges Addon is in **Beta stage**, so it may or may not contain bugs... a lot of bugs. Also it means, that some features are not working or implemented.
2019-05-09 15:22:02 +02:00
Latest official **Beta Release is 0.7.5**, and you can download it from [Release tab](https://github.com/BentoBoxWorld/Challenges/releases)
2019-08-28 12:11:03 +02:00
But it will work with BentoBox 1.5.0 only.
2019-02-13 10:21:07 +01:00
2019-08-28 12:11:03 +02:00
Latest development build will work with **BentoBox 1.7.0-SNAPSHOT**, as it contains new functionality, that is not in 1.6 release.
**Nightly builds** are available in [Jenkins Server](https://ci.codemc.org/job/BentoBoxWorld/job/Challenges/lastStableBuild/).
Be aware that 0.8.0-SNAPSHOT stores data differently than it is in 0.7.5 and below. It will be necessary to migrate data via command "/[gamemode_admin] challenges migrate".
2019-02-13 10:21:07 +01:00
If you like this addon but something is missing or is not working as you want, you can always submit an [Issue request](https://github.com/BentoBoxWorld/Challenges/issues) or get a support in Discord [BentoBox ![icon](https://avatars2.githubusercontent.com/u/41555324?s=15&v=4)](https://discord.bentobox.world)
2019-02-13 10:21:07 +01:00
## How to use
1. Place the addon jar in the addons folder of the BentoBox plugin
2. Restart the server
2019-08-30 15:29:41 +02:00
3. Edit the config.yml how you want.
4. Restart the server
2019-05-04 18:31:01 +02:00
#### Challenges
By default, challenges addon comes without any challenge or level. On first runtime only Admin GUI will be accessible.
2019-08-30 15:28:06 +02:00
Admins can create their own challenges or import some default challenges, which importing also are available via Admin GUI. Default challenges contains 5 levels and 57 challenges.
2019-02-12 15:16:14 +01:00
## Compatibility
2019-08-28 12:11:03 +02:00
- [x] BentoBox - 1.7.0-SNAPSHOT version
- [x] BSkyBlock - 1.6.0 version
- [x] AcidIsland - 1.6.0 version
- [x] SkyGrid - 1.6.0 version
- [x] CaveBlock - 1.6.0 version
## Config.yml
2019-02-12 15:16:14 +01:00
As most of BenotBox addons, config can be edited only when server is stopped. Otherwise all changes will be overwritten by server.
The config.yml has the following sections:
2019-05-04 18:31:01 +02:00
* **Commands** - ability to enable */challenges* command. This option change is possible only via configuration and requires server restart.
To enable, you should change `single-gui` to `true`.
* **History** - ability to enable completion history storing in player data object.
To enable, you should change `store-history-data` to `true`.
It is possible to change life-span of history data in days. (0 means that data will not be removed)
* **GUI Settings** - ability to change some options that are visible only in challenges GUI.
* Remove non-repeatable challenges from the challenge GUI when complete. Default is false.
* Add enchanted glow to completed challenges. Default is true.
* Locked level icon is displayed for locked levels.
* Free challenges location - You can decide, either free challenges will be at the top, or at the bottom.
* Description line length - allows to specify maximal line length in GUI icon descriptions.
* Challenge Description structure - allows to modify structure of challenge description.
* Level Description structure - allows to modify structure of Level description.
* **Store mode** - ability to store challenges completion per island or per player.
To enable storing challenges data per island change `store-island-data` to `true`. ATTENTION: progress will be lost on this option change.
* **Reset Challenges** - if this is true, player's challenges will reset when they reset an island or if they are kicked or leave a team. Prevents exploiting the challenges by doing them repeatedly. Default is true
* **Broadcast** - ability to broadcast 1st time challenge completion messages to all players. Change to false if the spam becomes too much. Default is true.
* **Title** - ability to enable showing Title screen on first challenge completion or level completion.
* **Disabled GameModes** - specify Game Modes where challenges will not work.
## Information
More information can be found in [Wiki Pages](https://github.com/BentoBoxWorld/Challenges/wiki).