Skip to content

Commit 9f5a313

Browse files
lewmilburnlewmilburn
authored
Merge pull request #3 from LewMC/ES-1.6.0
Es 1.6.0
2 parents 6d4a2fd + 4a79445 commit 9f5a313

8 files changed

+85
-17
lines changed

‎Writerside/LewMCWiki.tree

+3-2
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,9 @@
1515
<toc-element topic="ES-Permissions.md"/>
1616
<toc-element topic="ES-Disabling-Commands.md"/>
1717
</toc-element>
18-
<toc-element topic="ES-System-Requirements.md"/>
19-
<toc-element topic="ES-Language-Files.md"/>
18+
<toc-element topic="ES-System-Requirements.md">
19+
<toc-element topic="ES-Language-Files.md"/>
20+
</toc-element>
2021
<toc-element topic="ES-Teams.md"/>
2122
<toc-element topic="ES-Kits.md"/>
2223
<toc-element topic="ES-MOTD.md"/>

‎Writerside/images/en-gb-old.yml.png

1.06 KB
Loading

‎Writerside/images/en-gb.yml.png

1.06 KB
Loading

‎Writerside/topics/ES-Changelogs.md

+9-2
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,15 @@
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.6.0
8+
_2024-07-XX_ - Essence 1.6.0 adds a whole host of new features including Vault integration.
9+
10+
| Added | Essence can now be used as an economy provider for other plugins when [Vault](https://www.spigotmc.org/resources/vault.34315/) is installed. - Added /es reload, /msg, /reply, /rules, /seen, and /info commands. - Added Simplified Chinese (zh-CN) translation, very limited French (fr-FR) translation. |
11+
|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
12+
| Removed | Nothing was removed in this update. |
13+
| Changed | /broadcast now appears in /es help. |
14+
| Fixed | essence.* wildcard was not working correctly. - Fixed some aliases being incorrect. |
15+
716
## 1.5.3
817
_2024-06-25_ - Essence 1.5.3 changes how the /home command is handled, and provides additional quality-of-life fixes and improvements.
918

@@ -13,7 +22,6 @@ _2024-06-25_ - Essence 1.5.3 changes how the /home command is handled, and provi
1322
| Changed | /home will now list homes if there is no home named "home", instead of telling you it's missing. |
1423
| 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. |
1524

16-
1725
## 1.5.2
1826
_2024-06-20_ - Essence 1.5.2 fixes exceptions in the /team command, teleportation not working as expected, and more.
1927

@@ -23,7 +31,6 @@ _2024-06-20_ - Essence 1.5.2 fixes exceptions in the /team command, teleportatio
2331
| Changed | Teleportation can now handle more types of teleportation. |
2432
| Fixed | Exception when /team is ran by the console is now handled correctly. - Teleporting a player to a coordinate will now teleport that player instead of you. - Debug code left in accidentally has been removed. |
2533

26-
2734
## 1.5.1
2835
_2024-06-18_ - Essence 1.5.1 fixes players not respawning correctly and the /world command failing on non-vanilla generated worlds.
2936

‎Writerside/topics/ES-Commands.md

+23-3
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Commands
22

3+
> See also: [Permissions](ES-Permissions.md)
4+
35
## Main Command
46
This is the full list of commands included in the most recent version of Essence. Commands [can be disabled](ES-Disabling-Commands.md) by server administrators.
57

@@ -117,9 +119,11 @@ Wildcard permission: essence.stats.* and essence.stats.other.*
117119
## Chat Commands
118120
Wildcard permission: essence.chat.*
119121

120-
| Command | Permission Required | Description | Usage | Console can run? |
121-
|----------------------|------------------------|--------------------------------------|------------------------------------------|------------------|
122-
| /broadcast <message> | essence.chat.broadcast | Send a message to the entire server. | /broadcast This is an example broadcast. | Yes |
122+
| Command | Permission Required | Description | Usage | Console can run? |
123+
|-------------------------------|------------------------|--------------------------------------------------------|------------------------------------------|------------------|
124+
| /broadcast <message> | essence.chat.broadcast | Send a message to the entire server. | /broadcast This is an example broadcast. | Yes |
125+
| /msg <name> <message> | essence.chat.msg | Send a message to a specific user. | /msg Notch Hello there! | Yes |
126+
| /reply <message> /r <message> | essence.chat.reply | Reply to the last user who sent you a private message. | /r Hey back to you! | Yes |
123127

124128
## Economy Commands
125129
Wildcard permission: essence.economy.*
@@ -153,6 +157,22 @@ Wildcard permission: essence.team.*
153157
| /team rule <rule> <value> | essence.team.manage | Set the value of a team rule. | | No |
154158
| Team home commands | See home commands section. | | | |
155159

160+
## Administration Commands
161+
Wildcard permission: essence.admin.*
162+
163+
| Command | Permission Required | Description | Usage | Console can run? |
164+
|----------------------------|----------------------|-------------------------------------------------|--------------------------|------------------|
165+
| /seen <name> | essence.admin.seen | Displays the player's last login date and time. | /seen Notch | Yes |
166+
| /info <name> /pinfo <name> | essence.admin.info | Displays information about the player. | /info Notch /pinfo Notch | Yes |
167+
| /es reload | essence.admin.reload | Reloads Essence's configuration. | /es reload | Yes |
168+
169+
## Miscellaneous Commands
170+
Wildcard permission: None
171+
172+
| Command | Permission Required | Description | Usage | Console can run? |
173+
|----------------------------|----------------------|------------------------|--------|------------------|
174+
| /rules | essence.rules | View the server rules. | /rules | Yes |
175+
156176
<seealso>
157177
<category ref="es-commands">
158178
<a href="ES-Teams.md">Teams</a>

‎Writerside/topics/ES-Language-Files.md

+26-7
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,34 @@
1-
# Language Files
1+
# Supported Languages
22

3-
Language files are used in Essence to serve messages to players
3+
| Language | Code | Supported | Since |
4+
|----------------------|-------|--------------------------------------------------|-------|
5+
| Bengali | bn-BD | ❌ File exists but is not enabled, not translated | 1.6.0 |
6+
| British English | en-GB | ✅ Fully | 1.0.0 |
7+
| Chinese (Simplified) | zn-CN | ✅ Fully | 1.6.0 |
8+
| French | fr-FR | ⚠ Limited support | 1.6.0 |
9+
| German | de-DE | ❌ File exists but is not enabled, not translated | 1.6.0 |
10+
| Hindi | hi-IN | ❌ File exists but is not enabled, not translated | 1.6.0 |
11+
| Japanese | ja-JP | ❌ File exists but is not enabled, not translated | 1.6.0 |
12+
| Korean | ko-KR | ❌ File exists but is not enabled, not translated | 1.6.0 |
13+
| Portuguese | pt-PT | ❌ File exists but is not enabled, not translated | 1.6.0 |
14+
| Spanish | es-ES | ❌ File exists but is not enabled, not translated | 1.6.0 |
15+
| Turkish | tr-TR | ❌ File exists but is not enabled, not translated | 1.6.0 |
16+
| Vietnamese | vi-VN | ❌ File exists but is not enabled, not translated | 1.6.0 |
417

5-
These are automatically updated whenever you update your plugin.
18+
## Translate Essence
19+
We use Crowdin to provide translations for Essence, it automatically synchronises to our GitHub repository so any changes are automatically pushed with the next Essence update.
20+
21+
Translate to Crowdin: [https://crowdin.com/project/lewmc-essence](https://crowdin.com/project/lewmc-essence)
622

7-
We currently only support en-gb, you can see a [template here](https://github.com/lewmilburn/Essence/blob/main/src/main/resources/language/en-gb.yml) if you'd like to create a translation. If you have created a translation and would like to add it to Essence please open an issue on our [GitHub](https://github.com/lewmc/essence), thank you.
23+
## Language Files
824

9-
## Creating a new language file.
10-
> Essence may require restarting after changing the file it uses to grab messages, if you're editing a file that is already set as active in config, no restart is required.
25+
Language files are used in Essence to serve messages to players
26+
27+
These are automatically updated whenever you update your plugin.
1128

29+
### Creating a new Language File
30+
> Please consider translating essence to [Crowdin](https://crowdin.com/project/lewmc-essence) so that others can use the language too!
1231
1. Create a new .yml file in the /plugins/essence/languages folder. You should give it a unique name such as custom.yml
13-
2. Copy the contents of en-gb.yml to this file.
32+
2. Copy the contents of ![en-gb.yml](en-gb.yml.png) to this file.
1433
3. Customise any messages you wish to.
1534
4. Change the language option in config.yml to the name of your file without the yml ending (e.g. "custom").

‎Writerside/topics/ES-Permissions.md

+10-2
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,19 @@ Permissions are listed in the tables on the [commands page](ES-Commands.md).
66

77
## 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:
9-
essence.gamemode.*
9+
`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:
13-
essence.gamemode.survival
13+
`essence.gamemode.survival`
14+
15+
### Administrator Wildcard
16+
17+
`essence.*` provides access to all standard Essence commands, this is useful for administrators.
18+
19+
`essence.admin.*` provides access to all Essence administrator commands, this is useful for administrators.
20+
21+
Administrators who require access to _everything_ should be given both these permissions.
1422

1523
## Warp and Home Creation Limits
1624
By default, users can create as many warps and homes as they'd like. You can limit this by using permissions.

‎Writerside/topics/ES-Troubleshooting.md

+14-1
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,17 @@
44
This error can sometime occur when a non-vanilla loaded world is set as the main-world if always-spawn is also enabled.
55
We recommend setting the main-world to a vanilla loaded world (the world set in server.properties) if you also use always-spawn.
66

7-
If this is not causing the issue please [open an issue](https://github.com/lewmc/essence/issues).
7+
If this is not causing the issue please [open an issue](https://github.com/lewmc/essence/issues).
8+
9+
## Unable to send message to player.
10+
11+
### 1.6.0 and above.
12+
Please check your plugins/Essence/language folder. If it contains "![Old en-gb.yml](en-gb-old.yml.png)", please delete this file and restart your server.
13+
14+
The English language file should be "![en-gb.yml](en-gb.yml.png)", it appears that your server was unable to migrate the file to the new format correctly which may be causing your issue.
15+
16+
If this is not causing the issue please [open an issue](https://github.com/lewmc/essence/issues).
17+
18+
### Pre-1.6.0
19+
Please delete your en-gb.yml file and restart your server.
20+
Please note that earlier versions are no longer supported for bug-fixes, and we recommend updating Essence.

0 commit comments

Comments
 (0)