Upstream/LuckPerms
1
0
Fork 0
mirror of https://github.com/LuckPerms/LuckPerms.git synced 2024-11-28 05:35:26 +01:00
Code Issues Projects Releases Wiki Activity

Fix broken links (#62)

Andre_601 2020-05-03 01:42:58 +02:00 committed by GitHub
parent cdcb06423d
commit 728106db63
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 12 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
Weight.md

@ -1,28 +1,24 @@
# Weights # Weights
Weights are an integral part of the way LuckPerms operates, and are based on the premise of resolving conflict where it may appear. There are two different, independent weights systems in LuckPerms, the first being [**Groups**](#group-weights) and the second being [**Meta**](#meta-weights) like prefixes and suffixes. In all cases, **a higher weight number is a higher priority** Weights are an integral part of the way LuckPerms operates, and are based on the premise of resolving conflict where it may appear. There are two different, independent weights systems in LuckPerms, the first being [**Groups**](#group-weights) and the second being [**Meta**](#meta-weights) like prefixes and suffixes. In all cases, **a higher weight number is a higher priority**
- When setting up weights, it is recommended that large gaps weight-wise be left between groups, like going up by 100 instead of 1. This is so that if you want to insert groups later, you do not have to reweigh all groups. * When setting up weights, it is recommended that large gaps weight-wise be left between groups, like going up by 100 instead of 1. This is so that if you want to insert groups later, you do not have to reweigh all groups.
* Weight can be any number, including negative.
- Weight can be any number, including negative.
## Group Weights ## Group Weights
Group weights determine, in cases where a user has more than one group, which group's nodes take precedence when the nodes conflict. This is best explained by an example: Group weights determine, in cases where a user has more than one group, which group's nodes take precedence when the nodes conflict. This is best explained by an example:
- Suppose a player was in group default and in group "admin". There is one permission node in each group, and it is `essentials.fly`. * Suppose a player was in group default and in group "admin". There is one permission node in each group, and it is `essentials.fly`.
* In default group, `essentials.fly` is set to `false`. In "admin" group, `essentials.fly` is set to `true`. Without setting up weights, it is inconsistent and unclear which node the player will get - there is no way to know for sure whether they will be able to fly or not.
- In default group, `essentials.fly` is set to `false`. In "admin" group, `essentials.fly` is set to `true`. Without setting up weights, it is inconsistent and unclear which node the player will get - there is no way to know for sure whether they will be able to fly or not. * This is where __weights__ come in. Setting default in this example to have a higher weight than "admin" will result in the player being **unable** to fly. Setting admin to have a higher weight than default will result in the player being **able** to fly.
- This is where __weights__ come in. Setting default in this example to have a higher weight than "admin" will result in the player being **unable** to fly. Setting admin to have a higher weight than default will result in the player being **able** to fly.
Likewise, whenever a player has several groups, the permissions in the highest weighted group will override the permissions in any lower weighted ones that conflict. Likewise, whenever a player has several groups, the permissions in the highest weighted group will override the permissions in any lower weighted ones that conflict.
### Setting Group Weights ### Setting Group Weights
There are two ways to set weight for a group; using a [command]([https://github.com/lucko/LuckPerms/wiki/Command-Usage:-Group#lp-group-group-setweight-weight](https://github.com/lucko/LuckPerms/wiki/Command-Usage:-Group#lp-group-group-setweight-weight)), and using the [editor]([https://github.com/lucko/LuckPerms/wiki/Web-Editor#luckperms-nodes](https://github.com/lucko/LuckPerms/wiki/Web-Editor#luckperms-nodes)). There are two ways to set weight for a group; using a [command](https://github.com/lucko/LuckPerms/wiki/Command-Usage:-Group#lp-group-group-setweight-weight), and using the [editor](https://github.com/lucko/LuckPerms/wiki/Web-Editor#luckperms-nodes).
- With commands, you run `lp group <group> setweight <weight>`. * With commands, you run `lp group <group> setweight <weight>`.
* In the editor, you add the node `weight.<weight>` to the group.
- In the editor, you add the node `weight.<weight>` to the group.
## Meta Weights ## Meta Weights
@ -30,8 +26,7 @@ There are two ways to set weight for a group; using a [command]([https://github.
Meta weights are very similar to group weights, but for prefixes and suffixes. In the same way the group weights work, when a player inherits multiple prefixes or suffixes, the highest weighted one is the one that will display. Meta weights are very similar to group weights, but for prefixes and suffixes. In the same way the group weights work, when a player inherits multiple prefixes or suffixes, the highest weighted one is the one that will display.
### Setting Meta Weights ### Setting Meta Weights
There are two ways to set a weight for a prefix or suffix; using a [command]([https://github.com/lucko/LuckPerms/wiki/Command-Usage:-Meta#index](https://github.com/lucko/LuckPerms/wiki/Command-Usage:-Meta#index)), and using the [editor]([https://github.com/lucko/LuckPerms/wiki/Web-Editor#luckperms-nodes](https://github.com/lucko/LuckPerms/wiki/Web-Editor#luckperms-nodes)). There are two ways to set a weight for a prefix or suffix; using a [command](https://github.com/lucko/LuckPerms/wiki/Command-Usage:-Meta#index), and using the [editor](https://github.com/lucko/LuckPerms/wiki/Web-Editor#luckperms-nodes).
- With commands, you simply set the weight when you add or set a prefix or suffix to a group or player: `/lp user/group <user|group> meta setprefix/addprefix <weight> &b[ThePrefix]`. * With commands, you simply set the weight when you add or set a prefix or suffix to a group or player: `/lp user/group <user|group> meta setprefix/addprefix <weight> [ThePrefix]`.
* With the editor, you simply add or modify the node `prefix.<priority>.[ThePrefix]` to change the weight, AKA priority, of a prefix. The same principle applies to suffixes.
- With the editor, you simply add or modify the node `prefix.<priority>.&b[ThePrefix]` to change the weight, AKA priority, of a prefix. The same principle applies to suffixes.

2
_Sidebar.md

@ -5,7 +5,7 @@
* [**Credits**](https://github.com/lucko/LuckPerms/wiki/Credits) * [**Credits**](https://github.com/lucko/LuckPerms/wiki/Credits)
### Setup ### Setup
* [**Installation**](Installation) * [**Installation**](https://github.com/lucko/LuckPerms/wiki/Installation)
* [Initial Setup](https://github.com/lucko/LuckPerms/wiki/Installation#initial-setup) * [Initial Setup](https://github.com/lucko/LuckPerms/wiki/Installation#initial-setup)
* [Requirements](https://github.com/lucko/LuckPerms/wiki/Installation#requirements) * [Requirements](https://github.com/lucko/LuckPerms/wiki/Installation#requirements)
* [Compatibility](https://github.com/lucko/LuckPerms/wiki/Installation#compatibility) * [Compatibility](https://github.com/lucko/LuckPerms/wiki/Installation#compatibility)