/
config.yml
2112 lines (1905 loc) · 138 KB
/
config.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
#########################
##### AngelChest #####
#########################
# written by mfnalex / JEFF Media GbR
# Support: https://discord.jeff-media.com
##### WARNING! #####
# This file contains UTF8 symbols! You MUST use a proper text editor like Notepad++ to edit this file!
# If you use some kind of "online editor", your file is likely to break and reset to the default values!
# If this [♥] doesn't look like a heart, you MUST use another text editor, because yours doesn't support UTF-8!
##### WARNING! #####
#############################
##### Permissions #####
#############################
# The following permissions are available:
#
# angelchest.use Spawns AngelChest on death instead of dropping the items
# angelchest.protect The AngelChest is locked for other players
# angelchest.protect.ignore Players can open other player's locked AngelChests
# angelchest.fetch Allows the player to teleport their chests to them
# angelchest.tp The player can teleport to their AngelChests
# angelchest.preview Allows the player to preview their AngelChests' contents in /acgui
# angelchest.toggle Allows to enable/disable AngelChest per player
# angelchest.others Allows to run /actoggle, /aclist, /actp, /acfetch and /acunlock for other players
# angelchest.reload Allows reloading the config using /acreload
# angelchest.debug Allows to use the debug command /acdebug
# angelchest.version Allows to use the version command /acversion
# The following permissions are given to everyone by default:
#
# angelchest.list Allows to use the list command /aclist (also requires angelchest.use)
# angelchest.gui Allows to use the GUI command /acgui (also requires angelchest.use)
# angelchest.unlock Allows the player to unlock their protected chests using /acunlock
#############################
##### Commands #####
#############################
# The following commands are available:
#
# /acgui Permission: angelchest.use
# Opens the AngelChest GUI, listing all your AngelChests with buttons for teleporting to,
# fetching and unlocking each chest
#
# /aclist Permission: angelchest.use
# Shows a list of your AngelChests, including links for teleporting to, fetching and
# unlocking each chest. This is basically the "chat-only" version of /acgui
#
# /acfetch [chestID] Permission: angelchest.fetch
# Teleports one of the chests to the player
#
# /actp [chestID] Permission: angelchest.tp
# Teleports the player to one of their chest
#
# /acunlock [chestID] Permission: angelchest.protect and angelchest.unlock
# Unlocks one of your AngelChests if you have the angelchest.protect permission
#
# /actoggle [player] Permission: angelchest.toggle
# Enables/disables AngelChest for this player.
# Also requires permission angelchest.others when changing other player's settings.
#
# /acgraveyard Permission: angelchest.admin
# Manage graveyard settings
#
# /acadmin Permission: angelchest.admin
# Admin commands
#
# /acversion Permission: angelchest.version
# Prints plugin version, whether you have the Plus version and what server software
# you are using.
#
# /acreload Permission: angelchest.reload
# Reloads the config
#
# /acdebug Permission: angelchest.debug
# AngelChestMain debug command. Enter /acdebug for more information
# Note: You can add new command aliases, see "Command Settings" at about line 800 in this config.yml
############################
##### Information #####
############################
# You can use color codes everywhere.
#
# Hex colors can be used in three different styles:
# - <#ff0000>Your Text
# - &#ff0000Your Text
# - &x&f&f&0&0&0&0Your Text
#
# You can also use gradients, for example:
# - <#ff0000> Red to white <#/ffffff>
# - <#ff0000> Red to white <#/ffffff> to red <#/ff0000>
#
# PlaceholderAPI works in most messages, but not all. Let me know when I missed a message.
# ItemsAdder emojis & similar features from other plugins should also work, if not: https://discord.jeff-media.com :)
############################
##### General settings #####
############################
# After this amount of seconds, the AngelChest is automatically destroyed
# and drops its contents. Use 0 for infinite duration.
# You can override this for certain players by setting up groups and
# giving players the angelchest.group.<groupname> permission. See
# groups.example.yml for more information.
# Default is 600 seconds = 10 minutes
angelchest-duration: 600
# The "angelchest-duration" (see above) for players who died in PvP.
# Use 0 for infinite duration.
# When set to -1, it uses the same value as the normal "angelchest-duration" setting.
angelchest-duration-in-pvp: -1
# If players have their chests protected (angelchest.protect permission),
# you can define a duration in seconds to automatically unlock the chests.
# Use 0 to never automatically unlock chests.
# You can override this for certain players by setting up groups and
# giving players the angelchest.group.<groupname> permission. See
# groups.example.yml for more information.
# Default is 0 = never
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
unlock-duration: 0
# When set to true, countdowns (angelchest-duration, angelchest-duration-in-pvp, unlock-duration)
# only count down while the player is online ("online time").
# When set to false (default), countdowns use "real time"
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
suspend-countdowns-when-player-is-offline: false
# The maximum amount of AngelChests a player may have at the same time.
# If a player dies again so that they would exceed this number, the
# first created AngelChest is either destroyed or drops its contents.
# (See option below)
# You can override this for certain players by setting up groups
# and giving players the angelchest.group.<groupname> permission.
# See groups.example.yml for more information.
max-allowed-angelchests: 5
# When a player has reached the above defined "max-allowed-angelchests" limit,
# their oldest AngelChest is either destroyed (without dropping its contents)
# or dropping all its contents.
# When set to "drop", the oldest AngelChest will drop its contents once the
# limit is reached.
# When set to "delete", the oldest AngelChest will disappear without dropping
# anything
max-allowed-angelchests-behaviour: drop
# When true, the AngelChest drops its contents when it expires
# When false, all contents disappear
drop-contents-when-expired: true
# You can disable spawning the AngelChest when a player has been killed by
# another player. By default, the AngelChest will always spawn.
allow-angelchest-in-pvp: true
# When set to true, AngelChests created by players who died in PVP will not
# be protected from other players.
dont-protect-chest-if-player-died-in-pvp: false
# When true, the XP (see "xp-percentage" below) is collected, too.
# When false, XP drops normally
# When set to "nopvp", the XP is not collected if the player died during PvP.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus! (Free version always stores the vanilla XP amount)
collect-xp: true
# Amount of XP the player keeps within their chest on death.
# 1.0 = 100%, 0.5 = 50%, etc.
# When set to 0, all XP is lost.
# When set to -1, use vanilla amount
# You can override this for certain players by setting up groups
# and giving players the angelchest.group.<groupname> permission.
# See groups.example.yml for more information.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus! (Free version always uses vanilla XP amount)
xp-percentage: -1
# Global chance for spawning an AngelChest
# 1.0 = 100%, 0.5 = 50%, 0.01 = 1%
# Example: setting this to 1.0 will always spawn a chest, setting it to
# 0.5 will only spawn it with a probability of 50%
# You can override this for certain players by setting up groups and
# giving players the angelchest.group.<groupname> permission. See
# groups.example.yml for more information.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
spawn-chance: 1.0
# You can define an amount of item stacks that will be randomly lost on death.
# You can also adjust the item loss individually for each group. See groups.example.yml
# You can also add the letter "p" to the end of the number to use percentages.
# E.g. when using "0.2p", 20% of item stacks will be lost.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
random-item-loss: 0
# When true, all items that would be lost due to "random-item-loss" will be dropped instead of just be removed
random-item-loss-drop: false
# When set to true, the random-item-loss defined above will NOT apply to enchanted items!
# That means that enchanted items will always be stored in the AngelChest regardless of random item loss chance.
random-item-loss-ignores-enchanted-items: false
# When set to true, the random-item-loss defined above will NOT apply to shulkerboxes!
random-item-loss-ignores-shulkerboxes: false
# When set to higher than 0, players dying outside of PvP will get a cooldown before the next AngelChest can be spawned (in seconds)
# This is separate from the "pvp-cooldown".
## PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
cooldown: 0
# When set to higher than 0, players dying in PvP will get a cooldown before the next AngelChest can be spawned (in seconds)
# This is separate from the (non-pvp) "cooldown".
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
pvp-cooldown: 0
# When set to true, players will receive a message telling them where the AngelChest
# is located, including clickable links to teleport, fetch or unlock the chest if
# the player has permission for those commands.
show-location: true
# When set to true, players will receive the list of AngelChests again after rejoining.
show-location-on-join: true
# Whether to show a message to the AngelChest owner when other players open or empty their chest
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
show-message-when-other-player-opens-angelchest: true
show-message-when-other-player-empties-angelchest: true
# When true, dead players will automatically get the AngelChest GUI opened after
# they respawn if they have at least one AngelChest.
# Possible values:
# true - Opens the main GUI showing all AngelChests or the latest if you only have one
# latest - Opens the GUI showing the latest AngelChest only
# false - Do not open the GUI automatically
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
show-gui-after-death: false
# When "show-gui-after-death" is enabled ("latest" or "true"), only show the GUI if the
# player has access to either teleport or fetch the chest. If not, do not open the GUI
only-show-gui-after-death-if-player-can-tp-or-fetch: true
# You can choose the Material to use for the AngelChest,
# e.g. CHEST, ENDER_CHEST, OBSIDIAN, ...
# It's also possible to use custom heads here, or custom blockdata, or even blocks from ItemsAdder and Oraxen.
#
# IMPORTANT: ItemsAdder & Oraxen integration is still EXPERIMENTAL and WILL bug out for furniture!
# Do NOT use ItemsAdder or Oraxen blocks and/or furniture on a production server!
#
# IMPORTANT: You must use "double quotes" here!
#
# Examples:
# material: "DIRT" (will use a dirt block)
# material: "head:player" (will use the player's head)
# material: "head:somebase64string" (will use that custom base64 texture)
# material: "minecraft:red_candle[candles=3,lit=true]" (will use 3 red, lit candles)
# material: "itemsadder:ruby_ore" (will use Ruby Ore from ItemsAdder)
# material: "oraxen:ruby_ore" (will use Ruby Ore from Oraxen)
material: "CHEST"
# You can choose another Material to use for unlocked AngelChests.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
use-different-material-when-unlocked: false
material-unlocked: "ENDER_CHEST"
# When true, AngelChest will spawn the chest at the last location where a player was standing
# before he died in the void. When false, the chest will spawn at Y=1
void-detection: true
# When true, AngelChest will avoid spawning a chest inside lava seas and instead spawns it nearby
lava-detection: true
# When false, AngelChests will not be spawned for players who died in lava
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
allow-chest-in-lava: true
# When false, AngelChests will not be spawned for players who died in the void
# NOTE: The vanilla /kill command will cause void damage, so when you set this to
# false, using /kill or /minecraft:kill will prevent the AngelChest from spawning
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
allow-chest-in-void: true
# When set to a value above 0, players will get invulnerability for this amount of seconds
# after teleporting themselves to their chest.
# Consider to only use this when you set a price for teleporting the chest, otherwise it
# could be abused.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
invulnerability-after-tp: 0
# When set to true, players will NOT get their armor equipped automatically on fast-looting
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus! In the free version, auto-equipping is
# always allowed.
prohibit-auto-equip: false
# You probably don't want your AngelChest to spawn on blocks like GRASS_PATH, FARMLAND, etc.
# as that would destroy those blocks. You can blacklist them here so AngelChest searches
# for a spot nearby.
dont-spawn-on:
- FARMLAND
- GRASS_PATH
- DIRT_PATH
- LAVA
# You can specify inside which existing blocks the AngelChest may spawn. If the block where
# the player died is not in this list, AngelChest searches for a spot nearby.
only-spawn-in:
- AIR
- WATER
- SNOW
# When the block where the player died doesn't match "dont-spawn-on" and "only-spawn-in"
# we will search for another block inside max-radius. Default is 10 blocks.
# If there is absolutely no free space inside this radius, the chest
# is spawned exactly where the player died and may replace an existing block, so
# do not set this value too low.
max-radius: 10
# Searches for a new chest location if there isn't at least this amount of air above the chest.
minimum-air-above-chest: 0
# When enabled, and a player dies in lava, the chest will always spawn on at least the player's
# Y level, to avoid them being spawned in some caves below a lava ocean
avoid-lava-oceans: false
# When absolutely no block inside "max-radius" is found, and the block where the player
# died is bedrock, we can search for another block to replace instead of bedrock.
never-replace-bedrock: true
# Remove curse of vanishing / curse of binding items from the chest?
remove-curse-of-vanishing: true
remove-curse-of-binding: false
# When true, totems of undying will work in every inventory slot
# When false, they only work in the hand/off-hand slot (vanilla default)
totem-of-undying-works-everywhere: true
# When true, players who have an AngelChest spawned will be shown the Totem of Undying animation
# If you are using a custom resource pack, you can also enter a custom model data to change
# the appearance of the totem
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
play-totem-animation: false
totem-custom-model-data: 0
# When enabled, AngelChest will handle player respawns. They will be automatically respawned after death once
# the delay (see option below) has expired
auto-respawn: false
# When auto-respawn is true, you can define a delay in seconds before the player is respawned.
auto-respawn-delay: 10
# When a player decides to disable AngelChests from spawning using /actoggle and the following option
# is set to true, then all existing AngelChests from this player will be broken and drop its
# contents. If the player had to pay money for having the chest spawned and you set "refund-expired-chests"
# to true, the player still will not be refunden as it was their own decision to have their chests broken.
using-actoggle-breaks-existing-chests: true
# When true, AngelChest loads all chunks asynchronously to avoid lags when players are teleporting
# to one of their chests. This only works on Paper and its forks, but you do NOT have to disable
# this if you do not use Paper. On very slow servers, users could experience a small pause
# between starting the teleport and actually being teleported when this is enabled. This is NO lag,
# it's just AngelChest waiting for the server to load the chunks instead of "force loading" them.
# If you don't know what this means: just leave it enabled
async-chunk-loading: true
# Should we check for updates?
# When enabled, a message is printed in the console if a new version has
# been found, and OPs will be notified when they join the server.
# When set to true, we will check for updates on startup and every X hours
# When set to on-startup, we will only check on startup
# When set to false, don't check for updates
check-for-updates: true
# When check-for-updates is true, AngelChest will check every X hours
check-interval: 24
#########################
#### Death maps ####
#########################
# You can make players get a map with their AngelChest location when they respawn.
# This allows them to easily go back to their death location.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
death-maps: false
# When set to true, death Maps created by AngelChest will never be put into any
# AngelChests on the next death. This avoids filling up inventories when dying several times in a row.
dispose-death-maps: false
# You can change the marker type to be used. See here for a list of valid marker types in the latest MC version:
# https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/map/MapCursor.Type.html
death-map-marker: RED_X
death-map-name: "AngelChest"
death-map-lore: "X: {x}\nY: {y}\nZ: {z}"
#########################
#### Player heads ####
#########################
# You can have AngelChest drop the player's head when they die.
# Note: The head will only drop if the player has an AngelChest spawned.
# That means that no heads will drop when the player does not have the
# angelchest.use permission, if they don't have enough money for the chest,
# or if they die in a blacklisted world / region.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
drop-heads: false
# When set to true, heads are only dropped when a player dies in PvP
only-drop-heads-in-pvp: true
# Time in seconds since the last PVP hit until a player is not considered to be in PVP anymore
# If set to 0, only the last hit is considered
only-drop-heads-in-pvp-cooldown: 10
# When set to true, heads are dropped next to the AngelChest instead of being put inside
dont-store-heads-in-angelchest: true
#########################
#### Graveyards ####
#########################
# PREMIUM FEATURE: Only available in AngelChest Plus!
# You can define graveyards to use for spawning AngelChests instead of the player's
# death location.
# IMPORTANT: Please see the graveyards.example.yml file for more information.
# Everything defined here are the GLOBAL graveyard settings. You can define
# individual graveyards in the graveyards.yml file. You must rename the
# graveyards.example.yml file to graveyards.yml to enable Graveyard features.
# When enabled, player's AngelChests will NOT be spawned in the graveyards, but
# at their death location. The graveyards will then only be used to respawn players
# after they died. All defined "grave locations" will then be used as possible
# respawn points, unless a global spawn has been set for that graveyard.
# When this is enabled, players will also respawn at graveyards even when
# they didn't get an AngelChest because their inventory was empty.
use-graveyard-only-as-respawn-point: false
# What happens when the closest graveyard in the current world is full?
# When true, AngelChest will search for the next graveyard in the same world.
# When false, or when all graveyards in this world are full, see option below
try-closest-graveyard: true
# What happens when all graveyards in this world are full, or when there are no
# graveyards defined for this world?
# When true, AngelChest will try to bury the player at the global graveyard.
# When false, or when the global graveyard is also full, see option below
try-global-graveyard: true
# What happens when the global graveyard is full too?
# When true, AngelChest will spawn the chest at the player's death location.
# When false, the player will die like in vanilla and does not get any AngelChest.
fallback-to-deathlocation: true
#########################
#### Economy ####
#########################
# You can set up a certain price for some actions. This will only work if you
# use Vault and a supported economy plugin.
# If you need more options to adjust the prices for certain actions, please
# leave a message in the SpigotMC discussion or open an issue at GitHub.
# If you request a feature in the review section, it will probably be ignored.
# You can also adjust those prices individually for each group. See groups.example.yml
# You can also add the letter "p" to the end of the number to use percentages.
# E.g. when using "0.2p", a user has to pay 20% of his account balance.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
# You can also use certain items that have to be "paid" with instead of money.
# See items.yml file for more information
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
#####
# How much does it cost to teleport yourself to one of your AngelChests?
# If you want to use an item, simply use "price-teleport: item-name" (see items.yml) (Premium version only)
price-teleport: 0
# How much does it cost to teleport your AngelChests to you?
# I suggest you make this cheaper than "price-teleport" because teleporting to
# your death location is probably more useful than just getting your stuff back.
# If you want to use an item, simply use "price-fetch: item-name" (see items.yml) (Premium version only)
price-fetch: 0
# How much does it cost to spawn the AngelChest? The amount will automatically
# be taken from the player on death if they have enough money, otherwise
# the chest will not spawn and the items drop normally
# If you want to use an item, simply use "price: item-name" (see items.yml)
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
price: 0
# You can refund the price when a player does not to open their AngelChest
# before it expires
refund-expired-chests: false
# How much does it cost for a player to open a chest? Each player will only be
# charged once per chest.
# If you want to use an item, simply use "price-open: item-name" (see items.yml)
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
price-open: 0
# When set to true, players must confirm teleporting to or fetching a chest if you set a price for those actions
# by entering the same command again or by clicking on a text message in the chat
confirm: true
# When set to true, no player will be able to place ANY custom AngelChest items.
prevent-placing-custom-items: true
# The format used to display prices in chat messages or GUIs.
# Must be valid format for Java's String#format() method.
# Only change this if you know what you are doing!
# The default is %,.2f which means two decimal places and a comma as thousands separator.
# If you want to use dots as thousands separator, use %.,2f
price-format: "%,.2f"
#################################
#### Max. TP/Fetch distance #####
#################################
# If the following options are set to false, players will have to be in the same
# world to teleport to or to fetch their chests
allow-tp-across-worlds: true
allow-fetch-across-worlds: true
# You can set a max distance for players who want to tp to or fetch their AngelChest.
# If set to 0, players can teleport/fetch regardless of the distance to their chest.
# When using this, consider to disallow TPing or fetching between worlds because
# otherwise players could just bypass this by going into another world.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus! Free version will always use 0
max-tp-distance: 0
max-fetch-distance: 0
# You can also set a minimum distance to avoid players teleporting to their chest or
# fetching it, for example to avoid them accidentally clicking the link twice and
# having to pay the price again.
min-distance: 0
# When set, a player has to stand still for this amount of seconds before they
# get teleported
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
tp-wait-time: 0
#################################
#### Sounds for TP / Fetch #####
#################################
# You can have sound effects when fetching or teleporting to your chests, if you feel like it.
# See here for the sound names of the current version:
# https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus! Free version will always use 0
play-sound-on-tp: true
play-sound-on-fetch: true
sound-effect: ENTITY_EXPERIENCE_ORB_PICKUP
sound-volume: 1.0
sound-pitch: 1.0
sound-channel: BLOCKS
#########################
#### Disabled items ####
#########################
# Some plugins have items that you automatically get back after death. To
# avoid those from being duplicated, you can just enter their material
# type here. Future versions will also allow to filter for items by
# lore or custom name and more 3rd party plugins hooks
# You can also use blacklist.yml for more detailed filtering. It allows you
# to filter items by name, lore, PDC Keys (or NBT tags), custom model data,
# and more. It also lets you allow to define whether blacklisted items should
# drop normally or be deleted.
# Example:
# disabled-materials:
# - WOODEN_HOE
# - COMPASS
disabled-materials:
#########################
#### Disabled worlds ####
#########################
# You can disable AngelChest for certain worlds. Each world's name has to
# be on a separate line, starting with a hyphen and followed by a space
# Example:
#
# disabled-worlds:
# - world_nether
# - world_the_end
disabled-worlds:
##########################
#### WorldGuard Flags ####
##########################
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
# AngelChestPlus currently has one custom WorldGuard flag:
# allow-angelchest:
# Whether or not spawning of AngelChests is allowed in a region (Default: allow)
##########################
#### WorldGuard ####
##########################
# You can disable AngelChest for certain WorldGuard region. Each region's name has to
# be on a separate line, starting with a hyphen and followed by a space
# Example:
#
# disabled-worldguard-regions:
# - spawn
# - pvparena
disabled-worldguard-regions:
# If, for some reason, you get errors using WorldGuard and AngelChest together, you can
# disable the WorldGuard integration, but this will also mean you cannot disable
# AngelChest in certain regions. If you get errors, please open an issue at github
# or join our discord: https://discord.jeff-media.de
disable-worldguard-integration: false
#########################
## Protection plugins ##
#########################
# AngelChest can check if a player has permissions to place blocks where he died. If
# the player is prohibited from placing blocks there, AngelChest will not spawn a
# chest if the following option is set to true.
# Fetching chests into areas where players cannot build will also be prohibited.
only-spawn-chests-if-player-may-build: false
#########################
## Other plugins ##
#########################
# AngelChest can hook into certain 3rd party plugins to improve the chest
# generation. None of those plugins is required, and you do NOT have to
# disable the integration if a certain plugin is not installed.
# Some plugins add additional drops to the death of a player. AngelChest can detect
# those. If you experience any duplication issues, try disabling this setting.
detect-additional-drops: true
# If you use a plugin that logs player deaths, you can set this option to true.
# This will however prevent the "slot" option in blacklist.yml to work and might also
# cause issues with other plugins.
dont-clear-inventory: false
# Some plugins offer a telekinesis enchant that prevent getting AngelChests spawned
# when a player with telekinesis kills another player.
# This is intended behaviour. If you still want the victim to get an AngelChest,
# you can disable telekinesis for PVP kills in your enchantment plugins' config.
# You also have to set the following option to true.
# If you simply set this to true WITHOUT telling your enchantment plugin to not
# make telekinesis work on players, you MIGHT be getting duplicated items!
ignore-telekinesis: false
# When you have Slimefun installed, AngelChest can check for "Soulbound" items
# and prevent those from being put into the chest.
use-slimefun: true
# When you have ExecutableItems installed, AngelChest can check for "Keep on Death"
# items and prevent those from being put into the chest.
use-executableitems: true
# There are many other plugins adding "Soulbound" items. AngelChest can try
# to detect those as well and prevent those from being put into the chest.
check-generic-soulbound: true
# EliteMobs' soulbound feature is a bit different. Those items will NOT be
# kept on death, but they would be detected by the generic soulbound detection.
# If you set the following option to false, EliteMobs' soulbound items will
# behave like "normal" soulbound items, meaning they will be kept in your
# inventory on death. If the option is set to true, the items will behave
# like normally when using EliteMobs: the items will go into the chest like
# regular items.
exempt-elitemobs-soulbound-items-from-generic-soulbound-detection: true
# When using Lands, and the player gets killed by another player they are
# at war with, they will not get a death chest when set to true
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
lands-dont-protect-when-at-war: false
# Some plugins make you keep your items on death, e.g. Essentials when you are /op.
# AngelChest respects that, but you can also set the following option to true to always
# get a chest, regardless of the keepInventory flag.
# Note that many plugins (including EssentialsX) also clear your drops list for
# totally retarded reasons, although it's not needed and prevents AngelChest
# from detecting the drops. If you get the message that your inventory was empty
# on death, try setting the "event-priority" below to LOWEST, then raise it slowly
# to the highest possible value where it still works.
ignore-keep-inventory: true
# If set to true, AngelChest will try to only spawn chests INSIDE the world border as dictated by WorldBorderAPI.
# If set to false, AngelChest doesn't care about what WorldBorderAPI says.
use-worldborder-api: true
# When true, players who are currently in combat cannot fast-loot AngelChests
combatlogx-prevent-fastlooting: false
# You can define the priority on which AngelChest detects the player's drops. When you use plugins to
# manipulate what items a player drops on death, consider setting this to a high value (e.g. HIGHEST
# or MONITOR).
# If you experience problems with some items not being put into the chest but being dropped next to it,
# try to lower the priority of AngelChest until the drops get detected.
# If you have problems with the chest not spawning at all (but remaining in the player's inventory),
# consider using a low priority (e.g. LOWEST)
# Available priorities (from high to low): MONITOR, HIGHEST, HIGH, NORMAL, LOW, LOWEST
# I HIGHLY SUGGEST YOU LEAVE THIS ON HIGHEST! ONLY CHANGE THIS IF KNOW WHAT YOU ARE DOING!
# WHEN IN DOUBT, CONTACT ME ON DISCORD: https://discord.jeff-media.de
event-priority: HIGHEST
# Some outdated plugins cause trouble when interacting with invisible armor stands (holograms).
# Only set the following option to "true" if you really know what you are doing!
disable-interacting-with-holograms: false
# If true, AngelChest tries to ignore deaths of NPCs (players that aren't actual players)
try-to-ignore-npc-deaths: true
# Miscellaneous plugins might cause issues when not force-closing inventories on AngelChest spawn.
# Normally, you don't want to change these options and keep them both enabled.
force-close-open-inventory-on-angelchest-spawn: true
call-inventory-close-event-manually-if-needed: true
#########################
##### Localization ######
#########################
# In the following configuration sections, you can use color and
# formatting codes for all text messages.
# Available color codes:
# &0 Black &6 Gold &c Red
# &1 Dark Blue &7 Gray &d Light Purple
# &2 Dark Green &8 Dark Gray &e Yellow
# &3 Dark Aqua &9 Blue &f White
# &4 Dark Red &a Green
# &5 Dark Purple &b Aqua
# Available formatting codes:
# &k Obfuscated &m Strikethrough
# &l Bold &o Italic
# &n Underline &r Reset
#########################
##### Hologram ######
#########################
# {player} The player's name.
# {time} Time until the chest despawns
# {items} Number of items the chest contains
# {xp} Number of XP the chest contains
# {deathcause} Name of the killer, or LAVA, VOID etc. when not killed in PvP
# {protected} Protection status - PREMIUM FEATURE - see option below!
# \n New line
# The default hologram contains all options mentioned above except {protected}
# The hologram text also allows you to use PlacerholderAPI placeholders
# Use an empty string to disable the hologram.
hologram-text: "&a&l[AngelChest]&r\n&b{player}\n&7{items} items / {xp} XP\n&6{time}\n&cKilled by {deathcause}"
# This text is added to the hologram where you have {protected} in your "hologram-text"
# and if your AngelChest is protected and auto unlocking is disabled.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
hologram-protected-text: "&cProtected"
# This text is added to the hologram where you have {protected} in your "hologram-text"
# and if your AngelChest is protected and auto unlocking is enabled.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
hologram-protected-countdown-text: "&cProtected for {time}"
# This text is added to the hologram where you have {protected} in your "hologram-text"
# and if your AngelChest is unprotected.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
hologram-unprotected-text: "&aUnprotected"
# If you think the hologram is displayed too high, you can change this number.
# For example -0.5 means the hologram will be moved 0.5 blocks down
hologram-offset: 0.0
# The distance between each hologram line
hologram-offset-per-line: 0.25
#########################
##### GUI ######
#########################
# PREMIUM FEATURE: THE WHOLE GUI IS ONLY AVAILABLE IN AngelChestPlus!
# When set to true, players can fast-loot the AngelChest using rightclick (or shift-rightclick, see option below)
# When set to false, players cannot fast-loot and always get the GUI displayed when opening a chest
# When set to "force", players will always fast-loot chests and will never see the GUI.
allow-fastlooting: true
# When true, players can open the AngelChest GUI using shift-rightclick and fast-loot the chest via rightclick
# When false, players can open the AngelChest GUI using rightclick and fast-loot the chest via shift-rightclick
gui-requires-shift: true
# You can use custom materials or base64 strings to customize the GUI buttons.
# You can for example use this website: https://minecraft-heads.com/custom-heads
# At the bottom of each head's page, copy the string at Other -> Value
gui-button-back: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODY0Zjc3OWE4ZTNmZmEyMzExNDNmYTY5Yjk2YjE0ZWUzNWMxNmQ2NjllMTljNzVmZDFhN2RhNGJmMzA2YyJ9fX0="
gui-button-info: "PAPER"
gui-button-teleport: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZGZlYjM5ZDcxZWY4ZTZhNDI2NDY1OTMzOTNhNTc1M2NlMjZhMWJlZTI3YTBjYThhMzJjYjYzN2IxZmZhZSJ9fX0="
gui-button-fetch: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZGZlYjM5ZDcxZWY4ZTZhNDI2NDY1OTMzOTNhNTc1M2NlMjZhMWJlZTI3YTBjYThhMzJjYjYzN2IxZmZhZSJ9fX0="
gui-button-unlock: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOGFkOTQzZDA2MzM0N2Y5NWFiOWU5ZmE3NTc5MmRhODRlYzY2NWViZDIyYjA1MGJkYmE1MTlmZjdkYTYxZGIifX19"
gui-button-preview: "BOOK"
gui-button-preview-placeholder: "GRAY_STAINED_GLASS_PANE"
gui-button-confirm-info: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYjZlNTIyZDkxODI1MjE0OWU2ZWRlMmVkZjNmZTBmMmMyYzU4ZmVlNmFjMTFjYjg4YzYxNzIwNzIxOGFlNDU5NSJ9fX0="
gui-button-confirm-accept: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvY2UyYTUzMGY0MjcyNmZhN2EzMWVmYWI4ZTQzZGFkZWUxODg5MzdjZjgyNGFmODhlYThlNGM5M2E0OWM1NzI5NCJ9fX0="
gui-button-confirm-decline: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZTljZGI5YWYzOGNmNDFkYWE1M2JjOGNkYTc2NjVjNTA5NjMyZDE0ZTY3OGYwZjE5ZjI2M2Y0NmU1NDFkOGEzMCJ9fX0="
##### Inventory title in the GUI main menu
gui-title-main: "&4&l[&c&lAngelChest&4&l]"
##### Name and lore of the AngelChest items in the GUI main menu
# {id} is the number of the chest
# {time} is the amount of time left
# {x} {y} {z} are the coordinates
# {world} is the world's name
# \n is a newline
gui-chest-name: "§6AngelChest #{id}"
gui-chest-lore: "§4{time}\n§aX: §f{x}\n§aY: §f{y}\n§aZ: §f{z}\n§f{world}"
##### Inventory title in GUI after selecting a specific chest
# {id} is the number of the chest
# {time} is the amount of time left
gui-title-chest: "&4&l[&c&lAngelChest&4&l] &c#{id} &4| &c{time}"
##### Chest inventory name
# {player} is the player's name.
angelchest-inventory-name: "&4&l[&c&lAngelChest&4&l] &b{player}&r"
##### Button names and lore
# Placeholders available in "gui-info-lore", "gui-teleport", "gui-teleport-lore", "gui-fetch" and "gui-fetch-lore":
# {price} is the teleportation price
# {currency} is the currency's name
# {balance} is the player's current balance
# You can use \n for newlines in lores
gui-back: "&6Back"
gui-info: "&6Info"
gui-info-lore: "§6You are about to spend {price}{currency}."
gui-teleport: "&6Teleport"
gui-teleport-lore: "§6You are about to spend {price}{currency}."
gui-fetch: "&6Fetch"
gui-fetch-lore: "§6You are about to spend {price}{currency}."
gui-unlock: "&6Unlock"
gui-accept: "&aAccept"
gui-decline: "&cDecline"
gui-preview: "&6Preview"
#########################
##### Other ######
#########################
##### AngelChest list (/aclist) settings
# {id} is the number of the chest
# {x} {y} {z} are the coordinates
# {world} is the name of the world
# {time} is the amount of time left
# \n is a new line.
angelchest-list: "[{id}] {time} &aX:&f {x} &aY:&f {y} &aZ:&f {z} | {world} "
##### Clickable Links when running /acinfo or /aclist
link-unlock: "&5[Unlock]&r"
link-fetch: "&6[Fetch]&r"
link-teleport: "&6[TP]&r"
# When set to true, the links in the chat for teleportation, fetching or unlocking
# an AngelChest will be sent on a separate line
show-links-on-separate-line: false
# Whether AngelChest should automatically prefix all messages
add-prefix: true
prefix: "&b[&aAngelChest&b] &r"
############################
##### Command settings #####
############################
# You can change the command aliases for all player commands here.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
# Commands that can be used instead of /acgui
command-aliases-acgui:
- angelchestgui
# Commands that can be used instead of /aclist
command-aliases-aclist:
- acinfo
- ac
- angelchest
- angelchestinfo
- angelchestlist
# Commands that can be used instead of /acfetch
command-aliases-acfetch:
- acretrieve
- angelchestfetch
- angelchestretrieve
# Commands that can be used instead of /actp
command-aliases-actp:
- acteleport
- angelchesttp
- angelchestteleport
# Commands that can be used instead of /acunlock
command-aliases-acunlock:
- angelchestunlock
- unlockchest
- unlock
# Commands than can be used instead of /actoggle.
command-aliases-actoggle:
- angelchesttoggle
# Commands that can be used instead of /acreload
command-aliases-acreload:
- angelchestreload
# Commands that can be used instead of /acdebug
command-aliases-acdebug:
- acd
#########################
##### Misc #####
#########################
# Whether to show a console message when a player opens an AngelChest
console-message-on-open: false
# Log all created AngelChests, including content, death location, death cause, death time and player' inventory content.
# Also logs what items have been put into the chest and when a chest has been emptied.
# Note: Taking out single items from the chest is currently NOT logged! That will be added in the future.
# PREMIUM FEATURE: ONLY AVAILABLE IN AngelChest Plus!
log-angelchests: false
# The amount of hours until log files are removed again. Set to -1 to never remove the log files
purge-logs-older-than-x-hours: 48
# The amount of hours inbetween each attempt to remove old log files. Set to -1 to only remove on startup
purge-logs-every-x-hours: 1
# File names for the log files. Available placerholders:
# {player} - Player's name
# {uuid} - Player's UUID
# {world} - World nane
# {date} - Date and time
log-filename: "{player}_{world}_{date}.log"
# File names for the AngelChest files. Available placerholders:
# {player} - Player's name
# {uuid} - Player's UUID
# {world} - World nane
# {x}, {y}, {z} - Coordinates
chest-filename: "{player}_{world}_{x}_{y}_{z}.yml"
#########################
##### Messages ######
#########################
message-all-your-angelchests-were-already-unlocked: "&eAll your AngelChests were already unlocked."
message-angelchest-created: "&aAn Angel collected your stuff and put it into a chest located at the place of your death."
message-angelchest-disappeared: "&cYou were too slow... Your AngelChest has disappeared and dropped its contents."
message-error-players-only: "&cError: This command can only be used by players."
message-inventory-was-empty: "&eAn Angel searched for your stuff but could not find anything."
message-not-allowed-to-break-other-angelchests: "&cYou are not allowed to break this AngelChest."
message-not-allowed-to-open-other-angelchests: "&cYou are not allowed to open this AngelChest."
message-unlocked-more-angelchests: "&aYou have unlocked %d AngelChests."
message-unlocked-one-angelchest: "&aYou have unlocked your AngelChest."
message-you-dont-have-any-angelchests: "&eYou don't have any AngelChests."
message-you-got-part-of-your-inventory-back: "&eYou got a part of your inventory back, but some items are still in the AngelChest."
message-you-got-your-inventory-back: "&aYou got your inventory back!"
message-angelchest-location: "&eLocations of your AngelChests:"
message-not-enough-money: "&cYou don't have enough money."
message-not-enough-money2: "&cAn Angel tried to collect your stuff but you didn't have enough money."
message-please-select-chest: "&7Please specify which AngelChest you would like to select."
message-already-unlocked: "&cThis AngelChest is already unlocked."
message-too-many-angelchests: "&cYou had more AngelChests than your Angel could handle... Your oldest AngelChest has exploded."
message-no-angelchest-in-pvp: "&cAn Angel tried to collect your stuff but was put to flight by the presence of your killer."
message-angelchest-retrieved: "&aAngelChest retrieved!"
message-confirm: "&6You are about to spend {price}{currency}. Click this message to continue."
message-paid-open: "&8You spent {price}{currency} to open an AngelChest."
message-unlocked-automatically: "&8Your AngelChest has been unlocked automatically."
message-angelchest-opened: "&6{player} has opened your AngelChest."
message-angelchest-emptied: "&c{player} has emptied your AngelChest."
message-spawn-chance-unsuccessful: "&cYour Angel forgot to collect your stuff, unlucky!"
message-no-permission: "&cYou do not have the permission to use this command."
message-invulnerable: "&a&lYou are invulnerable for {time}."
message-vulnerable: "&c&lYou are no longer invulnerable."
message-tp-across-worlds-not-allowed: "&cYou cannot teleport to your AngelChest across worlds."
message-fetch-across-worlds-not-allowed: "&cYou cannot fetch your AngelChest across worlds."