mirror of
https://github.com/Zrips/Jobs.git
synced 2024-11-25 20:16:13 +01:00
43b705195c
- Since there's no jenkins or releases it will always show red in the top icons, I've removed the two - Moved the issues and pulls icons to the same line as the first two - Moved the header with the image to the top - Re-wrote the introduction text to be more friendly, yet informative. And proofread it for grammar/spelling. This way it's a bit more modern and current. - Made sure the headers `#` vs `##` are a bit better (consistency) - Made sure there was a clear mention near the top of the required cmilib library - Made the introduction more friendly to the releases links, and include cmilib there, as well a mention that tech savvy people can get the code and compile it, - Included a bit more clear listing for officially supported (and not..) server engines. People who confirm this works on their modded server are free to clone/pr their findings I guess - Included installation instructions for people who don't want to deal with code, or are new to server running, they now can find the download links, the required library file, and the extra server restart text .. all in one readme document. hopefully lowering the 'it does not work' questions on discord etc. - Bugs and suggestions - this is added to explain where to post what, and that if they know how to fix the bug that they can clone/pr it. - Moved support before API, and moved API as a whole lower on the page. - Made sure discord community is part of support - Included link to the official zrips.net website for the jobs/api uner API - And I've moved the credits to the bottom, as most ppl who come to github come to find out what this is about, how to get it, how to get support .. so credits can be a bit lower. And I've included a link to the contributions made by others. I hope it's the correct way of doing that. - General grammar/spelling reviewed. - Made the document a bit more 'the same as' to match the more recent cmilib readme update. (more indirect-consistency) - Included basic permissions examples, because I noticed on discord people keep asking a few times per week.
148 lines
5.9 KiB
Markdown
148 lines
5.9 KiB
Markdown
# Jobs Reborn
|
|
|
|
|
|
|
|
-------
|
|
|
|
[](https://github.com/Zrips/Jobs/blob/master/LICENSE-Apache.txt) [](https://github.com/Zrips/Jobs/blob/master/LICENSE-GNU-GPL.txt) [](https://github.com/Zrips/Jobs/issues) [](https://github.com/Zrips/Jobs/pulls)
|
|
|
|
-------
|
|
|
|
## Introduction
|
|
|
|
Welcome to the Minecraft plugin that makes the gaming experience for your players even more exciting!
|
|
|
|
With this plugin, a player can pick their favorite job(s), such as building, mining, fishing, and crafting. By just playing they can earn rewards like job points, job experience that helps them level up, and ingame money (requires economy engine).
|
|
|
|
Whether they're a seasoned player or just starting out, they'll love the class-based professions and the satisfaction of leveling up as they master their chosen job(s).
|
|
|
|
Get ready for a whole new world of fun and rewards! This plugin works great together with the premium plugin CMI.
|
|
|
|
## Required Dependancy
|
|
|
|
To ensure the best experience with the Zrips made plugins, including Jobs Reborn, it's important to have the CMILib library installed.
|
|
|
|
We've made it easy for you by providing the latest .jar file. Simply make sure to include this library when you first install Jobs (or when you upgrade to a newer version), and you'll be on your way to enjoying all the fun and benefits our plugins have to offer.
|
|
|
|
## Releases / Downloads
|
|
|
|
We highly recommend keeping the Jobs Reborn .jar file, as well as all Zrips plugins, up-to-date. You can easily download the latest releases from the following links:
|
|
|
|
- CMILib Library: https://www.zrips.net/cmilib/
|
|
- Jobs-Reborn Plugin: https://www.spigotmc.org/resources/4216/
|
|
- For the tech-savvy, you can also access the latest Jobs source code on Github and compile it yourself.
|
|
- The old Bukkit Platform: https://dev.bukkit.org/projects/jobs-reborn
|
|
|
|
## Minecraft Server Engines
|
|
|
|
Jobs is designed for and officially supported on the following server engines:
|
|
|
|
- Spigot: https://www.spigotmc.org/
|
|
- Paper: https://papermc.io/
|
|
|
|
While other server engines are not officially supported, direct forks of Spigot and Paper _may_ still be compatible. Here are a few examples:
|
|
|
|
- PurPur
|
|
- Tuinity
|
|
|
|
Please note that these unsupported engines are used 'as is' and may not offer the same level of support or performance as the officially supported engines.
|
|
|
|
## Installation Instructions
|
|
|
|
To install the Jobs-Reborn plugin along with the CMILib library, follow these steps:
|
|
|
|
- Backup your server by running the /stop command.
|
|
- Download the latest CMILib .jar file and place it in the ~/plugins/ directory.
|
|
- Also include the Jobs-Reborn .jar file in the ~/plugins/ directory.
|
|
- Start your server back up.
|
|
- After the initial run, if you see the message 'Done!' with no issues, the plugin will have generated the necessary language and configuration files.
|
|
- Stop and restart the server one more time to review the plugin configurations. You can customize jobs, economy, chat settings, and more by following the guidance on the zrips.net > Jobs pages.
|
|
|
|
## Basic Permissions for Players
|
|
|
|
The Jobs-Reborn plugin requires some configuration in order for players to use the plugin, this includes the ability to use it, to browse and pick jobs, and to only get paid out in certain worlds. Below is an example of some basic permissions you can consider using to achieve that. (This requires a permission manager)
|
|
|
|
```
|
|
jobs.command.browse
|
|
jobs.command.info
|
|
jobs.command.join
|
|
jobs.command.leave
|
|
jobs.command.stats
|
|
jobs.command.top
|
|
jobs.join.*
|
|
jobs.max.3
|
|
jobs.use
|
|
jobs.world.world_overworld
|
|
jobs.world.world_theend
|
|
jobs.world.world_thenether
|
|
```
|
|
|
|
For example, using LuckPerms you could update the default group as such:
|
|
```
|
|
lp group default permission set jobs.use true
|
|
lp group default permission set jobs.max.1 true
|
|
lp group donator permission set jobs.max.2 true
|
|
```
|
|
|
|
## Bugs and Suggestions
|
|
|
|
Feel free to clone and submit a pull request with bug fixes or code suggestions.
|
|
|
|
If you're not familiar with the process, you can also report bugs and make suggestions as an issue (if one doesn't already exist) under the [Issues tab](https://github.com/Zrips/Jobs/issues) on Github.
|
|
|
|
## Support
|
|
|
|
You can request support from other Community Members on the [Zrips Community Discord](https://discord.gg/dDMamN4). (Pick the right roles, to unlock and show the plugins' #help channels.)
|
|
|
|
Please do check [the zrips.net/jobs website](https://www.zrips.net/jobs/) out first, before asking questions.
|
|
|
|
## Jobs API
|
|
|
|
- Information: https://www.zrips.net/jobs/api/
|
|
|
|
You can manually add the .jar file to your build path or you can use Jitpack if you use Maven or Gradle:
|
|
|
|
### Maven
|
|
|
|
```xml
|
|
<repositories>
|
|
<repository>
|
|
<id>jitpack.io</id>
|
|
<url>https://jitpack.io</url>
|
|
</repository>
|
|
</repositories>
|
|
|
|
<dependencies>
|
|
<dependency>
|
|
<groupId>com.github.Zrips</groupId>
|
|
<artifactId>Jobs</artifactId>
|
|
<version>LATEST</version> <!-- Change the LATEST to the current version of jobs -->
|
|
<scope>provided</scope>
|
|
</dependency>
|
|
</dependencies>
|
|
```
|
|
|
|
### Gradle
|
|
|
|
```gradle
|
|
repositories {
|
|
maven {
|
|
url 'https://jitpack.io'
|
|
}
|
|
}
|
|
dependencies {
|
|
implementation 'com.github.Zrips:Jobs:LATEST' //Change the LATEST to the current version of jobs
|
|
}
|
|
```
|
|
|
|
### API Events
|
|
|
|
For API events: https://github.com/Zrips/Jobs/wiki/API
|
|
|
|
## Credits
|
|
|
|
- _Original author and manager of this was phrstbrn until [v2.12.0](https://dev.bukkit.org/projects/jobs/files/808311) version._
|
|
- Current development: [Zrips](https://www.spigotmc.org/resources/authors/zrips.24572/)
|
|
- Contributions: https://github.com/Zrips/Jobs/graphs/contributors
|
|
|