Staff++
Search…
Multiple modes
You can configure multiple staff modes inside the modes.yml file. All modes extend, by default, the default mode. You cannot remove the default mode from the configuration but you can alter it.
  • If a staff-mode module is disabled it won't show up in the GUI
  • Custom modules can also be used inside the GUI config. Make sure the key name matches.

Example configuration

We'll go over the following example configuration.
1
modes:
2
default:
3
damage: false
4
enable-commands: []
5
disable-commands: []
6
disable-on-world-change: false
7
creative: false
8
night-vision: false
9
flight: false
10
inventory-interaction: false
11
invincible: false
12
item-drop: false
13
item-pickup: false
14
vanish-type: NONE
15
enable-on-login: false
16
disable-on-logout: true
17
original-location: true
18
block-manipulation: false
19
silent-chest-interaction: false
20
hunger-loss: true
21
allowed-worlds:
22
- world
23
gui:
24
- counter-module:1
25
Helper:
26
permission: rank.helper
27
weight: 1
28
flight: true
29
hunger-loss: false
30
gui:
31
- compass-module:1
32
- vanish-module:2
33
- counter-module:3
34
- follow-module:4
35
Mod:
36
permission: rank.moderator
37
weight: 2
38
extends: Helper
39
invincible: true
40
allowed-worlds:
41
- world
42
- world_nether
43
gui:
44
- compass-module:1
45
- random-teleport-module:2
46
- vanish-module:3
47
- counter-module:4
48
- freeze-module:5
49
- follow-module:6
50
- Whip:7
51
Admin:
52
permission: rank.admin
53
weight: 3
54
extends: Mod
55
creative: true
56
allowed-worlds:
57
- world
58
- world_nether
59
- world_the_end
60
gui:
61
- compass-module:1
62
- random-teleport-module:2
63
- vanish-module:3
64
- gui-module:4
65
- counter-module:5
66
- freeze-module:6
67
- cps-module:7
68
- examine-module:8
69
- follow-module:9
70
- player-details-module:10
71
72
# --------------------
73
Investigator:
74
permission: rank.investigator
75
weight: -1
76
gui:
77
- compass-module:1
Copied!

Default mode

The default mode is a mandatory mode which needs to be present. It contains all possible configuration options. To access this mode you need at least the staff.mode permission. In this setup I configured the default mode to be as basic as possible. In reality no one will ever enter just "default" mode in this setup. They will always use one of the other configured modes. To see all configuration options explained see the staff mode section.
1
default:
2
damage: false
3
enable-commands: []
4
disable-on-world-change: false
5
creative: false
6
night-vision: false
7
flight: false
8
inventory-interaction: false
9
invincible: false
10
staff-see-staff-in-mode: false
11
disable-commands: []
12
item-drop: false
13
item-pickup: false
14
vanish-type: NONE
15
enable-on-login: false
16
disable-on-logout: true
17
original-location: true
18
block-manipulation: false
19
silent-chest-interaction: false
20
hunger-loss: true
21
allowed-worlds:
22
- world
23
gui:
24
- counter-module:1
Copied!

Helper

Every custom mode must provide a permission and weight property. These properties are used during mode calculation. The helper mode has no extends property so it extends from the default mode. When you create a new mode it inherits all properties from the default mode. You can overwrite every property by defining it inside your mode config. In this example I give Helpers flight and no hunger loss. I also provide them with different Staff items.
1
Helper:
2
permission: rank.helper
3
weight: 1
4
flight: true
5
hunger-loss: false
6
gui:
7
- compass-module:1
8
- vanish-module:2
9
- counter-module:3
10
- follow-module:4
Copied!

Mod

The Mod mode extends from the Helper mode. So it automatically gets flight and disables hunger loss. In addition to that I configure invincibility. I also add the nether to allowed worlds. And Mods get a different GUI with some more staff items. Notice it also has a higher weight. So if a staff member has both the helper and mod permission, the mod staff mode has priority.
1
Mod:
2
permission: rank.moderator
3
weight: 2
4
extends: Helper
5
invincible: true
6
allowed-worlds:
7
- world
8
- world_nether
9
gui:
10
- compass-module:1
11
- random-teleport-module:2
12
- vanish-module:3
13
- counter-module:4
14
- freeze-module:5
15
- follow-module:6
16
- Whip:7
Copied!

Admin

Admin is the highest staff mode that is available. This is indicated by the weight. It extends the Mod mode and thus inherits everything from Mod mode. In addition to this Admin mode can be enabled in more worlds and his GUI has been extended. Admins also get creative mode.
1
Admin:
2
permission: rank.admin
3
weight: 3
4
extends: Mod
5
creative: true
6
allowed-worlds:
7
- world
8
- world_nether
9
- world_the_end
10
gui:
11
- compass-module:1
12
- random-teleport-module:2
13
- vanish-module:3
14
- gui-module:4
15
- counter-module:5
16
- freeze-module:6
17
- cps-module:7
18
- examine-module:8
19
- follow-module:9
Copied!

Investigator

The last mode in my configuration file is the Investigator mode. This mode is special because it won't be considered during mode calculation. In other words, you can only access the mode if you have the permission to switch to a specific staff mode staff.mode.specific or if it gets enabled programmatically. This is indicated by the weight. It is set to -1 , which means don't use it for staff mode calculation. Notice it does not define an extends property, thus it gets all properties defined in the default mode.
When enabled the player gets vanished automatically and gains the compass module.
1
Investigator:
2
permission: rank.investigator
3
weight: -1
4
vanish-type: TOTAL
5
gui:
6
- compass-module:1
Copied!
Last modified 1mo ago