Compare commits
487 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
08c14f4def | ||
|
|
0fa6f972c0 | ||
|
|
8837fecfa0 | ||
|
|
af1841770e | ||
|
|
1d85dbf08d | ||
|
|
ba9812534a | ||
|
|
1f95a33385 | ||
|
|
bc652a8154 | ||
|
|
0c2e1f0cae | ||
|
|
39d6eb7f9a | ||
|
|
61bae6de55 | ||
|
|
aa4ac4c6d1 | ||
|
|
7141b12e95 | ||
|
|
2382548629 | ||
|
|
0c4bd182f7 | ||
|
|
e90e053b45 | ||
|
|
742c1abb00 | ||
|
|
c0686ca386 | ||
|
|
db2ea7daa9 | ||
|
|
ed4f0b2ab6 | ||
|
|
6decc68d1b | ||
|
|
1e061313a4 | ||
|
|
4762004e94 | ||
|
|
0d9889ef43 | ||
|
|
b2a23e80a1 | ||
|
|
0e439db7b3 | ||
|
|
f615006b23 | ||
|
|
d952dbc61b | ||
|
|
d95a96f4c6 | ||
|
|
33940f5778 | ||
|
|
173d04595f | ||
|
|
c7c4ca3777 | ||
|
|
cbf7316db9 | ||
|
|
601cadd582 | ||
|
|
877647db03 | ||
|
|
81196bb132 | ||
|
|
ef701f1f86 | ||
|
|
58d8f72cf5 | ||
|
|
3abf916f18 | ||
|
|
b459a746e3 | ||
|
|
30c37078a2 | ||
|
|
36ccfb5fc6 | ||
|
|
c84f1a060a | ||
|
|
d8d5609f6b | ||
|
|
462abd46c6 | ||
|
|
e89008cf97 | ||
|
|
d34e43797d | ||
|
|
63ee83c795 | ||
|
|
2eec17698e | ||
|
|
ad52c2a086 | ||
|
|
6e482cccda | ||
|
|
899b4297f7 | ||
|
|
ceb95e20b5 | ||
|
|
bdfeb9a0ab | ||
|
|
e0707e2afa | ||
|
|
e8048f5a0a | ||
|
|
a36018e31a | ||
|
|
a34c63161d | ||
|
|
2eb350977c | ||
|
|
8a89a63c5f | ||
|
|
5c26e6e782 | ||
|
|
f88b914fa6 | ||
|
|
15ff6b3ea3 | ||
|
|
b14eed696c | ||
|
|
cffae33c87 | ||
|
|
adf6d1c800 | ||
|
|
2b7c8962e7 | ||
|
|
b60cbfce2c | ||
|
|
910ad18703 | ||
|
|
8a4a71ebc1 | ||
|
|
2e748b1723 | ||
|
|
cb28726bc3 | ||
|
|
c0c20d63bb | ||
|
|
3b11610c45 | ||
|
|
232048022e | ||
|
|
9abfe0ab01 | ||
|
|
e7ac05278c | ||
|
|
85ba40c279 | ||
|
|
1acf86492e | ||
|
|
4609d38389 | ||
|
|
2d6836cc93 | ||
|
|
8e21617345 | ||
|
|
2f99a17d02 | ||
|
|
34edf1d7b4 | ||
|
|
be85ba5706 | ||
|
|
b817b00ca4 | ||
|
|
ee02528abc | ||
|
|
794948c8f9 | ||
|
|
7c70dec2e7 | ||
|
|
d1f20b7111 | ||
|
|
595751a094 | ||
|
|
8231afdcbf | ||
|
|
4f55d66096 | ||
|
|
d350febbdc | ||
|
|
78755b0e9a | ||
|
|
63d7bdab6b | ||
|
|
344032b7e3 | ||
|
|
3ae5c8a72c | ||
|
|
e4f2bc2e39 | ||
|
|
90ba0a0391 | ||
|
|
801a3cd4f9 | ||
|
|
ce9cada75a | ||
|
|
ae551dd0f7 | ||
|
|
1b3dd53fb8 | ||
|
|
dda4224e6e | ||
|
|
6e14265655 | ||
|
|
77fd99d215 | ||
|
|
cf05efc2ff | ||
|
|
0e8c759a4c | ||
|
|
ba7bfb828b | ||
|
|
8dd1239b99 | ||
|
|
edada09966 | ||
|
|
19c300bbf3 | ||
|
|
4fc9c21034 | ||
|
|
2366dcd293 | ||
|
|
054e6a53c0 | ||
|
|
46f590fe3e | ||
|
|
b46aaf547f | ||
|
|
0f7125e1c8 | ||
|
|
6cb99819f3 | ||
|
|
a018a1fca5 | ||
|
|
8a7b8f2b03 | ||
|
|
abf3dc1e9e | ||
|
|
e92cc41be6 | ||
|
|
49570c841b | ||
|
|
9aa465844d | ||
|
|
a692fbee01 | ||
|
|
4223e8f17a | ||
|
|
5f26b23a53 | ||
|
|
c8c179981c | ||
|
|
4bb8bb62f9 | ||
|
|
c1b3bec67c | ||
|
|
f2535ce75c | ||
|
|
049d64821e | ||
|
|
bf5766e61c | ||
|
|
38da5fe6d1 | ||
|
|
e16649873b | ||
|
|
a3b0b4f847 | ||
|
|
d9f1ddd188 | ||
|
|
14a4d9291b | ||
|
|
6630044546 | ||
|
|
1043981fe4 | ||
|
|
fb0b7c52cf | ||
|
|
74e5464f7d | ||
|
|
2ad1ff4cdb | ||
|
|
2d47c18be6 | ||
|
|
69e67be436 | ||
|
|
c144723d5b | ||
|
|
108375f545 | ||
|
|
83d5b3e96e | ||
|
|
37e09a470e | ||
|
|
1f064110b7 | ||
|
|
94a0b4de5d | ||
|
|
8a68666f86 | ||
|
|
2c218d1088 | ||
|
|
3fa95d82a6 | ||
|
|
9648b42c4d | ||
|
|
66887f0a3a | ||
|
|
410cdfe7e3 | ||
|
|
bbffdc7e23 | ||
|
|
0d267e2bec | ||
|
|
578256f89b | ||
|
|
90ecbfce00 | ||
|
|
9945704338 | ||
|
|
5c7a7876d8 | ||
|
|
94df0e67a6 | ||
|
|
92c4e62709 | ||
|
|
e094a1e934 | ||
|
|
26c07a20e7 | ||
|
|
ad68e1efef | ||
|
|
d8c3a3befa | ||
|
|
aa52dcdf94 | ||
|
|
9d3ba7ea88 | ||
|
|
e2b417af74 | ||
|
|
77394d3038 | ||
|
|
fcc7f82b38 | ||
|
|
396f4dac44 | ||
|
|
3341093735 | ||
|
|
714d04e48f | ||
|
|
73b7ccea3a | ||
|
|
606bf8fcd2 | ||
|
|
fbbf893d64 | ||
|
|
36001373eb | ||
|
|
9ac34288eb | ||
|
|
6345d1fe92 | ||
|
|
a7fa0ecf26 | ||
|
|
a65f16cfac | ||
|
|
49965c091b | ||
|
|
f9bc2aba99 | ||
|
|
5627582bd5 | ||
|
|
ab8065d06e | ||
|
|
444764e481 | ||
|
|
c240e94a6b | ||
|
|
9da28a1dff | ||
|
|
cf3c1f8394 | ||
|
|
f98befbdce | ||
|
|
d0d8ea07e4 | ||
|
|
109347a601 | ||
|
|
43bef762bf | ||
|
|
69a2e0e247 | ||
|
|
874a9b4f32 | ||
|
|
5690221c27 | ||
|
|
f19b143804 | ||
|
|
10a313bef5 | ||
|
|
9ae40ae09e | ||
|
|
7b4e1d8d24 | ||
|
|
7035280731 | ||
|
|
a1e3d53cd2 | ||
|
|
d7885f05c3 | ||
|
|
415c425097 | ||
|
|
cb4d992e7d | ||
|
|
cb64d088d1 | ||
|
|
bbbf19c041 | ||
|
|
61ace5c8e5 | ||
|
|
94b73ef35c | ||
|
|
5cfc2068e7 | ||
|
|
0ce7d1dd6c | ||
|
|
19eefaf879 | ||
|
|
1ebf7fb875 | ||
|
|
e8afd15d80 | ||
|
|
d024c9238e | ||
|
|
1356bd1f26 | ||
|
|
407ccca5e0 | ||
|
|
82de602d47 | ||
|
|
b0873112af | ||
|
|
3a0b81b7de | ||
|
|
5142b9ce92 | ||
|
|
9403a1cbcb | ||
|
|
e4ebea354d | ||
|
|
d32b31f1e5 | ||
|
|
384657f1dc | ||
|
|
7c9d226bc3 | ||
|
|
031401bb8e | ||
|
|
1a5c429b67 | ||
|
|
d028cf5bf3 | ||
|
|
fdd1581ce3 | ||
|
|
3d07e10543 | ||
|
|
c851e35347 | ||
|
|
4cbb33b1fd | ||
|
|
2ff1458772 | ||
|
|
e71ad9f034 | ||
|
|
196a651ab3 | ||
|
|
253a8c24ad | ||
|
|
ac265d0260 | ||
|
|
ad861b10bb | ||
|
|
db5b7f89f6 | ||
|
|
2c33ce25c0 | ||
|
|
9c3ca429c9 | ||
|
|
70e294501a | ||
|
|
65a0a0ecc7 | ||
|
|
d4431e7569 | ||
|
|
a6191b0870 | ||
|
|
5eecef83ee | ||
|
|
82a02f3738 | ||
|
|
804142799b | ||
|
|
e1de9b9ab3 | ||
|
|
cc56343041 | ||
|
|
69d28e8bc2 | ||
|
|
6878a74724 | ||
|
|
ebc76bba76 | ||
|
|
378218b7da | ||
|
|
e053514b94 | ||
|
|
341a30e6da | ||
|
|
70eb6d4420 | ||
|
|
aa368909ae | ||
|
|
606a54bcf8 | ||
|
|
7f8fb3d87b | ||
|
|
e97d454ff6 | ||
|
|
109b9aa3f3 | ||
|
|
4a90385b27 | ||
|
|
0edd50832c | ||
|
|
46415268b7 | ||
|
|
b652dbad2d | ||
|
|
50550d077a | ||
|
|
60c3b58a33 | ||
|
|
7216d0b09f | ||
|
|
97eeea8d48 | ||
|
|
82061ee6a3 | ||
|
|
f274b9045e | ||
|
|
2241a5c90f | ||
|
|
bbc38ae801 | ||
|
|
e77346ed62 | ||
|
|
6117abca56 | ||
|
|
2e2a061ebe | ||
|
|
cdc89ac397 | ||
|
|
e758cebe77 | ||
|
|
a408e3436a | ||
|
|
3df977c1bc | ||
|
|
136f1841b4 | ||
|
|
1086a59a6a | ||
|
|
d9147f9918 | ||
|
|
d144df4048 | ||
|
|
061f77e911 | ||
|
|
5cebe2fce8 | ||
|
|
1e712dcae6 | ||
|
|
09d444da58 | ||
|
|
09f45c0ab5 | ||
|
|
f64d69f084 | ||
|
|
86a948738f | ||
|
|
8f9c5e7ed8 | ||
|
|
ae897b7493 | ||
|
|
f1a7c9d50e | ||
|
|
83ee8fe4cd | ||
|
|
465f885e22 | ||
|
|
d4141735a9 | ||
|
|
b9b4ce1937 | ||
|
|
56234e6c83 | ||
|
|
2dda34097e | ||
|
|
155a349569 | ||
|
|
ce231934a3 | ||
|
|
5cbb7bfe47 | ||
|
|
06e0ec0295 | ||
|
|
02ed583674 | ||
|
|
8e4cbdd1aa | ||
|
|
8828f8e45d | ||
|
|
d15524ee9e | ||
|
|
d45e66d71e | ||
|
|
6b1dde7540 | ||
|
|
abf2964c48 | ||
|
|
db51c4c761 | ||
|
|
cbb574acec | ||
|
|
93c044ef09 | ||
|
|
1cc39fe40a | ||
|
|
edfd561fcd | ||
|
|
bd7f22cb02 | ||
|
|
3233bad307 | ||
|
|
3cefcbe0bb | ||
|
|
49bce53724 | ||
|
|
2b86159b30 | ||
|
|
d028511a48 | ||
|
|
5ad1ef33b8 | ||
|
|
634d6194d6 | ||
|
|
7f7eb4f45a | ||
|
|
bd90ae996b | ||
|
|
1bc57dec08 | ||
|
|
ce44d40f0f | ||
|
|
68824fb4d0 | ||
|
|
fd96b0d2cf | ||
|
|
2669569e81 | ||
|
|
067f740bcc | ||
|
|
2ce96ab0b1 | ||
|
|
027f9be194 | ||
|
|
a09018d1f0 | ||
|
|
a1da83173d | ||
|
|
8ac30283f8 | ||
|
|
6099b5d64d | ||
|
|
19d2e0788b | ||
|
|
1b223b3736 | ||
|
|
d6d1f01704 | ||
|
|
51231939c0 | ||
|
|
72fb20ecd9 | ||
|
|
58a386922c | ||
|
|
12824c7f6c | ||
|
|
b5236b8db6 | ||
|
|
3ffbb861d1 | ||
|
|
f8fad15f0b | ||
|
|
a0e96fca35 | ||
|
|
6cf9a53a65 | ||
|
|
a4909453d7 | ||
|
|
a10666f792 | ||
|
|
a845cda9ed | ||
|
|
ed5f1ccb5e | ||
|
|
c6e59e1d62 | ||
|
|
ed24b6278e | ||
|
|
3aea7b4077 | ||
|
|
f53c29cd56 | ||
|
|
6845152a09 | ||
|
|
7eaf2dc8ed | ||
|
|
310485402f | ||
|
|
727dc25083 | ||
|
|
364f36d502 | ||
|
|
b6086bc4bd | ||
|
|
dd3beaa548 | ||
|
|
c36c0c247f | ||
|
|
6611a0f82c | ||
|
|
625b981b81 | ||
|
|
d8607917a1 | ||
|
|
30d5f54459 | ||
|
|
a59c05174f | ||
|
|
cf01abcf87 | ||
|
|
70a4a06d4f | ||
|
|
bbee18fd8a | ||
|
|
26ab9a327d | ||
|
|
0676f5fa33 | ||
|
|
051b95ad88 | ||
|
|
d786014cbc | ||
|
|
b62bb48bb6 | ||
|
|
b238a10209 | ||
|
|
251049f1f1 | ||
|
|
16d146dba0 | ||
|
|
214308da10 | ||
|
|
2c12f78aa6 | ||
|
|
800e83d24b | ||
|
|
0a1ee0679c | ||
|
|
898230040a | ||
|
|
6f01577165 | ||
|
|
1c8c95f292 | ||
|
|
8cda5be2f0 | ||
|
|
850bf5d642 | ||
|
|
af197db70a | ||
|
|
c11fedff4e | ||
|
|
4001af9b8c | ||
|
|
69a8acf39a | ||
|
|
7247b95cbe | ||
|
|
4b5657de91 | ||
|
|
11ab52be94 | ||
|
|
d47757cca4 | ||
|
|
411753859c | ||
|
|
bb188e5812 | ||
|
|
a1a477e7df | ||
|
|
3144c3a954 | ||
|
|
75412b98a4 | ||
|
|
3f7f1946dc | ||
|
|
d40fa7983d | ||
|
|
c7a7a8c48a | ||
|
|
cfd5cc4be2 | ||
|
|
c1e36eb2bc | ||
|
|
d6d6da520a | ||
|
|
b2fd23b13a | ||
|
|
d6e4346e4f | ||
|
|
b4e5735c51 | ||
|
|
ba8f861901 | ||
|
|
a40415a76f | ||
|
|
d85a7a4503 | ||
|
|
cab3cb9a9f | ||
|
|
9fb106c4de | ||
|
|
cce8e46634 | ||
|
|
bb595e340c | ||
|
|
b40c3a41c2 | ||
|
|
226ad14ede | ||
|
|
eadbb489a7 | ||
|
|
fb900a18ad | ||
|
|
395a5e1745 | ||
|
|
eeffa33918 | ||
|
|
617a91c41c | ||
|
|
fbfe11d275 | ||
|
|
a4e31ff5ca | ||
|
|
bf85785451 | ||
|
|
d830672795 | ||
|
|
255bb4b38e | ||
|
|
d73c665d20 | ||
|
|
39b95c7a34 | ||
|
|
bbcbc7f88b | ||
|
|
4787d0f389 | ||
|
|
641d479c6d | ||
|
|
a521a9c93a | ||
|
|
51f690c9cb | ||
|
|
a451732c1e | ||
|
|
d6d0e4d3b3 | ||
|
|
e6bdf192ed | ||
|
|
eccd4b4a6f | ||
|
|
8650e9bb2a | ||
|
|
8e5392084d | ||
|
|
5c39a557f2 | ||
|
|
75d13fafc1 | ||
|
|
c674518eb8 | ||
|
|
23e18cd0dd | ||
|
|
2644495bca | ||
|
|
130094a16e | ||
|
|
6c4bb2e6e8 | ||
|
|
c56d5d38c3 | ||
|
|
f0d44ccf02 | ||
|
|
83f9c27238 | ||
|
|
083f643ce2 | ||
|
|
76e808b8b1 | ||
|
|
beca53ca6a | ||
|
|
028c7c76da | ||
|
|
0e02e8f6db | ||
|
|
94984d993b | ||
|
|
741208d20c | ||
|
|
b92c55d3e7 | ||
|
|
b60fc49fd5 | ||
|
|
9fc5b78fa0 | ||
|
|
91ba7cc475 | ||
|
|
45fc05ca49 | ||
|
|
610081dab4 | ||
|
|
22c62e45be | ||
|
|
119b5742fb | ||
|
|
c143006c4b | ||
|
|
f88c9b7d42 | ||
|
|
775c562705 | ||
|
|
9b443f25cc | ||
|
|
ddeaa5c79c | ||
|
|
78093531f7 | ||
|
|
5ec293e9c9 | ||
|
|
d846f348ac | ||
|
|
30ce422349 |
11
.github/dependabot.yml
vendored
Normal file
11
.github/dependabot.yml
vendored
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
# To get started with Dependabot version updates, you'll need to specify which
|
||||||
|
# package ecosystems to update and where the package manifests are located.
|
||||||
|
# Please see the documentation for all configuration options:
|
||||||
|
# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
|
||||||
|
|
||||||
|
version: 2
|
||||||
|
updates:
|
||||||
|
- package-ecosystem: "gradle" # See documentation for possible values
|
||||||
|
directory: "/" # Location of package manifests
|
||||||
|
schedule:
|
||||||
|
interval: "daily"
|
||||||
38
.github/workflows/publish-release.yml
vendored
Normal file
38
.github/workflows/publish-release.yml
vendored
Normal file
@@ -0,0 +1,38 @@
|
|||||||
|
name: Publish release
|
||||||
|
|
||||||
|
on:
|
||||||
|
release:
|
||||||
|
types: [published]
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
publish-release:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- name: Checkout latest code
|
||||||
|
uses: actions/checkout@v2
|
||||||
|
|
||||||
|
- name: Set up JDK 16
|
||||||
|
uses: actions/setup-java@v2
|
||||||
|
with:
|
||||||
|
distribution: 'adopt'
|
||||||
|
java-version: 16
|
||||||
|
|
||||||
|
- name: Setup build cache
|
||||||
|
uses: actions/cache@v2.1.6
|
||||||
|
with:
|
||||||
|
path: ~/.gradle/caches
|
||||||
|
key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle.kts') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-gradle-
|
||||||
|
- name: Publish artifact
|
||||||
|
env:
|
||||||
|
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
|
||||||
|
# The GITHUB_REF tag comes in the format 'refs/tags/xxx'.
|
||||||
|
# So if we split on '/' and take the 3rd value, we can get the release name.
|
||||||
|
run: |
|
||||||
|
NEW_VERSION=$(echo "${GITHUB_REF}" | cut -d "/" -f3)
|
||||||
|
echo "New version: ${NEW_VERSION}"
|
||||||
|
echo "Github username: ${GITHUB_ACTOR}"
|
||||||
|
./gradlew -Pversion=${NEW_VERSION} publish
|
||||||
1
.gitignore
vendored
1
.gitignore
vendored
@@ -14,6 +14,7 @@ bin/
|
|||||||
# Gradle
|
# Gradle
|
||||||
.gradle
|
.gradle
|
||||||
**/build/
|
**/build/
|
||||||
|
**/out/
|
||||||
!eco-api/src/**/build/
|
!eco-api/src/**/build/
|
||||||
.gradletasknamecache
|
.gradletasknamecache
|
||||||
!gradle-wrapper.jar
|
!gradle-wrapper.jar
|
||||||
|
|||||||
@@ -6,7 +6,7 @@
|
|||||||
- Every method and field must have a javadoc attached.
|
- Every method and field must have a javadoc attached.
|
||||||
|
|
||||||
2. Use lombok wherever possible.
|
2. Use lombok wherever possible.
|
||||||
- @Getter, @Setter, @ToString, @EqualsAndHashCode, @UtilityClass are the most important.
|
- @Getter, @Setter, @UtilityClass only.
|
||||||
|
|
||||||
3. Use JetBrains annotations
|
3. Use JetBrains annotations
|
||||||
- Every parameter should be annotated with @NotNull or @Nullable
|
- Every parameter should be annotated with @NotNull or @Nullable
|
||||||
@@ -24,4 +24,4 @@
|
|||||||
|
|
||||||
## Other
|
## Other
|
||||||
- All drops **must** be sent through a DropQueue - calls to World#dropItem will get your PR rejected.
|
- All drops **must** be sent through a DropQueue - calls to World#dropItem will get your PR rejected.
|
||||||
- eco is built with java 8. Usage of J9+ will get your PR rejected.
|
- eco is built with java 16.
|
||||||
169
README.md
169
README.md
@@ -1 +1,168 @@
|
|||||||
## eco - Library for spigot plugin development.
|
<h1 align="center">
|
||||||
|
<br>
|
||||||
|
<img src="https://i.imgur.com/kU3ejCt.png" alt="eco logo" width="256">
|
||||||
|
<br>
|
||||||
|
</h1>
|
||||||
|
|
||||||
|
<h4 align="center">eco - Simplify spigot development.</h4>
|
||||||
|
|
||||||
|
### Plugin Information
|
||||||
|
- Requires ProtocolLib to be installed: get the latest version [here](https://www.spigotmc.org/resources/protocollib.1997/)
|
||||||
|
- Supports 1.16.5+
|
||||||
|
|
||||||
|
### bStats
|
||||||
|
<img src="https://bstats.org/signatures/bukkit/eco.svg" width="512">
|
||||||
|
|
||||||
|
# Information for development
|
||||||
|
|
||||||
|
## Javadoc
|
||||||
|
The 6.8.0 Javadoc can be found [here](https://javadoc.jitpack.io/com/willfp/eco/6.8.0/javadoc/)
|
||||||
|
|
||||||
|
## Plugin Information
|
||||||
|
|
||||||
|
eco is a standalone plugin, so you will need to install it on any servers that have plugins which depend on it,
|
||||||
|
and specify it as a dependency in your plugin.yml:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
depend:
|
||||||
|
- eco
|
||||||
|
```
|
||||||
|
|
||||||
|
eco is available from any of these places:
|
||||||
|
|
||||||
|
- [GitHub](https://github.com/Auxilor/eco/releases)
|
||||||
|
- [Polymart](https://polymart.org/resource/eco.773)
|
||||||
|
- [Build it locally](https://github.com/Auxilor/eco#build-locally).
|
||||||
|
|
||||||
|
## Get from JitPack:
|
||||||
|
|
||||||
|
Gradle:
|
||||||
|
|
||||||
|
```groovy
|
||||||
|
repositories {
|
||||||
|
maven { url 'https://jitpack.io' }
|
||||||
|
}
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
```groovy
|
||||||
|
dependencies {
|
||||||
|
compileOnly 'com.willfp:eco:Tag'
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Replace `Tag` with a release tag for eco, eg `6.0.0`.
|
||||||
|
|
||||||
|
Maven:
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<repository>
|
||||||
|
<id>jitpack.io</id>
|
||||||
|
<url>https://jitpack.io</url>
|
||||||
|
</repository>
|
||||||
|
```
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<dependency>
|
||||||
|
<groupId>com.willfp</groupId>
|
||||||
|
<artifactId>eco</artifactId>
|
||||||
|
<version>Tag</version>
|
||||||
|
<scope>provided</scope>
|
||||||
|
</dependency>
|
||||||
|
```
|
||||||
|
|
||||||
|
Replace `Tag` with a release tag for eco, eg `6.8.0`.
|
||||||
|
|
||||||
|
## Build locally:
|
||||||
|
|
||||||
|
Run the following commands in your terminal of choice.
|
||||||
|
|
||||||
|
If you're on windows, you will need to have git bash installed.
|
||||||
|
```
|
||||||
|
git clone https://github.com/Auxilor/eco
|
||||||
|
cd eco
|
||||||
|
./gradlew build
|
||||||
|
```
|
||||||
|
|
||||||
|
# Features
|
||||||
|
|
||||||
|
Here's a list of some (not all) of the features of eco:
|
||||||
|
|
||||||
|
- Command system with subcommands
|
||||||
|
- Reworked config system
|
||||||
|
- JSON Config Support
|
||||||
|
- Client-Side item display
|
||||||
|
- World drop system
|
||||||
|
- Event manager
|
||||||
|
- PlayerJumpEvent
|
||||||
|
- ArmorEquipEvent
|
||||||
|
- EntityDeathByEntityEvent
|
||||||
|
- NaturalExpGainEvent
|
||||||
|
- Plugin extensions (com.willfp.eco.internal.Plugins for plugins)
|
||||||
|
- GUI System
|
||||||
|
- Integration system for external plugins
|
||||||
|
- Anticheat support
|
||||||
|
- AAC
|
||||||
|
- Matrix
|
||||||
|
- NCP
|
||||||
|
- Spartan
|
||||||
|
- Vulcan
|
||||||
|
- Antigrief/Combat support
|
||||||
|
- CombatLogX (V10 + V11)
|
||||||
|
- FactionsUUID
|
||||||
|
- GriefPrevention
|
||||||
|
- Kingdoms
|
||||||
|
- Lands
|
||||||
|
- Towny
|
||||||
|
- WorldGuard
|
||||||
|
- mcMMO support
|
||||||
|
- Custom Items support
|
||||||
|
- Oraxen
|
||||||
|
- PlaceholderAPI support
|
||||||
|
- NMS Proxy / Wrapper system built in
|
||||||
|
- Custom Items system
|
||||||
|
- Crafting Recipe handler
|
||||||
|
- Tuples
|
||||||
|
- Support uploading to / downloading from hastebin
|
||||||
|
- Packet System (via ProtocolLib)
|
||||||
|
- Dependency Injection systems
|
||||||
|
- Prerequisite system
|
||||||
|
- API additions (via utility classes)
|
||||||
|
- Get bow from arrow
|
||||||
|
- Break a block as a player
|
||||||
|
- Get a vein of blocks
|
||||||
|
- Create 2D lists
|
||||||
|
- Create NamespacedKeys safely
|
||||||
|
- Random number, distribution, roman numerals
|
||||||
|
- Set skull texture
|
||||||
|
- Format all strings
|
||||||
|
- Hex Support
|
||||||
|
- Gradient Support
|
||||||
|
- Placeholder Support
|
||||||
|
- Get a scoreboard team from any color
|
||||||
|
- Telekinesis (Drops straight to inventory) system
|
||||||
|
- More vector options
|
||||||
|
- Update checker
|
||||||
|
- bStats integration
|
||||||
|
- Reworked systems for:
|
||||||
|
- NamespacedKey
|
||||||
|
- MetadataValue
|
||||||
|
- Runnables / Scheduling
|
||||||
|
|
||||||
|
... and a lot more!
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
*Click here to read [the entire license](https://github.com/Auxilor/eco/blob/master/LICENSE.md).*
|
||||||
|
|
||||||
|
<h1 align="center">
|
||||||
|
<br>
|
||||||
|
<a href="https://gamersupps.gg/discount/Auxilor?afmc=Auxilor" target="_blank">
|
||||||
|
<img src="https://i.imgur.com/uFDpBAC.png" alt="supps banner">
|
||||||
|
</a>
|
||||||
|
<a href="https://dedimc.promo/Auxilor" target="_blank">
|
||||||
|
<img src="https://i.imgur.com/zdDLhFA.png" alt="dedimc banner">
|
||||||
|
</a>
|
||||||
|
<br>
|
||||||
|
</h1>
|
||||||
|
|
||||||
|
|||||||
37
build.gradle
37
build.gradle
@@ -7,7 +7,11 @@ plugins {
|
|||||||
|
|
||||||
dependencies {
|
dependencies {
|
||||||
implementation project(":eco-api")
|
implementation project(":eco-api")
|
||||||
implementation project(":eco-core").getSubprojects()
|
implementation project(":eco-core:core-plugin")
|
||||||
|
implementation project(":eco-core:core-proxy")
|
||||||
|
implementation project(":eco-core:core-backend")
|
||||||
|
implementation project(":eco-core:core-nms:v1_16_R3")
|
||||||
|
implementation project(path: ":eco-core:core-nms:v1_17_R1", configuration: 'mapped')
|
||||||
}
|
}
|
||||||
|
|
||||||
allprojects {
|
allprojects {
|
||||||
@@ -21,11 +25,14 @@ allprojects {
|
|||||||
mavenLocal()
|
mavenLocal()
|
||||||
maven { url 'https://jitpack.io' }
|
maven { url 'https://jitpack.io' }
|
||||||
|
|
||||||
|
// SuperiorSkyblock2
|
||||||
|
maven { url 'https://repo.bg-software.com/repository/api/' }
|
||||||
|
|
||||||
// NMS (for jitpack compilation)
|
// NMS (for jitpack compilation)
|
||||||
maven { url 'https://repo.codemc.org/repository/nms/' }
|
maven { url 'https://repo.codemc.org/repository/nms/' }
|
||||||
|
|
||||||
// bStats, mcMMO
|
// bStats, mcMMO, BentoBox
|
||||||
maven { url 'https://repo.codemc.org/repository/maven-public' }
|
maven { url 'https://repo.codemc.org/repository/maven-public/' }
|
||||||
|
|
||||||
// Spigot API
|
// Spigot API
|
||||||
maven { url 'https://hub.spigotmc.org/nexus/content/repositories/snapshots/' }
|
maven { url 'https://hub.spigotmc.org/nexus/content/repositories/snapshots/' }
|
||||||
@@ -53,10 +60,14 @@ allprojects {
|
|||||||
compileOnly 'org.jetbrains:annotations:19.0.0'
|
compileOnly 'org.jetbrains:annotations:19.0.0'
|
||||||
|
|
||||||
// Lombok
|
// Lombok
|
||||||
compileOnly 'org.projectlombok:lombok:1.18.20'
|
compileOnly 'org.projectlombok:lombok:1.18.22'
|
||||||
annotationProcessor 'org.projectlombok:lombok:1.18.20'
|
annotationProcessor 'org.projectlombok:lombok:1.18.20'
|
||||||
testCompileOnly 'org.projectlombok:lombok:1.18.20'
|
testCompileOnly 'org.projectlombok:lombok:1.18.20'
|
||||||
testAnnotationProcessor 'org.projectlombok:lombok:1.18.20'
|
testAnnotationProcessor 'org.projectlombok:lombok:1.18.20'
|
||||||
|
|
||||||
|
// Test
|
||||||
|
testImplementation 'org.junit.jupiter:junit-jupiter-api:5.3.1'
|
||||||
|
testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.1'
|
||||||
}
|
}
|
||||||
|
|
||||||
tasks.withType(JavaCompile) {
|
tasks.withType(JavaCompile) {
|
||||||
@@ -68,14 +79,15 @@ allprojects {
|
|||||||
exclude group: "org.codehaus.plexus", module: "plexus-utils"
|
exclude group: "org.codehaus.plexus", module: "plexus-utils"
|
||||||
exclude group: "com.mojang", module: "brigadier"
|
exclude group: "com.mojang", module: "brigadier"
|
||||||
exclude group: "org.kitteh", module: "paste-gg-api"
|
exclude group: "org.kitteh", module: "paste-gg-api"
|
||||||
|
exclude group: "org.kitteh", module: "pastegg"
|
||||||
exclude group: "org.spongepowered", module: "configurate-hocon"
|
exclude group: "org.spongepowered", module: "configurate-hocon"
|
||||||
exclude group: "com.darkblade12", module: "particleeffect"
|
exclude group: "com.darkblade12", module: "particleeffect"
|
||||||
exclude group: "com.github.cryptomorin", module: "XSeries"
|
exclude group: "com.github.cryptomorin", module: "XSeries"
|
||||||
}
|
}
|
||||||
|
|
||||||
shadowJar {
|
shadowJar {
|
||||||
relocate('org.bstats.bukkit', 'com.willfp.eco.shaded.bstats')
|
relocate('org.bstats', 'com.willfp.eco.shaded.bstats')
|
||||||
relocate('org.apache.maven', 'com.willfp.eco.shaded.maven')
|
relocate('net.kyori.adventure.text.minimessage', 'com.willfp.eco.shaded.minimessage')
|
||||||
}
|
}
|
||||||
|
|
||||||
jar {
|
jar {
|
||||||
@@ -89,6 +101,19 @@ allprojects {
|
|||||||
java {
|
java {
|
||||||
sourceCompatibility = JavaVersion.VERSION_16
|
sourceCompatibility = JavaVersion.VERSION_16
|
||||||
targetCompatibility = JavaVersion.VERSION_16
|
targetCompatibility = JavaVersion.VERSION_16
|
||||||
|
withSourcesJar()
|
||||||
|
}
|
||||||
|
|
||||||
|
test {
|
||||||
|
useJUnitPlatform()
|
||||||
|
|
||||||
|
// Always run tests, even when nothing changed.
|
||||||
|
dependsOn cleanTest
|
||||||
|
|
||||||
|
// Show test results.
|
||||||
|
testLogging {
|
||||||
|
events "passed", "skipped", "failed"
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
compileJava.options.encoding = 'UTF-8'
|
compileJava.options.encoding = 'UTF-8'
|
||||||
|
|||||||
@@ -45,7 +45,7 @@
|
|||||||
-->
|
-->
|
||||||
<property name="severity" value="error"/>
|
<property name="severity" value="error"/>
|
||||||
|
|
||||||
<property name="fileExtensions" value="java, properties, xml"/>
|
<property name="fileExtensions" value="java, properties, xml, kt"/>
|
||||||
|
|
||||||
<!-- Excludes all 'module-info.java' files -->
|
<!-- Excludes all 'module-info.java' files -->
|
||||||
<!-- See https://checkstyle.org/config_filefilters.html -->
|
<!-- See https://checkstyle.org/config_filefilters.html -->
|
||||||
@@ -66,6 +66,7 @@
|
|||||||
<module name="FileLength"/>
|
<module name="FileLength"/>
|
||||||
<module name="LineLength">
|
<module name="LineLength">
|
||||||
<property name="fileExtensions" value="java"/>
|
<property name="fileExtensions" value="java"/>
|
||||||
|
<property name="fileExtensions" value="kt"/>
|
||||||
<property name="max" value="200"/>
|
<property name="max" value="200"/>
|
||||||
</module>
|
</module>
|
||||||
|
|
||||||
|
|||||||
@@ -10,6 +10,8 @@
|
|||||||
<suppress files="[\\/]internal[\\/]" checks="JavadocVariable"/>
|
<suppress files="[\\/]internal[\\/]" checks="JavadocVariable"/>
|
||||||
<suppress files="[\\/]eco[\\/]spigot[\\/]" checks="MissingJavadocMethod"/>
|
<suppress files="[\\/]eco[\\/]spigot[\\/]" checks="MissingJavadocMethod"/>
|
||||||
<suppress files="[\\/]eco[\\/]spigot[\\/]" checks="JavadocVariable"/>
|
<suppress files="[\\/]eco[\\/]spigot[\\/]" checks="JavadocVariable"/>
|
||||||
|
<suppress files="[\\/]eco[\\/]proxy[\\/]" checks="MissingJavadocMethod"/>
|
||||||
|
<suppress files="[\\/]eco[\\/]proxy[\\/]" checks="JavadocVariable"/>
|
||||||
|
|
||||||
<!-- Modified version of library -->
|
<!-- Modified version of library -->
|
||||||
<suppress files="ArmorEquipEvent.java" checks="JavadocVariable"/>
|
<suppress files="ArmorEquipEvent.java" checks="JavadocVariable"/>
|
||||||
|
|||||||
@@ -6,16 +6,24 @@ group 'com.willfp'
|
|||||||
version rootProject.version
|
version rootProject.version
|
||||||
|
|
||||||
dependencies {
|
dependencies {
|
||||||
compileOnly 'org.spigotmc:spigot:1.17-R0.1-SNAPSHOT'
|
// Adventure
|
||||||
compileOnly 'org.apache.maven:maven-artifact:3.0.3'
|
compileOnly 'net.kyori:adventure-platform-bukkit:4.0.0'
|
||||||
compileOnly 'org.bstats:bstats-bukkit:1.7'
|
compileOnly 'net.kyori:adventure-text-minimessage:4.1.0-SNAPSHOT'
|
||||||
compileOnly 'com.comphenix.protocol:ProtocolLib:4.6.0-SNAPSHOT'
|
compileOnly 'net.kyori:adventure-api:4.9.2'
|
||||||
compileOnly 'me.clip:placeholderapi:2.10.9'
|
compileOnly 'net.kyori:adventure-text-serializer-gson:4.9.2'
|
||||||
compileOnly 'com.google.code.gson:gson:2.8.7'
|
compileOnly 'net.kyori:adventure-text-serializer-legacy:4.9.2'
|
||||||
|
|
||||||
|
// Other
|
||||||
|
compileOnly 'org.spigotmc:spigot-api:1.17.1-R0.1-SNAPSHOT'
|
||||||
|
compileOnly 'org.apache.maven:maven-artifact:3.8.1'
|
||||||
|
compileOnly 'com.comphenix.protocol:ProtocolLib:4.7.1-SNAPSHOT'
|
||||||
|
compileOnly 'com.google.code.gson:gson:2.8.8'
|
||||||
|
}
|
||||||
|
|
||||||
|
java {
|
||||||
|
withJavadocJar()
|
||||||
}
|
}
|
||||||
|
|
||||||
compileJava.options.encoding = 'UTF-8'
|
|
||||||
compileJava.dependsOn clean
|
|
||||||
|
|
||||||
build.dependsOn publishToMavenLocal
|
build.dependsOn publishToMavenLocal
|
||||||
|
|
||||||
@@ -26,4 +34,15 @@ publishing {
|
|||||||
artifactId 'eco'
|
artifactId 'eco'
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
repositories {
|
||||||
|
maven {
|
||||||
|
name = "GitHubPackages"
|
||||||
|
url = uri("https://maven.pkg.github.com/Auxilor/eco")
|
||||||
|
credentials {
|
||||||
|
username = System.getenv("GITHUB_ACTOR")
|
||||||
|
password = System.getenv("GITHUB_TOKEN")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
@@ -12,6 +12,9 @@ import org.jetbrains.annotations.NotNull;
|
|||||||
|
|
||||||
import java.util.Collections;
|
import java.util.Collections;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Wrapper class for ProtocolLib packets.
|
||||||
|
*/
|
||||||
public abstract class AbstractPacketAdapter extends PacketAdapter {
|
public abstract class AbstractPacketAdapter extends PacketAdapter {
|
||||||
/**
|
/**
|
||||||
* The packet type to listen for.
|
* The packet type to listen for.
|
||||||
@@ -56,28 +59,6 @@ public abstract class AbstractPacketAdapter extends PacketAdapter {
|
|||||||
this(plugin, type, ListenerPriority.NORMAL, postLoad);
|
this(plugin, type, ListenerPriority.NORMAL, postLoad);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* The code that should be executed once the packet has been received.
|
|
||||||
*
|
|
||||||
* @param packet The packet.
|
|
||||||
* @param player The player.
|
|
||||||
*/
|
|
||||||
public void onReceive(@NotNull final PacketContainer packet,
|
|
||||||
@NotNull final Player player) {
|
|
||||||
// Empty rather than abstract as implementations don't need both
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* THe code that should be executed once the packet has been sent.
|
|
||||||
*
|
|
||||||
* @param packet The packet.
|
|
||||||
* @param player The player.
|
|
||||||
*/
|
|
||||||
public void onSend(@NotNull final PacketContainer packet,
|
|
||||||
@NotNull final Player player) {
|
|
||||||
// Empty rather than abstract as implementations don't need both
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* The code that should be executed once the packet has been received.
|
* The code that should be executed once the packet has been received.
|
||||||
*
|
*
|
||||||
@@ -119,7 +100,6 @@ public abstract class AbstractPacketAdapter extends PacketAdapter {
|
|||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
onReceive(event.getPacket(), event.getPlayer());
|
|
||||||
onReceive(event.getPacket(), event.getPlayer(), event);
|
onReceive(event.getPacket(), event.getPlayer(), event);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -138,7 +118,6 @@ public abstract class AbstractPacketAdapter extends PacketAdapter {
|
|||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
onSend(event.getPacket(), event.getPlayer());
|
|
||||||
onSend(event.getPacket(), event.getPlayer(), event);
|
onSend(event.getPacket(), event.getPlayer(), event);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
52
eco-api/src/main/java/com/willfp/eco/core/Eco.java
Normal file
52
eco-api/src/main/java/com/willfp/eco/core/Eco.java
Normal file
@@ -0,0 +1,52 @@
|
|||||||
|
package com.willfp.eco.core;
|
||||||
|
|
||||||
|
import lombok.experimental.UtilityClass;
|
||||||
|
import org.apache.commons.lang.Validate;
|
||||||
|
import org.jetbrains.annotations.ApiStatus;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base class to hold the handler.
|
||||||
|
*
|
||||||
|
* @see Handler
|
||||||
|
*/
|
||||||
|
@UtilityClass
|
||||||
|
public class Eco {
|
||||||
|
/**
|
||||||
|
* Instance of eco handler.
|
||||||
|
*/
|
||||||
|
@ApiStatus.Internal
|
||||||
|
private Handler handler;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the handler.
|
||||||
|
* @param handler The handler.
|
||||||
|
*/
|
||||||
|
@ApiStatus.Internal
|
||||||
|
public void setHandler(@NotNull final Handler handler) {
|
||||||
|
Validate.isTrue(Eco.handler == null, "Already initialized!");
|
||||||
|
|
||||||
|
Eco.handler = handler;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the instance of the eco handler.
|
||||||
|
* <p>
|
||||||
|
* The handler is, in essence, a way to interface between the eco-api
|
||||||
|
* frontend module, and the eco-backend implementations.
|
||||||
|
* <p>
|
||||||
|
* There shouldn't really be any reason to ever use the handler
|
||||||
|
* in your own plugins, and you are likely to break things. All parts of
|
||||||
|
* the handler are abstracted into logically named parts of the API.
|
||||||
|
* <p>
|
||||||
|
* In versions of eco before 6.12.0, the handler was considered part of
|
||||||
|
* the eco API, however it has since been moved into an internal component
|
||||||
|
* that shouldn't be used in your plugins.
|
||||||
|
*
|
||||||
|
* @return The handler.
|
||||||
|
*/
|
||||||
|
@ApiStatus.Internal
|
||||||
|
public Handler getHandler() {
|
||||||
|
return handler;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,10 +1,9 @@
|
|||||||
package com.willfp.eco.core;
|
package com.willfp.eco.core;
|
||||||
|
|
||||||
import com.willfp.eco.core.command.AbstractCommand;
|
|
||||||
import com.willfp.eco.core.command.impl.PluginCommand;
|
import com.willfp.eco.core.command.impl.PluginCommand;
|
||||||
import com.willfp.eco.core.config.ConfigHandler;
|
|
||||||
import com.willfp.eco.core.config.base.ConfigYml;
|
import com.willfp.eco.core.config.base.ConfigYml;
|
||||||
import com.willfp.eco.core.config.base.LangYml;
|
import com.willfp.eco.core.config.base.LangYml;
|
||||||
|
import com.willfp.eco.core.config.updating.ConfigHandler;
|
||||||
import com.willfp.eco.core.display.Display;
|
import com.willfp.eco.core.display.Display;
|
||||||
import com.willfp.eco.core.display.DisplayModule;
|
import com.willfp.eco.core.display.DisplayModule;
|
||||||
import com.willfp.eco.core.events.EventManager;
|
import com.willfp.eco.core.events.EventManager;
|
||||||
@@ -14,23 +13,13 @@ import com.willfp.eco.core.factory.NamespacedKeyFactory;
|
|||||||
import com.willfp.eco.core.factory.RunnableFactory;
|
import com.willfp.eco.core.factory.RunnableFactory;
|
||||||
import com.willfp.eco.core.integrations.IntegrationLoader;
|
import com.willfp.eco.core.integrations.IntegrationLoader;
|
||||||
import com.willfp.eco.core.integrations.placeholder.PlaceholderManager;
|
import com.willfp.eco.core.integrations.placeholder.PlaceholderManager;
|
||||||
|
import com.willfp.eco.core.proxy.AbstractProxy;
|
||||||
|
import com.willfp.eco.core.proxy.ProxyFactory;
|
||||||
import com.willfp.eco.core.scheduling.Scheduler;
|
import com.willfp.eco.core.scheduling.Scheduler;
|
||||||
import com.willfp.eco.internal.Internals;
|
import com.willfp.eco.core.web.UpdateChecker;
|
||||||
import com.willfp.eco.internal.UpdateChecker;
|
|
||||||
import com.willfp.eco.internal.arrows.ArrowDataListener;
|
|
||||||
import com.willfp.eco.internal.config.updating.EcoConfigHandler;
|
|
||||||
import com.willfp.eco.internal.events.EcoEventManager;
|
|
||||||
import com.willfp.eco.internal.extensions.EcoExtensionLoader;
|
|
||||||
import com.willfp.eco.internal.factory.EcoMetadataValueFactory;
|
|
||||||
import com.willfp.eco.internal.factory.EcoNamespacedKeyFactory;
|
|
||||||
import com.willfp.eco.internal.factory.EcoRunnableFactory;
|
|
||||||
import com.willfp.eco.internal.integrations.PlaceholderIntegrationPAPI;
|
|
||||||
import com.willfp.eco.internal.logging.EcoLogger;
|
|
||||||
import com.willfp.eco.internal.scheduling.EcoScheduler;
|
|
||||||
import lombok.Getter;
|
import lombok.Getter;
|
||||||
import org.apache.commons.lang.Validate;
|
import org.apache.commons.lang.Validate;
|
||||||
import org.apache.maven.artifact.versioning.DefaultArtifactVersion;
|
import org.apache.maven.artifact.versioning.DefaultArtifactVersion;
|
||||||
import org.bstats.bukkit.Metrics;
|
|
||||||
import org.bukkit.Bukkit;
|
import org.bukkit.Bukkit;
|
||||||
import org.bukkit.configuration.file.FileConfiguration;
|
import org.bukkit.configuration.file.FileConfiguration;
|
||||||
import org.bukkit.event.Listener;
|
import org.bukkit.event.Listener;
|
||||||
@@ -47,24 +36,25 @@ import java.util.Set;
|
|||||||
import java.util.logging.Logger;
|
import java.util.logging.Logger;
|
||||||
import java.util.stream.Collectors;
|
import java.util.stream.Collectors;
|
||||||
|
|
||||||
@SuppressWarnings({"deprecation", "DeprecatedIsStillUsed"})
|
/**
|
||||||
public abstract class EcoPlugin extends JavaPlugin {
|
* EcoPlugin is the base plugin class for eco-based plugins.
|
||||||
/**
|
* <p>
|
||||||
* Loaded eco plugins.
|
* It functions as a replacement for {@link JavaPlugin}.
|
||||||
|
* <p>
|
||||||
|
* EcoPlugin is a lot more powerful than {@link JavaPlugin} and
|
||||||
|
* contains many methods to reduce boilerplate code and reduce
|
||||||
|
* plugin complexity.
|
||||||
|
* <p>
|
||||||
|
* It is recommended to view the source code for this class to
|
||||||
|
* gain a better understanding of how it works.
|
||||||
|
* <p>
|
||||||
|
* <b>IMPORTANT: When reloading a plugin, all runnables / tasks will
|
||||||
|
* be cancelled.</b>
|
||||||
*/
|
*/
|
||||||
public static final List<String> LOADED_ECO_PLUGINS = new ArrayList<>();
|
@SuppressWarnings("unused")
|
||||||
|
public abstract class EcoPlugin extends JavaPlugin implements PluginLike {
|
||||||
/**
|
/**
|
||||||
* The name of the plugin.
|
* The polymart resource ID of the plugin.
|
||||||
*
|
|
||||||
* @deprecated Pointless, use getName instead.
|
|
||||||
*/
|
|
||||||
@Getter
|
|
||||||
@Deprecated
|
|
||||||
private final String pluginName;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* The spigot resource ID of the plugin.
|
|
||||||
*/
|
*/
|
||||||
@Getter
|
@Getter
|
||||||
private final int resourceId;
|
private final int resourceId;
|
||||||
@@ -93,11 +83,6 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
@Getter
|
@Getter
|
||||||
private final Set<String> loadedIntegrations = new HashSet<>();
|
private final Set<String> loadedIntegrations = new HashSet<>();
|
||||||
|
|
||||||
/**
|
|
||||||
* Set of classes to be processed on config update.
|
|
||||||
*/
|
|
||||||
private final List<Class<?>> updatableClasses = new ArrayList<>();
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* The internal plugin scheduler.
|
* The internal plugin scheduler.
|
||||||
*/
|
*/
|
||||||
@@ -178,14 +163,20 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
private final boolean supportingExtensions;
|
private final boolean supportingExtensions;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Create a new plugin without a specified color, proxy support, spigot, or bStats.
|
* The proxy factory.
|
||||||
|
*/
|
||||||
|
@Getter
|
||||||
|
private final ProxyFactory proxyFactory;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a new plugin without a specified color, proxy support, polymart, or bStats.
|
||||||
*/
|
*/
|
||||||
protected EcoPlugin() {
|
protected EcoPlugin() {
|
||||||
this("&f");
|
this("&f");
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Create a new plugin without proxy support, spigot, or bStats.
|
* Create a new plugin without proxy support, polymart, or bStats.
|
||||||
*
|
*
|
||||||
* @param color The color.
|
* @param color The color.
|
||||||
*/
|
*/
|
||||||
@@ -195,10 +186,10 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Create a new plugin unlinked to spigot and bStats.
|
* Create a new plugin unlinked to polymart and bStats.
|
||||||
*
|
*
|
||||||
* @param proxyPackage The package where proxy implementations are stored.
|
* @param proxyPackage The package where proxy implementations are stored.
|
||||||
* @param color The color of the plugin (used in messages, such as &a, &b)
|
* @param color The color of the plugin (used in messages, using standard formatting)
|
||||||
*/
|
*/
|
||||||
protected EcoPlugin(@NotNull final String proxyPackage,
|
protected EcoPlugin(@NotNull final String proxyPackage,
|
||||||
@NotNull final String color) {
|
@NotNull final String color) {
|
||||||
@@ -208,9 +199,9 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
/**
|
/**
|
||||||
* Create a new plugin without proxy or extension support.
|
* Create a new plugin without proxy or extension support.
|
||||||
*
|
*
|
||||||
* @param resourceId The spigot resource ID for the plugin.
|
* @param resourceId The polymart resource ID for the plugin.
|
||||||
* @param bStatsId The bStats resource ID for the plugin.
|
* @param bStatsId The bStats resource ID for the plugin.
|
||||||
* @param color The color of the plugin (used in messages, such as &a, &b)
|
* @param color The color of the plugin (used in messages, using standard formatting)
|
||||||
*/
|
*/
|
||||||
protected EcoPlugin(final int resourceId,
|
protected EcoPlugin(final int resourceId,
|
||||||
final int bStatsId,
|
final int bStatsId,
|
||||||
@@ -221,9 +212,9 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
/**
|
/**
|
||||||
* Create a new plugin without proxy support.
|
* Create a new plugin without proxy support.
|
||||||
*
|
*
|
||||||
* @param resourceId The spigot resource ID for the plugin.
|
* @param resourceId The polymart resource ID for the plugin.
|
||||||
* @param bStatsId The bStats resource ID for the plugin.
|
* @param bStatsId The bStats resource ID for the plugin.
|
||||||
* @param color The color of the plugin (used in messages, such as &a, &b)
|
* @param color The color of the plugin (used in messages, using standard formatting)
|
||||||
* @param supportingExtensions If the plugin supports extensions.
|
* @param supportingExtensions If the plugin supports extensions.
|
||||||
*/
|
*/
|
||||||
protected EcoPlugin(final int resourceId,
|
protected EcoPlugin(final int resourceId,
|
||||||
@@ -236,10 +227,10 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
/**
|
/**
|
||||||
* Create a new plugin without extension support.
|
* Create a new plugin without extension support.
|
||||||
*
|
*
|
||||||
* @param resourceId The spigot resource ID for the plugin.
|
* @param resourceId The polymart resource ID for the plugin.
|
||||||
* @param bStatsId The bStats resource ID for the plugin.
|
* @param bStatsId The bStats resource ID for the plugin.
|
||||||
* @param proxyPackage The package where proxy implementations are stored.
|
* @param proxyPackage The package where proxy implementations are stored.
|
||||||
* @param color The color of the plugin (used in messages, such as &a, &b)
|
* @param color The color of the plugin (used in messages, using standard formatting)
|
||||||
*/
|
*/
|
||||||
protected EcoPlugin(final int resourceId,
|
protected EcoPlugin(final int resourceId,
|
||||||
final int bStatsId,
|
final int bStatsId,
|
||||||
@@ -251,10 +242,10 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
/**
|
/**
|
||||||
* Create a new plugin.
|
* Create a new plugin.
|
||||||
*
|
*
|
||||||
* @param resourceId The spigot resource ID for the plugin.
|
* @param resourceId The polymart resource ID for the plugin.
|
||||||
* @param bStatsId The bStats resource ID for the plugin.
|
* @param bStatsId The bStats resource ID for the plugin.
|
||||||
* @param proxyPackage The package where proxy implementations are stored.
|
* @param proxyPackage The package where proxy implementations are stored.
|
||||||
* @param color The color of the plugin (used in messages, such as &a, &b)
|
* @param color The color of the plugin (used in messages, using standard formatting)
|
||||||
* @param supportingExtensions If the plugin supports extensions.
|
* @param supportingExtensions If the plugin supports extensions.
|
||||||
*/
|
*/
|
||||||
protected EcoPlugin(final int resourceId,
|
protected EcoPlugin(final int resourceId,
|
||||||
@@ -262,68 +253,79 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
@NotNull final String proxyPackage,
|
@NotNull final String proxyPackage,
|
||||||
@NotNull final String color,
|
@NotNull final String color,
|
||||||
final boolean supportingExtensions) {
|
final boolean supportingExtensions) {
|
||||||
this("", resourceId, bStatsId, proxyPackage, color, supportingExtensions);
|
/*
|
||||||
|
The handler must be initialized before any plugin's constructors
|
||||||
|
are called, as the constructors call Eco#getHandler().
|
||||||
|
|
||||||
|
To fix this, EcoSpigotPlugin an abstract class and the 'actual'
|
||||||
|
plugin class is EcoHandler - that way I can create the handler
|
||||||
|
before any plugins are loaded while still having a separation between
|
||||||
|
the plugin class and the handler class (for code clarity).
|
||||||
|
|
||||||
|
I don't really like the fact that the handler class *is* the
|
||||||
|
spigot plugin, but it is what it is.
|
||||||
|
|
||||||
|
There is probably a better way of doing it - maybe with
|
||||||
|
some sort of HandlerCreator interface in order to still have
|
||||||
|
a standalone handler class, but then there would be an interface
|
||||||
|
left in the API that doesn't really help anything.
|
||||||
|
|
||||||
|
The other alternative would be do use reflection to get a 'createHandler'
|
||||||
|
method that only exists in EcoSpigotPlugin - but that feels really dirty
|
||||||
|
and I'd rather only use reflection where necessary.
|
||||||
|
*/
|
||||||
|
|
||||||
|
if (Eco.getHandler() == null && this instanceof Handler) {
|
||||||
|
/*
|
||||||
|
This code is only ever called by EcoSpigotPlugin (EcoHandler)
|
||||||
|
as it's the first plugin to load and it is a handler.
|
||||||
|
|
||||||
|
Any other plugins will never call this code as the handler
|
||||||
|
will have already been initialized.
|
||||||
|
*/
|
||||||
|
|
||||||
|
Eco.setHandler((Handler) this);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
assert Eco.getHandler() != null;
|
||||||
* Create a new plugin.
|
|
||||||
*
|
|
||||||
* @param pluginName The name of the plugin.
|
|
||||||
* @param resourceId The spigot resource ID for the plugin.
|
|
||||||
* @param bStatsId The bStats resource ID for the plugin.
|
|
||||||
* @param proxyPackage The package where proxy implementations are stored.
|
|
||||||
* @param color The color of the plugin (used in messages, such as &a, &b)
|
|
||||||
* @deprecated pluginName is redundant.
|
|
||||||
*/
|
|
||||||
@Deprecated
|
|
||||||
@SuppressWarnings("unused")
|
|
||||||
protected EcoPlugin(@NotNull final String pluginName,
|
|
||||||
final int resourceId,
|
|
||||||
final int bStatsId,
|
|
||||||
@NotNull final String proxyPackage,
|
|
||||||
@NotNull final String color) {
|
|
||||||
this(pluginName, resourceId, bStatsId, proxyPackage, color, false);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create a new plugin.
|
|
||||||
*
|
|
||||||
* @param pluginName The name of the plugin.
|
|
||||||
* @param resourceId The spigot resource ID for the plugin.
|
|
||||||
* @param bStatsId The bStats resource ID for the plugin.
|
|
||||||
* @param proxyPackage The package where proxy implementations are stored.
|
|
||||||
* @param color The color of the plugin (used in messages, such as &a, &b)
|
|
||||||
* @param supportingExtensions If the plugin supports extensions.
|
|
||||||
* @deprecated pluginName is redundant.
|
|
||||||
*/
|
|
||||||
@Deprecated
|
|
||||||
@SuppressWarnings("unused")
|
|
||||||
protected EcoPlugin(@NotNull final String pluginName,
|
|
||||||
final int resourceId,
|
|
||||||
final int bStatsId,
|
|
||||||
@NotNull final String proxyPackage,
|
|
||||||
@NotNull final String color,
|
|
||||||
final boolean supportingExtensions) {
|
|
||||||
this.pluginName = this.getName();
|
|
||||||
this.resourceId = resourceId;
|
this.resourceId = resourceId;
|
||||||
this.bStatsId = bStatsId;
|
this.bStatsId = bStatsId;
|
||||||
this.proxyPackage = proxyPackage;
|
this.proxyPackage = proxyPackage;
|
||||||
this.color = color;
|
this.color = color;
|
||||||
this.supportingExtensions = supportingExtensions;
|
this.supportingExtensions = supportingExtensions;
|
||||||
|
|
||||||
this.scheduler = new EcoScheduler(this);
|
this.scheduler = Eco.getHandler().createScheduler(this);
|
||||||
this.eventManager = new EcoEventManager(this);
|
this.eventManager = Eco.getHandler().createEventManager(this);
|
||||||
this.namespacedKeyFactory = new EcoNamespacedKeyFactory(this);
|
this.namespacedKeyFactory = Eco.getHandler().createNamespacedKeyFactory(this);
|
||||||
this.metadataValueFactory = new EcoMetadataValueFactory(this);
|
this.metadataValueFactory = Eco.getHandler().createMetadataValueFactory(this);
|
||||||
this.runnableFactory = new EcoRunnableFactory(this);
|
this.runnableFactory = Eco.getHandler().createRunnableFactory(this);
|
||||||
this.extensionLoader = new EcoExtensionLoader(this);
|
this.extensionLoader = Eco.getHandler().createExtensionLoader(this);
|
||||||
this.configHandler = new EcoConfigHandler(this);
|
this.configHandler = Eco.getHandler().createConfigHandler(this);
|
||||||
this.logger = new EcoLogger(this);
|
this.logger = Eco.getHandler().createLogger(this);
|
||||||
|
this.proxyFactory = this.proxyPackage.equalsIgnoreCase("") ? null : Eco.getHandler().createProxyFactory(this);
|
||||||
|
|
||||||
this.langYml = new LangYml(this);
|
this.langYml = this.createLangYml();
|
||||||
this.configYml = new ConfigYml(this);
|
this.configYml = this.createConfigYml();
|
||||||
|
|
||||||
LOADED_ECO_PLUGINS.add(this.getName().toLowerCase());
|
Eco.getHandler().addNewPlugin(this);
|
||||||
|
|
||||||
|
/*
|
||||||
|
The minimum eco version check was moved here because it's very common
|
||||||
|
to add a lot of code in the constructor of plugins; meaning that the plugin
|
||||||
|
can throw errors without it being obvious to the user that the reason is
|
||||||
|
because they have an outdated version of eco installed.
|
||||||
|
*/
|
||||||
|
|
||||||
|
DefaultArtifactVersion runningVersion = new DefaultArtifactVersion(Eco.getHandler().getEcoPlugin().getDescription().getVersion());
|
||||||
|
DefaultArtifactVersion requiredVersion = new DefaultArtifactVersion(this.getMinimumEcoVersion());
|
||||||
|
if (!(runningVersion.compareTo(requiredVersion) > 0 || runningVersion.equals(requiredVersion))) {
|
||||||
|
this.getLogger().severe("You are running an outdated version of eco!");
|
||||||
|
this.getLogger().severe("You must be on at least" + this.getMinimumEcoVersion());
|
||||||
|
this.getLogger().severe("Download the newest version here:");
|
||||||
|
this.getLogger().severe("https://polymart.org/download/773/recent/JSpprMspkuyecf5y1wQ2Jn8OoLQSQ_IW");
|
||||||
|
Bukkit.getPluginManager().disablePlugin(this);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -336,8 +338,6 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
this.getLogger().info("");
|
this.getLogger().info("");
|
||||||
this.getLogger().info("Loading " + this.getColor() + this.getName());
|
this.getLogger().info("Loading " + this.getColor() + this.getName());
|
||||||
|
|
||||||
this.getEventManager().registerListener(new ArrowDataListener(this));
|
|
||||||
|
|
||||||
if (this.getResourceId() != 0) {
|
if (this.getResourceId() != 0) {
|
||||||
new UpdateChecker(this).getVersion(version -> {
|
new UpdateChecker(this).getVersion(version -> {
|
||||||
DefaultArtifactVersion currentVersion = new DefaultArtifactVersion(this.getDescription().getVersion());
|
DefaultArtifactVersion currentVersion = new DefaultArtifactVersion(this.getDescription().getVersion());
|
||||||
@@ -353,29 +353,22 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
DefaultArtifactVersion runningVersion = new DefaultArtifactVersion(Internals.getInstance().getPlugin().getDescription().getVersion());
|
|
||||||
DefaultArtifactVersion requiredVersion = new DefaultArtifactVersion(this.getMinimumEcoVersion());
|
|
||||||
if (!(runningVersion.compareTo(requiredVersion) > 0 || runningVersion.equals(requiredVersion))) {
|
|
||||||
this.getLogger().severe("You are running an outdated version of eco!");
|
|
||||||
this.getLogger().severe("You must be on at least" + this.getMinimumEcoVersion());
|
|
||||||
this.getLogger().severe("Download the newest version here:");
|
|
||||||
this.getLogger().severe("https://polymart.org/download/773/recent/JSpprMspkuyecf5y1wQ2Jn8OoLQSQ_IW");
|
|
||||||
Bukkit.getPluginManager().disablePlugin(this);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (this.getBStatsId() != 0) {
|
if (this.getBStatsId() != 0) {
|
||||||
new Metrics(this, this.getBStatsId());
|
Eco.getHandler().registerBStats(this);
|
||||||
}
|
}
|
||||||
|
|
||||||
Set<String> enabledPlugins = Arrays.stream(Bukkit.getPluginManager().getPlugins()).map(Plugin::getName).collect(Collectors.toSet());
|
Set<String> enabledPlugins = Arrays.stream(Bukkit.getPluginManager().getPlugins())
|
||||||
|
.map(Plugin::getName)
|
||||||
|
.map(String::toLowerCase)
|
||||||
|
.collect(Collectors.toSet());
|
||||||
|
|
||||||
if (enabledPlugins.contains("PlaceholderAPI")) {
|
if (enabledPlugins.contains("PlaceholderAPI".toLowerCase())) {
|
||||||
this.loadedIntegrations.add("PlaceholderAPI");
|
this.loadedIntegrations.add("PlaceholderAPI");
|
||||||
PlaceholderManager.addIntegration(new PlaceholderIntegrationPAPI(this));
|
PlaceholderManager.addIntegration(Eco.getHandler().createPAPIIntegration(this));
|
||||||
}
|
}
|
||||||
|
|
||||||
this.getIntegrationLoaders().forEach((integrationLoader -> {
|
this.loadIntegrationLoaders().forEach((integrationLoader -> {
|
||||||
if (enabledPlugins.contains(integrationLoader.getPluginName())) {
|
if (enabledPlugins.contains(integrationLoader.getPluginName().toLowerCase())) {
|
||||||
this.loadedIntegrations.add(integrationLoader.getPluginName());
|
this.loadedIntegrations.add(integrationLoader.getPluginName());
|
||||||
integrationLoader.load();
|
integrationLoader.load();
|
||||||
}
|
}
|
||||||
@@ -385,23 +378,18 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
|
|
||||||
Prerequisite.update();
|
Prerequisite.update();
|
||||||
|
|
||||||
this.getPacketAdapters().forEach(abstractPacketAdapter -> {
|
this.loadPacketAdapters().forEach(abstractPacketAdapter -> {
|
||||||
if (!abstractPacketAdapter.isPostLoad()) {
|
if (!abstractPacketAdapter.isPostLoad()) {
|
||||||
abstractPacketAdapter.register();
|
abstractPacketAdapter.register();
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
updatableClasses.addAll(this.getUpdatableClasses());
|
this.loadListeners().forEach(listener -> this.getEventManager().registerListener(listener));
|
||||||
|
|
||||||
this.getListeners().forEach(listener -> this.getEventManager().registerListener(listener));
|
this.loadPluginCommands().forEach(PluginCommand::register);
|
||||||
|
|
||||||
this.getCommands().forEach(AbstractCommand::register);
|
|
||||||
this.getPluginCommands().forEach(PluginCommand::register);
|
|
||||||
|
|
||||||
this.getScheduler().runLater(this::afterLoad, 1);
|
this.getScheduler().runLater(this::afterLoad, 1);
|
||||||
|
|
||||||
this.updatableClasses.forEach(clazz -> this.getConfigHandler().registerUpdatableClass(clazz));
|
|
||||||
|
|
||||||
if (this.isSupportingExtensions()) {
|
if (this.isSupportingExtensions()) {
|
||||||
this.getExtensionLoader().loadExtensions();
|
this.getExtensionLoader().loadExtensions();
|
||||||
|
|
||||||
@@ -413,7 +401,7 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
this.enable();
|
this.handleEnable();
|
||||||
|
|
||||||
this.getLogger().info("");
|
this.getLogger().info("");
|
||||||
}
|
}
|
||||||
@@ -427,13 +415,15 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
|
|
||||||
this.getEventManager().unregisterAllListeners();
|
this.getEventManager().unregisterAllListeners();
|
||||||
this.getScheduler().cancelAll();
|
this.getScheduler().cancelAll();
|
||||||
this.getConfigHandler().saveAllConfigs();
|
|
||||||
|
|
||||||
this.disable();
|
this.handleDisable();
|
||||||
|
|
||||||
if (this.isSupportingExtensions()) {
|
if (this.isSupportingExtensions()) {
|
||||||
this.getExtensionLoader().unloadExtensions();
|
this.getExtensionLoader().unloadExtensions();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
this.getLogger().info("Cleaning up...");
|
||||||
|
Eco.getHandler().getCleaner().clean(this);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -443,7 +433,7 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
public final void onLoad() {
|
public final void onLoad() {
|
||||||
super.onLoad();
|
super.onLoad();
|
||||||
|
|
||||||
this.load();
|
this.handleLoad();
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -456,7 +446,7 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
Display.registerDisplayModule(this.getDisplayModule());
|
Display.registerDisplayModule(this.getDisplayModule());
|
||||||
}
|
}
|
||||||
|
|
||||||
this.getPacketAdapters().forEach(abstractPacketAdapter -> {
|
this.loadPacketAdapters().forEach(abstractPacketAdapter -> {
|
||||||
if (abstractPacketAdapter.isPostLoad()) {
|
if (abstractPacketAdapter.isPostLoad()) {
|
||||||
abstractPacketAdapter.register();
|
abstractPacketAdapter.register();
|
||||||
}
|
}
|
||||||
@@ -475,15 +465,15 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
this.getLogger().severe("");
|
this.getLogger().severe("");
|
||||||
}
|
}
|
||||||
|
|
||||||
this.postLoad();
|
this.handleAfterLoad();
|
||||||
|
|
||||||
this.reload();
|
this.reload();
|
||||||
|
|
||||||
this.getLogger().info("Loaded " + this.color + this.pluginName);
|
this.getLogger().info("Loaded " + this.color + this.getName());
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Default code to be executed on plugin reload.
|
* Reload the plugin.
|
||||||
*/
|
*/
|
||||||
public final void reload() {
|
public final void reload() {
|
||||||
this.getConfigHandler().updateConfigs();
|
this.getConfigHandler().updateConfigs();
|
||||||
@@ -492,7 +482,20 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
this.getConfigHandler().callUpdate(); // Call twice to fix issues
|
this.getConfigHandler().callUpdate(); // Call twice to fix issues
|
||||||
this.getScheduler().cancelAll();
|
this.getScheduler().cancelAll();
|
||||||
|
|
||||||
this.onReload();
|
this.handleReload();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Reload the plugin and return the time taken to reload.
|
||||||
|
*
|
||||||
|
* @return The time.
|
||||||
|
*/
|
||||||
|
public final long reloadWithTime() {
|
||||||
|
long startTime = System.currentTimeMillis();
|
||||||
|
|
||||||
|
this.reload();
|
||||||
|
|
||||||
|
return System.currentTimeMillis() - startTime;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -500,7 +503,7 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
* <p>
|
* <p>
|
||||||
* Override when needed.
|
* Override when needed.
|
||||||
*/
|
*/
|
||||||
public void enable() {
|
protected void handleEnable() {
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -509,7 +512,7 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
* <p>
|
* <p>
|
||||||
* Override when needed.
|
* Override when needed.
|
||||||
*/
|
*/
|
||||||
public void disable() {
|
protected void handleDisable() {
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -520,7 +523,7 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
* <p>
|
* <p>
|
||||||
* Override when needed.
|
* Override when needed.
|
||||||
*/
|
*/
|
||||||
public void load() {
|
protected void handleLoad() {
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -529,7 +532,7 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
* <p>
|
* <p>
|
||||||
* Override when needed.
|
* Override when needed.
|
||||||
*/
|
*/
|
||||||
public void onReload() {
|
protected void handleReload() {
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -538,7 +541,7 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
* <p>
|
* <p>
|
||||||
* Override when needed.
|
* Override when needed.
|
||||||
*/
|
*/
|
||||||
public void postLoad() {
|
protected void handleAfterLoad() {
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -547,18 +550,7 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
*
|
*
|
||||||
* @return A list of integrations.
|
* @return A list of integrations.
|
||||||
*/
|
*/
|
||||||
public List<IntegrationLoader> getIntegrationLoaders() {
|
protected List<IntegrationLoader> loadIntegrationLoaders() {
|
||||||
return new ArrayList<>();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* The commands to be registered.
|
|
||||||
*
|
|
||||||
* @return A list of commands.
|
|
||||||
* @deprecated Use {@link this#getPluginCommands()} instead.
|
|
||||||
*/
|
|
||||||
@Deprecated
|
|
||||||
public List<AbstractCommand> getCommands() {
|
|
||||||
return new ArrayList<>();
|
return new ArrayList<>();
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -567,7 +559,7 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
*
|
*
|
||||||
* @return A list of commands.
|
* @return A list of commands.
|
||||||
*/
|
*/
|
||||||
public List<PluginCommand> getPluginCommands() {
|
protected List<PluginCommand> loadPluginCommands() {
|
||||||
return new ArrayList<>();
|
return new ArrayList<>();
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -578,7 +570,7 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
*
|
*
|
||||||
* @return A list of packet adapters.
|
* @return A list of packet adapters.
|
||||||
*/
|
*/
|
||||||
public List<AbstractPacketAdapter> getPacketAdapters() {
|
protected List<AbstractPacketAdapter> loadPacketAdapters() {
|
||||||
return new ArrayList<>();
|
return new ArrayList<>();
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -587,15 +579,28 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
*
|
*
|
||||||
* @return A list of all listeners.
|
* @return A list of all listeners.
|
||||||
*/
|
*/
|
||||||
public abstract List<Listener> getListeners();
|
protected abstract List<Listener> loadListeners();
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* All updatable classes.
|
* Useful for custom LangYml implementations.
|
||||||
|
* <p>
|
||||||
|
* Override if needed.
|
||||||
*
|
*
|
||||||
* @return A list of all updatable classes.
|
* @return lang.yml.
|
||||||
*/
|
*/
|
||||||
public List<Class<?>> getUpdatableClasses() {
|
protected LangYml createLangYml() {
|
||||||
return new ArrayList<>();
|
return new LangYml(this);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Useful for custom ConfigYml implementations.
|
||||||
|
* <p>
|
||||||
|
* Override if needed.
|
||||||
|
*
|
||||||
|
* @return config.yml.
|
||||||
|
*/
|
||||||
|
protected ConfigYml createConfigYml() {
|
||||||
|
return new ConfigYml(this);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -618,8 +623,8 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
*
|
*
|
||||||
* @return The version.
|
* @return The version.
|
||||||
*/
|
*/
|
||||||
protected String getMinimumEcoVersion() {
|
public String getMinimumEcoVersion() {
|
||||||
return "5.0.0";
|
return "6.0.0";
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -633,12 +638,25 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
return logger;
|
return logger;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a proxy.
|
||||||
|
*
|
||||||
|
* @param proxyClass The proxy class.
|
||||||
|
* @param <T> The proxy type.
|
||||||
|
* @return The proxy.
|
||||||
|
*/
|
||||||
|
public final <T extends AbstractProxy> T getProxy(@NotNull final Class<T> proxyClass) {
|
||||||
|
Validate.notNull(proxyFactory, "Plugin does not support proxy!");
|
||||||
|
|
||||||
|
return proxyFactory.getProxy(proxyClass);
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Get unwrapped config.
|
* Get unwrapped config.
|
||||||
* Does not use eco config system, don't use.
|
* Does not use eco config system, don't use.
|
||||||
*
|
*
|
||||||
* @return The bukkit config.
|
* @return The bukkit config.
|
||||||
* @deprecated Use {@link EcoPlugin#getConfigYml()} instead.
|
* @deprecated Use getConfigYml() instead.
|
||||||
*/
|
*/
|
||||||
@NotNull
|
@NotNull
|
||||||
@Override
|
@Override
|
||||||
@@ -646,7 +664,7 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
public final FileConfiguration getConfig() {
|
public final FileConfiguration getConfig() {
|
||||||
this.getLogger().warning("Call to default config method in eco plugin!");
|
this.getLogger().warning("Call to default config method in eco plugin!");
|
||||||
|
|
||||||
return this.getConfigYml().getHandle();
|
return this.getConfigYml().getBukkitHandle();
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -687,4 +705,23 @@ public abstract class EcoPlugin extends JavaPlugin {
|
|||||||
|
|
||||||
super.reloadConfig();
|
super.reloadConfig();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get an EcoPlugin by name.
|
||||||
|
*
|
||||||
|
* @param pluginName The name.
|
||||||
|
* @return The plugin.
|
||||||
|
*/
|
||||||
|
public static EcoPlugin getPlugin(@NotNull final String pluginName) {
|
||||||
|
return Eco.getHandler().getPluginByName(pluginName);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get all EcoPlugin names.
|
||||||
|
*
|
||||||
|
* @return The set of names.
|
||||||
|
*/
|
||||||
|
public static Set<String> getPluginNames() {
|
||||||
|
return new HashSet<>(Eco.getHandler().getLoadedPlugins());
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
234
eco-api/src/main/java/com/willfp/eco/core/Handler.java
Normal file
234
eco-api/src/main/java/com/willfp/eco/core/Handler.java
Normal file
@@ -0,0 +1,234 @@
|
|||||||
|
package com.willfp.eco.core;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.config.updating.ConfigHandler;
|
||||||
|
import com.willfp.eco.core.config.wrapper.ConfigFactory;
|
||||||
|
import com.willfp.eco.core.data.keys.KeyRegistry;
|
||||||
|
import com.willfp.eco.core.data.PlayerProfileHandler;
|
||||||
|
import com.willfp.eco.core.drops.DropQueueFactory;
|
||||||
|
import com.willfp.eco.core.events.EventManager;
|
||||||
|
import com.willfp.eco.core.extensions.ExtensionLoader;
|
||||||
|
import com.willfp.eco.core.factory.MetadataValueFactory;
|
||||||
|
import com.willfp.eco.core.factory.NamespacedKeyFactory;
|
||||||
|
import com.willfp.eco.core.factory.RunnableFactory;
|
||||||
|
import com.willfp.eco.core.fast.FastItemStack;
|
||||||
|
import com.willfp.eco.core.gui.GUIFactory;
|
||||||
|
import com.willfp.eco.core.integrations.placeholder.PlaceholderIntegration;
|
||||||
|
import com.willfp.eco.core.proxy.Cleaner;
|
||||||
|
import com.willfp.eco.core.proxy.ProxyFactory;
|
||||||
|
import com.willfp.eco.core.requirement.RequirementFactory;
|
||||||
|
import com.willfp.eco.core.scheduling.Scheduler;
|
||||||
|
import net.kyori.adventure.platform.bukkit.BukkitAudiences;
|
||||||
|
import org.bukkit.inventory.ItemStack;
|
||||||
|
import org.jetbrains.annotations.ApiStatus;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
import org.jetbrains.annotations.Nullable;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Eco#getHandler()
|
||||||
|
*/
|
||||||
|
@ApiStatus.Internal
|
||||||
|
public interface Handler {
|
||||||
|
/**
|
||||||
|
* Create a scheduler.
|
||||||
|
*
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @return The scheduler.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
Scheduler createScheduler(@NotNull EcoPlugin plugin);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create an event manager.
|
||||||
|
*
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @return The event manager.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
EventManager createEventManager(@NotNull EcoPlugin plugin);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a NamespacedKey factory.
|
||||||
|
*
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @return The factory.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
NamespacedKeyFactory createNamespacedKeyFactory(@NotNull EcoPlugin plugin);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a MetadataValue factory.
|
||||||
|
*
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @return The factory.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
MetadataValueFactory createMetadataValueFactory(@NotNull EcoPlugin plugin);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a Runnable factory.
|
||||||
|
*
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @return The factory.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
RunnableFactory createRunnableFactory(@NotNull EcoPlugin plugin);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create an ExtensionLoader.
|
||||||
|
*
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @return The factory.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
ExtensionLoader createExtensionLoader(@NotNull EcoPlugin plugin);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a config handler.
|
||||||
|
*
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @return The handler.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
ConfigHandler createConfigHandler(@NotNull EcoPlugin plugin);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a logger.
|
||||||
|
*
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @return The logger.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
Logger createLogger(@NotNull EcoPlugin plugin);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a PAPI integration.
|
||||||
|
*
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @return The integration.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
PlaceholderIntegration createPAPIIntegration(@NotNull EcoPlugin plugin);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a proxy factory.
|
||||||
|
*
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @return The factory.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
ProxyFactory createProxyFactory(@NotNull EcoPlugin plugin);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get eco Spigot plugin.
|
||||||
|
*
|
||||||
|
* @return The plugin.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
EcoPlugin getEcoPlugin();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get config factory.
|
||||||
|
*
|
||||||
|
* @return The factory.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
ConfigFactory getConfigFactory();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get drop queue factory.
|
||||||
|
*
|
||||||
|
* @return The factory.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
DropQueueFactory getDropQueueFactory();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get GUI factory.
|
||||||
|
*
|
||||||
|
* @return The factory.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
GUIFactory getGUIFactory();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get cleaner.
|
||||||
|
*
|
||||||
|
* @return The cleaner.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
Cleaner getCleaner();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add new plugin.
|
||||||
|
*
|
||||||
|
* @param plugin The plugin.
|
||||||
|
*/
|
||||||
|
void addNewPlugin(@NotNull EcoPlugin plugin);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get plugin by name.
|
||||||
|
*
|
||||||
|
* @param name The name.
|
||||||
|
* @return The plugin.
|
||||||
|
*/
|
||||||
|
@Nullable
|
||||||
|
EcoPlugin getPluginByName(@NotNull String name);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get all loaded eco plugins.
|
||||||
|
*
|
||||||
|
* @return A list of plugin names in lowercase.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
List<String> getLoadedPlugins();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a FastItemStack.
|
||||||
|
*
|
||||||
|
* @param itemStack The base ItemStack.
|
||||||
|
* @return The FastItemStack.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
FastItemStack createFastItemStack(@NotNull ItemStack itemStack);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Register bStats metrics.
|
||||||
|
*
|
||||||
|
* @param plugin The plugin.
|
||||||
|
*/
|
||||||
|
void registerBStats(@NotNull EcoPlugin plugin);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the requirement factory.
|
||||||
|
*
|
||||||
|
* @return The factory.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
RequirementFactory getRequirementFactory();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get Adventure audiences.
|
||||||
|
*
|
||||||
|
* @return The audiences.
|
||||||
|
*/
|
||||||
|
@Nullable
|
||||||
|
BukkitAudiences getAdventure();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the key registry.
|
||||||
|
*
|
||||||
|
* @return The registry.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
KeyRegistry getKeyRegistry();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the PlayerProfile handler.
|
||||||
|
*
|
||||||
|
* @return The handler.
|
||||||
|
*/
|
||||||
|
PlayerProfileHandler getPlayerProfileHandler();
|
||||||
|
}
|
||||||
@@ -4,11 +4,17 @@ import lombok.AccessLevel;
|
|||||||
import lombok.Getter;
|
import lombok.Getter;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Quick DI class to manage passing eco plugins.
|
||||||
|
*
|
||||||
|
* @param <T> The eco plugin type.
|
||||||
|
*/
|
||||||
public abstract class PluginDependent<T extends EcoPlugin> {
|
public abstract class PluginDependent<T extends EcoPlugin> {
|
||||||
/**
|
/**
|
||||||
* The {@link EcoPlugin} that is stored.
|
* The {@link EcoPlugin} that is stored.
|
||||||
*/
|
*/
|
||||||
@Getter(AccessLevel.PROTECTED)
|
@Getter(AccessLevel.PROTECTED)
|
||||||
|
@NotNull
|
||||||
private final T plugin;
|
private final T plugin;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
29
eco-api/src/main/java/com/willfp/eco/core/PluginLike.java
Normal file
29
eco-api/src/main/java/com/willfp/eco/core/PluginLike.java
Normal file
@@ -0,0 +1,29 @@
|
|||||||
|
package com.willfp.eco.core;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.config.updating.ConfigHandler;
|
||||||
|
|
||||||
|
import java.io.File;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Represents any class that acts like a plugin, for example {@link EcoPlugin}
|
||||||
|
* or {@link com.willfp.eco.core.extensions.Extension}. This exists to create
|
||||||
|
* things such as extension base configs rather than needing to pass an instance
|
||||||
|
* of the owning plugin.
|
||||||
|
*/
|
||||||
|
public interface PluginLike {
|
||||||
|
/**
|
||||||
|
* Get the data folder of the object.
|
||||||
|
* <p>
|
||||||
|
* Returns the plugin data folder for a plugin, or the extension's parent plugin's folder
|
||||||
|
*
|
||||||
|
* @return The data folder.
|
||||||
|
*/
|
||||||
|
File getDataFolder();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the handler class for updatable classes.
|
||||||
|
*
|
||||||
|
* @return The config handler.
|
||||||
|
*/
|
||||||
|
ConfigHandler getConfigHandler();
|
||||||
|
}
|
||||||
@@ -10,6 +10,12 @@ import java.util.Arrays;
|
|||||||
import java.util.List;
|
import java.util.List;
|
||||||
import java.util.function.Supplier;
|
import java.util.function.Supplier;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A prerequisite is a requirement for something.
|
||||||
|
* <p>
|
||||||
|
* For example, you can require the server to have paper or be a specific version,
|
||||||
|
* or have some other dependency.
|
||||||
|
*/
|
||||||
public class Prerequisite {
|
public class Prerequisite {
|
||||||
/**
|
/**
|
||||||
* All existing prerequisites are registered on creation.
|
* All existing prerequisites are registered on creation.
|
||||||
@@ -25,12 +31,11 @@ public class Prerequisite {
|
|||||||
);
|
);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Requires the server to be running 1.17.
|
* Requires the server to be running an implementation of paper.
|
||||||
*/
|
*/
|
||||||
@Deprecated
|
public static final Prerequisite HAS_VAULT = new Prerequisite(
|
||||||
public static final Prerequisite v1_17 = new Prerequisite(
|
() -> ClassUtils.exists("net.milkbowl.vault.economy.Economy"),
|
||||||
() -> ProxyConstants.NMS_VERSION.contains("17"),
|
"Requires server to have vault"
|
||||||
"Requires server to be running 1.17+"
|
|
||||||
);
|
);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -1,156 +0,0 @@
|
|||||||
package com.willfp.eco.core.command;
|
|
||||||
|
|
||||||
import com.willfp.eco.core.PluginDependent;
|
|
||||||
import com.willfp.eco.core.EcoPlugin;
|
|
||||||
import org.bukkit.Bukkit;
|
|
||||||
import org.bukkit.command.Command;
|
|
||||||
import org.bukkit.command.CommandExecutor;
|
|
||||||
import org.bukkit.command.CommandSender;
|
|
||||||
import org.bukkit.command.PluginCommand;
|
|
||||||
import org.bukkit.entity.Player;
|
|
||||||
import org.jetbrains.annotations.NotNull;
|
|
||||||
import org.jetbrains.annotations.Nullable;
|
|
||||||
|
|
||||||
import java.util.Arrays;
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
@Deprecated
|
|
||||||
@SuppressWarnings("DeprecatedIsStillUsed")
|
|
||||||
public abstract class AbstractCommand extends PluginDependent<EcoPlugin> implements CommandExecutor {
|
|
||||||
/**
|
|
||||||
* The name of the command
|
|
||||||
* <p>
|
|
||||||
* i.e. the name used on execution, for example /enchantinfo would have the name enchantinfo.
|
|
||||||
*/
|
|
||||||
private final String name;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* The permission required to execute the command.
|
|
||||||
* <p>
|
|
||||||
* Written out as a string for flexibility with subclasses.
|
|
||||||
*/
|
|
||||||
private final String permission;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Should the command only be allowed to be executed by players?
|
|
||||||
* <p>
|
|
||||||
* In other worlds, only allowed to be executed by console.
|
|
||||||
*/
|
|
||||||
private final boolean playersOnly;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create a new command.
|
|
||||||
* <p>
|
|
||||||
* The command will not be registered until {@link this#register()} is called.
|
|
||||||
* <p>
|
|
||||||
* The name cannot be the same as an existing command as this will conflict.
|
|
||||||
*
|
|
||||||
* @param plugin The owning {@link EcoPlugin}.
|
|
||||||
* @param name The name used in execution.
|
|
||||||
* @param permission The permission required to execute the command.
|
|
||||||
* @param playersOnly If only players should be able to execute this command.
|
|
||||||
*/
|
|
||||||
protected AbstractCommand(@NotNull final EcoPlugin plugin,
|
|
||||||
@NotNull final String name,
|
|
||||||
@NotNull final String permission,
|
|
||||||
final boolean playersOnly) {
|
|
||||||
super(plugin);
|
|
||||||
this.name = name;
|
|
||||||
this.permission = permission;
|
|
||||||
this.playersOnly = playersOnly;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the {@link AbstractTabCompleter} associated with this command.
|
|
||||||
* <p>
|
|
||||||
* Implementations of {@link AbstractCommand} do not have to override this method:
|
|
||||||
* null represents no associated tab-completer.
|
|
||||||
*
|
|
||||||
* @return The associated {@link AbstractTabCompleter}, or null if none associated.
|
|
||||||
*/
|
|
||||||
public @Nullable AbstractTabCompleter getTab() {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the name of the permission required to execute this command.
|
|
||||||
*
|
|
||||||
* @return The name of the permission.
|
|
||||||
*/
|
|
||||||
public String getPermission() {
|
|
||||||
return this.permission;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the name of the command used in execution.
|
|
||||||
*
|
|
||||||
* @return The command name.
|
|
||||||
*/
|
|
||||||
public String getName() {
|
|
||||||
return this.name;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Internal implementation used to clean up boilerplate.
|
|
||||||
* Used for parity with {@link CommandExecutor#onCommand(CommandSender, Command, String, String[])}.
|
|
||||||
* <p>
|
|
||||||
* Calls {@link this#onExecute(CommandSender, List)}.
|
|
||||||
*
|
|
||||||
* @param sender The executor of the command.
|
|
||||||
* @param command The bukkit command.
|
|
||||||
* @param label The name of the executed command.
|
|
||||||
* @param args The arguments of the command (anything after the physical command name)
|
|
||||||
* @return If the command was processed by the linked {@link EcoPlugin}
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public final boolean onCommand(@NotNull final CommandSender sender,
|
|
||||||
@NotNull final Command command,
|
|
||||||
@NotNull final String label,
|
|
||||||
@NotNull final String[] args) {
|
|
||||||
if (!command.getName().equalsIgnoreCase(name)) {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (playersOnly && !(sender instanceof Player)) {
|
|
||||||
sender.sendMessage(this.getPlugin().getLangYml().getMessage("not-player"));
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!sender.hasPermission(permission) && sender instanceof Player) {
|
|
||||||
sender.sendMessage(this.getPlugin().getLangYml().getNoPermission());
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
onExecute(sender, Arrays.asList(args));
|
|
||||||
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Registers the command with the server,
|
|
||||||
* <p>
|
|
||||||
* Requires the command name to exist, defined in plugin.yml.
|
|
||||||
*/
|
|
||||||
public final void register() {
|
|
||||||
PluginCommand command = Bukkit.getPluginCommand(name);
|
|
||||||
assert command != null;
|
|
||||||
command.setExecutor(this);
|
|
||||||
|
|
||||||
AbstractTabCompleter tabCompleter = this.getTab();
|
|
||||||
if (tabCompleter != null) {
|
|
||||||
command.setTabCompleter(tabCompleter);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* The code for the execution of the command (The actual functionality).
|
|
||||||
* <p>
|
|
||||||
* Unlike {@link this#onCommand(CommandSender, Command, String, String[])},
|
|
||||||
* this does not return a value as the command <b>will</b> have been processed.
|
|
||||||
*
|
|
||||||
* @param sender The sender of the command
|
|
||||||
* @param args The arguments of the command
|
|
||||||
*/
|
|
||||||
protected abstract void onExecute(CommandSender sender,
|
|
||||||
List<String> args);
|
|
||||||
}
|
|
||||||
@@ -1,66 +0,0 @@
|
|||||||
package com.willfp.eco.core.command;
|
|
||||||
|
|
||||||
import org.bukkit.command.Command;
|
|
||||||
import org.bukkit.command.CommandSender;
|
|
||||||
import org.bukkit.command.TabCompleter;
|
|
||||||
import org.jetbrains.annotations.NotNull;
|
|
||||||
import org.jetbrains.annotations.Nullable;
|
|
||||||
|
|
||||||
import java.util.Arrays;
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
@Deprecated
|
|
||||||
public abstract class AbstractTabCompleter implements TabCompleter {
|
|
||||||
/**
|
|
||||||
* The {@link AbstractCommand} that is tab-completed.
|
|
||||||
*/
|
|
||||||
private final AbstractCommand command;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create a tab-completer for a specified {@link AbstractCommand}.
|
|
||||||
*
|
|
||||||
* @param command The command to tab-complete.
|
|
||||||
*/
|
|
||||||
protected AbstractTabCompleter(@NotNull final AbstractCommand command) {
|
|
||||||
this.command = command;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Internal implementation used to clean up boilerplate.
|
|
||||||
* Used for parity with {@link TabCompleter#onTabComplete(CommandSender, Command, String, String[])}.
|
|
||||||
* <p>
|
|
||||||
* Calls {@link this#onTab(CommandSender, List)}.
|
|
||||||
*
|
|
||||||
* @param sender The executor of the command.
|
|
||||||
* @param command The bukkit command.
|
|
||||||
* @param label The name of the executed command.
|
|
||||||
* @param args The arguments of the command (anything after the physical command name).
|
|
||||||
* @return The list of tab-completions.
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public @Nullable List<String> onTabComplete(@NotNull final CommandSender sender,
|
|
||||||
@NotNull final Command command,
|
|
||||||
@NotNull final String label,
|
|
||||||
@NotNull final String[] args) {
|
|
||||||
if (!command.getName().equalsIgnoreCase(this.command.getName())) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!sender.hasPermission(this.command.getPermission())) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
return onTab(sender, Arrays.asList(args));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* The code for the tab-completion of the command (The actual functionality).
|
|
||||||
* <p>
|
|
||||||
*
|
|
||||||
* @param sender The sender of the command.
|
|
||||||
* @param args The arguments of the command.
|
|
||||||
* @return The list of tab-completions.
|
|
||||||
*/
|
|
||||||
public abstract List<String> onTab(@NotNull CommandSender sender,
|
|
||||||
@NotNull List<String> args);
|
|
||||||
}
|
|
||||||
@@ -2,6 +2,9 @@ package com.willfp.eco.core.command;
|
|||||||
|
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Interface for all command implementations.
|
||||||
|
*/
|
||||||
public interface CommandBase {
|
public interface CommandBase {
|
||||||
/**
|
/**
|
||||||
* Get command name.
|
* Get command name.
|
||||||
@@ -39,10 +42,24 @@ public interface CommandBase {
|
|||||||
*/
|
*/
|
||||||
CommandHandler getHandler();
|
CommandHandler getHandler();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the handler.
|
||||||
|
*
|
||||||
|
* @param handler The handler.
|
||||||
|
*/
|
||||||
|
void setHandler(@NotNull CommandHandler handler);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Get the tab completer.
|
* Get the tab completer.
|
||||||
*
|
*
|
||||||
* @return The tab completer.
|
* @return The tab completer.
|
||||||
*/
|
*/
|
||||||
TabCompleteHandler getTabCompleter();
|
TabCompleteHandler getTabCompleter();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the tab completer.
|
||||||
|
*
|
||||||
|
* @param handler The handler.
|
||||||
|
*/
|
||||||
|
void setTabCompleter(@NotNull TabCompleteHandler handler);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,10 +1,17 @@
|
|||||||
package com.willfp.eco.core.command;
|
package com.willfp.eco.core.command;
|
||||||
|
|
||||||
|
import org.bukkit.command.Command;
|
||||||
import org.bukkit.command.CommandSender;
|
import org.bukkit.command.CommandSender;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A command handler handles the actual code for a command.
|
||||||
|
* <p>
|
||||||
|
* The replacement for {@link org.bukkit.command.CommandExecutor#onCommand(CommandSender, Command, String, String[])}
|
||||||
|
* @see CommandBase
|
||||||
|
*/
|
||||||
@FunctionalInterface
|
@FunctionalInterface
|
||||||
public interface CommandHandler {
|
public interface CommandHandler {
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -1,10 +1,17 @@
|
|||||||
package com.willfp.eco.core.command;
|
package com.willfp.eco.core.command;
|
||||||
|
|
||||||
|
import org.bukkit.command.Command;
|
||||||
import org.bukkit.command.CommandSender;
|
import org.bukkit.command.CommandSender;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A Tab Complete handler handles the actual tab-completion code.
|
||||||
|
* <p>
|
||||||
|
* The replacement for {@link org.bukkit.command.TabCompleter#onTabComplete(CommandSender, Command, String, String[])}
|
||||||
|
* @see CommandBase
|
||||||
|
*/
|
||||||
@FunctionalInterface
|
@FunctionalInterface
|
||||||
public interface TabCompleteHandler {
|
public interface TabCompleteHandler {
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -1,14 +1,15 @@
|
|||||||
package com.willfp.eco.internal.commands;
|
package com.willfp.eco.core.command.impl;
|
||||||
|
|
||||||
import com.willfp.eco.core.EcoPlugin;
|
import com.willfp.eco.core.EcoPlugin;
|
||||||
import com.willfp.eco.core.PluginDependent;
|
import com.willfp.eco.core.PluginDependent;
|
||||||
import com.willfp.eco.core.command.CommandBase;
|
import com.willfp.eco.core.command.CommandBase;
|
||||||
import com.willfp.eco.core.command.CommandHandler;
|
import com.willfp.eco.core.command.CommandHandler;
|
||||||
import com.willfp.eco.core.command.TabCompleteHandler;
|
import com.willfp.eco.core.command.TabCompleteHandler;
|
||||||
import com.willfp.eco.internal.commands.util.CommandUtils;
|
|
||||||
import lombok.AccessLevel;
|
import lombok.AccessLevel;
|
||||||
import lombok.Getter;
|
import lombok.Getter;
|
||||||
|
import lombok.Setter;
|
||||||
import org.bukkit.command.CommandSender;
|
import org.bukkit.command.CommandSender;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
import org.bukkit.util.StringUtil;
|
import org.bukkit.util.StringUtil;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
@@ -18,7 +19,14 @@ import java.util.Collections;
|
|||||||
import java.util.List;
|
import java.util.List;
|
||||||
import java.util.stream.Collectors;
|
import java.util.stream.Collectors;
|
||||||
|
|
||||||
public abstract class HandledCommand extends PluginDependent<EcoPlugin> implements CommandBase {
|
/**
|
||||||
|
* Abstract class for commands that can be handled.
|
||||||
|
* <p>
|
||||||
|
* Handled commands have a method to pass in raw input from bukkit commands
|
||||||
|
* in order to execute the command-specific code. It's essentially an internal
|
||||||
|
* layer, hence why it's a package-private class.
|
||||||
|
*/
|
||||||
|
abstract class HandledCommand extends PluginDependent<EcoPlugin> implements CommandBase {
|
||||||
/**
|
/**
|
||||||
* The name of the command.
|
* The name of the command.
|
||||||
*/
|
*/
|
||||||
@@ -41,6 +49,20 @@ public abstract class HandledCommand extends PluginDependent<EcoPlugin> implemen
|
|||||||
@Getter
|
@Getter
|
||||||
private final boolean playersOnly;
|
private final boolean playersOnly;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The actual code to be executed in the command.
|
||||||
|
*/
|
||||||
|
@Getter
|
||||||
|
@Setter
|
||||||
|
private CommandHandler handler = (sender, args) -> { };
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The tab completion code to be executed in the command.
|
||||||
|
*/
|
||||||
|
@Getter
|
||||||
|
@Setter
|
||||||
|
private TabCompleteHandler tabCompleter = (sender, args) -> new ArrayList<>();
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* All subcommands for the command.
|
* All subcommands for the command.
|
||||||
*/
|
*/
|
||||||
@@ -57,7 +79,7 @@ public abstract class HandledCommand extends PluginDependent<EcoPlugin> implemen
|
|||||||
* @param permission The permission required to execute the command.
|
* @param permission The permission required to execute the command.
|
||||||
* @param playersOnly If only players should be able to execute this command.
|
* @param playersOnly If only players should be able to execute this command.
|
||||||
*/
|
*/
|
||||||
protected HandledCommand(@NotNull final EcoPlugin plugin,
|
HandledCommand(@NotNull final EcoPlugin plugin,
|
||||||
@NotNull final String name,
|
@NotNull final String name,
|
||||||
@NotNull final String permission,
|
@NotNull final String permission,
|
||||||
final boolean playersOnly) {
|
final boolean playersOnly) {
|
||||||
@@ -89,14 +111,14 @@ public abstract class HandledCommand extends PluginDependent<EcoPlugin> implemen
|
|||||||
*/
|
*/
|
||||||
protected final void handle(@NotNull final CommandSender sender,
|
protected final void handle(@NotNull final CommandSender sender,
|
||||||
@NotNull final String[] args) {
|
@NotNull final String[] args) {
|
||||||
if (!CommandUtils.canExecute(sender, this, this.getPlugin())) {
|
if (!canExecute(sender, this, this.getPlugin())) {
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
if (args.length > 0) {
|
if (args.length > 0) {
|
||||||
for (CommandBase subcommand : this.getSubcommands()) {
|
for (CommandBase subcommand : this.getSubcommands()) {
|
||||||
if (subcommand.getName().equalsIgnoreCase(args[0])) {
|
if (subcommand.getName().equalsIgnoreCase(args[0])) {
|
||||||
if (!CommandUtils.canExecute(sender, subcommand, this.getPlugin())) {
|
if (!canExecute(sender, subcommand, this.getPlugin())) {
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -115,6 +137,7 @@ public abstract class HandledCommand extends PluginDependent<EcoPlugin> implemen
|
|||||||
*
|
*
|
||||||
* @param sender The sender.
|
* @param sender The sender.
|
||||||
* @param args The arguments.
|
* @param args The arguments.
|
||||||
|
* @return The tab completion results.
|
||||||
*/
|
*/
|
||||||
protected final List<String> handleTabCompletion(@NotNull final CommandSender sender,
|
protected final List<String> handleTabCompletion(@NotNull final CommandSender sender,
|
||||||
@NotNull final String[] args) {
|
@NotNull final String[] args) {
|
||||||
@@ -156,11 +179,27 @@ public abstract class HandledCommand extends PluginDependent<EcoPlugin> implemen
|
|||||||
return this.getTabCompleter().tabComplete(sender, Arrays.asList(args));
|
return this.getTabCompleter().tabComplete(sender, Arrays.asList(args));
|
||||||
}
|
}
|
||||||
|
|
||||||
@Override
|
/**
|
||||||
public abstract CommandHandler getHandler();
|
* If a sender can execute the command.
|
||||||
|
*
|
||||||
|
* @param sender The sender.
|
||||||
|
* @param command The command.
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @return If the sender can execute.
|
||||||
|
*/
|
||||||
|
public static boolean canExecute(@NotNull final CommandSender sender,
|
||||||
|
@NotNull final CommandBase command,
|
||||||
|
@NotNull final EcoPlugin plugin) {
|
||||||
|
if (command.isPlayersOnly() && !(sender instanceof Player)) {
|
||||||
|
sender.sendMessage(plugin.getLangYml().getMessage("not-player"));
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
@Override
|
if (!sender.hasPermission(command.getPermission()) && sender instanceof Player) {
|
||||||
public TabCompleteHandler getTabCompleter() {
|
sender.sendMessage(plugin.getLangYml().getNoPermission());
|
||||||
return (sender, args) -> new ArrayList<>();
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
return true;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -1,7 +1,6 @@
|
|||||||
package com.willfp.eco.core.command.impl;
|
package com.willfp.eco.core.command.impl;
|
||||||
|
|
||||||
import com.willfp.eco.core.EcoPlugin;
|
import com.willfp.eco.core.EcoPlugin;
|
||||||
import com.willfp.eco.internal.commands.HandledCommand;
|
|
||||||
import org.bukkit.Bukkit;
|
import org.bukkit.Bukkit;
|
||||||
import org.bukkit.command.Command;
|
import org.bukkit.command.Command;
|
||||||
import org.bukkit.command.CommandExecutor;
|
import org.bukkit.command.CommandExecutor;
|
||||||
@@ -12,13 +11,16 @@ import org.jetbrains.annotations.Nullable;
|
|||||||
|
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* PluginCommands are the class to be used instead of CommandExecutor.
|
||||||
|
* <p>
|
||||||
|
* The command will not be registered until register() is called.
|
||||||
|
* <p>
|
||||||
|
* The name cannot be the same as an existing command as this will conflict.
|
||||||
|
*/
|
||||||
public abstract class PluginCommand extends HandledCommand implements CommandExecutor, TabCompleter {
|
public abstract class PluginCommand extends HandledCommand implements CommandExecutor, TabCompleter {
|
||||||
/**
|
/**
|
||||||
* Create a new command.
|
* Create a new command.
|
||||||
* <p>
|
|
||||||
* The command will not be registered until {@link this#register()} is called.
|
|
||||||
* <p>
|
|
||||||
* The name cannot be the same as an existing command as this will conflict.
|
|
||||||
*
|
*
|
||||||
* @param plugin The plugin.
|
* @param plugin The plugin.
|
||||||
* @param name The name used in execution.
|
* @param name The name used in execution.
|
||||||
|
|||||||
@@ -2,9 +2,11 @@ package com.willfp.eco.core.command.impl;
|
|||||||
|
|
||||||
import com.willfp.eco.core.EcoPlugin;
|
import com.willfp.eco.core.EcoPlugin;
|
||||||
import com.willfp.eco.core.command.CommandBase;
|
import com.willfp.eco.core.command.CommandBase;
|
||||||
import com.willfp.eco.internal.commands.HandledCommand;
|
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Subcommands can be added to PluginCommands or to other Subcommands.
|
||||||
|
*/
|
||||||
public abstract class Subcommand extends HandledCommand {
|
public abstract class Subcommand extends HandledCommand {
|
||||||
/**
|
/**
|
||||||
* Create subcommand.
|
* Create subcommand.
|
||||||
|
|||||||
@@ -1,40 +0,0 @@
|
|||||||
package com.willfp.eco.core.config;
|
|
||||||
|
|
||||||
import com.willfp.eco.internal.config.yaml.UpdatableYamlConfig;
|
|
||||||
import com.willfp.eco.core.EcoPlugin;
|
|
||||||
import org.jetbrains.annotations.NotNull;
|
|
||||||
|
|
||||||
public abstract class BaseConfig extends UpdatableYamlConfig {
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Config implementation for configs present in the plugin's base directory (eg config.yml, lang.yml).
|
|
||||||
* <p>
|
|
||||||
* Automatically updates.
|
|
||||||
*
|
|
||||||
* @param configName The name of the config
|
|
||||||
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
|
||||||
* @param plugin The plugin.
|
|
||||||
* @param updateBlacklist Substring of keys to not add/remove keys for.
|
|
||||||
*/
|
|
||||||
protected BaseConfig(@NotNull final String configName,
|
|
||||||
final boolean removeUnused,
|
|
||||||
@NotNull final EcoPlugin plugin,
|
|
||||||
@NotNull final String... updateBlacklist) {
|
|
||||||
super(configName, plugin, "", plugin.getClass(), removeUnused, updateBlacklist);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Config implementation for configs present in the plugin's base directory (eg config.yml, lang.yml).
|
|
||||||
* <p>
|
|
||||||
* Automatically updates.
|
|
||||||
*
|
|
||||||
* @param configName The name of the config
|
|
||||||
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
|
||||||
* @param plugin The plugin.
|
|
||||||
*/
|
|
||||||
protected BaseConfig(@NotNull final String configName,
|
|
||||||
final boolean removeUnused,
|
|
||||||
@NotNull final EcoPlugin plugin) {
|
|
||||||
super(configName, plugin, "", plugin.getClass(), removeUnused, "");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
package com.willfp.eco.core.config;
|
|
||||||
|
|
||||||
import java.lang.annotation.ElementType;
|
|
||||||
import java.lang.annotation.Retention;
|
|
||||||
import java.lang.annotation.RetentionPolicy;
|
|
||||||
import java.lang.annotation.Target;
|
|
||||||
|
|
||||||
@Retention(RetentionPolicy.RUNTIME)
|
|
||||||
@Target(ElementType.METHOD)
|
|
||||||
public @interface ConfigUpdater {
|
|
||||||
}
|
|
||||||
@@ -1,28 +0,0 @@
|
|||||||
package com.willfp.eco.core.config;
|
|
||||||
|
|
||||||
import com.willfp.eco.internal.config.yaml.UpdatableYamlConfig;
|
|
||||||
import com.willfp.eco.core.EcoPlugin;
|
|
||||||
import org.jetbrains.annotations.NotNull;
|
|
||||||
|
|
||||||
public abstract class ExtendableConfig extends UpdatableYamlConfig {
|
|
||||||
/**
|
|
||||||
* Config implementation for configs present in the plugin's base directory (eg config.yml, lang.yml).
|
|
||||||
* <p>
|
|
||||||
* Automatically updates.
|
|
||||||
*
|
|
||||||
* @param configName The name of the config
|
|
||||||
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
|
||||||
* @param plugin The plugin.
|
|
||||||
* @param updateBlacklist Substring of keys to not add/remove keys for.
|
|
||||||
* @param subDirectoryPath The subdirectory path.
|
|
||||||
* @param source The class that owns the resource.
|
|
||||||
*/
|
|
||||||
protected ExtendableConfig(@NotNull final String configName,
|
|
||||||
final boolean removeUnused,
|
|
||||||
@NotNull final EcoPlugin plugin,
|
|
||||||
@NotNull final Class<?> source,
|
|
||||||
@NotNull final String subDirectoryPath,
|
|
||||||
@NotNull final String... updateBlacklist) {
|
|
||||||
super(configName, plugin, subDirectoryPath, source, removeUnused, updateBlacklist);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,20 +0,0 @@
|
|||||||
package com.willfp.eco.core.config;
|
|
||||||
|
|
||||||
import com.willfp.eco.core.EcoPlugin;
|
|
||||||
import com.willfp.eco.internal.config.json.LoadableJsonConfig;
|
|
||||||
import org.jetbrains.annotations.NotNull;
|
|
||||||
|
|
||||||
public abstract class JsonStaticBaseConfig extends LoadableJsonConfig {
|
|
||||||
/**
|
|
||||||
* Config implementation for configs present in the plugin's base directory (eg config.json, lang.json).
|
|
||||||
* <p>
|
|
||||||
* Does not automatically update.
|
|
||||||
*
|
|
||||||
* @param configName The name of the config
|
|
||||||
* @param plugin The plugin.
|
|
||||||
*/
|
|
||||||
protected JsonStaticBaseConfig(@NotNull final String configName,
|
|
||||||
@NotNull final EcoPlugin plugin) {
|
|
||||||
super(configName, plugin, "", plugin.getClass());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,20 +0,0 @@
|
|||||||
package com.willfp.eco.core.config;
|
|
||||||
|
|
||||||
import com.willfp.eco.internal.config.yaml.LoadableYamlConfig;
|
|
||||||
import com.willfp.eco.core.EcoPlugin;
|
|
||||||
import org.jetbrains.annotations.NotNull;
|
|
||||||
|
|
||||||
public abstract class StaticBaseConfig extends LoadableYamlConfig {
|
|
||||||
/**
|
|
||||||
* Config implementation for configs present in the plugin's base directory (eg config.yml, lang.yml).
|
|
||||||
* <p>
|
|
||||||
* Does not automatically update.
|
|
||||||
*
|
|
||||||
* @param configName The name of the config
|
|
||||||
* @param plugin The plugin.
|
|
||||||
*/
|
|
||||||
protected StaticBaseConfig(@NotNull final String configName,
|
|
||||||
@NotNull final EcoPlugin plugin) {
|
|
||||||
super(configName, plugin, "", plugin.getClass());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,18 +0,0 @@
|
|||||||
package com.willfp.eco.core.config;
|
|
||||||
|
|
||||||
import com.willfp.eco.internal.config.yaml.YamlConfigWrapper;
|
|
||||||
import org.bukkit.configuration.file.YamlConfiguration;
|
|
||||||
import org.jetbrains.annotations.NotNull;
|
|
||||||
|
|
||||||
public abstract class YamlConfig extends YamlConfigWrapper<YamlConfiguration> {
|
|
||||||
/**
|
|
||||||
* Config implementation for passing YamlConfigurations.
|
|
||||||
* <p>
|
|
||||||
* Does not automatically update.
|
|
||||||
*
|
|
||||||
* @param config The YamlConfiguration handle.
|
|
||||||
*/
|
|
||||||
public YamlConfig(@NotNull final YamlConfiguration config) {
|
|
||||||
init(config);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,11 +1,13 @@
|
|||||||
package com.willfp.eco.core.config.base;
|
package com.willfp.eco.core.config.base;
|
||||||
|
|
||||||
import com.willfp.eco.core.config.BaseConfig;
|
|
||||||
import com.willfp.eco.core.EcoPlugin;
|
import com.willfp.eco.core.EcoPlugin;
|
||||||
|
import com.willfp.eco.core.config.yaml.YamlBaseConfig;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
public class ConfigYml extends BaseConfig {
|
* Default plugin config.yml.
|
||||||
|
*/
|
||||||
|
public class ConfigYml extends YamlBaseConfig {
|
||||||
/**
|
/**
|
||||||
* Config.yml.
|
* Config.yml.
|
||||||
*
|
*
|
||||||
|
|||||||
@@ -1,10 +1,14 @@
|
|||||||
package com.willfp.eco.core.config.base;
|
package com.willfp.eco.core.config.base;
|
||||||
|
|
||||||
import com.willfp.eco.core.config.BaseConfig;
|
|
||||||
import com.willfp.eco.core.EcoPlugin;
|
import com.willfp.eco.core.EcoPlugin;
|
||||||
|
import com.willfp.eco.core.config.yaml.YamlBaseConfig;
|
||||||
|
import com.willfp.eco.util.StringUtils;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
public class LangYml extends BaseConfig {
|
/**
|
||||||
|
* Default plugin lang.yml.
|
||||||
|
*/
|
||||||
|
public class LangYml extends YamlBaseConfig {
|
||||||
/**
|
/**
|
||||||
* Lang.yml.
|
* Lang.yml.
|
||||||
*
|
*
|
||||||
@@ -39,6 +43,18 @@ public class LangYml extends BaseConfig {
|
|||||||
* @return The message with a prefix appended.
|
* @return The message with a prefix appended.
|
||||||
*/
|
*/
|
||||||
public String getMessage(@NotNull final String message) {
|
public String getMessage(@NotNull final String message) {
|
||||||
return getPrefix() + this.getString("messages." + message);
|
return getMessage(message, StringUtils.FormatOption.WITH_PLACEHOLDERS);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a chat message.
|
||||||
|
*
|
||||||
|
* @param message The key of the message.
|
||||||
|
* @param option The format options.
|
||||||
|
* @return The message with a prefix appended.
|
||||||
|
*/
|
||||||
|
public String getMessage(@NotNull final String message,
|
||||||
|
@NotNull final StringUtils.FormatOption option) {
|
||||||
|
return getPrefix() + this.getString("messages." + message, option);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,11 +1,17 @@
|
|||||||
package com.willfp.eco.core.config;
|
package com.willfp.eco.core.config.interfaces;
|
||||||
|
|
||||||
|
import com.willfp.eco.util.StringUtils;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
import org.jetbrains.annotations.Nullable;
|
import org.jetbrains.annotations.Nullable;
|
||||||
|
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
|
|
||||||
public interface Config {
|
/**
|
||||||
|
* All canfigs implement this interface.
|
||||||
|
* <p>
|
||||||
|
* Contains all methods that must exist in yaml and json configurations.
|
||||||
|
*/
|
||||||
|
public interface Config extends Cloneable {
|
||||||
/**
|
/**
|
||||||
* Clears cache.
|
* Clears cache.
|
||||||
*/
|
*/
|
||||||
@@ -160,7 +166,48 @@ public interface Config {
|
|||||||
* @return The found value, or an empty string if not found.
|
* @return The found value, or an empty string if not found.
|
||||||
*/
|
*/
|
||||||
@NotNull
|
@NotNull
|
||||||
String getString(@NotNull String path);
|
default String getString(@NotNull String path) {
|
||||||
|
return getString(path, true);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a string from config.
|
||||||
|
*
|
||||||
|
* @param path The key to fetch the value from.
|
||||||
|
* @param format If the string should be formatted.
|
||||||
|
* @return The found value, or an empty string if not found.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
default String getString(@NotNull String path,
|
||||||
|
boolean format) {
|
||||||
|
return this.getString(path, format, StringUtils.FormatOption.WITH_PLACEHOLDERS);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a string from config.
|
||||||
|
*
|
||||||
|
* @param path The key to fetch the value from.
|
||||||
|
* @param option The format option.
|
||||||
|
* @return The found value, or an empty string if not found.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
default String getString(@NotNull String path,
|
||||||
|
@NotNull final StringUtils.FormatOption option) {
|
||||||
|
return this.getString(path, true, option);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a string from config.
|
||||||
|
*
|
||||||
|
* @param path The key to fetch the value from.
|
||||||
|
* @param format If the string should be formatted.
|
||||||
|
* @param option The format option.
|
||||||
|
* @return The found value, or an empty string if not found.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
String getString(@NotNull String path,
|
||||||
|
boolean format,
|
||||||
|
@NotNull StringUtils.FormatOption option);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Get a string from config.
|
* Get a string from config.
|
||||||
@@ -169,7 +216,48 @@ public interface Config {
|
|||||||
* @return The found value, or null if not found.
|
* @return The found value, or null if not found.
|
||||||
*/
|
*/
|
||||||
@Nullable
|
@Nullable
|
||||||
String getStringOrNull(@NotNull String path);
|
default String getStringOrNull(@NotNull String path) {
|
||||||
|
return getStringOrNull(path, true);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a string from config.
|
||||||
|
*
|
||||||
|
* @param path The key to fetch the value from.
|
||||||
|
* @param format If the string should be formatted.
|
||||||
|
* @return The found value, or null if not found.
|
||||||
|
*/
|
||||||
|
@Nullable
|
||||||
|
default String getStringOrNull(@NotNull String path,
|
||||||
|
boolean format) {
|
||||||
|
return this.getStringOrNull(path, format, StringUtils.FormatOption.WITH_PLACEHOLDERS);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a string from config.
|
||||||
|
*
|
||||||
|
* @param path The key to fetch the value from.
|
||||||
|
* @param option The format option.
|
||||||
|
* @return The found value, or null if not found.
|
||||||
|
*/
|
||||||
|
@Nullable
|
||||||
|
default String getStringOrNull(@NotNull String path,
|
||||||
|
@NotNull StringUtils.FormatOption option) {
|
||||||
|
return this.getStringOrNull(path, true, option);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a string from config.
|
||||||
|
*
|
||||||
|
* @param path The key to fetch the value from.
|
||||||
|
* @param format If the string should be formatted.
|
||||||
|
* @param option The format option.
|
||||||
|
* @return The found value, or null if not found.
|
||||||
|
*/
|
||||||
|
@Nullable
|
||||||
|
String getStringOrNull(@NotNull String path,
|
||||||
|
boolean format,
|
||||||
|
@NotNull StringUtils.FormatOption option);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Get a list of strings from config.
|
* Get a list of strings from config.
|
||||||
@@ -180,7 +268,9 @@ public interface Config {
|
|||||||
* @return The found value, or a blank {@link java.util.ArrayList} if not found.
|
* @return The found value, or a blank {@link java.util.ArrayList} if not found.
|
||||||
*/
|
*/
|
||||||
@NotNull
|
@NotNull
|
||||||
List<String> getStrings(@NotNull String path);
|
default List<String> getStrings(@NotNull String path) {
|
||||||
|
return getStrings(path, true);
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Get a list of strings from config.
|
* Get a list of strings from config.
|
||||||
@@ -190,8 +280,36 @@ public interface Config {
|
|||||||
* @return The found value, or a blank {@link java.util.ArrayList} if not found.
|
* @return The found value, or a blank {@link java.util.ArrayList} if not found.
|
||||||
*/
|
*/
|
||||||
@NotNull
|
@NotNull
|
||||||
|
default List<String> getStrings(@NotNull String path,
|
||||||
|
boolean format) {
|
||||||
|
return this.getStrings(path, format, StringUtils.FormatOption.WITH_PLACEHOLDERS);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a list of strings from config.
|
||||||
|
*
|
||||||
|
* @param path The key to fetch the value from.
|
||||||
|
* @param option The format option.
|
||||||
|
* @return The found value, or a blank {@link java.util.ArrayList} if not found.
|
||||||
|
*/
|
||||||
|
@Nullable
|
||||||
|
default List<String> getStrings(@NotNull String path,
|
||||||
|
@NotNull StringUtils.FormatOption option) {
|
||||||
|
return getStrings(path, true, option);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a list of strings from config.
|
||||||
|
*
|
||||||
|
* @param path The key to fetch the value from.
|
||||||
|
* @param format If the strings should be formatted.
|
||||||
|
* @param option The option.
|
||||||
|
* @return The found value, or a blank {@link java.util.ArrayList} if not found.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
List<String> getStrings(@NotNull String path,
|
List<String> getStrings(@NotNull String path,
|
||||||
boolean format);
|
boolean format,
|
||||||
|
@NotNull StringUtils.FormatOption option);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Get a list of strings from config.
|
* Get a list of strings from config.
|
||||||
@@ -200,7 +318,48 @@ public interface Config {
|
|||||||
* @return The found value, or null if not found.
|
* @return The found value, or null if not found.
|
||||||
*/
|
*/
|
||||||
@Nullable
|
@Nullable
|
||||||
List<String> getStringsOrNull(@NotNull String path);
|
default List<String> getStringsOrNull(@NotNull String path) {
|
||||||
|
return getStringsOrNull(path, true);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a list of strings from config.
|
||||||
|
*
|
||||||
|
* @param path The key to fetch the value from.
|
||||||
|
* @param format If the strings should be formatted.
|
||||||
|
* @return The found value, or null if not found.
|
||||||
|
*/
|
||||||
|
@Nullable
|
||||||
|
default List<String> getStringsOrNull(@NotNull String path,
|
||||||
|
boolean format) {
|
||||||
|
return getStringsOrNull(path, format, StringUtils.FormatOption.WITH_PLACEHOLDERS);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a list of strings from config.
|
||||||
|
*
|
||||||
|
* @param path The key to fetch the value from.
|
||||||
|
* @param option The format option.
|
||||||
|
* @return The found value, or null if not found.
|
||||||
|
*/
|
||||||
|
@Nullable
|
||||||
|
default List<String> getStringsOrNull(@NotNull String path,
|
||||||
|
@NotNull StringUtils.FormatOption option) {
|
||||||
|
return getStringsOrNull(path, true, option);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a list of strings from config.
|
||||||
|
*
|
||||||
|
* @param path The key to fetch the value from.
|
||||||
|
* @param format If the strings should be formatted.
|
||||||
|
* @param option The format option.
|
||||||
|
* @return The found value, or null if not found.
|
||||||
|
*/
|
||||||
|
@Nullable
|
||||||
|
List<String> getStringsOrNull(@NotNull String path,
|
||||||
|
boolean format,
|
||||||
|
@NotNull StringUtils.FormatOption option);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Get a decimal from config.
|
* Get a decimal from config.
|
||||||
@@ -236,4 +395,11 @@ public interface Config {
|
|||||||
*/
|
*/
|
||||||
@Nullable
|
@Nullable
|
||||||
List<Double> getDoublesOrNull(@NotNull String path);
|
List<Double> getDoublesOrNull(@NotNull String path);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Clone the config.
|
||||||
|
*
|
||||||
|
* @return The clone.
|
||||||
|
*/
|
||||||
|
Config clone();
|
||||||
}
|
}
|
||||||
@@ -1,10 +1,15 @@
|
|||||||
package com.willfp.eco.core.config;
|
package com.willfp.eco.core.config.interfaces;
|
||||||
|
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
import org.jetbrains.annotations.Nullable;
|
import org.jetbrains.annotations.Nullable;
|
||||||
|
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* JSON configs have extra methods compared to yaml configs.
|
||||||
|
* <p>
|
||||||
|
* If you need to use them, then use JSONConfig instead.
|
||||||
|
*/
|
||||||
public interface JSONConfig extends Config {
|
public interface JSONConfig extends Config {
|
||||||
/**
|
/**
|
||||||
* Get a list of subsections from config.
|
* Get a list of subsections from config.
|
||||||
@@ -23,4 +28,28 @@ public interface JSONConfig extends Config {
|
|||||||
*/
|
*/
|
||||||
@Nullable
|
@Nullable
|
||||||
List<JSONConfig> getSubsectionsOrNull(@NotNull String path);
|
List<JSONConfig> getSubsectionsOrNull(@NotNull String path);
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get subsection from config.
|
||||||
|
*
|
||||||
|
* @param path The key to check.
|
||||||
|
* @return The subsection. Throws NPE if not found.
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
@NotNull
|
||||||
|
JSONConfig getSubsection(@NotNull String path);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get subsection from config.
|
||||||
|
*
|
||||||
|
* @param path The key to check.
|
||||||
|
* @return The subsection, or null if not found.
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
@Nullable
|
||||||
|
JSONConfig getSubsectionOrNull(@NotNull String path);
|
||||||
|
|
||||||
|
@Override
|
||||||
|
JSONConfig clone();
|
||||||
}
|
}
|
||||||
@@ -1,8 +1,11 @@
|
|||||||
package com.willfp.eco.internal.config;
|
package com.willfp.eco.core.config.interfaces;
|
||||||
|
|
||||||
import java.io.File;
|
import java.io.File;
|
||||||
import java.io.IOException;
|
import java.io.IOException;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Interface for configs that physically exist as files in plugins.
|
||||||
|
*/
|
||||||
public interface LoadableConfig {
|
public interface LoadableConfig {
|
||||||
/**
|
/**
|
||||||
* Create the file.
|
* Create the file.
|
||||||
@@ -31,7 +34,7 @@ public interface LoadableConfig {
|
|||||||
File getConfigFile();
|
File getConfigFile();
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Get the config name (including extension)
|
* Get the config name (including extension).
|
||||||
*
|
*
|
||||||
* @return The name.
|
* @return The name.
|
||||||
*/
|
*/
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
package com.willfp.eco.core.config.interfaces;
|
||||||
|
|
||||||
|
import org.bukkit.configuration.file.YamlConfiguration;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Interface for configs that wrap an {@link YamlConfiguration}.
|
||||||
|
*
|
||||||
|
* @see com.willfp.eco.core.config.yaml.wrapper.YamlConfigWrapper
|
||||||
|
*/
|
||||||
|
public interface WrappedYamlConfiguration {
|
||||||
|
/**
|
||||||
|
* Get the ConfigurationSection handle.
|
||||||
|
*
|
||||||
|
* @return The handle.
|
||||||
|
*/
|
||||||
|
YamlConfiguration getBukkitHandle();
|
||||||
|
}
|
||||||
@@ -0,0 +1,78 @@
|
|||||||
|
package com.willfp.eco.core.config.json;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.Eco;
|
||||||
|
import com.willfp.eco.core.EcoPlugin;
|
||||||
|
import com.willfp.eco.core.PluginLike;
|
||||||
|
import com.willfp.eco.core.config.json.wrapper.LoadableJSONConfigWrapper;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Config implementation for configs present in the plugin's base directory (eg config.json).
|
||||||
|
* <p>
|
||||||
|
* Automatically updates.
|
||||||
|
*/
|
||||||
|
public abstract class JSONBaseConfig extends LoadableJSONConfigWrapper {
|
||||||
|
/**
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @param updateBlacklist Substring of keys to not add/remove keys for.
|
||||||
|
*/
|
||||||
|
protected JSONBaseConfig(@NotNull final String configName,
|
||||||
|
final boolean removeUnused,
|
||||||
|
@NotNull final PluginLike plugin,
|
||||||
|
@NotNull final String... updateBlacklist) {
|
||||||
|
super(
|
||||||
|
Eco.getHandler().getConfigFactory().createUpdatableJSONConfig(
|
||||||
|
configName,
|
||||||
|
plugin,
|
||||||
|
"",
|
||||||
|
plugin.getClass(),
|
||||||
|
removeUnused, updateBlacklist
|
||||||
|
)
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
||||||
|
* @param plugin The plugin.
|
||||||
|
*/
|
||||||
|
protected JSONBaseConfig(@NotNull final String configName,
|
||||||
|
final boolean removeUnused,
|
||||||
|
@NotNull final PluginLike plugin) {
|
||||||
|
super(
|
||||||
|
Eco.getHandler().getConfigFactory().createUpdatableJSONConfig(
|
||||||
|
configName,
|
||||||
|
plugin,
|
||||||
|
"",
|
||||||
|
plugin.getClass(),
|
||||||
|
removeUnused
|
||||||
|
)
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @param updateBlacklist Substring of keys to not add/remove keys for.
|
||||||
|
*/
|
||||||
|
protected JSONBaseConfig(@NotNull final String configName,
|
||||||
|
final boolean removeUnused,
|
||||||
|
@NotNull final EcoPlugin plugin,
|
||||||
|
@NotNull final String... updateBlacklist) {
|
||||||
|
this(configName, removeUnused, (PluginLike) plugin, updateBlacklist);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
||||||
|
* @param plugin The plugin.
|
||||||
|
*/
|
||||||
|
protected JSONBaseConfig(@NotNull final String configName,
|
||||||
|
final boolean removeUnused,
|
||||||
|
@NotNull final EcoPlugin plugin) {
|
||||||
|
this(configName, removeUnused, (PluginLike) plugin);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,60 @@
|
|||||||
|
package com.willfp.eco.core.config.json;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.Eco;
|
||||||
|
import com.willfp.eco.core.EcoPlugin;
|
||||||
|
import com.willfp.eco.core.PluginLike;
|
||||||
|
import com.willfp.eco.core.config.json.wrapper.LoadableJSONConfigWrapper;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Config implementation for configs present in one of two places:
|
||||||
|
* <ul>
|
||||||
|
* <li>Plugin base directory (eg config.yml, lang.yml)</li>
|
||||||
|
* <li>Other extension's configs</li>
|
||||||
|
* </ul>
|
||||||
|
* <p>
|
||||||
|
* Automatically updates.
|
||||||
|
*/
|
||||||
|
public abstract class JSONExtendableConfig extends LoadableJSONConfigWrapper {
|
||||||
|
/**
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @param updateBlacklist Substring of keys to not add/remove keys for.
|
||||||
|
* @param subDirectoryPath The subdirectory path.
|
||||||
|
* @param source The class that owns the resource.
|
||||||
|
*/
|
||||||
|
protected JSONExtendableConfig(@NotNull final String configName,
|
||||||
|
final boolean removeUnused,
|
||||||
|
@NotNull final PluginLike plugin,
|
||||||
|
@NotNull final Class<?> source,
|
||||||
|
@NotNull final String subDirectoryPath,
|
||||||
|
@NotNull final String... updateBlacklist) {
|
||||||
|
super(
|
||||||
|
Eco.getHandler().getConfigFactory().createUpdatableJSONConfig(
|
||||||
|
configName,
|
||||||
|
plugin,
|
||||||
|
subDirectoryPath,
|
||||||
|
source,
|
||||||
|
removeUnused,
|
||||||
|
updateBlacklist
|
||||||
|
)
|
||||||
|
);
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @param updateBlacklist Substring of keys to not add/remove keys for.
|
||||||
|
* @param subDirectoryPath The subdirectory path.
|
||||||
|
* @param source The class that owns the resource.
|
||||||
|
*/
|
||||||
|
protected JSONExtendableConfig(@NotNull final String configName,
|
||||||
|
final boolean removeUnused,
|
||||||
|
@NotNull final EcoPlugin plugin,
|
||||||
|
@NotNull final Class<?> source,
|
||||||
|
@NotNull final String subDirectoryPath,
|
||||||
|
@NotNull final String... updateBlacklist) {
|
||||||
|
this(configName, removeUnused, (PluginLike) plugin, source, subDirectoryPath, updateBlacklist);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
package com.willfp.eco.core.config.json;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.Eco;
|
||||||
|
import com.willfp.eco.core.EcoPlugin;
|
||||||
|
import com.willfp.eco.core.PluginLike;
|
||||||
|
import com.willfp.eco.core.config.json.wrapper.LoadableJSONConfigWrapper;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Non-updatable JSON config that exists within a plugin jar.
|
||||||
|
*/
|
||||||
|
public abstract class JSONStaticBaseConfig extends LoadableJSONConfigWrapper {
|
||||||
|
/**
|
||||||
|
* Config implementation for configs present in the plugin's base directory (eg config.json, lang.json).
|
||||||
|
* <p>
|
||||||
|
* Does not automatically update.
|
||||||
|
*
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param plugin The plugin.
|
||||||
|
*/
|
||||||
|
protected JSONStaticBaseConfig(@NotNull final String configName,
|
||||||
|
@NotNull final PluginLike plugin) {
|
||||||
|
super(Eco.getHandler().getConfigFactory().createLoadableJSONConfig(configName, plugin, "", plugin.getClass()));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Config implementation for configs present in the plugin's base directory (eg config.json, lang.json).
|
||||||
|
* <p>
|
||||||
|
* Does not automatically update.
|
||||||
|
*
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param plugin The plugin.
|
||||||
|
*/
|
||||||
|
protected JSONStaticBaseConfig(@NotNull final String configName,
|
||||||
|
@NotNull final EcoPlugin plugin) {
|
||||||
|
this(configName, (PluginLike) plugin);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
package com.willfp.eco.core.config.json;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.Eco;
|
||||||
|
import com.willfp.eco.core.config.json.wrapper.JSONConfigWrapper;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Raw JSON config with a map of values at its core.
|
||||||
|
*/
|
||||||
|
public class JSONTransientConfig extends JSONConfigWrapper {
|
||||||
|
/**
|
||||||
|
* Config implementation for passing maps.
|
||||||
|
* <p>
|
||||||
|
* Does not automatically update.
|
||||||
|
*
|
||||||
|
* @param values The map of values.
|
||||||
|
*/
|
||||||
|
public JSONTransientConfig(@NotNull final Map<String, Object> values) {
|
||||||
|
super(Eco.getHandler().getConfigFactory().createJSONConfig(values));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,48 @@
|
|||||||
|
package com.willfp.eco.core.config.json.wrapper;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.config.interfaces.JSONConfig;
|
||||||
|
import com.willfp.eco.core.config.wrapper.ConfigWrapper;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
import org.jetbrains.annotations.Nullable;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Wrapper to handle the backend JSON config implementations.
|
||||||
|
*/
|
||||||
|
public abstract class JSONConfigWrapper extends ConfigWrapper<JSONConfig> implements JSONConfig {
|
||||||
|
/**
|
||||||
|
* Create a config wrapper.
|
||||||
|
*
|
||||||
|
* @param handle The handle.
|
||||||
|
*/
|
||||||
|
protected JSONConfigWrapper(@NotNull final JSONConfig handle) {
|
||||||
|
super(handle);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @NotNull List<JSONConfig> getSubsections(@NotNull final String path) {
|
||||||
|
return this.getHandle().getSubsections(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @Nullable List<JSONConfig> getSubsectionsOrNull(@NotNull final String path) {
|
||||||
|
return this.getHandle().getSubsectionsOrNull(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @NotNull JSONConfig getSubsection(@NotNull final String path) {
|
||||||
|
return this.getHandle().getSubsection(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @Nullable JSONConfig getSubsectionOrNull(@NotNull final String path) {
|
||||||
|
return this.getHandle().getSubsectionOrNull(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public JSONConfig clone() {
|
||||||
|
return this.getHandle().clone();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,51 @@
|
|||||||
|
package com.willfp.eco.core.config.json.wrapper;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.config.interfaces.JSONConfig;
|
||||||
|
import com.willfp.eco.core.config.interfaces.LoadableConfig;
|
||||||
|
import org.apache.commons.lang.Validate;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
import java.io.File;
|
||||||
|
import java.io.IOException;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Wrapper to handle the backend loadable JSON config implementations.
|
||||||
|
*/
|
||||||
|
public abstract class LoadableJSONConfigWrapper extends JSONConfigWrapper implements LoadableConfig {
|
||||||
|
/**
|
||||||
|
* Create a config wrapper.
|
||||||
|
*
|
||||||
|
* @param handle The handle.
|
||||||
|
*/
|
||||||
|
protected LoadableJSONConfigWrapper(@NotNull final JSONConfig handle) {
|
||||||
|
super(handle);
|
||||||
|
|
||||||
|
Validate.isTrue(handle instanceof LoadableConfig, "Wrapped config must be loadable!");
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void createFile() {
|
||||||
|
((LoadableConfig) this.getHandle()).createFile();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String getResourcePath() {
|
||||||
|
return ((LoadableConfig) this.getHandle()).getResourcePath();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void save() throws IOException {
|
||||||
|
((LoadableConfig) this.getHandle()).save();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public File getConfigFile() {
|
||||||
|
return ((LoadableConfig) this.getHandle()).getConfigFile();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String getName() {
|
||||||
|
return ((LoadableConfig) this.getHandle()).getName();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,21 +1,19 @@
|
|||||||
package com.willfp.eco.core.config;
|
package com.willfp.eco.core.config.updating;
|
||||||
|
|
||||||
import com.willfp.eco.internal.config.LoadableConfig;
|
import com.willfp.eco.core.config.interfaces.LoadableConfig;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Every {@link com.willfp.eco.core.PluginLike} has a config handler.
|
||||||
|
* <p>
|
||||||
|
* Handles updating and saving configs.
|
||||||
|
*/
|
||||||
public interface ConfigHandler {
|
public interface ConfigHandler {
|
||||||
/**
|
/**
|
||||||
* Invoke all update methods.
|
* Invoke all update methods.
|
||||||
*/
|
*/
|
||||||
void callUpdate();
|
void callUpdate();
|
||||||
|
|
||||||
/**
|
|
||||||
* Register an updatable class.
|
|
||||||
*
|
|
||||||
* @param updatableClass The class with an update method.
|
|
||||||
*/
|
|
||||||
void registerUpdatableClass(@NotNull Class<?> updatableClass);
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Save all configs.
|
* Save all configs.
|
||||||
*/
|
*/
|
||||||
@@ -0,0 +1,39 @@
|
|||||||
|
package com.willfp.eco.core.config.updating;
|
||||||
|
|
||||||
|
import java.lang.annotation.ElementType;
|
||||||
|
import java.lang.annotation.Retention;
|
||||||
|
import java.lang.annotation.RetentionPolicy;
|
||||||
|
import java.lang.annotation.Target;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Annotation to put on update methods.
|
||||||
|
* <p>
|
||||||
|
* All update methods must be public and static,
|
||||||
|
* and can accept an EcoPlugin as a parameter.
|
||||||
|
* <p>
|
||||||
|
* As such, there are only 2 valid update methods:
|
||||||
|
* <p>
|
||||||
|
* The first:
|
||||||
|
* <pre>{@code
|
||||||
|
* @ConfigUpdater
|
||||||
|
* public static void update() {
|
||||||
|
* // Update code
|
||||||
|
* }
|
||||||
|
* }</pre>
|
||||||
|
* <p>
|
||||||
|
* The second:
|
||||||
|
* <pre>{@code
|
||||||
|
* public static void update(EcoPlugin plugin) {}
|
||||||
|
* // Update code
|
||||||
|
* }</pre>
|
||||||
|
* <p>
|
||||||
|
* Config update methods in all classes in a plugin jar will be called
|
||||||
|
* on reload.
|
||||||
|
* <p>
|
||||||
|
* By having a plugin as a parameter, you shouldn't really need getInstance()
|
||||||
|
* calls in your code.
|
||||||
|
*/
|
||||||
|
@Retention(RetentionPolicy.RUNTIME)
|
||||||
|
@Target(ElementType.METHOD)
|
||||||
|
public @interface ConfigUpdater {
|
||||||
|
}
|
||||||
@@ -0,0 +1,94 @@
|
|||||||
|
package com.willfp.eco.core.config.wrapper;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.PluginLike;
|
||||||
|
import com.willfp.eco.core.config.interfaces.Config;
|
||||||
|
import com.willfp.eco.core.config.interfaces.JSONConfig;
|
||||||
|
import org.bukkit.configuration.file.YamlConfiguration;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Internal component to create backend config implementations.
|
||||||
|
*/
|
||||||
|
public interface ConfigFactory {
|
||||||
|
/**
|
||||||
|
* Updatable config.
|
||||||
|
*
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @param subDirectoryPath The subdirectory path.
|
||||||
|
* @param source The class that owns the resource.
|
||||||
|
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
||||||
|
* @param updateBlacklist Substring of keys to not add/remove keys for.
|
||||||
|
* @return The config implementation.
|
||||||
|
*/
|
||||||
|
Config createUpdatableYamlConfig(@NotNull String configName,
|
||||||
|
@NotNull PluginLike plugin,
|
||||||
|
@NotNull String subDirectoryPath,
|
||||||
|
@NotNull Class<?> source,
|
||||||
|
boolean removeUnused,
|
||||||
|
@NotNull String... updateBlacklist);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Updatable config.
|
||||||
|
*
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @param subDirectoryPath The subdirectory path.
|
||||||
|
* @param source The class that owns the resource.
|
||||||
|
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
||||||
|
* @param updateBlacklist Substring of keys to not add/remove keys for.
|
||||||
|
* @return The config implementation.
|
||||||
|
*/
|
||||||
|
JSONConfig createUpdatableJSONConfig(@NotNull String configName,
|
||||||
|
@NotNull PluginLike plugin,
|
||||||
|
@NotNull String subDirectoryPath,
|
||||||
|
@NotNull Class<?> source,
|
||||||
|
boolean removeUnused,
|
||||||
|
@NotNull String... updateBlacklist);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* JSON loadable config.
|
||||||
|
*
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @param subDirectoryPath The subdirectory path.
|
||||||
|
* @param source The class that owns the resource.
|
||||||
|
* @return The config implementation.
|
||||||
|
*/
|
||||||
|
JSONConfig createLoadableJSONConfig(@NotNull String configName,
|
||||||
|
@NotNull PluginLike plugin,
|
||||||
|
@NotNull String subDirectoryPath,
|
||||||
|
@NotNull Class<?> source);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Yaml loadable config.
|
||||||
|
*
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @param subDirectoryPath The subdirectory path.
|
||||||
|
* @param source The class that owns the resource.
|
||||||
|
* @return The config implementation.
|
||||||
|
*/
|
||||||
|
Config createLoadableYamlConfig(@NotNull String configName,
|
||||||
|
@NotNull PluginLike plugin,
|
||||||
|
@NotNull String subDirectoryPath,
|
||||||
|
@NotNull Class<?> source);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Yaml config.
|
||||||
|
*
|
||||||
|
* @param config The handle.
|
||||||
|
* @return The config implementation.
|
||||||
|
*/
|
||||||
|
Config createYamlConfig(@NotNull YamlConfiguration config);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* JSON config.
|
||||||
|
*
|
||||||
|
* @param values The values.
|
||||||
|
* @return The config implementation.
|
||||||
|
*/
|
||||||
|
JSONConfig createJSONConfig(@NotNull Map<String, Object> values);
|
||||||
|
}
|
||||||
@@ -0,0 +1,182 @@
|
|||||||
|
package com.willfp.eco.core.config.wrapper;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.config.interfaces.Config;
|
||||||
|
import com.willfp.eco.util.StringUtils;
|
||||||
|
import lombok.Getter;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
import org.jetbrains.annotations.Nullable;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Configs from eco have an internal implementation,
|
||||||
|
* which is the handle.
|
||||||
|
* <p>
|
||||||
|
* This class handles them.
|
||||||
|
*
|
||||||
|
* @param <T> The type of the handle.
|
||||||
|
*/
|
||||||
|
public abstract class ConfigWrapper<T extends Config> implements Config {
|
||||||
|
/**
|
||||||
|
* Configs from eco have an internal implementation,
|
||||||
|
* which is the handle.
|
||||||
|
* <p>
|
||||||
|
* The handle should only ever be used if you want to
|
||||||
|
* do something <i>interesting</i> config-wise with some
|
||||||
|
* internals.
|
||||||
|
* <p>
|
||||||
|
* In general use, though, the handle isn't necessary.
|
||||||
|
*/
|
||||||
|
@Getter
|
||||||
|
private final T handle;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a config wrapper.
|
||||||
|
*
|
||||||
|
* @param handle The config that is being wrapped.
|
||||||
|
*/
|
||||||
|
protected ConfigWrapper(@NotNull final T handle) {
|
||||||
|
this.handle = handle;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void clearCache() {
|
||||||
|
handle.clearCache();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String toPlaintext() {
|
||||||
|
return handle.toPlaintext();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean has(@NotNull final String path) {
|
||||||
|
return handle.has(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @NotNull List<String> getKeys(final boolean deep) {
|
||||||
|
return handle.getKeys(deep);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @Nullable Object get(@NotNull final String path) {
|
||||||
|
return handle.get(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void set(@NotNull final String path,
|
||||||
|
@Nullable final Object object) {
|
||||||
|
handle.set(path, object);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @NotNull Config getSubsection(@NotNull final String path) {
|
||||||
|
return handle.getSubsection(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @Nullable Config getSubsectionOrNull(@NotNull final String path) {
|
||||||
|
return handle.getSubsectionOrNull(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public int getInt(@NotNull final String path) {
|
||||||
|
return handle.getInt(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @Nullable Integer getIntOrNull(@NotNull final String path) {
|
||||||
|
return handle.getIntOrNull(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public int getInt(@NotNull final String path,
|
||||||
|
final int def) {
|
||||||
|
return handle.getInt(path, def);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @NotNull List<Integer> getInts(@NotNull final String path) {
|
||||||
|
return handle.getInts(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @Nullable List<Integer> getIntsOrNull(@NotNull final String path) {
|
||||||
|
return handle.getIntsOrNull(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean getBool(@NotNull final String path) {
|
||||||
|
return handle.getBool(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @Nullable Boolean getBoolOrNull(@NotNull final String path) {
|
||||||
|
return handle.getBoolOrNull(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @NotNull List<Boolean> getBools(@NotNull final String path) {
|
||||||
|
return handle.getBools(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @Nullable List<Boolean> getBoolsOrNull(@NotNull final String path) {
|
||||||
|
return handle.getBoolsOrNull(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @NotNull String getString(@NotNull final String path,
|
||||||
|
final boolean format,
|
||||||
|
@NotNull final StringUtils.FormatOption option) {
|
||||||
|
return handle.getString(path, format, option);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @Nullable String getStringOrNull(@NotNull final String path,
|
||||||
|
final boolean format,
|
||||||
|
@NotNull final StringUtils.FormatOption option) {
|
||||||
|
return handle.getStringOrNull(path, format, option);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @NotNull List<String> getStrings(@NotNull final String path,
|
||||||
|
final boolean format,
|
||||||
|
@NotNull final StringUtils.FormatOption option) {
|
||||||
|
return handle.getStrings(path, format, option);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @Nullable List<String> getStringsOrNull(@NotNull final String path,
|
||||||
|
final boolean format,
|
||||||
|
@NotNull final StringUtils.FormatOption option) {
|
||||||
|
return handle.getStringsOrNull(path, format, option);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public double getDouble(@NotNull final String path) {
|
||||||
|
return handle.getDouble(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @Nullable Double getDoubleOrNull(@NotNull final String path) {
|
||||||
|
return handle.getDoubleOrNull(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @NotNull List<Double> getDoubles(@NotNull final String path) {
|
||||||
|
return handle.getDoubles(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public @Nullable List<Double> getDoublesOrNull(@NotNull final String path) {
|
||||||
|
return handle.getDoublesOrNull(path);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Config clone() {
|
||||||
|
return handle.clone();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,78 @@
|
|||||||
|
package com.willfp.eco.core.config.yaml;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.Eco;
|
||||||
|
import com.willfp.eco.core.EcoPlugin;
|
||||||
|
import com.willfp.eco.core.PluginLike;
|
||||||
|
import com.willfp.eco.core.config.yaml.wrapper.LoadableYamlConfigWrapper;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Config implementation for configs present in the plugin's base directory (eg config.yml, lang.yml).
|
||||||
|
* <p>
|
||||||
|
* Automatically updates.
|
||||||
|
*/
|
||||||
|
public abstract class YamlBaseConfig extends LoadableYamlConfigWrapper {
|
||||||
|
/**
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @param updateBlacklist Substring of keys to not add/remove keys for.
|
||||||
|
*/
|
||||||
|
protected YamlBaseConfig(@NotNull final String configName,
|
||||||
|
final boolean removeUnused,
|
||||||
|
@NotNull final PluginLike plugin,
|
||||||
|
@NotNull final String... updateBlacklist) {
|
||||||
|
super(
|
||||||
|
Eco.getHandler().getConfigFactory().createUpdatableYamlConfig(
|
||||||
|
configName,
|
||||||
|
plugin,
|
||||||
|
"",
|
||||||
|
plugin.getClass(),
|
||||||
|
removeUnused, updateBlacklist
|
||||||
|
)
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
||||||
|
* @param plugin The plugin.
|
||||||
|
*/
|
||||||
|
protected YamlBaseConfig(@NotNull final String configName,
|
||||||
|
final boolean removeUnused,
|
||||||
|
@NotNull final PluginLike plugin) {
|
||||||
|
super(
|
||||||
|
Eco.getHandler().getConfigFactory().createUpdatableYamlConfig(
|
||||||
|
configName,
|
||||||
|
plugin,
|
||||||
|
"",
|
||||||
|
plugin.getClass(),
|
||||||
|
removeUnused
|
||||||
|
)
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @param updateBlacklist Substring of keys to not add/remove keys for.
|
||||||
|
*/
|
||||||
|
protected YamlBaseConfig(@NotNull final String configName,
|
||||||
|
final boolean removeUnused,
|
||||||
|
@NotNull final EcoPlugin plugin,
|
||||||
|
@NotNull final String... updateBlacklist) {
|
||||||
|
this(configName, removeUnused, (PluginLike) plugin, updateBlacklist);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
||||||
|
* @param plugin The plugin.
|
||||||
|
*/
|
||||||
|
protected YamlBaseConfig(@NotNull final String configName,
|
||||||
|
final boolean removeUnused,
|
||||||
|
@NotNull final EcoPlugin plugin) {
|
||||||
|
this(configName, removeUnused, (PluginLike) plugin);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,60 @@
|
|||||||
|
package com.willfp.eco.core.config.yaml;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.Eco;
|
||||||
|
import com.willfp.eco.core.EcoPlugin;
|
||||||
|
import com.willfp.eco.core.PluginLike;
|
||||||
|
import com.willfp.eco.core.config.yaml.wrapper.LoadableYamlConfigWrapper;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Config implementation for configs present in one of two places:
|
||||||
|
* <ul>
|
||||||
|
* <li>Plugin base directory (eg config.yml, lang.yml)</li>
|
||||||
|
* <li>Other extension's configs</li>
|
||||||
|
* </ul>
|
||||||
|
* <p>
|
||||||
|
* Automatically updates.
|
||||||
|
*/
|
||||||
|
public abstract class YamlExtendableConfig extends LoadableYamlConfigWrapper {
|
||||||
|
/**
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @param updateBlacklist Substring of keys to not add/remove keys for.
|
||||||
|
* @param subDirectoryPath The subdirectory path.
|
||||||
|
* @param source The class that owns the resource.
|
||||||
|
*/
|
||||||
|
protected YamlExtendableConfig(@NotNull final String configName,
|
||||||
|
final boolean removeUnused,
|
||||||
|
@NotNull final PluginLike plugin,
|
||||||
|
@NotNull final Class<?> source,
|
||||||
|
@NotNull final String subDirectoryPath,
|
||||||
|
@NotNull final String... updateBlacklist) {
|
||||||
|
super(
|
||||||
|
Eco.getHandler().getConfigFactory().createUpdatableYamlConfig(
|
||||||
|
configName,
|
||||||
|
plugin,
|
||||||
|
subDirectoryPath,
|
||||||
|
source,
|
||||||
|
removeUnused,
|
||||||
|
updateBlacklist
|
||||||
|
)
|
||||||
|
);
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param removeUnused Whether keys not present in the default config should be removed on update.
|
||||||
|
* @param plugin The plugin.
|
||||||
|
* @param updateBlacklist Substring of keys to not add/remove keys for.
|
||||||
|
* @param subDirectoryPath The subdirectory path.
|
||||||
|
* @param source The class that owns the resource.
|
||||||
|
*/
|
||||||
|
protected YamlExtendableConfig(@NotNull final String configName,
|
||||||
|
final boolean removeUnused,
|
||||||
|
@NotNull final EcoPlugin plugin,
|
||||||
|
@NotNull final Class<?> source,
|
||||||
|
@NotNull final String subDirectoryPath,
|
||||||
|
@NotNull final String... updateBlacklist) {
|
||||||
|
this(configName, removeUnused, (PluginLike) plugin, source, subDirectoryPath, updateBlacklist);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
package com.willfp.eco.core.config.yaml;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.Eco;
|
||||||
|
import com.willfp.eco.core.EcoPlugin;
|
||||||
|
import com.willfp.eco.core.PluginLike;
|
||||||
|
import com.willfp.eco.core.config.yaml.wrapper.LoadableYamlConfigWrapper;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Non-updatable yaml config that exists within a plugin jar.
|
||||||
|
*/
|
||||||
|
public abstract class YamlStaticBaseConfig extends LoadableYamlConfigWrapper {
|
||||||
|
/**
|
||||||
|
* Config implementation for configs present in the plugin's base directory (eg config.yml, lang.yml).
|
||||||
|
* <p>
|
||||||
|
* Does not automatically update.
|
||||||
|
*
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param plugin The plugin.
|
||||||
|
*/
|
||||||
|
protected YamlStaticBaseConfig(@NotNull final String configName,
|
||||||
|
@NotNull final PluginLike plugin) {
|
||||||
|
super(Eco.getHandler().getConfigFactory().createLoadableYamlConfig(configName, plugin, "", plugin.getClass()));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Config implementation for configs present in the plugin's base directory (eg config.yml, lang.yml).
|
||||||
|
* <p>
|
||||||
|
* Does not automatically update.
|
||||||
|
*
|
||||||
|
* @param configName The name of the config
|
||||||
|
* @param plugin The plugin.
|
||||||
|
*/
|
||||||
|
protected YamlStaticBaseConfig(@NotNull final String configName,
|
||||||
|
@NotNull final EcoPlugin plugin) {
|
||||||
|
this(configName, (PluginLike) plugin);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
package com.willfp.eco.core.config.yaml;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.Eco;
|
||||||
|
import com.willfp.eco.core.config.yaml.wrapper.YamlConfigWrapper;
|
||||||
|
import org.bukkit.configuration.file.YamlConfiguration;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
import java.io.StringReader;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Config implementation for passing YamlConfigurations.
|
||||||
|
* <p>
|
||||||
|
* Does not automatically update.
|
||||||
|
*/
|
||||||
|
public class YamlTransientConfig extends YamlConfigWrapper {
|
||||||
|
/**
|
||||||
|
* @param config The YamlConfiguration handle.
|
||||||
|
*/
|
||||||
|
public YamlTransientConfig(@NotNull final YamlConfiguration config) {
|
||||||
|
super(Eco.getHandler().getConfigFactory().createYamlConfig(config));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param contents The contents of the config.
|
||||||
|
*/
|
||||||
|
public YamlTransientConfig(@NotNull final String contents) {
|
||||||
|
super(Eco.getHandler().getConfigFactory().createYamlConfig(YamlConfiguration.loadConfiguration(new StringReader(contents))));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,51 @@
|
|||||||
|
package com.willfp.eco.core.config.yaml.wrapper;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.config.interfaces.Config;
|
||||||
|
import com.willfp.eco.core.config.interfaces.LoadableConfig;
|
||||||
|
import org.apache.commons.lang.Validate;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
import java.io.File;
|
||||||
|
import java.io.IOException;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Wrapper to handle the backend loadable yaml config implementations.
|
||||||
|
*/
|
||||||
|
public abstract class LoadableYamlConfigWrapper extends YamlConfigWrapper implements LoadableConfig {
|
||||||
|
/**
|
||||||
|
* Create a config wrapper.
|
||||||
|
*
|
||||||
|
* @param handle The handle.
|
||||||
|
*/
|
||||||
|
protected LoadableYamlConfigWrapper(@NotNull final Config handle) {
|
||||||
|
super(handle);
|
||||||
|
|
||||||
|
Validate.isTrue(handle instanceof LoadableConfig, "Wrapped config must be loadable!");
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void createFile() {
|
||||||
|
((LoadableConfig) this.getHandle()).createFile();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String getResourcePath() {
|
||||||
|
return ((LoadableConfig) this.getHandle()).getResourcePath();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void save() throws IOException {
|
||||||
|
((LoadableConfig) this.getHandle()).save();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public File getConfigFile() {
|
||||||
|
return ((LoadableConfig) this.getHandle()).getConfigFile();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String getName() {
|
||||||
|
return ((LoadableConfig) this.getHandle()).getName();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
package com.willfp.eco.core.config.yaml.wrapper;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.config.interfaces.Config;
|
||||||
|
import com.willfp.eco.core.config.interfaces.WrappedYamlConfiguration;
|
||||||
|
import com.willfp.eco.core.config.wrapper.ConfigWrapper;
|
||||||
|
import org.bukkit.configuration.file.YamlConfiguration;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Wrapper to handle the backend yaml config implementations.
|
||||||
|
*/
|
||||||
|
public abstract class YamlConfigWrapper extends ConfigWrapper<Config> implements WrappedYamlConfiguration {
|
||||||
|
/**
|
||||||
|
* Create a config wrapper.
|
||||||
|
*
|
||||||
|
* @param handle The handle.
|
||||||
|
*/
|
||||||
|
protected YamlConfigWrapper(@NotNull final Config handle) {
|
||||||
|
super(handle);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public YamlConfiguration getBukkitHandle() {
|
||||||
|
return ((WrappedYamlConfiguration) this.getHandle()).getBukkitHandle();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,85 +0,0 @@
|
|||||||
package com.willfp.eco.core.data;
|
|
||||||
|
|
||||||
import com.willfp.eco.core.EcoPlugin;
|
|
||||||
import com.willfp.eco.core.config.Config;
|
|
||||||
import com.willfp.eco.core.config.JSONConfig;
|
|
||||||
import com.willfp.eco.core.config.JsonStaticBaseConfig;
|
|
||||||
import com.willfp.eco.internal.config.LoadableConfig;
|
|
||||||
import com.willfp.eco.internal.config.json.JsonConfigSection;
|
|
||||||
import lombok.experimental.UtilityClass;
|
|
||||||
import org.bukkit.OfflinePlayer;
|
|
||||||
import org.jetbrains.annotations.ApiStatus;
|
|
||||||
import org.jetbrains.annotations.NotNull;
|
|
||||||
|
|
||||||
import java.io.IOException;
|
|
||||||
import java.util.HashMap;
|
|
||||||
import java.util.Map;
|
|
||||||
import java.util.UUID;
|
|
||||||
|
|
||||||
@UtilityClass
|
|
||||||
public class Data {
|
|
||||||
/**
|
|
||||||
* Instance of eco data.yml.
|
|
||||||
*/
|
|
||||||
private static JSONConfig datafile = null;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* All cached player data.
|
|
||||||
*/
|
|
||||||
private static final Map<UUID, Map<EcoPlugin, JSONConfig>> PLAYER_DATA = new HashMap<>();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Initialize the player data with an instance of data.json.
|
|
||||||
*
|
|
||||||
* @param config data.json.
|
|
||||||
*/
|
|
||||||
@ApiStatus.Internal
|
|
||||||
public void init(@NotNull final JsonStaticBaseConfig config) {
|
|
||||||
datafile = config;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Save to data.yml.
|
|
||||||
*
|
|
||||||
* @param config Instance of data.yml.
|
|
||||||
* @throws IOException Error during saving.
|
|
||||||
*/
|
|
||||||
@ApiStatus.Internal
|
|
||||||
public void save(@NotNull final Config config) throws IOException {
|
|
||||||
for (Map.Entry<UUID, Map<EcoPlugin, JSONConfig>> entry : PLAYER_DATA.entrySet()) {
|
|
||||||
entry.getValue().forEach((plugin, jsonConfig) -> {
|
|
||||||
for (String key : jsonConfig.getKeys(false)) {
|
|
||||||
config.set("player-data." + plugin.getName().toLowerCase() + "." + entry.getKey().toString() + "." + key, jsonConfig);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
((LoadableConfig) config).save();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the data for a player.
|
|
||||||
*
|
|
||||||
* @param player The player.
|
|
||||||
* @param plugin The plugin.
|
|
||||||
* @return The data.
|
|
||||||
*/
|
|
||||||
public JSONConfig getData(@NotNull final OfflinePlayer player,
|
|
||||||
@NotNull final EcoPlugin plugin) {
|
|
||||||
if (!PLAYER_DATA.containsKey(player.getUniqueId())) {
|
|
||||||
PLAYER_DATA.put(player.getUniqueId(), new HashMap<>());
|
|
||||||
}
|
|
||||||
|
|
||||||
JSONConfig config = PLAYER_DATA.get(player.getUniqueId()).get(plugin);
|
|
||||||
|
|
||||||
if (config == null) {
|
|
||||||
config = (JSONConfig) datafile.getSubsectionOrNull("player-data." + plugin.getName().toLowerCase() + "." + player.getUniqueId());
|
|
||||||
if (config == null) {
|
|
||||||
config = new JsonConfigSection(new HashMap<>());
|
|
||||||
}
|
|
||||||
PLAYER_DATA.get(player.getUniqueId()).put(plugin, config);
|
|
||||||
return getData(player, plugin);
|
|
||||||
}
|
|
||||||
|
|
||||||
return config;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,56 @@
|
|||||||
|
package com.willfp.eco.core.data;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.Eco;
|
||||||
|
import com.willfp.eco.core.data.keys.PersistentDataKey;
|
||||||
|
import org.bukkit.OfflinePlayer;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
import java.util.UUID;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Persistent data storage interface for players.
|
||||||
|
* <p>
|
||||||
|
* Profiles save automatically, so there is no need to save after changes.
|
||||||
|
*/
|
||||||
|
public interface PlayerProfile {
|
||||||
|
/**
|
||||||
|
* Write a key to a player's persistent data.
|
||||||
|
*
|
||||||
|
* @param key The key.
|
||||||
|
* @param value The value.
|
||||||
|
* @param <T> The type of the key.
|
||||||
|
*/
|
||||||
|
<T> void write(@NotNull PersistentDataKey<T> key,
|
||||||
|
@NotNull T value);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Read a key from a player's persistent data.
|
||||||
|
*
|
||||||
|
* @param key The key.
|
||||||
|
* @param <T> The type of the key.
|
||||||
|
* @return The value, or the default value if not found.
|
||||||
|
*/
|
||||||
|
<T> @NotNull T read(@NotNull PersistentDataKey<T> key);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Load a player profile.
|
||||||
|
*
|
||||||
|
* @param player The player.
|
||||||
|
* @return The profile.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
static PlayerProfile load(@NotNull final OfflinePlayer player) {
|
||||||
|
return load(player.getUniqueId());
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Load a player profile.
|
||||||
|
*
|
||||||
|
* @param uuid The player's UUID.
|
||||||
|
* @return The profile.
|
||||||
|
*/
|
||||||
|
@NotNull
|
||||||
|
static PlayerProfile load(@NotNull final UUID uuid) {
|
||||||
|
return Eco.getHandler().getPlayerProfileHandler().load(uuid);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,32 @@
|
|||||||
|
package com.willfp.eco.core.data;
|
||||||
|
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
import java.util.UUID;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* API to handle player profiles.
|
||||||
|
*/
|
||||||
|
public interface PlayerProfileHandler {
|
||||||
|
/**
|
||||||
|
* Load a player profile.
|
||||||
|
*
|
||||||
|
* @param uuid The UUID.
|
||||||
|
* @return The profile.
|
||||||
|
*/
|
||||||
|
PlayerProfile load(@NotNull UUID uuid);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Save a player profile.
|
||||||
|
*
|
||||||
|
* @param uuid The uuid.
|
||||||
|
*/
|
||||||
|
void savePlayer(@NotNull UUID uuid);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Save all player data.
|
||||||
|
*
|
||||||
|
* @param async If the saving should be done asynchronously.
|
||||||
|
*/
|
||||||
|
void saveAll(boolean async);
|
||||||
|
}
|
||||||
@@ -0,0 +1,24 @@
|
|||||||
|
package com.willfp.eco.core.data.keys;
|
||||||
|
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
import java.util.Set;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* API to register persistent data keys.
|
||||||
|
*/
|
||||||
|
public interface KeyRegistry {
|
||||||
|
/**
|
||||||
|
* Register a persistent data key to be stored.
|
||||||
|
*
|
||||||
|
* @param key The key.
|
||||||
|
*/
|
||||||
|
void registerKey(@NotNull PersistentDataKey<?> key);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get all registered keys.
|
||||||
|
*
|
||||||
|
* @return The keys.
|
||||||
|
*/
|
||||||
|
Set<PersistentDataKey<?>> getRegisteredKeys();
|
||||||
|
}
|
||||||
@@ -0,0 +1,57 @@
|
|||||||
|
package com.willfp.eco.core.data.keys;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.Eco;
|
||||||
|
import lombok.Getter;
|
||||||
|
import org.bukkit.NamespacedKey;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A persistent data key is a key with a type that can be stored about an offline player.
|
||||||
|
*
|
||||||
|
* @param <T> The type of the data.
|
||||||
|
*/
|
||||||
|
public class PersistentDataKey<T> {
|
||||||
|
/**
|
||||||
|
* The key of the persistent data value.
|
||||||
|
*/
|
||||||
|
@Getter
|
||||||
|
private final NamespacedKey key;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The default value for the key.
|
||||||
|
*/
|
||||||
|
@Getter
|
||||||
|
private final T defaultValue;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The persistent data key type.
|
||||||
|
*/
|
||||||
|
@Getter
|
||||||
|
private final PersistentDataKeyType type;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a new Persistent Data Key.
|
||||||
|
*
|
||||||
|
* @param key The key.
|
||||||
|
* @param type The data type.
|
||||||
|
* @param defaultValue The default value.
|
||||||
|
*/
|
||||||
|
public PersistentDataKey(@NotNull final NamespacedKey key,
|
||||||
|
@NotNull final PersistentDataKeyType type,
|
||||||
|
@NotNull final T defaultValue) {
|
||||||
|
this.key = key;
|
||||||
|
this.defaultValue = defaultValue;
|
||||||
|
this.type = type;
|
||||||
|
|
||||||
|
Eco.getHandler().getKeyRegistry().registerKey(this);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String toString() {
|
||||||
|
return "PersistentDataKey{"
|
||||||
|
+ "key=" + key
|
||||||
|
+ ", defaultValue=" + defaultValue
|
||||||
|
+ ", type=" + type
|
||||||
|
+ '}';
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,26 @@
|
|||||||
|
package com.willfp.eco.core.data.keys;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* All storable data key types.
|
||||||
|
*/
|
||||||
|
public enum PersistentDataKeyType {
|
||||||
|
/**
|
||||||
|
* String.
|
||||||
|
*/
|
||||||
|
STRING,
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Boolean.
|
||||||
|
*/
|
||||||
|
BOOLEAN,
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Integer.
|
||||||
|
*/
|
||||||
|
INT,
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Double.
|
||||||
|
*/
|
||||||
|
DOUBLE
|
||||||
|
}
|
||||||
@@ -1,182 +1,99 @@
|
|||||||
package com.willfp.eco.core.display;
|
package com.willfp.eco.core.display;
|
||||||
|
|
||||||
import lombok.experimental.UtilityClass;
|
import lombok.experimental.UtilityClass;
|
||||||
import org.apache.commons.lang.Validate;
|
import org.bukkit.entity.Player;
|
||||||
import org.bukkit.NamespacedKey;
|
|
||||||
import org.bukkit.inventory.ItemStack;
|
import org.bukkit.inventory.ItemStack;
|
||||||
import org.bukkit.inventory.meta.ItemMeta;
|
|
||||||
import org.bukkit.persistence.PersistentDataContainer;
|
|
||||||
import org.bukkit.persistence.PersistentDataType;
|
|
||||||
import org.jetbrains.annotations.ApiStatus;
|
import org.jetbrains.annotations.ApiStatus;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
import org.jetbrains.annotations.Nullable;
|
||||||
|
|
||||||
import java.util.ArrayList;
|
/**
|
||||||
import java.util.HashMap;
|
* Utility class to manage client-side item display.
|
||||||
import java.util.List;
|
*/
|
||||||
import java.util.Map;
|
|
||||||
|
|
||||||
@UtilityClass
|
@UtilityClass
|
||||||
public class Display {
|
public class Display {
|
||||||
/**
|
/**
|
||||||
* The prefix for lore lines.
|
* The prefix for client-side lore lines.
|
||||||
*/
|
*/
|
||||||
public static final String PREFIX = "§z";
|
public static final String PREFIX = "§z";
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* All registered display modules.
|
* The display handler.
|
||||||
*/
|
*/
|
||||||
private static final Map<DisplayPriority, List<DisplayModule>> MODULES = new HashMap<>();
|
private static DisplayHandler handler = null;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* NamespacedKey for finalizing.
|
* Display on ItemStacks.
|
||||||
*/
|
|
||||||
private static NamespacedKey finalizeKey = null;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Register display module.
|
|
||||||
*
|
*
|
||||||
* @param module The module.
|
* @param itemStack The item.
|
||||||
|
* @return The ItemStack.
|
||||||
*/
|
*/
|
||||||
public void registerDisplayModule(@NotNull final DisplayModule module) {
|
public ItemStack display(@NotNull final ItemStack itemStack) {
|
||||||
List<DisplayModule> modules = MODULES.get(module.getPriority());
|
return display(itemStack, null);
|
||||||
|
|
||||||
modules.removeIf(module1 -> module1.getPluginName().equalsIgnoreCase(module.getPluginName()));
|
|
||||||
|
|
||||||
modules.add(module);
|
|
||||||
|
|
||||||
MODULES.put(module.getPriority(), modules);
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Display on ItemStacks.
|
* Display on ItemStacks.
|
||||||
*
|
*
|
||||||
* @param itemStack The item.
|
* @param itemStack The item.
|
||||||
* @return The itemstack.
|
* @param player The player.
|
||||||
|
* @return The ItemStack.
|
||||||
*/
|
*/
|
||||||
public ItemStack display(@NotNull final ItemStack itemStack) {
|
public ItemStack display(@NotNull final ItemStack itemStack,
|
||||||
if (!itemStack.hasItemMeta()) {
|
@Nullable final Player player) {
|
||||||
return itemStack; // return early if there's no customization of the item
|
return handler.display(itemStack, player);
|
||||||
}
|
|
||||||
|
|
||||||
Map<String, Object[]> pluginVarArgs = new HashMap<>();
|
|
||||||
|
|
||||||
for (DisplayPriority priority : DisplayPriority.values()) {
|
|
||||||
List<DisplayModule> modules = MODULES.get(priority);
|
|
||||||
for (DisplayModule module : modules) {
|
|
||||||
pluginVarArgs.put(module.getPluginName(), module.generateVarArgs(itemStack));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
revert(itemStack);
|
|
||||||
|
|
||||||
ItemMeta meta = itemStack.getItemMeta();
|
|
||||||
|
|
||||||
if (meta == null) {
|
|
||||||
return itemStack;
|
|
||||||
}
|
|
||||||
|
|
||||||
for (DisplayPriority priority : DisplayPriority.values()) {
|
|
||||||
List<DisplayModule> modules = MODULES.get(priority);
|
|
||||||
for (DisplayModule module : modules) {
|
|
||||||
Object[] varargs = pluginVarArgs.get(module.getPluginName());
|
|
||||||
module.display(itemStack, varargs);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return itemStack;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Display on ItemStacks and then finalize.
|
* Display on ItemStacks and then finalize.
|
||||||
*
|
*
|
||||||
* @param itemStack The item.
|
* @param itemStack The item.
|
||||||
* @return The itemstack.
|
* @return The ItemStack.
|
||||||
*/
|
*/
|
||||||
public ItemStack displayAndFinalize(@NotNull final ItemStack itemStack) {
|
public ItemStack displayAndFinalize(@NotNull final ItemStack itemStack) {
|
||||||
return finalize(display(itemStack));
|
return finalize(display(itemStack, null));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Display on ItemStacks and then finalize.
|
||||||
|
*
|
||||||
|
* @param itemStack The item.
|
||||||
|
* @param player The player.
|
||||||
|
* @return The ItemStack.
|
||||||
|
*/
|
||||||
|
public ItemStack displayAndFinalize(@NotNull final ItemStack itemStack,
|
||||||
|
@Nullable final Player player) {
|
||||||
|
return finalize(display(itemStack, player));
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Revert on ItemStacks.
|
* Revert on ItemStacks.
|
||||||
*
|
*
|
||||||
* @param itemStack The item.
|
* @param itemStack The item.
|
||||||
* @return The itemstack.
|
* @return The ItemStack.
|
||||||
*/
|
*/
|
||||||
public ItemStack revert(@NotNull final ItemStack itemStack) {
|
public ItemStack revert(@NotNull final ItemStack itemStack) {
|
||||||
if (Display.isFinalized(itemStack)) {
|
return handler.revert(itemStack);
|
||||||
unfinalize(itemStack);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!itemStack.hasItemMeta()) {
|
|
||||||
return itemStack;
|
|
||||||
}
|
|
||||||
|
|
||||||
ItemMeta meta = itemStack.getItemMeta();
|
|
||||||
|
|
||||||
if (meta == null) {
|
|
||||||
return itemStack;
|
|
||||||
}
|
|
||||||
|
|
||||||
List<String> lore = meta.getLore();
|
|
||||||
|
|
||||||
if (lore != null && lore.removeIf(line -> line.startsWith(Display.PREFIX))) { // only apply lore modification if needed
|
|
||||||
meta.setLore(lore);
|
|
||||||
itemStack.setItemMeta(meta);
|
|
||||||
}
|
|
||||||
|
|
||||||
for (DisplayPriority priority : DisplayPriority.values()) {
|
|
||||||
List<DisplayModule> modules = MODULES.get(priority);
|
|
||||||
for (DisplayModule module : modules) {
|
|
||||||
module.revert(itemStack);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return itemStack;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Finalize an ItemStacks.
|
* Finalize an ItemStacks.
|
||||||
*
|
*
|
||||||
* @param itemStack The item.
|
* @param itemStack The item.
|
||||||
* @return The itemstack.
|
* @return The ItemStack.
|
||||||
*/
|
*/
|
||||||
public ItemStack finalize(@NotNull final ItemStack itemStack) {
|
public ItemStack finalize(@NotNull final ItemStack itemStack) {
|
||||||
Validate.notNull(finalizeKey, "Key cannot be null!");
|
return handler.finalize(itemStack);
|
||||||
|
|
||||||
if (itemStack.getType().getMaxStackSize() > 1) {
|
|
||||||
return itemStack;
|
|
||||||
}
|
|
||||||
|
|
||||||
ItemMeta meta = itemStack.getItemMeta();
|
|
||||||
if (meta == null) {
|
|
||||||
return itemStack;
|
|
||||||
}
|
|
||||||
|
|
||||||
PersistentDataContainer container = meta.getPersistentDataContainer();
|
|
||||||
container.set(finalizeKey, PersistentDataType.INTEGER, 1);
|
|
||||||
itemStack.setItemMeta(meta);
|
|
||||||
return itemStack;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Unfinalize an ItemStacks.
|
* Unfinalize an ItemStacks.
|
||||||
*
|
*
|
||||||
* @param itemStack The item.
|
* @param itemStack The item.
|
||||||
* @return The itemstack.
|
* @return The ItemStack.
|
||||||
*/
|
*/
|
||||||
public ItemStack unfinalize(@NotNull final ItemStack itemStack) {
|
public ItemStack unfinalize(@NotNull final ItemStack itemStack) {
|
||||||
Validate.notNull(finalizeKey, "Key cannot be null!");
|
return handler.unfinalize(itemStack);
|
||||||
|
|
||||||
ItemMeta meta = itemStack.getItemMeta();
|
|
||||||
|
|
||||||
if (meta == null) {
|
|
||||||
return itemStack;
|
|
||||||
}
|
|
||||||
|
|
||||||
PersistentDataContainer container = meta.getPersistentDataContainer();
|
|
||||||
container.remove(finalizeKey);
|
|
||||||
itemStack.setItemMeta(meta);
|
|
||||||
return itemStack;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -186,31 +103,77 @@ public class Display {
|
|||||||
* @return If finalized.
|
* @return If finalized.
|
||||||
*/
|
*/
|
||||||
public boolean isFinalized(@NotNull final ItemStack itemStack) {
|
public boolean isFinalized(@NotNull final ItemStack itemStack) {
|
||||||
Validate.notNull(finalizeKey, "Key cannot be null!");
|
return handler.isFinalized(itemStack);
|
||||||
|
|
||||||
ItemMeta meta = itemStack.getItemMeta();
|
|
||||||
|
|
||||||
if (meta == null) {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
|
|
||||||
PersistentDataContainer container = meta.getPersistentDataContainer();
|
|
||||||
return container.has(finalizeKey, PersistentDataType.INTEGER);
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Set key to be used for finalization.
|
* Register a new display module.
|
||||||
*
|
*
|
||||||
* @param finalizeKey The key.
|
* @param module The module.
|
||||||
*/
|
*/
|
||||||
@ApiStatus.Internal
|
public void registerDisplayModule(@NotNull final DisplayModule module) {
|
||||||
public static void setFinalizeKey(@NotNull final NamespacedKey finalizeKey) {
|
handler.registerDisplayModule(module);
|
||||||
Display.finalizeKey = finalizeKey;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
static {
|
/**
|
||||||
for (DisplayPriority priority : DisplayPriority.values()) {
|
* Initialize the display system.
|
||||||
MODULES.put(priority, new ArrayList<>());
|
*
|
||||||
|
* @param handler The handler.
|
||||||
|
*/
|
||||||
|
@ApiStatus.Internal
|
||||||
|
public static void init(@NotNull final DisplayHandler handler) {
|
||||||
|
if (Display.handler != null) {
|
||||||
|
throw new IllegalArgumentException("Already Initialized!");
|
||||||
}
|
}
|
||||||
|
Display.handler = handler;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Extremely janky method - also internal, so don't use it. <b>This method is
|
||||||
|
* NOT part of the API and may be removed at any time!</b>
|
||||||
|
* <p>
|
||||||
|
* This calls a display module with the specified parameters, now
|
||||||
|
* you might ask why I need a static java method when the DisplayHandler
|
||||||
|
* implementation could just call it itself? Well, kotlin doesn't really
|
||||||
|
* like dealing with vararg ambiguity, and so while kotlin can't figure out
|
||||||
|
* what is and isn't a vararg when I call display with a player, java can.
|
||||||
|
* <p>
|
||||||
|
* Because of this, I need to have this part of the code in java.
|
||||||
|
*
|
||||||
|
* <b>Don't call this method as part of your plugins!</b>
|
||||||
|
* <p>
|
||||||
|
* No, seriously - don't. This skips a bunch of checks and you'll almost
|
||||||
|
* definitely break something.
|
||||||
|
*
|
||||||
|
* @param module The display module.
|
||||||
|
* @param itemStack The ItemStack.
|
||||||
|
* @param player The player.
|
||||||
|
* @param args The args.
|
||||||
|
*/
|
||||||
|
@ApiStatus.Internal
|
||||||
|
public static void callDisplayModule(@NotNull final DisplayModule module,
|
||||||
|
@NotNull final ItemStack itemStack,
|
||||||
|
@Nullable final Player player,
|
||||||
|
@NotNull final Object... args) {
|
||||||
|
module.display(itemStack, args);
|
||||||
|
if (player != null) {
|
||||||
|
module.display(itemStack, player, args);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the display handler.
|
||||||
|
* <p>
|
||||||
|
* Internal API component, you will cause bugs if you create your own handler.
|
||||||
|
*
|
||||||
|
* @param handler The handler.
|
||||||
|
*/
|
||||||
|
@ApiStatus.Internal
|
||||||
|
public static void setHandler(@NotNull final DisplayHandler handler) {
|
||||||
|
if (Display.handler != null) {
|
||||||
|
throw new IllegalStateException("Display already initialized!");
|
||||||
|
}
|
||||||
|
|
||||||
|
Display.handler = handler;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,60 @@
|
|||||||
|
package com.willfp.eco.core.display;
|
||||||
|
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.bukkit.inventory.ItemStack;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
import org.jetbrains.annotations.Nullable;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Interface for display implementations.
|
||||||
|
*/
|
||||||
|
public interface DisplayHandler {
|
||||||
|
/**
|
||||||
|
* Register display module.
|
||||||
|
*
|
||||||
|
* @param module The module.
|
||||||
|
*/
|
||||||
|
void registerDisplayModule(@NotNull DisplayModule module);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Display on ItemStacks.
|
||||||
|
*
|
||||||
|
* @param itemStack The item.
|
||||||
|
* @param player The player.
|
||||||
|
* @return The ItemStack.
|
||||||
|
*/
|
||||||
|
ItemStack display(@NotNull ItemStack itemStack,
|
||||||
|
@Nullable Player player);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Revert on ItemStacks.
|
||||||
|
*
|
||||||
|
* @param itemStack The item.
|
||||||
|
* @return The ItemStack.
|
||||||
|
*/
|
||||||
|
ItemStack revert(@NotNull ItemStack itemStack);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Finalize an ItemStacks.
|
||||||
|
*
|
||||||
|
* @param itemStack The item.
|
||||||
|
* @return The ItemStack.
|
||||||
|
*/
|
||||||
|
ItemStack finalize(@NotNull ItemStack itemStack);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Unfinalize an ItemStacks.
|
||||||
|
*
|
||||||
|
* @param itemStack The item.
|
||||||
|
* @return The ItemStack.
|
||||||
|
*/
|
||||||
|
ItemStack unfinalize(@NotNull ItemStack itemStack);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* If an item is finalized.
|
||||||
|
*
|
||||||
|
* @param itemStack The item.
|
||||||
|
* @return If finalized.
|
||||||
|
*/
|
||||||
|
boolean isFinalized(@NotNull ItemStack itemStack);
|
||||||
|
}
|
||||||
@@ -1,11 +1,16 @@
|
|||||||
package com.willfp.eco.core.display;
|
package com.willfp.eco.core.display;
|
||||||
|
|
||||||
import com.willfp.eco.core.PluginDependent;
|
|
||||||
import com.willfp.eco.core.EcoPlugin;
|
import com.willfp.eco.core.EcoPlugin;
|
||||||
|
import com.willfp.eco.core.PluginDependent;
|
||||||
import lombok.Getter;
|
import lombok.Getter;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
import org.bukkit.inventory.ItemStack;
|
import org.bukkit.inventory.ItemStack;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
import org.jetbrains.annotations.Nullable;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Class for all plugin-specific client-side item display modules.
|
||||||
|
*/
|
||||||
public abstract class DisplayModule extends PluginDependent<EcoPlugin> {
|
public abstract class DisplayModule extends PluginDependent<EcoPlugin> {
|
||||||
/**
|
/**
|
||||||
* The priority of the module.
|
* The priority of the module.
|
||||||
@@ -31,7 +36,20 @@ public abstract class DisplayModule extends PluginDependent<EcoPlugin> {
|
|||||||
* @param itemStack The item.
|
* @param itemStack The item.
|
||||||
* @param args Optional args for display.
|
* @param args Optional args for display.
|
||||||
*/
|
*/
|
||||||
protected void display(@NotNull final ItemStack itemStack,
|
public void display(@NotNull final ItemStack itemStack,
|
||||||
|
@NotNull final Object... args) {
|
||||||
|
// Technically optional.
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Display an item.
|
||||||
|
*
|
||||||
|
* @param itemStack The item.
|
||||||
|
* @param player The player.
|
||||||
|
* @param args Optional args for display.
|
||||||
|
*/
|
||||||
|
public void display(@NotNull final ItemStack itemStack,
|
||||||
|
@Nullable final Player player,
|
||||||
@NotNull final Object... args) {
|
@NotNull final Object... args) {
|
||||||
// Technically optional.
|
// Technically optional.
|
||||||
}
|
}
|
||||||
@@ -41,17 +59,17 @@ public abstract class DisplayModule extends PluginDependent<EcoPlugin> {
|
|||||||
*
|
*
|
||||||
* @param itemStack The item.
|
* @param itemStack The item.
|
||||||
*/
|
*/
|
||||||
protected void revert(@NotNull final ItemStack itemStack) {
|
public void revert(@NotNull final ItemStack itemStack) {
|
||||||
// Technically optional.
|
// Technically optional.
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Create varargs to pass back to itemstack after reverting, but before display.
|
* Create varargs to pass back to ItemStack after reverting, but before display.
|
||||||
*
|
*
|
||||||
* @param itemStack The itemStack.
|
* @param itemStack The itemStack.
|
||||||
* @return The plugin-specific varargs.
|
* @return The plugin-specific varargs.
|
||||||
*/
|
*/
|
||||||
protected Object[] generateVarArgs(@NotNull final ItemStack itemStack) {
|
public Object[] generateVarArgs(@NotNull final ItemStack itemStack) {
|
||||||
return new Object[0];
|
return new Object[0];
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -60,7 +78,7 @@ public abstract class DisplayModule extends PluginDependent<EcoPlugin> {
|
|||||||
*
|
*
|
||||||
* @return The plugin name.
|
* @return The plugin name.
|
||||||
*/
|
*/
|
||||||
final String getPluginName() {
|
public final String getPluginName() {
|
||||||
return super.getPlugin().getName();
|
return super.getPlugin().getName();
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,5 +1,8 @@
|
|||||||
package com.willfp.eco.core.display;
|
package com.willfp.eco.core.display;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The priority (order) of display modules.
|
||||||
|
*/
|
||||||
public enum DisplayPriority {
|
public enum DisplayPriority {
|
||||||
/**
|
/**
|
||||||
* Ran first.
|
* Ran first.
|
||||||
|
|||||||
@@ -1,10 +1,6 @@
|
|||||||
package com.willfp.eco.core.drops;
|
package com.willfp.eco.core.drops;
|
||||||
|
|
||||||
import com.willfp.eco.internal.drops.AbstractDropQueue;
|
import com.willfp.eco.core.Eco;
|
||||||
import com.willfp.eco.internal.drops.DropManager;
|
|
||||||
import com.willfp.eco.internal.drops.DropQueueType;
|
|
||||||
import com.willfp.eco.internal.drops.impl.FastCollatedDropQueue;
|
|
||||||
import com.willfp.eco.internal.drops.impl.InternalDropQueue;
|
|
||||||
import org.bukkit.Location;
|
import org.bukkit.Location;
|
||||||
import org.bukkit.entity.Player;
|
import org.bukkit.entity.Player;
|
||||||
import org.bukkit.inventory.ItemStack;
|
import org.bukkit.inventory.ItemStack;
|
||||||
@@ -12,21 +8,26 @@ import org.jetbrains.annotations.NotNull;
|
|||||||
|
|
||||||
import java.util.Collection;
|
import java.util.Collection;
|
||||||
|
|
||||||
public class DropQueue {
|
/**
|
||||||
/**
|
* A {@link DropQueue} is a set of drops linked to player.
|
||||||
* The internally used {@link AbstractDropQueue}.
|
|
||||||
*/
|
|
||||||
private final AbstractDropQueue handle;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create {@link DropQueue} linked to player.
|
|
||||||
* <p>
|
* <p>
|
||||||
* All drops should be passed through a drop queue for telekinesis integration.
|
* All drops should be passed through a drop queue for telekinesis integration.
|
||||||
|
* <p>
|
||||||
|
* It functions essentially as a builder class, and runs very quickly.
|
||||||
*
|
*
|
||||||
|
* @see com.willfp.eco.util.TelekinesisUtils
|
||||||
|
*/
|
||||||
|
public class DropQueue {
|
||||||
|
/**
|
||||||
|
* The internally used {@link DropQueue}.
|
||||||
|
*/
|
||||||
|
private final InternalDropQueue handle;
|
||||||
|
|
||||||
|
/**
|
||||||
* @param player The player.
|
* @param player The player.
|
||||||
*/
|
*/
|
||||||
public DropQueue(@NotNull final Player player) {
|
public DropQueue(@NotNull final Player player) {
|
||||||
handle = DropManager.getType() == DropQueueType.COLLATED ? new FastCollatedDropQueue(player) : new InternalDropQueue(player);
|
handle = Eco.getHandler().getDropQueueFactory().create(player);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -0,0 +1,17 @@
|
|||||||
|
package com.willfp.eco.core.drops;
|
||||||
|
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Internal component to create backend DropQueue implementations.
|
||||||
|
*/
|
||||||
|
public interface DropQueueFactory {
|
||||||
|
/**
|
||||||
|
* Create a DropQueue.
|
||||||
|
*
|
||||||
|
* @param player The player.
|
||||||
|
* @return The Queue.
|
||||||
|
*/
|
||||||
|
InternalDropQueue create(@NotNull Player player);
|
||||||
|
}
|
||||||
@@ -1,4 +1,4 @@
|
|||||||
package com.willfp.eco.internal.drops;
|
package com.willfp.eco.core.drops;
|
||||||
|
|
||||||
import org.bukkit.Location;
|
import org.bukkit.Location;
|
||||||
import org.bukkit.inventory.ItemStack;
|
import org.bukkit.inventory.ItemStack;
|
||||||
@@ -6,14 +6,17 @@ import org.jetbrains.annotations.NotNull;
|
|||||||
|
|
||||||
import java.util.Collection;
|
import java.util.Collection;
|
||||||
|
|
||||||
public interface AbstractDropQueue {
|
/**
|
||||||
|
* Internal interface for backend DropQueue implementations.
|
||||||
|
*/
|
||||||
|
public interface InternalDropQueue {
|
||||||
/**
|
/**
|
||||||
* Add item to queue.
|
* Add item to queue.
|
||||||
*
|
*
|
||||||
* @param item The item to add.
|
* @param item The item to add.
|
||||||
* @return The DropQueue.
|
* @return The DropQueue.
|
||||||
*/
|
*/
|
||||||
AbstractDropQueue addItem(@NotNull ItemStack item);
|
InternalDropQueue addItem(@NotNull ItemStack item);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Add multiple items to queue.
|
* Add multiple items to queue.
|
||||||
@@ -21,7 +24,7 @@ public interface AbstractDropQueue {
|
|||||||
* @param itemStacks The items to add.
|
* @param itemStacks The items to add.
|
||||||
* @return The DropQueue.
|
* @return The DropQueue.
|
||||||
*/
|
*/
|
||||||
AbstractDropQueue addItems(@NotNull Collection<ItemStack> itemStacks);
|
InternalDropQueue addItems(@NotNull Collection<ItemStack> itemStacks);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Add xp to queue.
|
* Add xp to queue.
|
||||||
@@ -29,7 +32,7 @@ public interface AbstractDropQueue {
|
|||||||
* @param amount The amount to add.
|
* @param amount The amount to add.
|
||||||
* @return The DropQueue.
|
* @return The DropQueue.
|
||||||
*/
|
*/
|
||||||
AbstractDropQueue addXP(int amount);
|
InternalDropQueue addXP(int amount);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Set location of the origin of the drops.
|
* Set location of the origin of the drops.
|
||||||
@@ -37,14 +40,14 @@ public interface AbstractDropQueue {
|
|||||||
* @param location The location.
|
* @param location The location.
|
||||||
* @return The DropQueue.
|
* @return The DropQueue.
|
||||||
*/
|
*/
|
||||||
AbstractDropQueue setLocation(@NotNull Location location);
|
InternalDropQueue setLocation(@NotNull Location location);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Force the queue to act as if player is telekinetic.
|
* Force the queue to act as if player is telekinetic.
|
||||||
*
|
*
|
||||||
* @return The DropQueue.
|
* @return The DropQueue.
|
||||||
*/
|
*/
|
||||||
AbstractDropQueue forceTelekinesis();
|
InternalDropQueue forceTelekinesis();
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Push the queue.
|
* Push the queue.
|
||||||
@@ -0,0 +1,70 @@
|
|||||||
|
package com.willfp.eco.core.events;
|
||||||
|
|
||||||
|
import lombok.Getter;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.bukkit.event.HandlerList;
|
||||||
|
import org.bukkit.event.player.PlayerEvent;
|
||||||
|
import org.bukkit.inventory.ItemStack;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The armor change event <b>does</b> contain information about the event.
|
||||||
|
* <p>
|
||||||
|
* Unlike {@link ArmorEquipEvent}, it is called the next tick and contains previous and current armor contents.
|
||||||
|
*/
|
||||||
|
public class ArmorChangeEvent extends PlayerEvent {
|
||||||
|
/**
|
||||||
|
* Bukkit parity.
|
||||||
|
*/
|
||||||
|
private static final HandlerList HANDLERS = new HandlerList();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The armor contents before. 0 is helmet, 3 is boots.
|
||||||
|
*/
|
||||||
|
@Getter
|
||||||
|
private final List<ItemStack> before;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The armor contents after. 0 is helmet, 3 is boots.
|
||||||
|
*/
|
||||||
|
@Getter
|
||||||
|
private final List<ItemStack> after;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a new ArmorChangeEvent.
|
||||||
|
*
|
||||||
|
* @param player The player.
|
||||||
|
* @param before The armor contents before.
|
||||||
|
* @param after The armor contents after.
|
||||||
|
*/
|
||||||
|
public ArmorChangeEvent(@NotNull final Player player,
|
||||||
|
@NotNull final List<ItemStack> before,
|
||||||
|
@NotNull final List<ItemStack> after) {
|
||||||
|
super(player);
|
||||||
|
this.before = before;
|
||||||
|
this.after = after;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Gets a list of handlers handling this event.
|
||||||
|
*
|
||||||
|
* @return A list of handlers handling this event.
|
||||||
|
*/
|
||||||
|
|
||||||
|
@Override
|
||||||
|
@NotNull
|
||||||
|
public HandlerList getHandlers() {
|
||||||
|
return HANDLERS;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Bukkit parity.
|
||||||
|
*
|
||||||
|
* @return The handler list.
|
||||||
|
*/
|
||||||
|
public static HandlerList getHandlerList() {
|
||||||
|
return HANDLERS;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -5,10 +5,28 @@ import org.bukkit.event.HandlerList;
|
|||||||
import org.bukkit.event.player.PlayerEvent;
|
import org.bukkit.event.player.PlayerEvent;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The armor equip event <b>does not contain information about the event.</b>
|
||||||
|
* <p>
|
||||||
|
* It is purely a trigger called whenever a player changes armor, you have to run
|
||||||
|
* your own checks.
|
||||||
|
* <p>
|
||||||
|
* The event is called before the player's inventory actually updates,
|
||||||
|
* so you can check a tick later to see the new contents.
|
||||||
|
*
|
||||||
|
* @see ArmorChangeEvent
|
||||||
|
*/
|
||||||
public class ArmorEquipEvent extends PlayerEvent {
|
public class ArmorEquipEvent extends PlayerEvent {
|
||||||
|
/**
|
||||||
|
* Bukkit parity.
|
||||||
|
*/
|
||||||
private static final HandlerList HANDLERS = new HandlerList();
|
private static final HandlerList HANDLERS = new HandlerList();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a new ArmorEquipEvent.
|
||||||
|
*
|
||||||
|
* @param player The player.
|
||||||
|
*/
|
||||||
public ArmorEquipEvent(@NotNull final Player player) {
|
public ArmorEquipEvent(@NotNull final Player player) {
|
||||||
super(player);
|
super(player);
|
||||||
}
|
}
|
||||||
@@ -25,6 +43,11 @@ public class ArmorEquipEvent extends PlayerEvent {
|
|||||||
return HANDLERS;
|
return HANDLERS;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Bukkit parity.
|
||||||
|
*
|
||||||
|
* @return The handler list.
|
||||||
|
*/
|
||||||
public static HandlerList getHandlerList() {
|
public static HandlerList getHandlerList() {
|
||||||
return HANDLERS;
|
return HANDLERS;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -12,7 +12,9 @@ import org.jetbrains.annotations.NotNull;
|
|||||||
import java.util.List;
|
import java.util.List;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Event triggered when entity is killed by entity.
|
* Event called when an entity is killed by another entity.
|
||||||
|
* <p>
|
||||||
|
* Not sure why spigot doesn't have this event normally.
|
||||||
*/
|
*/
|
||||||
public class EntityDeathByEntityEvent extends Event {
|
public class EntityDeathByEntityEvent extends Event {
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -2,6 +2,9 @@ package com.willfp.eco.core.events;
|
|||||||
|
|
||||||
import org.bukkit.event.Listener;
|
import org.bukkit.event.Listener;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Manages listeners for a plugin.
|
||||||
|
*/
|
||||||
public interface EventManager {
|
public interface EventManager {
|
||||||
/**
|
/**
|
||||||
* Register a listener with bukkit.
|
* Register a listener with bukkit.
|
||||||
|
|||||||
@@ -6,6 +6,10 @@ import org.bukkit.event.HandlerList;
|
|||||||
import org.bukkit.event.player.PlayerExpChangeEvent;
|
import org.bukkit.event.player.PlayerExpChangeEvent;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Event similar to {@link PlayerExpChangeEvent}, except it
|
||||||
|
* isn't called if the exp is from a bottle.
|
||||||
|
*/
|
||||||
public class NaturalExpGainEvent extends Event {
|
public class NaturalExpGainEvent extends Event {
|
||||||
/**
|
/**
|
||||||
* Internal bukkit.
|
* Internal bukkit.
|
||||||
|
|||||||
@@ -1,15 +1,25 @@
|
|||||||
package com.willfp.eco.core.events;
|
package com.willfp.eco.core.events;
|
||||||
|
|
||||||
|
import org.bukkit.Location;
|
||||||
import org.bukkit.event.HandlerList;
|
import org.bukkit.event.HandlerList;
|
||||||
import org.bukkit.event.player.PlayerMoveEvent;
|
import org.bukkit.event.player.PlayerMoveEvent;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
import org.jetbrains.annotations.Nullable;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Event called when a player jumps.
|
||||||
|
*/
|
||||||
public class PlayerJumpEvent extends PlayerMoveEvent {
|
public class PlayerJumpEvent extends PlayerMoveEvent {
|
||||||
/**
|
/**
|
||||||
* Internal bukkit.
|
* Internal bukkit.
|
||||||
*/
|
*/
|
||||||
private static final HandlerList HANDLERS = new HandlerList();
|
private static final HandlerList HANDLERS = new HandlerList();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The handled event.
|
||||||
|
*/
|
||||||
|
private final PlayerMoveEvent handle;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Create a new PlayerJumpEvent.
|
* Create a new PlayerJumpEvent.
|
||||||
*
|
*
|
||||||
@@ -17,6 +27,8 @@ public class PlayerJumpEvent extends PlayerMoveEvent {
|
|||||||
*/
|
*/
|
||||||
public PlayerJumpEvent(@NotNull final PlayerMoveEvent event) {
|
public PlayerJumpEvent(@NotNull final PlayerMoveEvent event) {
|
||||||
super(event.getPlayer(), event.getFrom(), event.getTo());
|
super(event.getPlayer(), event.getFrom(), event.getTo());
|
||||||
|
|
||||||
|
this.handle = event;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -37,4 +49,36 @@ public class PlayerJumpEvent extends PlayerMoveEvent {
|
|||||||
public static @NotNull HandlerList getHandlerList() {
|
public static @NotNull HandlerList getHandlerList() {
|
||||||
return HANDLERS;
|
return HANDLERS;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean isCancelled() {
|
||||||
|
return handle.isCancelled();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void setCancelled(final boolean cancel) {
|
||||||
|
handle.setCancelled(cancel);
|
||||||
|
}
|
||||||
|
|
||||||
|
@NotNull
|
||||||
|
@Override
|
||||||
|
public Location getFrom() {
|
||||||
|
return handle.getFrom();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void setFrom(@NotNull final Location from) {
|
||||||
|
handle.setFrom(from);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Nullable
|
||||||
|
@Override
|
||||||
|
public Location getTo() {
|
||||||
|
return handle.getTo();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void setTo(@NotNull final Location to) {
|
||||||
|
handle.setTo(to);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,13 +1,27 @@
|
|||||||
package com.willfp.eco.core.extensions;
|
package com.willfp.eco.core.extensions;
|
||||||
|
|
||||||
import com.willfp.eco.internal.extensions.ExtensionMetadata;
|
|
||||||
import com.willfp.eco.core.EcoPlugin;
|
import com.willfp.eco.core.EcoPlugin;
|
||||||
|
import com.willfp.eco.core.PluginLike;
|
||||||
|
import com.willfp.eco.core.config.updating.ConfigHandler;
|
||||||
import lombok.AccessLevel;
|
import lombok.AccessLevel;
|
||||||
import lombok.Getter;
|
import lombok.Getter;
|
||||||
import org.apache.commons.lang.Validate;
|
import org.apache.commons.lang.Validate;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
public abstract class Extension {
|
import java.io.File;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* An extension is a separate jar file that hooks into the base plugin jar.
|
||||||
|
* <p>
|
||||||
|
* If you take PlaceholderAPI as an example, the PAPI expansions are identical to
|
||||||
|
* extensions.
|
||||||
|
* <p>
|
||||||
|
* Syntactically, extensions are very similar to plugins in their own right, except that
|
||||||
|
* they are loaded by another plugin.
|
||||||
|
*
|
||||||
|
* @see <a href="https://auxilor.polymart.org">Extension examples.</a>
|
||||||
|
*/
|
||||||
|
public abstract class Extension implements PluginLike {
|
||||||
/**
|
/**
|
||||||
* The {@link EcoPlugin} that this extension is for.
|
* The {@link EcoPlugin} that this extension is for.
|
||||||
*/
|
*/
|
||||||
@@ -74,6 +88,16 @@ public abstract class Extension {
|
|||||||
return this.metadata.name();
|
return this.metadata.name();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the author of the extension.
|
||||||
|
*
|
||||||
|
* @return The author of the metadata attached to the extension.
|
||||||
|
*/
|
||||||
|
public final String getAuthor() {
|
||||||
|
Validate.notNull(metadata, "Metadata cannot be null!");
|
||||||
|
return this.metadata.author();
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Get the version of the extension.
|
* Get the version of the extension.
|
||||||
*
|
*
|
||||||
@@ -83,4 +107,14 @@ public abstract class Extension {
|
|||||||
Validate.notNull(metadata, "Metadata cannot be null!");
|
Validate.notNull(metadata, "Metadata cannot be null!");
|
||||||
return this.metadata.version();
|
return this.metadata.version();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public File getDataFolder() {
|
||||||
|
return this.plugin.getDataFolder();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public ConfigHandler getConfigHandler() {
|
||||||
|
return this.plugin.getConfigHandler();
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -3,11 +3,9 @@ package com.willfp.eco.core.extensions;
|
|||||||
import java.util.Set;
|
import java.util.Set;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Interface for extension loader.
|
* Internal component to manage loading and unloading extensions.
|
||||||
* Some external plugins may modify extension loading for internal server purposes.
|
|
||||||
*/
|
*/
|
||||||
public interface ExtensionLoader {
|
public interface ExtensionLoader {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Load all extensions.
|
* Load all extensions.
|
||||||
*/
|
*/
|
||||||
|
|||||||
@@ -0,0 +1,18 @@
|
|||||||
|
package com.willfp.eco.core.extensions;
|
||||||
|
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The extension's metadata.
|
||||||
|
* <p>
|
||||||
|
* Stored as a record internally.
|
||||||
|
*
|
||||||
|
* @param version The extension version.
|
||||||
|
* @param name The extension name.
|
||||||
|
* @param author The extension's author.
|
||||||
|
*/
|
||||||
|
public record ExtensionMetadata(@NotNull String version,
|
||||||
|
@NotNull String name,
|
||||||
|
@NotNull String author) {
|
||||||
|
|
||||||
|
}
|
||||||
@@ -3,16 +3,13 @@ package com.willfp.eco.core.extensions;
|
|||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Called when the extension is made incorrectly.
|
|
||||||
*/
|
|
||||||
public class MalformedExtensionException extends RuntimeException {
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create a new MalformedExtensionException.
|
|
||||||
* <p>
|
|
||||||
* Potential causes include:
|
* Potential causes include:
|
||||||
* Missing or invalid extension.yml.
|
* Missing or invalid extension.yml.
|
||||||
* Invalid filetype.
|
* Invalid filetype.
|
||||||
|
*/
|
||||||
|
public class MalformedExtensionException extends RuntimeException {
|
||||||
|
/**
|
||||||
|
* Create a new MalformedExtensionException.
|
||||||
*
|
*
|
||||||
* @param errorMessage The error message to show.
|
* @param errorMessage The error message to show.
|
||||||
*/
|
*/
|
||||||
|
|||||||
@@ -3,6 +3,9 @@ package com.willfp.eco.core.factory;
|
|||||||
import org.bukkit.metadata.FixedMetadataValue;
|
import org.bukkit.metadata.FixedMetadataValue;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Factory to create metadata values for a specific plugin.
|
||||||
|
*/
|
||||||
public interface MetadataValueFactory {
|
public interface MetadataValueFactory {
|
||||||
/**
|
/**
|
||||||
* Create a metadata value for a given plugin and object.
|
* Create a metadata value for a given plugin and object.
|
||||||
|
|||||||
@@ -3,6 +3,9 @@ package com.willfp.eco.core.factory;
|
|||||||
import org.bukkit.NamespacedKey;
|
import org.bukkit.NamespacedKey;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Factory to create {@link NamespacedKey}s for a plugin.
|
||||||
|
*/
|
||||||
public interface NamespacedKeyFactory {
|
public interface NamespacedKeyFactory {
|
||||||
/**
|
/**
|
||||||
* Create an {@link NamespacedKey} associated with an {@link com.willfp.eco.core.EcoPlugin}.
|
* Create an {@link NamespacedKey} associated with an {@link com.willfp.eco.core.EcoPlugin}.
|
||||||
|
|||||||
@@ -5,6 +5,10 @@ import org.jetbrains.annotations.NotNull;
|
|||||||
|
|
||||||
import java.util.function.Consumer;
|
import java.util.function.Consumer;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Factory to create runnables. Much cleaner syntax than instantiating
|
||||||
|
* {@link org.bukkit.scheduler.BukkitRunnable}s.
|
||||||
|
*/
|
||||||
public interface RunnableFactory {
|
public interface RunnableFactory {
|
||||||
/**
|
/**
|
||||||
* Create a {@link RunnableTask}.
|
* Create a {@link RunnableTask}.
|
||||||
|
|||||||
@@ -0,0 +1,113 @@
|
|||||||
|
package com.willfp.eco.core.fast;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.Eco;
|
||||||
|
import org.bukkit.Material;
|
||||||
|
import org.bukkit.enchantments.Enchantment;
|
||||||
|
import org.bukkit.inventory.ItemFlag;
|
||||||
|
import org.bukkit.inventory.ItemStack;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
import org.jetbrains.annotations.Nullable;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
import java.util.Objects;
|
||||||
|
import java.util.Set;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* FastItemStack contains methods to modify and read items faster than in default bukkit.
|
||||||
|
*/
|
||||||
|
public interface FastItemStack {
|
||||||
|
/**
|
||||||
|
* Get all enchantments on an item.
|
||||||
|
*
|
||||||
|
* @param checkStored If stored NBT should also be checked.
|
||||||
|
* @return A map of all enchantments.
|
||||||
|
*/
|
||||||
|
Map<Enchantment, Integer> getEnchantmentsOnItem(boolean checkStored);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the level of an enchantment on an item.
|
||||||
|
*
|
||||||
|
* @param enchantment The enchantment.
|
||||||
|
* @param checkStored If the stored NBT should also be checked.
|
||||||
|
* @return The enchantment level, or 0 if not found.
|
||||||
|
*/
|
||||||
|
int getLevelOnItem(@NotNull Enchantment enchantment,
|
||||||
|
boolean checkStored);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the item lore.
|
||||||
|
*
|
||||||
|
* @param lore The lore.
|
||||||
|
*/
|
||||||
|
void setLore(@Nullable List<String> lore);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the item lore.
|
||||||
|
*
|
||||||
|
* @return The lore.
|
||||||
|
*/
|
||||||
|
List<String> getLore();
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the rework penalty.
|
||||||
|
*
|
||||||
|
* @param cost The rework penalty to set.
|
||||||
|
*/
|
||||||
|
void setRepairCost(int cost);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the rework penalty.
|
||||||
|
* .
|
||||||
|
*
|
||||||
|
* @return The rework penalty found on the item.
|
||||||
|
*/
|
||||||
|
int getRepairCost();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add ItemFlags.
|
||||||
|
*
|
||||||
|
* @param hideFlags The flags.
|
||||||
|
*/
|
||||||
|
void addItemFlags(ItemFlag... hideFlags);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Remove ItemFlags.
|
||||||
|
*
|
||||||
|
* @param hideFlags The flags.
|
||||||
|
*/
|
||||||
|
void removeItemFlags(ItemFlag... hideFlags);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the ItemFlags.
|
||||||
|
*
|
||||||
|
* @return The flags.
|
||||||
|
*/
|
||||||
|
Set<ItemFlag> getItemFlags();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Test the item for a flag.
|
||||||
|
*
|
||||||
|
* @param flag The flag.
|
||||||
|
* @return If the flag is present.
|
||||||
|
*/
|
||||||
|
boolean hasItemFlag(ItemFlag flag);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the Bukkit ItemStack again.
|
||||||
|
*
|
||||||
|
* @return The ItemStack.
|
||||||
|
*/
|
||||||
|
ItemStack unwrap();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Wrap an ItemStack to create a FastItemStack.
|
||||||
|
*
|
||||||
|
* @param itemStack The ItemStack.
|
||||||
|
* @return The FastItemStack.
|
||||||
|
*/
|
||||||
|
static FastItemStack wrap(@Nullable final ItemStack itemStack) {
|
||||||
|
return Eco.getHandler().createFastItemStack(Objects.requireNonNullElseGet(itemStack, () -> new ItemStack(Material.AIR)));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
package com.willfp.eco.core.gui;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.gui.menu.MenuBuilder;
|
||||||
|
import com.willfp.eco.core.gui.slot.SlotBuilder;
|
||||||
|
import com.willfp.eco.core.gui.slot.functional.SlotProvider;
|
||||||
|
import org.bukkit.inventory.ItemStack;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Internal component used by {@link com.willfp.eco.core.gui.menu.Menu#builder(int)}
|
||||||
|
* and {@link com.willfp.eco.core.gui.slot.Slot#builder(ItemStack)}.
|
||||||
|
*/
|
||||||
|
public interface GUIFactory {
|
||||||
|
/**
|
||||||
|
* Create slot builder.
|
||||||
|
*
|
||||||
|
* @param provider The provider.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
SlotBuilder createSlotBuilder(@NotNull SlotProvider provider);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create menu builder.
|
||||||
|
*
|
||||||
|
* @param rows The amount of rows.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
MenuBuilder createMenuBuilder(int rows);
|
||||||
|
}
|
||||||
@@ -0,0 +1,19 @@
|
|||||||
|
package com.willfp.eco.core.gui.menu;
|
||||||
|
|
||||||
|
import org.bukkit.event.inventory.InventoryCloseEvent;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Interface to run on menu close.
|
||||||
|
*/
|
||||||
|
@FunctionalInterface
|
||||||
|
public interface CloseHandler {
|
||||||
|
/**
|
||||||
|
* Performs this operation on the given arguments.
|
||||||
|
*
|
||||||
|
* @param event The close event.
|
||||||
|
* @param menu The menu.
|
||||||
|
*/
|
||||||
|
void handle(@NotNull InventoryCloseEvent event,
|
||||||
|
@NotNull Menu menu);
|
||||||
|
}
|
||||||
@@ -1,60 +0,0 @@
|
|||||||
package com.willfp.eco.core.gui.menu;
|
|
||||||
|
|
||||||
import com.willfp.eco.core.gui.slot.Slot;
|
|
||||||
import com.willfp.eco.core.items.builder.ItemStackBuilder;
|
|
||||||
import com.willfp.eco.internal.gui.FillerSlot;
|
|
||||||
import com.willfp.eco.util.ListUtils;
|
|
||||||
import lombok.Getter;
|
|
||||||
import org.bukkit.Material;
|
|
||||||
import org.bukkit.inventory.ItemStack;
|
|
||||||
import org.jetbrains.annotations.NotNull;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
public class FillerMask {
|
|
||||||
/**
|
|
||||||
* Mask.
|
|
||||||
*/
|
|
||||||
@Getter
|
|
||||||
private final List<List<Slot>> mask;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create a new filler mask.
|
|
||||||
*
|
|
||||||
* @param material The mask material.
|
|
||||||
* @param pattern The pattern.
|
|
||||||
*/
|
|
||||||
public FillerMask(@NotNull final Material material,
|
|
||||||
@NotNull final String... pattern) {
|
|
||||||
if (material == Material.AIR) {
|
|
||||||
throw new IllegalArgumentException("Material cannot be air!");
|
|
||||||
}
|
|
||||||
|
|
||||||
mask = ListUtils.create2DList(6, 9);
|
|
||||||
|
|
||||||
ItemStack itemStack = new ItemStackBuilder(material)
|
|
||||||
.setDisplayName("&r")
|
|
||||||
.build();
|
|
||||||
|
|
||||||
int row = 0;
|
|
||||||
|
|
||||||
for (String patternRow : pattern) {
|
|
||||||
int column = 0;
|
|
||||||
if (patternRow.length() != 9) {
|
|
||||||
throw new IllegalArgumentException("Invalid amount of columns in pattern!");
|
|
||||||
}
|
|
||||||
for (char c : patternRow.toCharArray()) {
|
|
||||||
if (c == '0') {
|
|
||||||
mask.get(row).set(column, null);
|
|
||||||
} else if (c == '1') {
|
|
||||||
mask.get(row).set(column, new FillerSlot(itemStack));
|
|
||||||
} else {
|
|
||||||
throw new IllegalArgumentException("Invalid character in pattern! (Must only be 0 and 1)");
|
|
||||||
}
|
|
||||||
|
|
||||||
column++;
|
|
||||||
}
|
|
||||||
row++;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,20 +1,23 @@
|
|||||||
package com.willfp.eco.core.gui.menu;
|
package com.willfp.eco.core.gui.menu;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.Eco;
|
||||||
import com.willfp.eco.core.gui.slot.Slot;
|
import com.willfp.eco.core.gui.slot.Slot;
|
||||||
import com.willfp.eco.internal.gui.EcoMenu;
|
import org.bukkit.NamespacedKey;
|
||||||
import com.willfp.eco.internal.gui.FillerSlot;
|
|
||||||
import com.willfp.eco.util.ListUtils;
|
|
||||||
import com.willfp.eco.util.StringUtils;
|
|
||||||
import org.bukkit.Material;
|
|
||||||
import org.bukkit.entity.Player;
|
import org.bukkit.entity.Player;
|
||||||
import org.bukkit.event.inventory.InventoryCloseEvent;
|
|
||||||
import org.bukkit.inventory.Inventory;
|
import org.bukkit.inventory.Inventory;
|
||||||
import org.bukkit.inventory.ItemStack;
|
import org.bukkit.inventory.ItemStack;
|
||||||
|
import org.bukkit.persistence.PersistentDataType;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
import org.jetbrains.annotations.Nullable;
|
||||||
|
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
import java.util.function.Consumer;
|
import java.util.Set;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* GUI version of {@link Inventory}.
|
||||||
|
* <p>
|
||||||
|
* A menu contains slots and is 1-indexed. (Top row has index 1, bottom row has index 6).
|
||||||
|
*/
|
||||||
public interface Menu {
|
public interface Menu {
|
||||||
/**
|
/**
|
||||||
* Get the amount of rows.
|
* Get the amount of rows.
|
||||||
@@ -48,99 +51,58 @@ public interface Menu {
|
|||||||
*/
|
*/
|
||||||
Inventory open(@NotNull Player player);
|
Inventory open(@NotNull Player player);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get captive items.
|
||||||
|
*
|
||||||
|
* @param player The player.
|
||||||
|
* @return The items.
|
||||||
|
*/
|
||||||
|
List<ItemStack> getCaptiveItems(@NotNull Player player);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Write data.
|
||||||
|
*
|
||||||
|
* @param player The player.
|
||||||
|
* @param key The key.
|
||||||
|
* @param type The type.
|
||||||
|
* @param value The value.
|
||||||
|
* @param <T> The type.
|
||||||
|
* @param <Z> The type.
|
||||||
|
*/
|
||||||
|
<T, Z> void writeData(@NotNull Player player,
|
||||||
|
@NotNull NamespacedKey key,
|
||||||
|
@NotNull PersistentDataType<T, Z> type,
|
||||||
|
@NotNull Z value);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Read data.
|
||||||
|
*
|
||||||
|
* @param player The player.
|
||||||
|
* @param key The key.
|
||||||
|
* @param type The type.
|
||||||
|
* @param <T> The type.
|
||||||
|
* @param <Z> The type.
|
||||||
|
* @return The data.
|
||||||
|
*/
|
||||||
|
@Nullable <T, Z> T readData(@NotNull Player player,
|
||||||
|
@NotNull NamespacedKey key,
|
||||||
|
@NotNull PersistentDataType<T, Z> type);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get all data keys for a player.
|
||||||
|
*
|
||||||
|
* @param player The player.
|
||||||
|
* @return The keys.
|
||||||
|
*/
|
||||||
|
Set<NamespacedKey> getKeys(@NotNull Player player);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Create a builder with a given amount of rows.
|
* Create a builder with a given amount of rows.
|
||||||
*
|
*
|
||||||
* @param rows The rows.
|
* @param rows The rows.
|
||||||
* @return The builder.
|
* @return The builder.
|
||||||
*/
|
*/
|
||||||
static Builder builder(final int rows) {
|
static MenuBuilder builder(final int rows) {
|
||||||
return new Builder(rows);
|
return Eco.getHandler().getGUIFactory().createMenuBuilder(rows);
|
||||||
}
|
|
||||||
|
|
||||||
class Builder {
|
|
||||||
/**
|
|
||||||
* The amount of rows.
|
|
||||||
*/
|
|
||||||
private final int rows;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* The title.
|
|
||||||
*/
|
|
||||||
private String title = "Menu";
|
|
||||||
|
|
||||||
/**
|
|
||||||
* The mask slots.
|
|
||||||
*/
|
|
||||||
private List<List<Slot>> maskSlots;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* The slots.
|
|
||||||
*/
|
|
||||||
private final List<List<Slot>> slots;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* The close event handler.
|
|
||||||
*/
|
|
||||||
private Consumer<InventoryCloseEvent> onClose = (event) -> {
|
|
||||||
};
|
|
||||||
|
|
||||||
Builder(final int rows) {
|
|
||||||
this.rows = rows;
|
|
||||||
this.slots = ListUtils.create2DList(rows, 9);
|
|
||||||
this.maskSlots = ListUtils.create2DList(rows, 9);
|
|
||||||
}
|
|
||||||
|
|
||||||
public Builder setTitle(@NotNull final String title) {
|
|
||||||
this.title = StringUtils.translate(title);
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
public Builder setSlot(final int row,
|
|
||||||
final int column,
|
|
||||||
@NotNull final Slot slot) {
|
|
||||||
if (row < 1 || row > this.rows) {
|
|
||||||
throw new IllegalArgumentException("Invalid row number!");
|
|
||||||
}
|
|
||||||
|
|
||||||
if (column < 1 || column > 9) {
|
|
||||||
throw new IllegalArgumentException("Invalid column number!");
|
|
||||||
}
|
|
||||||
|
|
||||||
slots.get(row - 1).set(column - 1, slot);
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
public Builder setMask(@NotNull final FillerMask mask) {
|
|
||||||
this.maskSlots = mask.getMask();
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
public Builder onClose(@NotNull final Consumer<InventoryCloseEvent> action) {
|
|
||||||
this.onClose = action;
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
public Menu build() {
|
|
||||||
List<List<Slot>> finalSlots = maskSlots;
|
|
||||||
for (int i = 0; i < slots.size(); i++) {
|
|
||||||
for (int j = 0; j < slots.get(i).size(); j++) {
|
|
||||||
Slot slot = slots.get(i).get(j);
|
|
||||||
if (slot != null) {
|
|
||||||
finalSlots.get(i).set(j, slot);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
for (List<Slot> finalSlot : finalSlots) {
|
|
||||||
for (int j = 0; j < finalSlot.size(); j++) {
|
|
||||||
if (finalSlot.get(j) == null) {
|
|
||||||
finalSlot.set(j, new FillerSlot(new ItemStack(Material.AIR)));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return new EcoMenu(rows, finalSlots, title, onClose);
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,75 @@
|
|||||||
|
package com.willfp.eco.core.gui.menu;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.gui.slot.FillerMask;
|
||||||
|
import com.willfp.eco.core.gui.slot.Slot;
|
||||||
|
import org.bukkit.event.inventory.InventoryCloseEvent;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
import java.util.function.Consumer;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Builder to create menus.
|
||||||
|
*/
|
||||||
|
public interface MenuBuilder {
|
||||||
|
/**
|
||||||
|
* Set the menu title.
|
||||||
|
*
|
||||||
|
* @param title The title.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
MenuBuilder setTitle(@NotNull String title);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set a slot.
|
||||||
|
*
|
||||||
|
* @param row The row.
|
||||||
|
* @param column The column.
|
||||||
|
* @param slot The slot.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
MenuBuilder setSlot(int row,
|
||||||
|
int column,
|
||||||
|
@NotNull Slot slot);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Run function to modify the builder.
|
||||||
|
*
|
||||||
|
* @param modifier The modifier.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
MenuBuilder modfiy(@NotNull Consumer<MenuBuilder> modifier);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the menu mask.
|
||||||
|
*
|
||||||
|
* @param mask The mask.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
MenuBuilder setMask(@NotNull FillerMask mask);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the menu close handler.
|
||||||
|
*
|
||||||
|
* @param action The handler.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
default MenuBuilder onClose(@NotNull Consumer<InventoryCloseEvent> action) {
|
||||||
|
onClose((event, menu) -> action.accept(event));
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the menu close handler.
|
||||||
|
*
|
||||||
|
* @param action The handler.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
MenuBuilder onClose(@NotNull CloseHandler action);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Build the menu.
|
||||||
|
*
|
||||||
|
* @return The menu.
|
||||||
|
*/
|
||||||
|
Menu build();
|
||||||
|
}
|
||||||
@@ -0,0 +1,85 @@
|
|||||||
|
package com.willfp.eco.core.gui.slot;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.items.builder.ItemStackBuilder;
|
||||||
|
import com.willfp.eco.util.ListUtils;
|
||||||
|
import lombok.Getter;
|
||||||
|
import org.bukkit.Material;
|
||||||
|
import org.bukkit.inventory.ItemStack;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
import java.util.Arrays;
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Mask of filler slots.
|
||||||
|
* <p>
|
||||||
|
* A pattern consists of 1s and 0s, where a 1 is a filler slot,
|
||||||
|
* and a 0 isn't.
|
||||||
|
* <p>
|
||||||
|
* For example, creating a filler mask for a single-chest sized menu would look like this:
|
||||||
|
* <p>
|
||||||
|
* new FillerMask(
|
||||||
|
* material,
|
||||||
|
* "11111111"
|
||||||
|
* "10000001"
|
||||||
|
* "11111111"
|
||||||
|
* );
|
||||||
|
*/
|
||||||
|
public class FillerMask {
|
||||||
|
/**
|
||||||
|
* Mask.
|
||||||
|
*/
|
||||||
|
@Getter
|
||||||
|
private final List<List<Slot>> mask;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a new filler mask.
|
||||||
|
*
|
||||||
|
* @param material The mask material.
|
||||||
|
* @param pattern The pattern.
|
||||||
|
*/
|
||||||
|
public FillerMask(@NotNull final Material material,
|
||||||
|
@NotNull final String... pattern) {
|
||||||
|
this(new MaskMaterials(material), pattern);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a new filler mask.
|
||||||
|
*
|
||||||
|
* @param materials The mask materials.
|
||||||
|
* @param pattern The pattern.
|
||||||
|
*/
|
||||||
|
public FillerMask(@NotNull final MaskMaterials materials,
|
||||||
|
@NotNull final String... pattern) {
|
||||||
|
if (Arrays.stream(materials.materials()).anyMatch(material -> material == Material.AIR)) {
|
||||||
|
throw new IllegalArgumentException("Materials cannot be air!");
|
||||||
|
}
|
||||||
|
|
||||||
|
mask = ListUtils.create2DList(6, 9);
|
||||||
|
|
||||||
|
for (int i = 0; i < materials.materials().length; i++) {
|
||||||
|
ItemStack itemStack = new ItemStackBuilder(materials.materials()[i])
|
||||||
|
.setDisplayName("&r")
|
||||||
|
.build();
|
||||||
|
|
||||||
|
int row = 0;
|
||||||
|
|
||||||
|
for (String patternRow : pattern) {
|
||||||
|
int column = 0;
|
||||||
|
if (patternRow.length() != 9) {
|
||||||
|
throw new IllegalArgumentException("Invalid amount of columns in pattern!");
|
||||||
|
}
|
||||||
|
for (char c : patternRow.toCharArray()) {
|
||||||
|
if (c == '0') {
|
||||||
|
mask.get(row).set(column, null);
|
||||||
|
} else if (c == Character.forDigit(i + 1, 10)) {
|
||||||
|
mask.get(row).set(column, new FillerSlot(itemStack));
|
||||||
|
}
|
||||||
|
|
||||||
|
column++;
|
||||||
|
}
|
||||||
|
row++;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
package com.willfp.eco.core.gui.slot;
|
||||||
|
|
||||||
|
import lombok.Getter;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.bukkit.inventory.ItemStack;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A filler slot is a slot that does nothing when clicked.
|
||||||
|
* <p>
|
||||||
|
* Useful for backgrounds.
|
||||||
|
*/
|
||||||
|
public class FillerSlot implements Slot {
|
||||||
|
/**
|
||||||
|
* The ItemStack.
|
||||||
|
*/
|
||||||
|
@Getter
|
||||||
|
private final ItemStack itemStack;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create new filler slot.
|
||||||
|
*
|
||||||
|
* @param itemStack The ItemStack.
|
||||||
|
*/
|
||||||
|
public FillerSlot(@NotNull final ItemStack itemStack) {
|
||||||
|
this.itemStack = itemStack;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public ItemStack getItemStack(@NotNull final Player player) {
|
||||||
|
return itemStack;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean isCaptive() {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
package com.willfp.eco.core.gui.slot;
|
||||||
|
|
||||||
|
import org.bukkit.Material;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Mask materials store a set of materials which can be accessed by
|
||||||
|
* a filler mask.
|
||||||
|
*
|
||||||
|
* @param materials The materials.
|
||||||
|
*/
|
||||||
|
public record MaskMaterials(@NotNull Material... materials) {
|
||||||
|
|
||||||
|
}
|
||||||
@@ -1,14 +1,17 @@
|
|||||||
package com.willfp.eco.core.gui.slot;
|
package com.willfp.eco.core.gui.slot;
|
||||||
|
|
||||||
import com.willfp.eco.internal.gui.EcoSlot;
|
import com.willfp.eco.core.Eco;
|
||||||
|
import com.willfp.eco.core.gui.slot.functional.SlotProvider;
|
||||||
|
import org.bukkit.Material;
|
||||||
import org.bukkit.entity.Player;
|
import org.bukkit.entity.Player;
|
||||||
import org.bukkit.event.inventory.InventoryClickEvent;
|
|
||||||
import org.bukkit.inventory.ItemStack;
|
import org.bukkit.inventory.ItemStack;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
import java.util.function.BiConsumer;
|
|
||||||
import java.util.function.Function;
|
import java.util.function.Function;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A slot is an item in a GUI that can handle clicks.
|
||||||
|
*/
|
||||||
public interface Slot {
|
public interface Slot {
|
||||||
/**
|
/**
|
||||||
* Get the ItemStack that would be shown to a player.
|
* Get the ItemStack that would be shown to a player.
|
||||||
@@ -18,14 +21,30 @@ public interface Slot {
|
|||||||
*/
|
*/
|
||||||
ItemStack getItemStack(@NotNull Player player);
|
ItemStack getItemStack(@NotNull Player player);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* If the slot is captive. (Can items be placed in it).
|
||||||
|
*
|
||||||
|
* @return If captive.
|
||||||
|
*/
|
||||||
|
boolean isCaptive();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a builder for an ItemStack.
|
||||||
|
*
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
static SlotBuilder builder() {
|
||||||
|
return Eco.getHandler().getGUIFactory().createSlotBuilder((player, menu) -> new ItemStack(Material.AIR));
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Create a builder for an ItemStack.
|
* Create a builder for an ItemStack.
|
||||||
*
|
*
|
||||||
* @param itemStack The ItemStack.
|
* @param itemStack The ItemStack.
|
||||||
* @return The builder.
|
* @return The builder.
|
||||||
*/
|
*/
|
||||||
static Builder builder(@NotNull final ItemStack itemStack) {
|
static SlotBuilder builder(@NotNull final ItemStack itemStack) {
|
||||||
return new Builder((player) -> itemStack);
|
return Eco.getHandler().getGUIFactory().createSlotBuilder((player, menu) -> itemStack);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -34,72 +53,17 @@ public interface Slot {
|
|||||||
* @param provider The provider.
|
* @param provider The provider.
|
||||||
* @return The builder.
|
* @return The builder.
|
||||||
*/
|
*/
|
||||||
static Builder builder(@NotNull final Function<Player, ItemStack> provider) {
|
static SlotBuilder builder(@NotNull final Function<Player, ItemStack> provider) {
|
||||||
return new Builder(provider);
|
return Eco.getHandler().getGUIFactory().createSlotBuilder((player, menu) -> provider.apply(player));
|
||||||
}
|
}
|
||||||
|
|
||||||
class Builder {
|
|
||||||
/**
|
|
||||||
* Provider.
|
|
||||||
*/
|
|
||||||
private final Function<Player, ItemStack> provider;
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Left click handler.
|
* Create a builder for a player-specific ItemStack.
|
||||||
|
*
|
||||||
|
* @param provider The provider.
|
||||||
|
* @return The builder.
|
||||||
*/
|
*/
|
||||||
private BiConsumer<InventoryClickEvent, Slot> onLeftClick = null;
|
static SlotBuilder builder(@NotNull final SlotProvider provider) {
|
||||||
|
return Eco.getHandler().getGUIFactory().createSlotBuilder(provider);
|
||||||
/**
|
|
||||||
* Right click handler.
|
|
||||||
*/
|
|
||||||
private BiConsumer<InventoryClickEvent, Slot> onRightClick = null;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Shift-Left-Click handler.
|
|
||||||
*/
|
|
||||||
private BiConsumer<InventoryClickEvent, Slot> onShiftLeftClick = null;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Shift-Right-Click handler.
|
|
||||||
*/
|
|
||||||
private BiConsumer<InventoryClickEvent, Slot> onShiftRightClick = null;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Middle click handler.
|
|
||||||
*/
|
|
||||||
private BiConsumer<InventoryClickEvent, Slot> onMiddleClick = null;
|
|
||||||
|
|
||||||
Builder(@NotNull final Function<Player, ItemStack> provider) {
|
|
||||||
this.provider = provider;
|
|
||||||
}
|
|
||||||
|
|
||||||
public Builder onLeftClick(@NotNull final BiConsumer<InventoryClickEvent, Slot> action) {
|
|
||||||
this.onLeftClick = action;
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
public Builder onRightClick(@NotNull final BiConsumer<InventoryClickEvent, Slot> action) {
|
|
||||||
this.onRightClick = action;
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
public Builder onShiftLeftClick(@NotNull final BiConsumer<InventoryClickEvent, Slot> action) {
|
|
||||||
this.onShiftLeftClick = action;
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
public Builder onShiftRightClick(@NotNull final BiConsumer<InventoryClickEvent, Slot> action) {
|
|
||||||
this.onShiftRightClick = action;
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
public Builder onMiddleClick(@NotNull final BiConsumer<InventoryClickEvent, Slot> action) {
|
|
||||||
this.onMiddleClick = action;
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
public Slot build() {
|
|
||||||
return new EcoSlot(provider, onLeftClick, onRightClick, onShiftLeftClick, onShiftRightClick, onMiddleClick);
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,125 @@
|
|||||||
|
package com.willfp.eco.core.gui.slot;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.gui.slot.functional.SlotHandler;
|
||||||
|
import com.willfp.eco.core.gui.slot.functional.SlotModifier;
|
||||||
|
import org.bukkit.event.inventory.InventoryClickEvent;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
import java.util.function.BiConsumer;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Builder to create slots.
|
||||||
|
*/
|
||||||
|
public interface SlotBuilder {
|
||||||
|
/**
|
||||||
|
* Set click handler.
|
||||||
|
*
|
||||||
|
* @param action The handler.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
default SlotBuilder onLeftClick(@NotNull BiConsumer<InventoryClickEvent, Slot> action) {
|
||||||
|
return onLeftClick((event, slot, menu) -> action.accept(event, slot));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set click handler.
|
||||||
|
*
|
||||||
|
* @param handler The handler.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
SlotBuilder onLeftClick(@NotNull SlotHandler handler);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set click handler.
|
||||||
|
*
|
||||||
|
* @param action The handler.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
default SlotBuilder onRightClick(@NotNull BiConsumer<InventoryClickEvent, Slot> action) {
|
||||||
|
return onRightClick((event, slot, menu) -> action.accept(event, slot));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set click handler.
|
||||||
|
*
|
||||||
|
* @param handler The handler.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
SlotBuilder onRightClick(@NotNull SlotHandler handler);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set click handler.
|
||||||
|
*
|
||||||
|
* @param action The handler.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
default SlotBuilder onShiftLeftClick(@NotNull BiConsumer<InventoryClickEvent, Slot> action) {
|
||||||
|
return onShiftLeftClick((event, slot, menu) -> action.accept(event, slot));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set click handler.
|
||||||
|
*
|
||||||
|
* @param handler The handler.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
SlotBuilder onShiftLeftClick(@NotNull SlotHandler handler);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set click handler.
|
||||||
|
*
|
||||||
|
* @param action The handler.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
default SlotBuilder onShiftRightClick(@NotNull BiConsumer<InventoryClickEvent, Slot> action) {
|
||||||
|
return onShiftRightClick((event, slot, menu) -> action.accept(event, slot));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set click handler.
|
||||||
|
*
|
||||||
|
* @param handler The handler.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
SlotBuilder onShiftRightClick(@NotNull SlotHandler handler);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set click handler.
|
||||||
|
*
|
||||||
|
* @param action The handler.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
default SlotBuilder onMiddleClick(@NotNull BiConsumer<InventoryClickEvent, Slot> action) {
|
||||||
|
return onMiddleClick((event, slot, menu) -> action.accept(event, slot));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set click handler.
|
||||||
|
*
|
||||||
|
* @param handler The handler.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
SlotBuilder onMiddleClick(@NotNull SlotHandler handler);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Modify the ItemStack.
|
||||||
|
*
|
||||||
|
* @param modifier The modifier.
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
SlotBuilder setModifier(@NotNull SlotModifier modifier);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set slot to be a captive slot.
|
||||||
|
*
|
||||||
|
* @return The builder.
|
||||||
|
*/
|
||||||
|
SlotBuilder setCaptive();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Build the slot.
|
||||||
|
*
|
||||||
|
* @return The slot.
|
||||||
|
*/
|
||||||
|
Slot build();
|
||||||
|
}
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
package com.willfp.eco.core.gui.slot.functional;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.gui.menu.Menu;
|
||||||
|
import com.willfp.eco.core.gui.slot.Slot;
|
||||||
|
import org.bukkit.event.inventory.InventoryClickEvent;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Interface to run on slot click.
|
||||||
|
*/
|
||||||
|
@FunctionalInterface
|
||||||
|
public interface SlotHandler {
|
||||||
|
/**
|
||||||
|
* Performs this operation on the given arguments.
|
||||||
|
*
|
||||||
|
* @param event The click event.
|
||||||
|
* @param slot The slot
|
||||||
|
* @param menu The menu.
|
||||||
|
*/
|
||||||
|
void handle(@NotNull InventoryClickEvent event,
|
||||||
|
@NotNull Slot slot,
|
||||||
|
@NotNull Menu menu);
|
||||||
|
}
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
package com.willfp.eco.core.gui.slot.functional;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.gui.menu.Menu;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.bukkit.inventory.ItemStack;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Interface to run on slot modify.
|
||||||
|
*/
|
||||||
|
@FunctionalInterface
|
||||||
|
public interface SlotModifier {
|
||||||
|
/**
|
||||||
|
* Performs this operation on the given arguments.
|
||||||
|
*
|
||||||
|
* @param player The player.
|
||||||
|
* @param menu The menu.
|
||||||
|
* @param previous The previous ItemStack.
|
||||||
|
*/
|
||||||
|
void modify(@NotNull Player player,
|
||||||
|
@NotNull Menu menu,
|
||||||
|
@NotNull ItemStack previous);
|
||||||
|
}
|
||||||
@@ -0,0 +1,22 @@
|
|||||||
|
package com.willfp.eco.core.gui.slot.functional;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.gui.menu.Menu;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.bukkit.inventory.ItemStack;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Interface to run on slot display.
|
||||||
|
*/
|
||||||
|
@FunctionalInterface
|
||||||
|
public interface SlotProvider {
|
||||||
|
/**
|
||||||
|
* Performs this operation on the given arguments.
|
||||||
|
*
|
||||||
|
* @param player The player.
|
||||||
|
* @param menu The menu.
|
||||||
|
* @return The ItemStack.
|
||||||
|
*/
|
||||||
|
ItemStack provide(@NotNull Player player,
|
||||||
|
@NotNull Menu menu);
|
||||||
|
}
|
||||||
@@ -1,8 +1,12 @@
|
|||||||
package com.willfp.eco.core.integrations;
|
package com.willfp.eco.core.integrations;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Abstract class for integrations.
|
||||||
|
*/
|
||||||
public interface Integration {
|
public interface Integration {
|
||||||
/**
|
/**
|
||||||
* Get the name of integration.
|
* Get the name of integration.
|
||||||
|
*
|
||||||
* @return The name.
|
* @return The name.
|
||||||
*/
|
*/
|
||||||
String getPluginName();
|
String getPluginName();
|
||||||
|
|||||||
@@ -3,6 +3,11 @@ package com.willfp.eco.core.integrations;
|
|||||||
import lombok.Getter;
|
import lombok.Getter;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* An integration loader runs a runnable only if a specific plugin is present on the server.
|
||||||
|
* <p>
|
||||||
|
* Used by {@link com.willfp.eco.core.EcoPlugin} to load integrations.
|
||||||
|
*/
|
||||||
public class IntegrationLoader {
|
public class IntegrationLoader {
|
||||||
/**
|
/**
|
||||||
* The lambda to be ran if the plugin is present.
|
* The lambda to be ran if the plugin is present.
|
||||||
|
|||||||
@@ -0,0 +1,44 @@
|
|||||||
|
package com.willfp.eco.core.integrations.afk;
|
||||||
|
|
||||||
|
import lombok.experimental.UtilityClass;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
import java.util.HashSet;
|
||||||
|
import java.util.Set;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Class to handle afk integrations.
|
||||||
|
*/
|
||||||
|
@UtilityClass
|
||||||
|
public class AFKManager {
|
||||||
|
/**
|
||||||
|
* A set of all registered integrations.
|
||||||
|
*/
|
||||||
|
private final Set<AFKWrapper> registered = new HashSet<>();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Register a new integration.
|
||||||
|
*
|
||||||
|
* @param integration The integration to register.
|
||||||
|
*/
|
||||||
|
public void register(@NotNull final AFKWrapper integration) {
|
||||||
|
registered.add(integration);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get if a player is afk.
|
||||||
|
*
|
||||||
|
* @param player The player.
|
||||||
|
* @return If afk.
|
||||||
|
*/
|
||||||
|
public boolean isAfk(@NotNull final Player player) {
|
||||||
|
for (AFKWrapper afkWrapper : registered) {
|
||||||
|
if (afkWrapper.isAfk(player)) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,18 @@
|
|||||||
|
package com.willfp.eco.core.integrations.afk;
|
||||||
|
|
||||||
|
import com.willfp.eco.core.integrations.Integration;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Wrapper class for afk integrations.
|
||||||
|
*/
|
||||||
|
public interface AFKWrapper extends Integration {
|
||||||
|
/**
|
||||||
|
* Get if a player is afk.
|
||||||
|
*
|
||||||
|
* @param player The player.
|
||||||
|
* @return If afk.
|
||||||
|
*/
|
||||||
|
boolean isAfk(@NotNull Player player);
|
||||||
|
}
|
||||||
@@ -9,6 +9,9 @@ import org.jetbrains.annotations.NotNull;
|
|||||||
import java.util.HashSet;
|
import java.util.HashSet;
|
||||||
import java.util.Set;
|
import java.util.Set;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Class to handle anticheat integrations.
|
||||||
|
*/
|
||||||
@UtilityClass
|
@UtilityClass
|
||||||
public class AnticheatManager {
|
public class AnticheatManager {
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -4,6 +4,9 @@ import com.willfp.eco.core.integrations.Integration;
|
|||||||
import org.bukkit.entity.Player;
|
import org.bukkit.entity.Player;
|
||||||
import org.jetbrains.annotations.NotNull;
|
import org.jetbrains.annotations.NotNull;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Wrapper class for anticheat integrations.
|
||||||
|
*/
|
||||||
public interface AnticheatWrapper extends Integration {
|
public interface AnticheatWrapper extends Integration {
|
||||||
/**
|
/**
|
||||||
* Exempt a player from checks.
|
* Exempt a player from checks.
|
||||||
|
|||||||
@@ -10,6 +10,9 @@ import org.jetbrains.annotations.NotNull;
|
|||||||
import java.util.HashSet;
|
import java.util.HashSet;
|
||||||
import java.util.Set;
|
import java.util.Set;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Class to handle antigrief integrations.
|
||||||
|
*/
|
||||||
@UtilityClass
|
@UtilityClass
|
||||||
public class AntigriefManager {
|
public class AntigriefManager {
|
||||||
/**
|
/**
|
||||||
@@ -26,6 +29,16 @@ public class AntigriefManager {
|
|||||||
registered.add(antigrief);
|
registered.add(antigrief);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Unregister an AntiGrief/Land Management integration.
|
||||||
|
*
|
||||||
|
* @param antigrief The integration to unregister.
|
||||||
|
*/
|
||||||
|
public void unregister(@NotNull final AntigriefWrapper antigrief) {
|
||||||
|
registered.removeIf(it -> it.getPluginName().equalsIgnoreCase(antigrief.getPluginName()));
|
||||||
|
registered.remove(antigrief);
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Can player break block.
|
* Can player break block.
|
||||||
*
|
*
|
||||||
|
|||||||
@@ -6,6 +6,9 @@ import org.bukkit.block.Block;
|
|||||||
import org.bukkit.entity.LivingEntity;
|
import org.bukkit.entity.LivingEntity;
|
||||||
import org.bukkit.entity.Player;
|
import org.bukkit.entity.Player;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Wrapper class for antigrief integrations.
|
||||||
|
*/
|
||||||
public interface AntigriefWrapper extends Integration {
|
public interface AntigriefWrapper extends Integration {
|
||||||
/**
|
/**
|
||||||
* Can player break block.
|
* Can player break block.
|
||||||
|
|||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user