HyperScript
Docs

← All of the Docs HyperPerms

Changing groups HyperPerms

effectadd <who> to group <name>HyperPerms

Put a player in a group, keeping the ones they have

add arg.1 to group "vip" for arg.2 * 1 day
effectadd <who> to group <name> for <duration>HyperPerms

The same, for a limited time; LuckPerms takes it away again

add arg.1 to group "vip" for arg.2 * 1 day
expressiontime left in group <name> of <who>HyperPerms

How long a time-limited membership still lasts, as a duration; unset if they are not in the group, or are in it for good

set {_left} to time left in group "vip" of player
effectremove <who> from group <name>HyperPerms

Take a player out of a group

remove arg.1 from group "vip"
effectset group of <who> to <name>HyperPerms

Out of every other group and into this one

set group of arg.1 to "default"
expressionpromote <who> on track <name>HyperPerms

One group up a track made in LuckPerms (/lp createtrack staff). Somebody who is on none of its groups gets the first

promote arg.1 on track "staff"
expressiondemote <who> on track <name>HyperPerms

One group down; from the first group, out of the track

demote arg.1 on track "staff"
Guide and examples
command /givevip <target:player> <days:integer>:
    permission: "ranks.give"
    trigger:
        add arg.1 to group "vip" for arg.2 * 1 day
        send "&a%arg.1% is VIP for %arg.2% day(s)."

command /vipleft:
    trigger:
        set {_left} to time left in group "vip" of player
        if {_left} is not set:
            send "&7You are not VIP for a limited time."
            stop
        send "&6Your VIP lasts another %{_left}%."

command /demote <target:player>:
    permission: "ranks.give"
    trigger:
        set group of arg.1 to "default"

command /takevip <target:player>:
    permission: "ranks.give"
    trigger:
        remove arg.1 from group "vip"
        send "&e%arg.1% is no longer VIP."
SyntaxEffect
add <who> to group <name>Put a player in a group, keeping the ones they have
add <who> to group <name> for <duration>The same, for a limited time; LuckPerms takes it away again
time left in group <name> of <who>How long a time-limited membership still lasts, as a duration; unset if they are not in the group, or are in it for good
remove <who> from group <name>Take a player out of a group
set group of <who> to <name>Out of every other group and into this one
promote <who> on track <name>One group up a track made in LuckPerms (/lp createtrack staff). Somebody who is on none of its groups gets the first
demote <who> on track <name>One group down; from the first group, out of the track
  • <who> is player, all players, or a name. A named player may be offline: LuckPerms looks them up, makes the change and saves it.
  • The group has to exist in LuckPerms. A name it does not know is reported in the console and nothing changes.
  • Adding someone to a group they are already in replaces the old membership, so a new time limit takes the place of the old one.
  • Changes are saved by LuckPerms and, if it is set up for that, shared with your other servers.