Skip to content

Commit e5e6ae3

Browse files
authored
Merge pull request #2 from LewMC/ES-1.5.3
Es 1.5.3
2 parents b16c229 + 2bcfc2b commit e5e6ae3

File tree

7 files changed

+66
-44
lines changed

7 files changed

+66
-44
lines changed

Writerside/topics/ES-Changelogs.md

+10
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,16 @@
44
<strong>You should always run the latest version of all software!</strong> That includes Essence! Updating keeps your server free from bugs, exploits, and other potential issues. When you see the message - update!
55
</warning>
66

7+
## 1.5.3
8+
_2024-06-25_ - Essence 1.5.3 changes how the /home command is handled, and provides additional quality-of-life fixes and improvements.
9+
10+
| Added | You can now limit the number of homes and warps a player can create by using permissions. [Learn more](ES-Permissions.md#warp-and-home-creation-limits). |
11+
|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
12+
| Removed | Nothing was removed in this update. |
13+
| Changed | /home will now list homes if there is no home named "home", instead of telling you it's missing. |
14+
| Fixed | /homes, /warps, and /thomes will now tell you if there's no homes set instead of displaying a blank list when homes/warps have been created in the past. - Fixes a bug where players would be occasionally teleported into the ground when they died. |
15+
16+
717
## 1.5.2
818
_2024-06-20_ - Essence 1.5.2 fixes exceptions in the /team command, teleportation not working as expected, and more.
919

Writerside/topics/ES-Commands.md

+20-14
Original file line numberDiff line numberDiff line change
@@ -49,26 +49,28 @@ Wildcard permission: essence.kits.*
4949
Wildcard permission: essence.teleport.*
5050

5151
<warning>
52-
<strong>/tpr was temporarily removed in Essence 1.4.0 due to platform and technical limitations.</strong> We're working on bringing this feature back.
52+
<strong>/tpr is unavailable on Folia-based servers.</strong> We're working on bringing this feature back. <a href="https://github.com/LewMC/Essence/issues/63">Learn more</a>.
5353
</warning>
5454

55-
| Command | Permission Required | Description | Usage | Console can run? |
56-
|---------------------------------------|-------------------------------------------------------|---------------------------------------------------------|------------------|------------------|
57-
| /teleport <x> <y> <z> /tp <x> <y> <z> | essence.teleport.coord | Teleport to a coordinate location in the world (x,y,z). | /tp 0 64 0 | No |
58-
| /teleport <name> /tp <name> | essence.teleport.player | Teleport to another player. | /tp Notch | No |
59-
| /tp <user> <x> <y> <z> | essence.teleport.coord **and** essence.teleport.other | Teleport another player to set coordinates | /tp Notch 0 64 0 | Yes |
60-
| /tpa <user> | essence.teleport.request.send | Sends a teleportation request to a user. | /tpa Notch | No |
61-
| /tpahere <user> | essence.teleport.request.here | Request a user to teleport to you. | /tpahere Notch | No |
62-
| /tpaccept | essence.teleport.request.accept | Accept a teleport request. | /tpaccept | No |
63-
| /tpdeny | essence.teleport.request.deny | Deny a teleport request. | /tpdeny | No |
64-
| /tpcancel | essence.teleport.request.cancel | Cancel a teleport request that you've sent. | /tpcancel | No |
65-
| /tptoggle | essence.teleport.request.toggle | Toggle if players can send you teleportation requests. | /tptoggle | No |
66-
| /tpr /rtp | essence.teleport.random | Teleport to a random location in the world. | /tpr /rtp | No |
67-
| /back | essence.teleport.back | Go back to your last location before teleporting. | /back | No |
55+
| Command | Permission Required | Description | Usage | Console can run? |
56+
|---------------------------------------|-------------------------------------------------------|---------------------------------------------------------|---------------------|------------------|
57+
| /teleport <x> <y> <z> /tp <x> <y> <z> | essence.teleport.coord | Teleport to a coordinate location in the world (x,y,z). | /tp 0 64 0 | No |
58+
| /teleport <name> /tp <name> | essence.teleport.player | Teleport to another player. | /tp Notch | No |
59+
| /tp <user> <x> <y> <z> | essence.teleport.coord **and** essence.teleport.other | Teleport another player to set coordinates | /tp Notch 0 64 0 | Yes |
60+
| /tpa <user> | essence.teleport.request.send | Sends a teleportation request to a user. | /tpa Notch | No |
61+
| /tpahere <user> | essence.teleport.request.here | Request a user to teleport to you. | /tpahere Notch | No |
62+
| /tpaccept | essence.teleport.request.accept | Accept a teleport request. | /tpaccept | No |
63+
| /tpdeny | essence.teleport.request.deny | Deny a teleport request. | /tpdeny | No |
64+
| /tpcancel | essence.teleport.request.cancel | Cancel a teleport request that you've sent. | /tpcancel | No |
65+
| /tptoggle | essence.teleport.request.toggle | Toggle if players can send you teleportation requests. | /tptoggle | No |
66+
| /tpr /rtp /tprandom | essence.teleport.random | Teleport to a random location in the world. | /tpr /rtp /tprandom | No |
67+
| /back | essence.teleport.back | Go back to your last location before teleporting. | /back | No |
6868

6969
### Warp Commands
7070
Wildcard permission: essence.warp.*
7171

72+
You can limit the number of warps a user can create by using `essence.warp.limit.X` - [Learn more](ES-Permissions.md#warp-and-home-creation-limits).
73+
7274
| Command | Permission Required | Description | Usage | Console can run? |
7375
|-----------------|---------------------|---------------------------|------------------|------------------|
7476
| /warp | essence.warp.list | Get a list of warps | /warp | No |
@@ -79,6 +81,8 @@ Wildcard permission: essence.warp.*
7981
### Home Commands
8082
Wildcard permission: essence.home.*
8183

84+
You can limit the number of homes a user can create by using `essence.home.limit.X` or `essence.home.team.limit.X` - [Learn more](ES-Permissions.md#warp-and-home-creation-limits).
85+
8286
| Command | Permission Required | Description | Usage | Console can run? |
8387
|------------------|--------------------------|--------------------------|------------------|------------------|
8488
| /homes | essence.home.list | Get a list of homes | /homes | No |
@@ -120,6 +124,8 @@ Wildcard permission: essence.chat.*
120124
## Economy Commands
121125
Wildcard permission: essence.economy.*
122126

127+
> You must have [Vault](https://dev.bukkit.org/projects/vault) installed for these commands to function.
128+
123129
| Command | Permission Required | Description | Usage | Console can run? |
124130
|----------------------|-------------------------|---------------------|----------------|------------------|
125131
| /pay <user> <amount> | essence.economy.pay | Pay another player. | /pay Notch 10 | No |

Writerside/topics/ES-Permissions.md

+22-1
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,35 @@ You need to give your players permission to access certain commands. By default,
44

55
Permissions are listed in the tables on the [commands page](ES-Commands.md).
66

7-
### Wildcards vs Granular
7+
## Wildcards vs Granular
88
Essence uses Wildcard permissions for some commands. The wildcard permission can be used if you'd like to give users access to all commands in that section, it makes writing permissions a whole lot faster! Wildcard permissions are shows at the top of each section. They look like this:
99
essence.gamemode.*
1010
If you use wildcard permissions, you don't need to give players other permissions from that section. For example if you use essence.gamemode.* you don't need to also use essence.gamemode.survival as that permission is included in the wildcard.
1111

1212
Alternatively, you can use granular permissions if there are only certain commands in a section you'd like players to be able to use. They look like this:
1313
essence.gamemode.survival
1414

15+
## Warp and Home Creation Limits
16+
By default, users can create as many warps and homes as they'd like. You can limit this by using permissions.
17+
18+
<warning>
19+
If a user already has more homes than the limit before you apply it, this won't delete existing homes, it will just prevent the user from creating more.
20+
</warning>
21+
22+
23+
Using this feature, you can define the number of homes a user can create by using a permissions plugin. This allows different ranks to have a different number of homes.
24+
25+
### Warps
26+
By giving a user the permission `essence.warp.limit.1`, it will limit the user to creating only 1 warp. You can change the number to what you'd like to set the limit to.
27+
28+
### Homes
29+
By giving a user the permission `essence.home.limit.1`, it will limit the user to creating only 1 home. You can change the number to what you'd like to set the limit to.
30+
31+
### Team Homes
32+
By giving a user the permission `essence.home.team.limit.1`, it will limit the user to creating only 1 team home. You can change the number to what you'd like to set the limit to.
33+
34+
A user must already be a member of a team to create team homes, and team homes must be enabled in the team's rules. [Learn more](ES-Teams.md).
35+
1536
<seealso>
1637
<category ref="es-commands">
1738
<a href="ES-Commands.md">Commands</a>

Writerside/topics/ES-System-Requirements.md

+2
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@
44
Some commands do not work on Folia-based servers, please see the section at the bottom of this page for more information.
55
</warning>
66

7+
> You must have [Vault](https://dev.bukkit.org/projects/vault) installed for Economy commands to function..
8+
79
| Essence Version | Minecraft Versions | Supported Software | Java Version | Active Support |
810
|-----------------|--------------------|---------------------------------------------------------------|--------------|----------------|
911
| 1.4.0+ | > 1.20.4 | CraftBukkit, Spigot, Paper, Folia, or a fork of these | 17 | Yes |

Writerside/topics/Essence.md

+4-10
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,6 @@
55
Essence is a lightweight and customisable plugin that adds warps, homes, and more.
66

77
## Download Essence
8-
9-
### Release Version
108
We recommend using **Modrinth or LewMC** to download our plugins, ads on the website are unintrusive and help us to keep maintaining the project.
119

1210
* LewMC: [https://lewmc.net/plugin/essence](https://lewmc.net/plugin/essence)
@@ -15,13 +13,9 @@ We recommend using **Modrinth or LewMC** to download our plugins, ads on the web
1513
* Spigot: [https://www.spigotmc.org/resources/essence.114553/](https://www.spigotmc.org/resources/essence.114553/)
1614
* Hangar: [https://hangar.papermc.io/LewMC/Essence](https://hangar.papermc.io/LewMC/Essence)
1715

18-
### Snapshot Version
19-
You can get the snapshot version from our GitHub: [https://github.com/lewmilburn/essence](https://github.com/lewmilburn/essence)
20-
21-
You'll need to compile this version yourself, you'll need to have maven installed.
16+
### Snapshot Builds
17+
Snapshot Builds are unstable, pre-release versions of Essence built as soon as changes are pushed to our version control software.
2218

23-
* Navigate to the essence directory in a terminal program.
24-
* Run <code>mvn package</code>
25-
* The jarfile will be created in the targets directory, you need to use Essence-[version].jar
19+
You should not use these versions in production environments, and you should backup your sever before using them.
2620

27-
If you have any issues with this please message Lew on [Discord](https://lewmc.net/discord), you may be able to request a precompiled jar to be sent to you if there's one available for this build. We tend to not publish snapshot versions as they tend to be unstable and are subject to change.
21+
[Download Snapshot Builds](https://github.com/LewMC/Essence/actions/workflows/maven.yml)

Writerside/topics/Jailhouse.md

+4-10
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,6 @@
44
Jailhouse is a free and easy to use Minecraft banning system. Jailhouse is currently in-development and is not available to download.
55

66
## Download Jailhouse
7-
8-
### Release Version
97
We recommend using **Modrinth or LewMC** to download our plugins, ads on the website are unintrusive and help us to keep maintaining the project.
108

119
* LewMC: _Not released on this platform._
@@ -14,13 +12,9 @@ We recommend using **Modrinth or LewMC** to download our plugins, ads on the web
1412
* Spigot: _Not released on this platform._
1513
* Hangar: _Not released on this platform._
1614

17-
### Snapshot Version
18-
You can get the snapshot version from our GitHub: [https://github.com/lewmilburn/jailhouse](https://github.com/lewmilburn/jailhouse)
19-
20-
You'll need to compile this version yourself, you'll need to have maven installed.
15+
### Snapshot Builds
16+
Snapshot Builds are unstable, pre-release versions of Jailhouse built as soon as changes are pushed to our version control software.
2117

22-
* Navigate to the essence directory in a terminal program.
23-
* Run <code>mvn package</code>
24-
* The jarfile will be created in the targets directory, you need to use Essence-[version].jar
18+
You should not use these versions in production environments, and you should backup your sever before using them.
2519

26-
If you have any issues with this please message Lew on [Discord](https://lewmc.net/discord), you may be able to request a precompiled jar to be sent to you if there's one available for this build. We tend to not publish snapshot versions as they tend to be unstable and are subject to change.
20+
[Download Snapshot Builds](https://github.com/LewMC/Jailhouse/actions/workflows/maven.yml)

Writerside/topics/Kryptonite.md

+4-9
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@
44
Kryptonite is a Minecraft server optimisation and exploit patching assistant.
55

66
## Download Kryptonite
7-
### Release Version
87
We recommend using **Modrinth or LewMC** to download our plugins, ads on the website are unintrusive and help us to keep maintaining the project.
98

109
* LewMC: [https://lewmc.net/plugin/kryptonite](https://lewmc.net/plugin/kryptonite)
@@ -13,13 +12,9 @@ We recommend using **Modrinth or LewMC** to download our plugins, ads on the web
1312
* Spigot: [https://www.spigotmc.org/resources/kryptonite-the-lag-killing-plugin.116844/](https://www.spigotmc.org/resources/kryptonite-the-lag-killing-plugin.116844/)
1413
* Hangar: [https://hangar.papermc.io/LewMC/Kryptonite](https://hangar.papermc.io/LewMC/Kryptonite)
1514

16-
### Snapshot Version
17-
You can get the snapshot version from our GitHub: [https://github.com/lewmilburn/kryptonite](https://github.com/lewmilburn/kryptonite)
15+
### Snapshot Builds
16+
Snapshot Builds are unstable, pre-release versions of Kryptonite built as soon as changes are pushed to our version control software.
1817

19-
You'll need to compile this version yourself, you'll need to have maven installed.
18+
You should not use these versions in production environments, and you should backup your sever before using them.
2019

21-
* Navigate to the essence directory in a terminal program.
22-
* Run <code>mvn package</code>
23-
* The jarfile will be created in the targets directory, you need to use Kryptonite-[version].jar
24-
25-
If you have any issues with this please message Lew on [Discord](https://lewmc.net/discord), you may be able to request a precompiled jar to be sent to you if there's one available for this build. We tend to not publish snapshot versions as they tend to be unstable and are subject to change.
20+
[Download Snapshot Builds](https://github.com/LewMC/Kryptonite/actions/workflows/maven.yml)

0 commit comments

Comments
 (0)