mirror of
https://github.com/sekwah41/Advanced-Portals.git
synced 2024-12-01 06:53:26 +01:00
105 lines
5.6 KiB
Markdown
105 lines
5.6 KiB
Markdown
|
|
|
|
[](https://discord.gg/fAJ3xJg)
|
|
[](https://github.com/sekwah41/Advanced-Portals/graphs/contributors)
|
|
[](https://github.com/sekwah41/Advanced-Portals/issues)
|
|
[](https://github.com/sekwah41/Advanced-Portals/pulls)
|
|
[](https://github.com/sekwah41/Advanced-Portals/network/members)
|
|
[](https://github.com/sekwah41/Advanced-Portals/stargazers)
|
|
[](https://github.com/sekwah41/Advanced-Portals/blob/master/LICENSE.md)
|
|
|
|
Advanced Portals
|
|
==============
|
|
An advanced portals plugin for bukkit made by sekwah41 designed to have a wide range of features which are easy to use. It adds a bunch of commands to create and edit portals and destinations. This plugin not only enable normal teleportation but also cross server teleportation for networks using bungee.
|
|
|
|
The recode is actively being worked on and should be available relatively soon.
|
|
https://github.com/sekwah41/Advanced-Portals/issues/360
|
|
|
|
# Usage
|
|
|
|
Check out the [Tutorial](https://advancedportals.sekwah.com/docs/intro), [List of Commands](https://advancedportals.sekwah.com/docs/commands), and [List of Portal Tags](https://advancedportals.sekwah.com/docs/portal-tags).
|
|
|
|
# Download
|
|
|
|
- [Bukkit](https://dev.bukkit.org/projects/advanced-portals)
|
|
- [Spigot](https://www.spigotmc.org/resources/advanced-portals.14356/)
|
|
- [Curseforge](https://www.curseforge.com/minecraft/bukkit-plugins/advanced-portals)
|
|
- [Modrinth](https://modrinth.com/plugin/advanced-portals)
|
|
- [Github](https://github.com/sekwah41/Advanced-Portals/releases)
|
|
|
|
# Recode
|
|
|
|
We are currently slowly working on a complete re-code of the plugin with a full API.
|
|
For now maintaining the current 1.13+ spigot versions is our main priority.
|
|
|
|
# Usage Data
|
|
|
|
Usage stats can be found here https://bstats.org/plugin/bukkit/AdvancedPortals
|
|
|
|
# API
|
|
|
|
The api isn't implemented in this version, sorry for any inconvenience. Check the recode tree for possibly a working recode at some point.
|
|
|
|
The re-code is based off a mix of the original version, and the original re-code that was abandoned [see here](https://github.com/sekwah41/Advanced-Portals/tree/recode/src/main/java/com/sekwah/advancedportals).
|
|
|
|
Part of this are currently a mess in terms of package organising, though any API changes will be documented in the changelog as well as the main registry classes should be relatively solid.
|
|
|
|
The goal of this rewrite is to make it easier to port to other platforms as well as add extra tags.
|
|
|
|
# Contributing
|
|
|
|
Don't worry about updating the file numbers in `bungee.yml`, `plugin.yml` and `AdvancedPortalsPlugin.java`.
|
|
They will be updated automatically before builds.
|
|
|
|
Please ensure that your commits are in the following style for PR's
|
|
|
|
https://www.conventionalcommits.org/en/v1.0.0/
|
|
|
|
Also if you could, please run `pre-commit run --files ...` or `pre-commit run --all-files` to ensure that the code is formatted correctly.
|
|
You will need to have clang-format installed for this to work.
|
|
|
|
## Types available
|
|
* **build**: Changes that affect the build system or external dependencies
|
|
* **ci**: Changes to our CI configuration files and scripts
|
|
* **docs**: Documentation only changes
|
|
* **feat**: A new feature
|
|
* **fix**: A bug fix
|
|
* **perf**: A code change that improves performance
|
|
* **refactor**: A code change that neither fixes a bug nor adds a feature
|
|
* **style**: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
|
|
<!---
|
|
We don't currently do tests. But in case.
|
|
* **test**: Adding missing tests or correcting existing tests
|
|
-->
|
|
|
|
## Scopes available
|
|
Scopes are only needed if relating to specific features just to make them easier to find.
|
|
_I'll expand the list as I work more on the project._
|
|
* **proxy** (Proxy specific features and issues)
|
|
|
|
https://www.conventionalcommits.org/en/v1.0.0/
|
|
|
|
Accepted tags mostly follow the Angular style and are meant to only loosely be followed.
|
|
When commits close an issue refer in the commit description in the following style (Refs #1, #2, #3)
|
|
## Types available
|
|
* **build**: Changes that affect the build system or external dependencies
|
|
* **ci**: Changes to our CI configuration files and scripts
|
|
* **docs**: Documentation only changes
|
|
* **feat**: A new feature
|
|
* **fix**: A bug fix
|
|
* **perf**: A code change that improves performance
|
|
* **refactor**: A code change that neither fixes a bug nor adds a feature
|
|
* **style**: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
|
|
<!---
|
|
We don't currently do tests. But in case.
|
|
* **test**: Adding missing tests or correcting existing tests
|
|
-->
|
|
|
|
## Scopes available
|
|
The scopes available should be the specific modules being worked on. E.g. core, spigot, docs
|
|
|
|
## Documentation
|
|
That is handled on the [website](https://github.com/sekwah41/Advanced-Portals/tree/website) branch.
|
|
|
|
At some point I may merge this onto this branch to try to push for documentation changes with new features, though for now this works.
|