From 16c2be1d01c5631ca36a641d8de2e7ad269468c2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Frying=E2=98=86Pan?= <7706960+LeotomasMC@users.noreply.github.com> Date: Thu, 2 Mar 2023 10:05:02 -0500 Subject: [PATCH] sorted all of the commands by the value of the name field added command for fabric vanilla permissions updated the commands command to be a little neater updated the editorsafety command to include stuff about webhooks added a link to modrinth for older forge/fabric downloads --- modules/triggers/triggers/embeds/list.json | 929 +++++++++++---------- 1 file changed, 482 insertions(+), 447 deletions(-) diff --git a/modules/triggers/triggers/embeds/list.json b/modules/triggers/triggers/embeds/list.json index 1eba44d..651e94f 100644 --- a/modules/triggers/triggers/embeds/list.json +++ b/modules/triggers/triggers/embeds/list.json @@ -1,205 +1,68 @@ [ { - "name": "wiki", - "aliases": [ - "docs" - ], - "title": "LuckPerms Wiki", - "url": "https://luckperms.net/wiki", - "description": "Learn how to use LuckPerms and all of its features by reading the wiki.", - "wiki": true - }, - { - "name": "install", - "title": "Installing LuckPerms", - "url": "https://luckperms.net/wiki/Installation", - "description": "You can install LuckPerms on Bukkit/Spigot/Paper, BungeeCord, Sponge, Fabric, Nukkit and Velocity servers. Check the installation guide for more info on setting up LuckPerms.", + "name": "advanced", + "title": "Advanced Setup", + "url": "https://luckperms.net/wiki/Advanced-Setup", + "description": "Discover some of the more advanced concepts of LuckPerms, such as permission calculation, shorthand permissions and more.", "wiki": true }, { - "name": "bungee", + "name": "api", "aliases": [ - "bungeecord", - "network" + "javadoc", + "javadocs" ], - "title": "Network Installation", - "url": "https://luckperms.net/wiki/Network-Installation", - "description": "If you run a BungeeCord network, learn how to correctly setup LuckPerms on all server instances (including Bungee).", + "title": "Developer API", + "url": "https://luckperms.net/wiki/Developer-API", + "description": "Learn how to use the LuckPerms API in your project.", "fields": [ { - "key": "Also read:", - "value": "Syncing data between servers\n\nhttps://luckperms.net/wiki/Syncing-data-between-servers" + "key": "Example usages", + "value": "https://luckperms.net/wiki/Developer-API-Usage" + }, + { + "key": "Read the Javadoc", + "value": "https://javadoc.io/doc/net.luckperms/api/latest/index.html" } ], "wiki": true }, { - "name": "sync", - "title": "Syncing data between servers", - "url": "https://luckperms.net/wiki/Syncing-data-between-servers", - "description": "To sync data between servers, you need to connect each LuckPerms plugin to the same database (for example MySQL) and set up a messaging service.", - "wiki": true - }, - { - "name": "usage", - "aliases": [ - "guide", "starting" - ], - "title": "Usage", - "url": "https://luckperms.net/wiki/Usage", - "description": "Here's a guide to help users understand and use LuckPerms for the first time.", - "wiki": true - }, - { - "name": "errors", - "aliases": [ - "error", "storageerror" - ], - "title": "Storage system errors", - "url": "https://luckperms.net/wiki/Storage-system-errors", - "description": "Here's a page with some common storage system errors.", - "wiki": true - }, - { - "name": "editor", - "aliases": [ - "webeditor" - ], - "title": "Web Editor", - "url": "https://luckperms.net/wiki/Web-Editor", - "description": "LuckPerms offers an easy to use, powerful Web Editor, with which you can add, delete and change permissions of groups and players.", - "wiki": true - }, - { - "name": "verbose", - "title": "Verbose", - "url": "https://luckperms.net/wiki/Verbose", - "description": "LuckPerms provides a `verbose` command to help you find out what permissions a command/plugin is checking.", - "wiki": true - }, - { - "name": "meta", - "aliases": [ - "prefix", - "prefixes", - "suffix", - "suffixes" - ], - "title": "Prefixes, Suffixes & Meta", - "url": "https://luckperms.net/wiki/Prefixes,-Suffixes-&-Meta", - "description": "You can set prefixes, suffixes and other meta data in LuckPerms for players and groups. Note that LuckPerms does **not** manage chat. You need to use another plugin to show prefixes/suffixes in chat.", - "wiki": true - }, - { - "name": "context", - "aliases": [ - "contexts" - ], - "title": "Context", - "url": "https://luckperms.net/wiki/Context", - "description": "You can set a permission or group on a per-world/per-server basis, through what we call \"contexts\".", - "wiki": true - }, - { - "name": "default", - "title": "Default Groups", - "url": "https://luckperms.net/wiki/Default-Groups", - "description": "LuckPerms provides a group that every player is added to upon joining the server, called `default`. You can use multiple methods to change the default group or change the name of it.", - "wiki": true - }, - { - "name": "storage", - "aliases": [ - "storagetypes", "filetypes" - ], - "title": "Storage types", - "url": "https://luckperms.net/wiki/Storage-types", - "description": "LuckPerms allows you to store data in a variety of storage types, read about the benefits and drawbacks of each type on the wiki.", - "wiki": true - }, - { - "name": "weight", + "name": "argumentbased", "aliases": [ - "weights", "priority" + "argbased" ], - "title": "Weight", - "url": "https://luckperms.net/wiki/Weight", - "description": "LuckPerms allows you to set weights in order to determine the priority of certain nodes, like permissions and even prefixes. A higher weight number is a higher priority.", + "title": "Argument based command permissions", + "url": "https://luckperms.net/wiki/Argument-based-command-permissions", + "description": "Fine tune exactly what users with permission to use LuckPerms can do.", "wiki": true }, { - "name": "commands", + "name": "ask", "aliases": [ - "command" + "pleaseask", + "justask" ], - "title": "Command Usage", - "url": "https://luckperms.net/wiki/Command-Usage", - "description": "Find all of the available LuckPerms commands on the wiki.", + "title": "Please ask your question!", + "description": "Please ask the question you have. Don't ask to ask, or ask to DM someone. There are people here to help you, but we need to know what to help you with, so please just ask the question you want to in as much detail as possible!", "fields": [ { - "key": "General commands", - "value": "[Link](https://luckperms.net/wiki/General-Commands)", - "inline": true - }, - { - "key": "User commands", - "value": "[Link](https://luckperms.net/wiki/User-Commands)", - "inline": true - }, - { - "key": "Group commands", - "value": "[Link](https://luckperms.net/wiki/Group-Commands)", - "inline": true - }, - { - "key": "Permission commands", - "value": "[Link](https://luckperms.net/wiki/Permission-Commands)", - "inline": true - }, - { - "key": "Parent commands", - "value": "[Link](https://luckperms.net/wiki/Parent-Commands)", - "inline": true - }, - { - "key": "Meta commands", - "value": "[Link](https://luckperms.net/wiki/Meta-Commands)", - "inline": true - }, - { - "key": "Track commands", - "value": "[Link](https://luckperms.net/wiki/Track-Commands)", - "inline": true - }, - { - "key": "Log commands", - "value": "[Link](https://luckperms.net/wiki/Log-Commands)", - "inline": true + "key": "Or, try here first:", + "value": "https://luckperms.net/wiki" }, { - "key": "\u200E", - "value": "\u200E", - "inline": true + "key": "Why shouldn't I ask to ask?", + "value": "https://sol.gfxile.net/dontask.html" } - ], - "wiki": true - }, - { - "name": "faq", - "title": "FAQ", - "url": "https://luckperms.net/wiki/FAQ", - "description": "Check out some of our frequently asked questions.", - "wiki": true + ] }, { - "name": "migration", + "name": "bedrock", "aliases": [ - "migrate" + "geyser" ], - "title": "Migration", - "url": "https://luckperms.net/wiki/Migration", - "description": "Learn about the process of migrating from another permission plugin.", - "wiki": true + "title": "Using Geyser?", + "description": "If you're having issues with permissions for bedrock players, or it's telling you that a bedrock player's name is invalid, try setting `allow-invalid-usernames` to true in the LuckPerms config." }, { "name": "bulkupdate", @@ -215,126 +78,55 @@ "wiki": true }, { - "name": "switchstorage", + "name": "bungee", "aliases": [ - "switch", "switchingstorage" + "bungeecord", + "network" ], - "title": "Switching storage types", - "url": "https://luckperms.net/wiki/Switching-storage-types", - "description": "If you wish to change your storage type (e.g. to YAML or MySQL) you may need to follow these instructions to ensure your groups and permissions are migrated to the new storage type.", + "title": "Network Installation", + "url": "https://luckperms.net/wiki/Network-Installation", + "description": "If you run a BungeeCord network, learn how to correctly setup LuckPerms on all server instances (including Bungee).", "fields": [ { - "key": "Read more about the Storage types", - "value": "https://luckperms.net/wiki/Storage-types" + "key": "Also read:", + "value": "Syncing data between servers\n\nhttps://luckperms.net/wiki/Syncing-data-between-servers" } ], "wiki": true }, { - "name": "stacking", - "title": "Prefix & Suffix Stacking", - "url": "https://luckperms.net/wiki/Prefix-&-Suffix-Stacking", - "description": "Display multiple prefixes/suffixes alongside a player's name.", - "wiki": true - }, - { - "name": "inheritance", + "name": "bungeecheck", "aliases": [ - "inherit", "inheriting", "inherits" + "checkbungee", + "networkcheck", + "checknetwork" ], - "title": "Inheritance", - "url": "https://luckperms.net/wiki/Usage#inheritance", - "description": "Learn about inheritance.", - "wiki": true - }, - { - "name": "tracks", - "title": "Tracks", - "url": "https://luckperms.net/wiki/Tracks", - "description": "Tracks provide a method for you to promote/demote players along a track (or ladder) of groups.", - "wiki": true - }, - { - "name": "advanced", - "title": "Advanced Setup", - "url": "https://luckperms.net/wiki/Advanced-Setup", - "description": "Discover some of the more advanced concepts of LuckPerms, such as permission calculation, shorthand permissions and more.", - "wiki": true + "title": "Running a network and getting UUID mismatches?", + "description": "Please double check that:\n`1.` BungeeCord `config.yml` has `ip_forward` **and** `online_mode` set to **`true`**\n`2.` *All* backend servers' `spigot.yml` has `bungeecord` set to **`true`**\n`3.` *All* backend servers' `server.properties` have `online-mode` set to **`false`**" }, { - "name": "argumentbased", + "name": "cauldron", "aliases": [ - "argbased" + "thermos" ], - "title": "Argument based command permissions", - "url": "https://luckperms.net/wiki/Argument-based-command-permissions", - "description": "Fine tune exactly what users with permission to use LuckPerms can do.", + "title": "Cauldron, Thermos, Forge + Bukkit Hacks", + "url": "https://luckperms.net/wiki/Installation#cauldron-thermos-etc", + "description": "Installing LuckPerms on a Cauldron, Thermos and any other Forge + Bukkit server software may require additional steps.", "wiki": true }, { - "name": "api", + "name": "colours", "aliases": [ - "javadoc", "javadocs" + "colors" ], - "title": "Developer API", - "url": "https://luckperms.net/wiki/Developer-API", - "description": "Learn how to use the LuckPerms API in your project.", + "title": "Colour Codes", + "description": "A helpful list of all colour codes that you can use.", "fields": [ { - "key": "Example usages", - "value": "https://luckperms.net/wiki/Developer-API-Usage" - }, - { - "key": "Read the Javadoc", - "value": "https://javadoc.io/doc/net.luckperms/api/latest/index.html" - } - ], - "wiki": true - }, - { - "name": "placeholders", - "title": "Placeholders", - "url": "https://luckperms.net/wiki/Placeholders", - "description": "Display data such as user prefixes and groups from LuckPerms in other plugins.", - "wiki": true - }, - { - "name": "permissions", - "title": "Permissions", - "url": "https://luckperms.net/wiki/Permissions", - "description": "A list of permissions used by LuckPerms commands.", - "wiki": true - }, - { - "name": "locale", - "title": "Locale & Translations", - "url": "https://luckperms.net/wiki/Locale-and-Translations", - "description": "Learn how to change all the message from LuckPerms.", - "wiki": true - }, - { - "name": "config", - "title": "LuckPerms Configuration", - "url": "https://luckperms.net/wiki/Configuration", - "description": "Learn what each of the config options are for.", - "wiki": true - }, - { - "name": "extracontexts", - "aliases": [ - "extracontext" - ], - "title": "Extra Contexts", - "url": "https://github.com/LuckPerms/ExtraContexts", - "description": "Add contexts not supported by stock LuckPerms.", - "wiki": true - }, - { - "name": "upgrade", - "title": "Upgrading from v4 to v5", - "url": "https://luckperms.net/wiki/Upgrading-from-v4-to-v5", - "description": "Read about upgrading LuckPerms from v4 to v5.", - "wiki": true + "key": "Colours", + "value": "https://wiki.ess3.net/mc/" + } + ] }, { "name": "commandequivalents", @@ -347,33 +139,69 @@ "wiki": true }, { - "name": "extensions", - "title": "Extensions", - "url": "https://luckperms.net/wiki/Extensions", - "description": "A list of all the Luckperms extensions.", + "name": "commands", + "aliases": [ + "command" + ], + "title": "Command Usage", + "description": "Find all of the available LuckPerms commands on the wiki.", + "fields": [ + { + "key": "\u200E", + "value": "[General Commands](https://luckperms.net/wiki/General-Commands)\n[Group Commands](https://luckperms.net/wiki/Group-Commands)\n[Parent Commands](https://luckperms.net/wiki/Parent-Commands)\n[Track Commands](https://luckperms.net/wiki/Track-Commands)", + "inline": true + }, + { + "key": "\u200E", + "value": "[User Commands](https://luckperms.net/wiki/User-Commands)\n[Permission Commands](https://luckperms.net/wiki/Permission-Commands)\n[Meta Commands](https://luckperms.net/wiki/Meta-Commands)\n[Log Commands](https://luckperms.net/wiki/Log-Commands)", + "inline": true + }, + { + "key": "Read more", + "value": "https://luckperms.net/wiki/Command-Usage" + } + ], "wiki": true }, { - "name": "selfhosting", - "title": "Self Hosting", - "url": "https://luckperms.net/wiki/Self-hosting-the-web-interfaces", - "description": "Learn how to self-host all the web interfaces.", + "name": "config", + "title": "LuckPerms Configuration", + "url": "https://luckperms.net/wiki/Configuration", + "description": "Learn what each of the config options are for.", "wiki": true }, { - "name": "whyluckperms", + "name": "context", "aliases": [ - "whylp" + "contexts" ], - "title": "Why LuckPerms", - "url": "https://luckperms.net/wiki/Why-LuckPerms", - "description": "Why should you choose LuckPerms? Read here to find out.", + "title": "Context", + "url": "https://luckperms.net/wiki/Context", + "description": "You can set a permission or group on a per-world/per-server basis, through what we call \"contexts\".", + "wiki": true + }, + { + "name": "cookbook", + "aliases": [ + "apicookbook", + "apiexamples" + ], + "title": "API Cookbook", + "url": "https://github.com/LuckPerms/api-cookbook", + "description": "The cookbook is a working example plugin which shows how to get/change data for users and groups, listen to LuckPerms events, and more." + }, + { + "name": "default", + "title": "Default Groups", + "url": "https://luckperms.net/wiki/Default-Groups", + "description": "LuckPerms provides a group that every player is added to upon joining the server, called `default`. You can use multiple methods to change the default group or change the name of it.", "wiki": true }, { "name": "downloads", "aliases": [ - "download", "update" + "download", + "update" ], "title": "Downloads", "url": "https://luckperms.net/download", @@ -382,38 +210,62 @@ { "key": "Additional downloads", "value": "https://ci.lucko.me/view/LuckPerms/" + }, + { + "key": "Older Forge and Fabric versions", + "value": "https://modrinth.com/mod/luckperms/versions" } ] }, { - "name": "translations", + "name": "editor", + "aliases": [ + "webeditor" + ], + "title": "Web Editor", + "url": "https://luckperms.net/wiki/Web-Editor", + "description": "LuckPerms offers an easy to use, powerful Web Editor, with which you can add, delete and change permissions of groups and players.", + "wiki": true + }, + { + "name": "editorsafety", "aliases": [ - "translate", "translating", "crowdin" + "edsaf", + "edpriv" ], - "title": "Translating LuckPerms", - "url": "https://crowdin.com/project/luckperms", - "description": "Translations for LuckPerms are managed on Crowdin. Any contributions are very welcome!", + "title": "It is safe to send an editor link in public.", + "description": "Any changes made in the editor have to be applied using the `/lp applyedits` command - impossible unless the person with the link is also connected to the server and with the required in-game permissions to use LuckPerms commands. It's effectively just as safe to share an editor link as it would be to share a screenshot of your permissions or a pastebin of a configuration file. The editor doesn't contain any sensitive data (except perhaps player names).", "fields": [ { - "key": "Installing the community translations", - "value": "https://luckperms.net/wiki/Locale-and-Translations" + "key": "What about trusted editors?", + "value": "If you get a chat message in-game about approving an editor session after sending your editor link to someone, you can just ignore the message. They will only be able to save changes if you trust their browser or they meet the above requirements." + }, + { + "key": "Concerns about the proprietary nature of your permissions setup?", + "value": "Please, don't be. We're here to help, not steal your permissions setup. Additionally, permissions can be tested by players simply joining your server and seeing what they can do." + }, + { + "key": "More Information:", + "value": "https://luckperms.net/wiki/Web-Editor" } ] }, { - "name": "cauldron", + "name": "errors", "aliases": [ - "thermos" + "error", + "storageerror" ], - "title": "Cauldron, Thermos, Forge + Bukkit Hacks", - "url": "https://luckperms.net/wiki/Installation#cauldron-thermos-etc", - "description": "Installing LuckPerms on a Cauldron, Thermos and any other Forge + Bukkit server software may require additional steps.", + "title": "Storage system errors", + "url": "https://luckperms.net/wiki/Storage-system-errors", + "description": "Here's a page with some common storage system errors.", "wiki": true }, { "name": "essentials", "aliases": [ - "moss", "essx" + "moss", + "essx" ], "title": "Essentials", "description": "Make sure you are using EssentialsX and Vault for prefixes. For any other issues with Essentials, you should seek support in either <#308232296753004556> or the official EssentialsX support Discord.", @@ -427,23 +279,107 @@ "sendMessageAfterEmbed": true }, { - "name": "colours", + "name": "extensions", + "title": "Extensions", + "url": "https://luckperms.net/wiki/Extensions", + "description": "A list of all the Luckperms extensions.", + "wiki": true + }, + { + "name": "extracontexts", "aliases": [ - "colors" + "extracontext" ], - "title": "Colour Codes", - "description": "A helpful list of all colour codes that you can use.", + "title": "Extra Contexts", + "url": "https://github.com/LuckPerms/ExtraContexts", + "description": "Add contexts not supported by stock LuckPerms.", + "wiki": true + }, + { + "name": "faq", + "title": "FAQ", + "url": "https://luckperms.net/wiki/FAQ", + "description": "Check out some of our frequently asked questions.", + "wiki": true + }, + { + "name": "fabric", + "aliases": [ + "vanilla" + ], + "title": "Why do vanilla permissions not work?", + "description": "Commands in vanilla Minecraft do not have permissions. Most modding platforms that LuckPerms supports add permissions to those command. However, Fabric makes as few changes to vanilla on its own, and does not add permissions to vanilla commands. If you want to control permissions for vanilla commands on Fabric, you will need a mod that adds permission checks to those commands.", "fields": [ { - "key": "Colours", - "value": "https://wiki.ess3.net/mc/" + "key": "Where can I find a mod to do that?", + "value": "You can use [minecraft-command-permissions-fabric](https://github.com/lucko/minecraft-command-permissions-fabric/releases) to add permission checks to vanilla commands." + } + ] + }, + { + "name": "forgepermissions", + "aliases": [ + "forgeperms", + "forge" + ], + "title": "Why not make LuckPerms work on older versions of Forge?", + "description": "Forge added the Permissions API only recently in 1.18. That API is what allowed a native Forge version of LuckPerms to be made, however that API does not currently exist on older versions of Forge, and is unlikely to be backported. Without the Permissions API existing on older versions of Forge, it is impossible to make LuckPerms work on those versions of Forge natively.", + "fields": [ + { + "key": "Is there any other option?", + "value": "There is a Sponge version of LuckPerms! You can add SpongeForge and the Sponge version of LuckPerms to use LuckPerms on older Forge versions." + } + ] + }, + { + "name": "formatting", + "aliases": [ + "chat", + "tab", + "tablist" + ], + "title": "LuckPerms does not perform any chat/tablist formatting of its own!", + "description": "LuckPerms only acts as the source for prefixes / suffixes, it doesn't actually apply them. You need an appropriately configured chat/tablist formatting plugin for them to be displayed. If the values appear correctly when you run `/lp user info`, LuckPerms is doing its job!", + "fields": [ + { + "key": "FAQ answer: Prefix isn't showing?", + "value": "https://luckperms.net/wiki/FAQ#why-are-prefixessuffixes-not-working" + }, + { + "key": "List of chat/tablist formatting plugins that work with LuckPerms", + "value": "https://luckperms.net/wiki/Prefixes,-Suffixes-&-Meta#displaying-prefixes-and-suffixes" + } + ] + }, + { + "name": "hack", + "aliases": [ + "hacked", + "exploited", + "exploit" + ], + "title": "Has LuckPerms been exploited/hacked?", + "description": "Most certainly: **no**. In most cases a 'LuckPerms exploit' is a simple case of human error, which can be avoided easily. Look below for some tips to be on the safe side.", + "fields": [ + { + "key": "Don't give random people full ( * ) permissions / admin permissions", + "value": "While this should be obvious, a lot of times a exploit can be traced back to faulty permission settings. You should always take your time with permissions and **read the plugin documentations**. In 99% of all cases the plugins have documentations explaining each permission, in the rare case that the plugin you are using does not have a documentation, you could still:\n **A:** Ask the plugin developer for help\n **B:** Use LuckPerms verbose functionality ( `!verbose` )\n **C:** Select a different plugin with proper documentation." + }, + { + "key": "Do not run your server/network in offline mode", + "value": "If you are running your server or network in offline mode, hackers have it really easy to steal your, or any other admins identity. While the server is in offline mode, certain checks ( **which exist to prevent exactly this** ), are being skipped, and the server does not verify if the person joining actually is the person they claim to be. While there may be plugins which increase the security of offline mode servers by adding things such as admin codes, you should just switch it to online to prevent the issue in the first place." + }, + { + "key": "Do not download plugins from shady websites / sent by friends", + "value": "You should never put anything on your server which has not been downloaded by yourself from official sources. Plugins can be infected with malware which injects itself into all other plugins, and thus is hard to remove. While it may look like a plugin has been hacked, you most certainly downloaded a modified version of it and **it is not the plugin authors fault**. In case your server has been infected by such malware:\n 1. Stop the server\n 2. Delete all plugins in your plugins folder, and just to be safe also the server jar file\n 3. Re-Download all plugins and server jar files **from official websites** such as SpigotMC or official plugin websites ( luckperms.net for example ).\n 4. Check if there have been any modifications to the permission system and remove unknown users and wrong permissions.\nif you follow these steps you should have a clean server by the end, without exploits." } ] }, { "name": "helpchat", "aliases": [ - "papi", "deluxechat" + "papi", + "deluxechat" ], "title": "Helpchat", "description": "Helpchat is a general plugin assistance discord as well as the home of DeluxeChat, PlaceholderAPI, and many more.", @@ -454,6 +390,64 @@ } ] }, + { + "name": "inheritance", + "aliases": [ + "inherit", + "inheriting", + "inherits" + ], + "title": "Inheritance", + "url": "https://luckperms.net/wiki/Usage#inheritance", + "description": "Learn about inheritance.", + "wiki": true + }, + { + "name": "install", + "title": "Installing LuckPerms", + "url": "https://luckperms.net/wiki/Installation", + "description": "You can install LuckPerms on Bukkit/Spigot/Paper, BungeeCord, Sponge, Fabric, Nukkit and Velocity servers. Check the installation guide for more info on setting up LuckPerms.", + "wiki": true + }, + { + "name": "libsdir", + "aliases": [ + "libs", + "dependencies" + ], + "title": "LuckPerms dependencies", + "description": "LuckPerms requires several libraries in order to operate. If you're getting a startup error such as `NoClassDefFoundError`, `ClassNotFoundException` or \"Unable to load dependency...\", stop your server, delete the `/plugins/LuckPerms/libs/` directory and start it up again." + }, + { + "name": "locale", + "title": "Locale & Translations", + "url": "https://luckperms.net/wiki/Locale-and-Translations", + "description": "Learn how to change all the message from LuckPerms.", + "wiki": true + }, + { + "name": "meta", + "aliases": [ + "prefix", + "prefixes", + "suffix", + "suffixes" + ], + "title": "Prefixes, Suffixes & Meta", + "url": "https://luckperms.net/wiki/Prefixes,-Suffixes-&-Meta", + "description": "You can set prefixes, suffixes and other meta data in LuckPerms for players and groups. Note that LuckPerms does **not** manage chat. You need to use another plugin to show prefixes/suffixes in chat.", + "wiki": true + }, + { + "name": "migration", + "aliases": [ + "migrate" + ], + "title": "Migration", + "url": "https://luckperms.net/wiki/Migration", + "description": "Learn about the process of migrating from another permission plugin.", + "wiki": true + }, { "name": "notworking", "aliases": [ @@ -469,41 +463,32 @@ ] }, { - "name": "suggestions", - "aliases": [ - "suggestion", "suggest", "bugreport", "issues", "issue" - ], - "title": "Suggestions and Bug Reports", - "description": "If you would like to request a feature for LuckPerms, or report a bug, feel free to open an issue on GitHub!", - "fields": [ - { - "key": "Issue Tracker:", - "value": "https://github.com/lucko/LuckPerms/issues/" - } - ] - }, - { - "name": "userinfo", + "name": "nowildcard", "aliases": [ - "sendinfo" + "nwc" ], - "title": "Please take a screenshot!", - "description": "Seeing a screenshot makes everything so much easier!", - "fields": [ - { - "key": "For prefixes not showing up in chat:", - "value": "`/lp user info`." - }, + "title": "Wildcard issues", + "description": "Some plugins are created in a way which results in odd behaviour when the root '*' wildcard is used.", + "fields": [ { - "key": "For database errors:", - "value": "Server console: `/lp info` | Bungee console: `/lpb info` | Velocity console: `/lpv info`" + "key": "More information:", + "value": "https://nucleuspowered.org/docs/nowildcard.html" } ] }, + { + "name": "offline", + "aliases": [ + "cracked" + ], + "title": "Offline mode/cracked servers", + "description": "Running a Minecraft server in offline mode can cause a lot of issues, particularly with UUIDs and security vulnerabilities. Some people also view it as unethical (piracy). We understand that some people need to run their servers in offline mode. However, due to the reasons mentioned, some users will choose to not support those running a server in offline mode (this does not apply to those running in a Bungeecord network). Please respect their decision, you may continue to seek help for your issue but in most cases, it can be resolved by setting online-mode=true in server.properties." + }, { "name": "pasteit", "aliases": [ - "paste", "pastebin" + "paste", + "pastebin" ], "title": "Please use pastebin!", "description": "Seeing a paste of the problem makes everything so much easier! Use https://pastes.dev/ for easy pasting!", @@ -519,94 +504,125 @@ ] }, { - "name": "ask", + "name": "permissions", + "title": "Permissions", + "url": "https://luckperms.net/wiki/Permissions", + "description": "A list of permissions used by LuckPerms commands.", + "wiki": true + }, + { + "name": "placeholders", + "title": "Placeholders", + "url": "https://luckperms.net/wiki/Placeholders", + "description": "Display data such as user prefixes and groups from LuckPerms in other plugins.", + "wiki": true + }, + { + "name": "reload", "aliases": [ - "pleaseask", "justask" + "plugman" ], - "title": "Please ask your question!", - "description": "Please ask the question you have. Don't ask to ask, or ask to DM someone. There are people here to help you, but we need to know what to help you with, so please just ask the question you want to in as much detail as possible!", + "title": "Using `/reload` or plugman?", + "description": "Using Bukkit's `/reload` command causes issues with many plugins, including LuckPerms. If you are adding or removing plugins, you should always fully restart your server.", "fields": [ { - "key": "Or, try here first:", - "value": "https://luckperms.net/wiki" + "key": "Read more:", + "value": "https://madelinemiller.dev/blog/problem-with-reload/" }, { - "key": "Why shouldn't I ask to ask?", - "value": "https://sol.gfxile.net/dontask.html" + "key": "What about plugman?", + "value": "Plugman causes all of the same issues as /reload as it is fundamentally doing the same thing as `/reload`" } ] }, { - "name": "editorsafety", + "name": "selfhosting", + "title": "Self Hosting", + "url": "https://luckperms.net/wiki/Self-hosting-the-web-interfaces", + "description": "Learn how to self-host all the web interfaces.", + "wiki": true + }, + { + "name": "spongeseven", "aliases": [ - "edsaf", "edpriv" + "sponge7", + "api7" ], - "title": "It is safe to send an editor link in public.", - "description": "Any changes made in the editor have to be applied using the `/lp applyedits` command - impossible unless the person with the link is also connected to the server and with the required in-game permissions to use LuckPerms commands. It's effectively just as safe to share an editor link as it would be to share a screenshot of your permissions or a pastebin of a configuration file. The editor doesn't contain any sensitive data (except perhaps player names).", + "title": "Using Sponge on 1.12.2?", + "description": "LuckPerms no longer releases updates for API 7 of Sponge, which is what the 1.12.2 version of Sponge uses. However you can still download the last version of LuckPerms that supported API 7 from Ore.", "fields": [ { - "key": "More Information:", - "value": "https://luckperms.net/wiki/Web-Editor" - }, - { - "key": "Concerns about the proprietary nature of your permissions setup?", - "value": "Please, don't be. We're here to help, not steal your permissions setup. Additionally, permissions can be tested by players simply joining your server and seeing what they can do." + "key": "Ore Download Page:", + "value": "https://ore.spongepowered.org/Luck/LuckPerms/versions/5.3.98" } ] }, { - "name": "formatting", + "name": "stacking", + "title": "Prefix & Suffix Stacking", + "url": "https://luckperms.net/wiki/Prefix-&-Suffix-Stacking", + "description": "Display multiple prefixes/suffixes alongside a player's name.", + "wiki": true + }, + { + "name": "storage", "aliases": [ - "chat", "tab", "tablist" + "storagetypes", + "filetypes" ], - "title": "LuckPerms does not perform any chat/tablist formatting of its own!", - "description": "LuckPerms only acts as the source for prefixes / suffixes, it doesn't actually apply them. You need an appropriately configured chat/tablist formatting plugin for them to be displayed. If the values appear correctly when you run `/lp user info`, LuckPerms is doing its job!", - "fields": [ - { - "key": "FAQ answer: Prefix isn't showing?", - "value": "https://luckperms.net/wiki/FAQ#why-are-prefixessuffixes-not-working" - }, - { - "key": "List of chat/tablist formatting plugins that work with LuckPerms", - "value": "https://luckperms.net/wiki/Prefixes,-Suffixes-&-Meta#displaying-prefixes-and-suffixes" - } - ] + "title": "Storage types", + "url": "https://luckperms.net/wiki/Storage-types", + "description": "LuckPerms allows you to store data in a variety of storage types, read about the benefits and drawbacks of each type on the wiki.", + "wiki": true }, { - "name": "nowildcard", + "name": "suggestions", "aliases": [ - "nwc" + "suggestion", + "suggest", + "bugreport", + "issues", + "issue" ], - "title": "Wildcard issues", - "description": "Some plugins are created in a way which results in odd behaviour when the root '*' wildcard is used.", + "title": "Suggestions and Bug Reports", + "description": "If you would like to request a feature for LuckPerms, or report a bug, feel free to open an issue on GitHub!", "fields": [ { - "key": "More information:", - "value": "https://nucleuspowered.org/docs/nowildcard.html" + "key": "Issue Tracker:", + "value": "https://github.com/lucko/LuckPerms/issues/" } ] }, { - "name": "libsdir", + "name": "switchstorage", "aliases": [ - "libs", "dependencies" + "switch", + "switchingstorage" ], - "title": "LuckPerms dependencies", - "description": "LuckPerms requires several libraries in order to operate. If you're getting a startup error such as `NoClassDefFoundError`, `ClassNotFoundException` or \"Unable to load dependency...\", stop your server, delete the `/plugins/LuckPerms/libs/` directory and start it up again." + "title": "Switching storage types", + "url": "https://luckperms.net/wiki/Switching-storage-types", + "description": "If you wish to change your storage type (e.g. to YAML or MySQL) you may need to follow these instructions to ensure your groups and permissions are migrated to the new storage type.", + "fields": [ + { + "key": "Read more about the Storage types", + "value": "https://luckperms.net/wiki/Storage-types" + } + ], + "wiki": true }, { - "name": "cookbook", - "aliases": [ - "apicookbook", "apiexamples" - ], - "title": "API Cookbook", - "url": "https://github.com/LuckPerms/api-cookbook", - "description": "The cookbook is a working example plugin which shows how to get/change data for users and groups, listen to LuckPerms events, and more." + "name": "sync", + "title": "Syncing data between servers", + "url": "https://luckperms.net/wiki/Syncing-data-between-servers", + "description": "To sync data between servers, you need to connect each LuckPerms plugin to the same database (for example MySQL) and set up a messaging service.", + "wiki": true }, { "name": "testingperms", "aliases": [ - "testperms", "testverbose", "testingverbose" + "testperms", + "testverbose", + "testingverbose" ], "title": "How-to test permissions", "description": "Small list of things for you to make sure when testing permissions:\n`1.` Don't test as op, your players/general staff will most likely not have op\n`2.` Make sure you don't have any special permissions (e.g. `*` or *the same permission you are testing*) on your user (`/lp user permission info`)\n`3.` Make sure your parent groups are the ones the target audience you are testing will have (if you are testing mod perms, don't have owner as parent)\n`4.` **[Use verbose](https://luckperms.net/wiki/Verbose)** to see *exactly* what's going on, what permissions are being checked", @@ -618,99 +634,118 @@ ] }, { - "name": "bungeecheck", - "aliases": [ - "checkbungee", "networkcheck", "checknetwork" - ], - "title": "Running a network and getting UUID mismatches?", - "description": "Please double check that:\n`1.` BungeeCord `config.yml` has `ip_forward` **and** `online_mode` set to **`true`**\n`2.` *All* backend servers' `spigot.yml` has `bungeecord` set to **`true`**\n`3.` *All* backend servers' `server.properties` have `online-mode` set to **`false`**" + "name": "tracks", + "title": "Tracks", + "url": "https://luckperms.net/wiki/Tracks", + "description": "Tracks provide a method for you to promote/demote players along a track (or ladder) of groups.", + "wiki": true }, { - "name": "velocitycheck", + "name": "translations", "aliases": [ - "checkvelocity" + "translate", + "translating", + "crowdin" ], - "title": "Running a network and getting UUID mismatches?", - "description": "Please double check that:\n`1.` Velocity `velocity.toml` has `player-info-forwarding-mode` set to **`\"modern\"`** **and** `online_mode` set to **`true`**\n`2.` *All* backend servers' `server.properties` have `online-mode` set to **`false`** **and** `spigot.yml` have `bungeecord` set to **`false`**\n For more information visit: `https://docs.papermc.io/velocity/player-information-forwarding#configuring-modern-forwarding-for-paper`" - }, + "title": "Translating LuckPerms", + "url": "https://crowdin.com/project/luckperms", + "description": "Translations for LuckPerms are managed on Crowdin. Any contributions are very welcome!", + "fields": [ + { + "key": "Installing the community translations", + "value": "https://luckperms.net/wiki/Locale-and-Translations" + } + ] + }, { "name": "tutorial", - "aliases": ["tut", "yt"], + "aliases": [ + "tut", + "yt" + ], "title": "YouTube Tutorial", "description": "If you would like a video tutorial for setting up LuckPerms, try:\nhttps://www.youtube.com/watch?v=l4anE2wOLdc" }, { - "name": "hack", + "name": "upgrade", + "title": "Upgrading from v4 to v5", + "url": "https://luckperms.net/wiki/Upgrading-from-v4-to-v5", + "description": "Read about upgrading LuckPerms from v4 to v5.", + "wiki": true + }, + { + "name": "usage", "aliases": [ - "hacked", "exploited", "exploit" + "guide", + "starting" ], - "title": "Has LuckPerms been exploited/hacked?", - "description": "Most certainly: **no**. In most cases a 'LuckPerms exploit' is a simple case of human error, which can be avoided easily. Look below for some tips to be on the safe side.", + "title": "Usage", + "url": "https://luckperms.net/wiki/Usage", + "description": "Here's a guide to help users understand and use LuckPerms for the first time.", + "wiki": true + }, + { + "name": "userinfo", + "aliases": [ + "sendinfo" + ], + "title": "Please take a screenshot!", + "description": "Seeing a screenshot makes everything so much easier!", "fields": [ { - "key": "Don't give random people full ( * ) permissions / admin permissions", - "value": "While this should be obvious, a lot of times a exploit can be traced back to faulty permission settings. You should always take your time with permissions and **read the plugin documentations**. In 99% of all cases the plugins have documentations explaining each permission, in the rare case that the plugin you are using does not have a documentation, you could still:\n **A:** Ask the plugin developer for help\n **B:** Use LuckPerms verbose functionality ( `!verbose` )\n **C:** Select a different plugin with proper documentation." - }, - { - "key": "Do not run your server/network in offline mode", - "value": "If you are running your server or network in offline mode, hackers have it really easy to steal your, or any other admins identity. While the server is in offline mode, certain checks ( **which exist to prevent exactly this** ), are being skipped, and the server does not verify if the person joining actually is the person they claim to be. While there may be plugins which increase the security of offline mode servers by adding things such as admin codes, you should just switch it to online to prevent the issue in the first place." + "key": "For prefixes not showing up in chat:", + "value": "`/lp user info`." }, { - "key": "Do not download plugins from shady websites / sent by friends", - "value": "You should never put anything on your server which has not been downloaded by yourself from official sources. Plugins can be infected with malware which injects itself into all other plugins, and thus is hard to remove. While it may look like a plugin has been hacked, you most certainly downloaded a modified version of it and **it is not the plugin authors fault**. In case your server has been infected by such malware:\n 1. Stop the server\n 2. Delete all plugins in your plugins folder, and just to be safe also the server jar file\n 3. Re-Download all plugins and server jar files **from official websites** such as SpigotMC or official plugin websites ( luckperms.net for example ).\n 4. Check if there have been any modifications to the permission system and remove unknown users and wrong permissions.\nif you follow these steps you should have a clean server by the end, without exploits." + "key": "For database errors:", + "value": "Server console: `/lp info` | Bungee console: `/lpb info` | Velocity console: `/lpv info`" } ] }, { - "name": "offline", - "aliases": ["cracked"], - "title": "Offline mode/cracked servers", - "description": "Running a Minecraft server in offline mode can cause a lot of issues, particularly with UUIDs and security vulnerabilities. Some people also view it as unethical (piracy). We understand that some people need to run their servers in offline mode. However, due to the reasons mentioned, some users will choose to not support those running a server in offline mode (this does not apply to those running in a Bungeecord network). Please respect their decision, you may continue to seek help for your issue but in most cases, it can be resolved by setting online-mode=true in server.properties." + "name": "velocitycheck", + "aliases": [ + "checkvelocity" + ], + "title": "Running a network and getting UUID mismatches?", + "description": "Please double check that:\n`1.` Velocity `velocity.toml` has `player-info-forwarding-mode` set to **`\"modern\"`** **and** `online_mode` set to **`true`**\n`2.` *All* backend servers' `server.properties` have `online-mode` set to **`false`** **and** `spigot.yml` have `bungeecord` set to **`false`**\n For more information visit: `https://docs.papermc.io/velocity/player-information-forwarding#configuring-modern-forwarding-for-paper`" }, { - "name": "bedrock", - "aliases": ["geyser"], - "title": "Using Geyser?", - "description": "If you're having issues with permissions for bedrock players, or it's telling you that a bedrock player's name is invalid, try setting `allow-invalid-usernames` to true in the LuckPerms config." + "name": "verbose", + "title": "Verbose", + "url": "https://luckperms.net/wiki/Verbose", + "description": "LuckPerms provides a `verbose` command to help you find out what permissions a command/plugin is checking.", + "wiki": true }, { - "name": "reload", - "aliases": ["plugman"], - "title": "Using `/reload` or plugman?", - "description": "Using Bukkit's `/reload` command causes issues with many plugins, including LuckPerms. If you are adding or removing plugins, you should always fully restart your server.", - "fields": [ - { - "key": "Read more:", - "value": "https://madelinemiller.dev/blog/problem-with-reload/" - }, - { - "key": "What about plugman?", - "value": "Plugman causes all of the same issues as /reload as it is fundamentally doing the same thing as `/reload`" - } - ] + "name": "weight", + "aliases": [ + "weights", + "priority" + ], + "title": "Weight", + "url": "https://luckperms.net/wiki/Weight", + "description": "LuckPerms allows you to set weights in order to determine the priority of certain nodes, like permissions and even prefixes. A higher weight number is a higher priority.", + "wiki": true }, { - "name": "forgepermissions", - "aliases": ["forgeperms", "forge"], - "title": "Why not make LuckPerms work on older versions of Forge?", - "description": "Forge added the Permissions API only recently in 1.18. That API is what allowed a native Forge version of LuckPerms to be made, however that API does not currently exist on older versions of Forge, and is unlikely to be backported. Without the Permissions API existing on older versions of Forge, it is impossible to make LuckPerms work on those versions of Forge natively.", - "fields": [ - { - "key": "Is there any other option?", - "value": "There is a Sponge version of LuckPerms! You can add SpongeForge and the Sponge version of LuckPerms to use LuckPerms on older Forge versions." - } - ] + "name": "whyluckperms", + "aliases": [ + "whylp" + ], + "title": "Why LuckPerms", + "url": "https://luckperms.net/wiki/Why-LuckPerms", + "description": "Why should you choose LuckPerms? Read here to find out.", + "wiki": true }, { - "name": "spongeseven", - "aliases": ["sponge7", "api7"], - "title": "Using Sponge on 1.12.2?", - "description": "LuckPerms no longer releases updates for API 7 of Sponge, which is what the 1.12.2 version of Sponge uses. However you can still download the last version of LuckPerms that supported API 7 from Ore.", - "fields": [ - { - "key": "Ore Download Page:", - "value": "https://ore.spongepowered.org/Luck/LuckPerms/versions/5.3.98" - } - ] + "name": "wiki", + "aliases": [ + "docs" + ], + "title": "LuckPerms Wiki", + "url": "https://luckperms.net/wiki", + "description": "Learn how to use LuckPerms and all of its features by reading the wiki.", + "wiki": true } -] +] \ No newline at end of file