diff --git a/src/main/java/org/geysermc/discordbot/commands/DownloadCommand.java b/src/main/java/org/geysermc/discordbot/commands/DownloadCommand.java index 4bbd8bc7..4b5b05dd 100644 --- a/src/main/java/org/geysermc/discordbot/commands/DownloadCommand.java +++ b/src/main/java/org/geysermc/discordbot/commands/DownloadCommand.java @@ -66,6 +66,7 @@ public DownloadCommand() { .put("floodgate-modded", new GeyserDownloadOption("Floodgate Modded", "A mod which allows Bedrock Edition clients to join Java edition servers without a Java Edition account.", "https://modrinth.com/mod/floodgate")) .put("paper", new DownloadOption("Paper", "Paper is a server software based on Spigot with better performance and more modern features.", "https://papermc.io/downloads", "https://github.com/PaperMC.png")) .put("viaversion", new DownloadOption("ViaVersion", "ViaVersion is a plugin which allows modern clients to join older Java Edition servers.", "https://ci.viaversion.com/job/ViaVersion/", "https://github.com/ViaVersion.png")) + .put("hurricane", new GeyserDownloadOption("Hurricane", "A Paper/Spigot plugin, and Fabric mod (unofficial port), that fixes some bugs that otherwise cannot be fixed without server modification.", "https://geysermc.org/wiki/other/hurricane#download")) .put("hydraulic", new GeyserDownloadOption("Hydraulic (Beta)", "A companion mod to Geyser which allows for Bedrock players to join modded Java Edition servers.", "https://geysermc.org/download?project=other-projects&hydraulic=expanded")) .put("rainbow", new GeyserDownloadOption("Rainbow (Beta)", "A Minecraft mod to generate Geyser item mappings and bedrock resourcepacks for use with Geyser's custom item API (v2). ", "https://geysermc.org/download?project=other-projects&rainbow=expanded")) .put("thunder", new GeyserDownloadOption("Thunder (Beta)", "A java application to convert simple Java Edition resource packs to Bedrock Edition ones.", "https://geysermc.org/download?project=other-projects&thunder=expanded")) diff --git a/src/main/java/org/geysermc/discordbot/commands/RoryCommand.java b/src/main/java/org/geysermc/discordbot/commands/RoryCommand.java new file mode 100644 index 00000000..75724201 --- /dev/null +++ b/src/main/java/org/geysermc/discordbot/commands/RoryCommand.java @@ -0,0 +1,78 @@ +/* + * Copyright (c) 2025 GeyserMC. http://geysermc.org + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + * + * @author GeyserMC + * @link https://github.com/GeyserMC/GeyserDiscordBot + */ + +package org.geysermc.discordbot.commands; + +import com.jagrosh.jdautilities.command.CommandEvent; +import com.jagrosh.jdautilities.command.SlashCommand; +import com.jagrosh.jdautilities.command.SlashCommandEvent; +import net.dv8tion.jda.api.EmbedBuilder; +import net.dv8tion.jda.api.entities.MessageEmbed; +import org.geysermc.discordbot.util.BotColors; +import org.geysermc.discordbot.util.MessageHelper; +import org.json.JSONObject; +import pw.chew.chewbotcca.util.RestClient; + +import java.time.Instant; + +public class RoryCommand extends SlashCommand { + public RoryCommand() { + this.name = "rory"; + this.help = "Shows a random rory image from rory.cat"; + this.aliases = new String[]{ "rory", "car" }; + this.guildOnly = false; + } + + @Override + protected void execute(SlashCommandEvent event) { + event.deferReply().queue(); + event.getHook().editOriginalEmbeds(handle()).queue(); + } + + @Override + protected void execute(CommandEvent event) { + event.getMessage().replyEmbeds(handle()).queue(); + } + + protected MessageEmbed handle() { + JSONObject result = RestClient.get("https://rory.cat/purr").asJSONObject(); + + if (!result.has("url") || !result.has("id")) { + return MessageHelper.errorResponse( + null, + "Couldn't find a random Rory image!", + "Unable to fetch a valid image url from rory.cat!" + ); + } + + return new EmbedBuilder() + .setTitle(":cat: Here’s A Random Rory Image:") + .setImage(result.getString("url")) + .setFooter("Cat ID: " + result.getInt("id") + " • Powered by rory.cat") + .setTimestamp(Instant.now()) + .setColor(BotColors.SUCCESS.getColor()) + .build(); + } +} \ No newline at end of file diff --git a/src/main/java/org/geysermc/discordbot/commands/SupportedVersionsCommand.java b/src/main/java/org/geysermc/discordbot/commands/SupportedVersionsCommand.java new file mode 100644 index 00000000..6d91e5a7 --- /dev/null +++ b/src/main/java/org/geysermc/discordbot/commands/SupportedVersionsCommand.java @@ -0,0 +1,68 @@ +/* + * Copyright (c) 2025 GeyserMC. http://geysermc.org + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + * + * @author GeyserMC + * @link https://github.com/GeyserMC/GeyserDiscordBot + */ + +package org.geysermc.discordbot.commands; + +import com.jagrosh.jdautilities.command.CommandEvent; +import com.jagrosh.jdautilities.command.SlashCommand; +import com.jagrosh.jdautilities.command.SlashCommandEvent; +import net.dv8tion.jda.api.EmbedBuilder; +import net.dv8tion.jda.api.entities.MessageEmbed; +import org.geysermc.discordbot.util.BotColors; +import org.json.JSONObject; +import pw.chew.chewbotcca.util.RestClient; + +public class SupportedVersionsCommand extends SlashCommand { + public SupportedVersionsCommand() { + this.name = "supportedversions"; + this.help = "Shows what Minecraft versions Geyser supports"; + this.aliases = new String[]{ "versions", "supportedversions" }; + this.guildOnly = false; + } + + @Override + protected void execute(SlashCommandEvent event) { + event.deferReply().queue(); + event.getHook().editOriginalEmbeds(handle()).queue(); + } + + @Override + protected void execute(CommandEvent event) { + event.getMessage().replyEmbeds(handle()).queue(); + } + + protected MessageEmbed handle() { + JSONObject result = RestClient.get("https://raw.githubusercontent.com/GeyserMC/GeyserWebsite/master/src/data/versions.json").asJSONObject(); + + String javaVersion = result.getJSONObject("java").getString("supported"); + String bedrockVersion = result.getJSONObject("bedrock").getString("supported"); + + return new EmbedBuilder() + .setTitle(":geyser: Geyser Supported Versions") + .setDescription("Currently, Geyser supports Minecraft: Bedrock Edition " + bedrockVersion + " and Minecraft: Java Edition " + javaVersion + ".") + .setColor(BotColors.SUCCESS.getColor()) + .build(); + } +} \ No newline at end of file diff --git a/src/main/java/org/geysermc/discordbot/commands/TagsCommand.java b/src/main/java/org/geysermc/discordbot/commands/TagsCommand.java index e6f444b8..02d51803 100644 --- a/src/main/java/org/geysermc/discordbot/commands/TagsCommand.java +++ b/src/main/java/org/geysermc/discordbot/commands/TagsCommand.java @@ -97,7 +97,7 @@ protected MessageEmbed handle(String search) { embed.setColor(BotColors.SUCCESS.getColor()); embed.setTitle("Tags (" + tagNames.size() + ")"); embed.setDescription("`" + String.join("`, `", tagNames) + "`"); - embed.setFooter("Use `" + PropertiesManager.getPrefix() + "tag ` to show a tag"); + embed.setFooter("Use `" + PropertiesManager.getPrefix() + PropertiesManager.getPrefix() + "` to show a tag"); } return embed.build(); diff --git a/src/main/java/org/geysermc/discordbot/tags/TagAliasCommand.java b/src/main/java/org/geysermc/discordbot/tags/TagAliasCommand.java index 51c7c0e7..7a7dd279 100644 --- a/src/main/java/org/geysermc/discordbot/tags/TagAliasCommand.java +++ b/src/main/java/org/geysermc/discordbot/tags/TagAliasCommand.java @@ -81,7 +81,7 @@ protected void execute(CommandEvent event) { if (foundTag.getAliases().length > 0) { embed.setTitle("Aliases for " + foundTag.getName() + " (" + foundTag.getAliases().length + ")"); embed.setDescription("`" + String.join("`, `", foundTag.getAliases()) + "`"); - embed.setFooter("Use `" + PropertiesManager.getPrefix() + "tag ` to show a tag"); + embed.setFooter("Use `" + PropertiesManager.getPrefix() + PropertiesManager.getPrefix() + "` to show a tag"); embed.setColor(BotColors.SUCCESS.getColor()); } else { embed.setTitle("No aliases for " + foundTag.getName()); diff --git a/src/main/java/org/geysermc/discordbot/util/BotColors.java b/src/main/java/org/geysermc/discordbot/util/BotColors.java index c1bc8400..b65f6fc8 100644 --- a/src/main/java/org/geysermc/discordbot/util/BotColors.java +++ b/src/main/java/org/geysermc/discordbot/util/BotColors.java @@ -28,6 +28,17 @@ import java.awt.Color; public enum BotColors { + // Tags Colors: + ERRORS("#FF4C4C"), + FUN("#FF6B81"), + HELP("#2ECC71"), + INFO("#5BC0EB"), + LINKS("#A569BD"), + ROLES("#FF8000"), + UTIL("#1E90FF"), + WARNS("#FFBF00"), + + // Regular Embed Colors: NEUTRAL("#2B5797"), SUCCESS("#4CAF50"), FAILURE("#FF0000"), diff --git a/src/main/resources/tags/README.md b/src/main/resources/tags/README.md index 12c05229..3c1974a7 100644 --- a/src/main/resources/tags/README.md +++ b/src/main/resources/tags/README.md @@ -19,7 +19,8 @@ The below lays out the `text` tag type, allows for Markdown to be sent as an emb type: text aliases: test1, test2 title: Test -color: neutral | success | failure | warning +colors: errors | fun | help | info | links | roles | util +legacy colors: neutral | success | failure | warning image: https://example.com/example.png button: [View Rory](https://example.com) button: [Floodgate Wiki](https://wiki.geysermc.org/floodgate/) diff --git a/src/main/resources/tags/errors/addressinuse.tag b/src/main/resources/tags/errors/addressinuse.tag index 9d978882..cb0e162b 100644 --- a/src/main/resources/tags/errors/addressinuse.tag +++ b/src/main/resources/tags/errors/addressinuse.tag @@ -1,8 +1,11 @@ type: text +title: :x: Address Already In Use issues: Address already in use aliases: bind, failedtobind, bindissue, addressalreadyinuse +color: errors --- -This means something (likely another instance of Geyser) is running on the port you have specified in the config. Please make sure you close all applications running on this port. If you don't recall opening anything, usually restarting your computer fixes this. -If you are using a server hosting provider and get this error, you likely need to use a specific port allocated to you. See the [setup guide](https://wiki.geysermc.org/geyser/setup/) for instructions on how to configure Geyser. \ No newline at end of file +The port in your Geyser config is already in use, often by another Geyser instance, query port, or voice chat plugin/mod. +- If you’re self-hosting, close any applications using that port, or restart your computer if you’re unsure what’s running. +- If you’re using a hosting provider, use the specific port allocated to you. \ No newline at end of file diff --git a/src/main/resources/tags/errors/assignaddressfailure.tag b/src/main/resources/tags/errors/assignaddressfailure.tag index 1502b955..f255f127 100644 --- a/src/main/resources/tags/errors/assignaddressfailure.tag +++ b/src/main/resources/tags/errors/assignaddressfailure.tag @@ -3,4 +3,5 @@ issues: java.net.BindException: Cannot assign requested address --- -This means the IP your server is trying to use is unavailable or disallowed by the system or firewall. +Your Geyser server is trying to use an IP address that isn't available or is being blocked by the operating system or firewall. +- In your Geyser config, check the bedrock section and make sure the `address` is set to `0.0.0.0`. \ No newline at end of file diff --git a/src/main/resources/tags/errors/closedchannelexcept.tag b/src/main/resources/tags/errors/closedchannelexcept.tag new file mode 100644 index 00000000..98be4fb1 --- /dev/null +++ b/src/main/resources/tags/errors/closedchannelexcept.tag @@ -0,0 +1,11 @@ +type: text +aliases: closechannelexception, closedchannelexc, closedchannel +title: :x: ClosedChannelException +issues: ClosedChannelException +color: errors + +--- + +We require server logs to assist you further. Please follow the instructions below: +1. Upload your logs to [MCLogs](https://mclo.gs/). +2. Share the MCLogs link in <#613168464634576897> or <#1038995448100306964>. \ No newline at end of file diff --git a/src/main/resources/tags/errors/closedchannelexception.tag b/src/main/resources/tags/errors/closedchannelexception.tag deleted file mode 100644 index 0bb14f5d..00000000 --- a/src/main/resources/tags/errors/closedchannelexception.tag +++ /dev/null @@ -1,7 +0,0 @@ -type: text -issues: ClosedChannelException - ---- - -This error can be caused by various things. Please upload your logs using https://mclo.gs/ and paste them in <#613168464634576897>. -If you are getting this error on a proxy server such as Velocity or BungeeCord, check your backend server logs for errors. \ No newline at end of file diff --git a/src/main/resources/tags/errors/connectionclosed.tag b/src/main/resources/tags/errors/connectionclosed.tag index 221e4af7..5228a2e7 100644 --- a/src/main/resources/tags/errors/connectionclosed.tag +++ b/src/main/resources/tags/errors/connectionclosed.tag @@ -1,7 +1,10 @@ type: text +title: :x: Connection Closed issues: Connection closed +color: errors --- -This error is probably caused by a connection error. Upload your logs with http://mclo.gs/ and paste the URL here. -If you are getting this error on a proxy server such as Velocity or BungeeCord, check your backend server logs for errors. \ No newline at end of file +We require server logs to assist you further. Please follow the instructions below: +1. Upload your logs to [MCLogs](https://mclo.gs/). +2. Share the MCLogs link in <#613168464634576897> or <#1038995448100306964>. \ No newline at end of file diff --git a/src/main/resources/tags/errors/connectiontimedout.tag b/src/main/resources/tags/errors/connectiontimedout.tag index 66a564c2..32f0480d 100644 --- a/src/main/resources/tags/errors/connectiontimedout.tag +++ b/src/main/resources/tags/errors/connectiontimedout.tag @@ -3,4 +3,6 @@ issues: AnnotatedConnectException: Connection timed out --- -The Geyser instance cannot connect to your Java server. +The Geyser instance cannot connect to your Java server. Please follow the instructions below to identify the issue: +1. Check if Geyser is using a bedrock port that is properly port forwarded. +2. Check if your Geyser server has plugin or mod conflicts. Run `!!plugindebugging` for more information. \ No newline at end of file diff --git a/src/main/resources/tags/errors/connectthroughtheofficialgeyser.tag b/src/main/resources/tags/errors/connectthroughtheofficialgeyser.tag deleted file mode 100644 index 21baf373..00000000 --- a/src/main/resources/tags/errors/connectthroughtheofficialgeyser.tag +++ /dev/null @@ -1,9 +0,0 @@ -type: text -issues: Please connect through the official Geyser -aliases: ctog, cttog - ---- - -This error is caused by a Floodgate key.pem mismatch, most likely between your proxy and your backend servers. -Make sure that the key.pem file in every Floodgate config folder is the same file. -If this still doesn't work and you're using an FTP client, try using the [WinSCP](https://winscp.net/eng/index.php) client. diff --git a/src/main/resources/tags/errors/illegalnickname.tag b/src/main/resources/tags/errors/illegalnickname.tag index af0e0c15..45b7137e 100644 --- a/src/main/resources/tags/errors/illegalnickname.tag +++ b/src/main/resources/tags/errors/illegalnickname.tag @@ -1,8 +1,9 @@ type: text -issues: invalid nickname +title: :x: Illegal Nickname +issues: illegal nickname || invalid nickname +aliases: invalidnickname, invalidnick, illegalnick +color: errors --- -This "error" is caused by a login plugin such as AuthMe which is not supported with Geyser. - -If you are simply just wanting Bedrock players to be able to join your Java server without a Java account, we recommend using our plugin [Floodgate](https://wiki.geysermc.org/floodgate/setup/) which allows them to join the server with it being in online mode. If you did not mean to set your server to offline mode or don't understand what it means, please set your server to online mode to receive support further. \ No newline at end of file +This error is caused by a login plugin such as AuthMe which Geyser does not support. Since login plugins indicate offline mode, we will not provide Geyser support. Run `!!offline` for more information. \ No newline at end of file diff --git a/src/main/resources/tags/errors/ipforwarderror.tag b/src/main/resources/tags/errors/ipforwarderror.tag index eed92da1..13bfc85e 100644 --- a/src/main/resources/tags/errors/ipforwarderror.tag +++ b/src/main/resources/tags/errors/ipforwarderror.tag @@ -1,8 +1,14 @@ type: text +title: :x: IP Forwarding Error +aliases: ipforward issues: please enable it in your BungeeCord config as well +color: errors --- -This error is caused either by BungeeCord/Waterfall not having IP forwarding enabled, or by a Floodgate mismatched key.pem from the proxy to the backend servers. -This could also be caused by *send-floodgate-data:* being enabled without Floodgate being present on all backend servers. -For more information on how to setup Floodgate API on proxies; run `!!proxies` in <#613194762249437245> +This error can be caused by the following: +- `ip_forward` is not enabled in your BungeeCord proxy `config.yml`. +- [Player information forwarding](https://docs.papermc.io/velocity/player-information-forwarding/) is not set up on your Velocity proxy. +- A Floodgate mismatched `key.pem` from the proxy to the backend servers. +- `send-floodgate-data` is enabled without Floodgate being present on all backend servers. +For more information on how to setup Floodgate API on proxy servers, run `!!proxies` in <#613194762249437245>. \ No newline at end of file diff --git a/src/main/resources/tags/errors/logintoxbox.tag b/src/main/resources/tags/errors/logintoxbox.tag index 0f7ddd03..04bd856f 100644 --- a/src/main/resources/tags/errors/logintoxbox.tag +++ b/src/main/resources/tags/errors/logintoxbox.tag @@ -1,13 +1,14 @@ type: text +title: :x: Login To Xbox issues: Please log into Xbox to join this server. +color: errors --- -This error occurs when Geyser is unable to validate your login. This might be because the client didn't send the right data, or you just aren't logged in. -You can use the following steps to debug this: -- Double check you are actually logged in. -- Restart your game and try again. -- Try joining a featured server, if you face the same issue then continue through the steps, if you don't, send a dump link (Run `!!dump` in <#613194762249437245> for more information). -- Log out of your account, then log back in. -- Restart your device. -- If the issue still persists, contact Minecraft support. +This error happens when Geyser can’t validate your login, often due to the client not sending the right data or not being logged in. You can use the instructions below to debug this: +1. Double check you are actually logged in. +2. Restart your game and try again. +3. If you don't face the same issue when joining a featured server, send a Geyser dump link. Run `!!dump` in <#613194762249437245> for more information. +4. Log out of your account and then log back in. +5. Restart your device. +6. If the issue still persists, contact Minecraft support. \ No newline at end of file diff --git a/src/main/resources/tags/errors/mismatch.tag b/src/main/resources/tags/errors/mismatch.tag new file mode 100644 index 00000000..5476e65c --- /dev/null +++ b/src/main/resources/tags/errors/mismatch.tag @@ -0,0 +1,9 @@ +type: text +title: :x: Floodgate Key Mismatch +issues: Please connect through the official Geyser +aliases: ctog, cttog +color: errors + +--- + +This error happens when the Floodgate key.pem files don’t match between your proxy and backend servers. Ensure every Floodgate config folder has the same key.pem. If issues persist and you’re using an FTP client, try switching to [WinSCP](https://winscp.net/eng/index.php). \ No newline at end of file diff --git a/src/main/resources/tags/errors/mpconnectfail.tag b/src/main/resources/tags/errors/mpconnectfail.tag new file mode 100644 index 00000000..afcfc337 --- /dev/null +++ b/src/main/resources/tags/errors/mpconnectfail.tag @@ -0,0 +1,14 @@ +type: text +aliases: multiplayerconnectionfailed, mpconnectionfailed, mpconnectfailed, mpconnect, unabletoconnect, unabletoconnecttoworld +title: :x: Multiplayer Connection Failed +issues: Multiplayer connection failed || Unable to connect to world +color: errors + +--- + +This is a network issue usually caused by improper port forwarding. To resolve this error, try the following: +- Follow server hosting instructions provided by running `/provider` followed by your server hosting's name in <#613194762249437245>. +- Follow `!!networkdebug` instructions if your server hosting is not listed in `/provider`. +- Follow `!!playitdebug` instructions if your playit.gg for port forwarding. +- Make sure Geyser is not running on the same port as a voice chat plugin or mod. +- Check out this [Geyser Wiki Page](https://wiki.geysermc.org/geyser/fixing-unable-to-connect-to-world/) for additional fixes for this error. \ No newline at end of file diff --git a/src/main/resources/tags/errors/needjavaaccount.tag b/src/main/resources/tags/errors/needjavaaccount.tag index 073879ad..4fa23ffc 100644 --- a/src/main/resources/tags/errors/needjavaaccount.tag +++ b/src/main/resources/tags/errors/needjavaaccount.tag @@ -1,7 +1,8 @@ type: text +title: :x: Need Java Edition Account issues: you need a java edition account to play on this server +color: errors --- -If you are getting a form with 'You need a Java Edition Account to play on this server' and you do not have a Java account, then you will need to install Floodgate. -Run !download floodgate in <#613194762249437245> for additional information or see the setup guide: https://wiki.geysermc.org/floodgate/setup/ \ No newline at end of file +If you are getting a form with "You need a Java Edition account to play on this server", you will either need to link a Java Edition account everytime you join the Geyser server or install [Floodgate](https://geysermc.org/wiki/floodgate/setup/) which allows Bedrock players without a Minecraft Java Edition account on your Geyser server. \ No newline at end of file diff --git a/src/main/resources/tags/errors/outdatedclient.tag b/src/main/resources/tags/errors/outdatedclient.tag index 75e18214..fae8d4e9 100644 --- a/src/main/resources/tags/errors/outdatedclient.tag +++ b/src/main/resources/tags/errors/outdatedclient.tag @@ -1,6 +1,8 @@ type: text +title: :x: Outdated Bedrock Client issues: Outdated Bedrock client +color: errors --- -Your issue is caused by your Bedrock client being outdated, please update it. +This error is caused by your Minecraft: Bedrock Edition client being outdated, please update it. \ No newline at end of file diff --git a/src/main/resources/tags/errors/outdatedgeyser.tag b/src/main/resources/tags/errors/outdatedgeyser.tag index f9fc405c..485ea28d 100644 --- a/src/main/resources/tags/errors/outdatedgeyser.tag +++ b/src/main/resources/tags/errors/outdatedgeyser.tag @@ -1,8 +1,12 @@ type: text +title: :x: Outdated Geyser Proxy issues: Outdated Geyser proxy +color: errors --- -Your Geyser plugin is outdated. Please update Geyser! -To update Geyser or Floodgate, shut down your server, run `!download geyser` or `!download floodgate` in <#613194762249437245>, and replace your current jar file with the new version from the link. -You do not need to remove or modify your config when updating Geyser or Floodgate. \ No newline at end of file +Your Geyser is outdated, please update Geyser by following the steps below: +1. Shut down your Geyser server. +2. Download the new [Geyser](https://geysermc.org/download) jar file. +3. Replace your current Geyser jar file with the new Geyser jar file. +**You do not need to remove or modify your config when updating Geyser.** \ No newline at end of file diff --git a/src/main/resources/tags/errors/outdatedjava.tag b/src/main/resources/tags/errors/outdatedjava.tag new file mode 100644 index 00000000..1a662a03 --- /dev/null +++ b/src/main/resources/tags/errors/outdatedjava.tag @@ -0,0 +1,13 @@ +type: text +aliases: latestjava, unsupportedclassversion, updatejava, openjdk, javadownload +issues: java.lang.UnsupportedClassVersionError +title: :x: Geyser Java Requirements +color: errors + +--- + +This error means your server is not running Java 17 or later which Geyser requires to run. +- You can download Java 17 [here](https://adoptium.net/temurin/releases/). +- To find out how to change your Java version on hosts or other platforms, see [this](https://docs.papermc.io/java-install-update). +- If you’re running a version of Paper that does not support Java 17 or later, you can add the flag `-DPaper.IgnoreJavaVersion=true` to your startup Java arguments to allow Paper to run on Java 17. +- You can run Geyser standalone on another device if a server software cannot be updated to use Java 17. \ No newline at end of file diff --git a/src/main/resources/tags/errors/outdatedserver.tag b/src/main/resources/tags/errors/outdatedserver.tag index 1fd44f62..a0237d29 100644 --- a/src/main/resources/tags/errors/outdatedserver.tag +++ b/src/main/resources/tags/errors/outdatedserver.tag @@ -1,9 +1,11 @@ type: text +title: :x: Outdated Server issues: Outdated server +color: errors --- - -This error means that you need to update your server/proxy to the latest version or install the ViaVersion plugin. -Run `!download viaversion` in <#613194762249437245>. -Please read this when considering what Minecraft version to use for your server: https://madelinemiller.dev/blog/which-minecraft-version/ +This error means that your server or proxy is outdated. To resolve this error, try the following: +- Update to the latest Minecraft version or proxy version. Please read [this](https://madelinemiller.dev/blog/which-minecraft-version/) when considering what Minecraft version to use for your server. +- Install or update the [ViaVersion](https://ci.viaversion.com/job/ViaVersion/) plugin. +- If your using Geyser-Fabric or Geyser-NeoForge, please see this [page](https://geysermc.org/wiki/geyser/supported-versions/#fabric-neoforge-servers). \ No newline at end of file diff --git a/src/main/resources/tags/errors/outofmemory.tag b/src/main/resources/tags/errors/outofmemory.tag index 4907facc..24ad9bcf 100644 --- a/src/main/resources/tags/errors/outofmemory.tag +++ b/src/main/resources/tags/errors/outofmemory.tag @@ -3,4 +3,6 @@ issues: java.lang.OutOfMemoryError --- -This means your server ran out of memory while running. You could allocate more RAM to it or it could be caused by a memory leak. +This error means your server ran out of memory for one of two reasons: +- The server doesn’t have enough RAM allocated. +- There’s a memory leak. \ No newline at end of file diff --git a/src/main/resources/tags/errors/secureprofiles.tag b/src/main/resources/tags/errors/secureprofiles.tag index 5ca9f5ab..2fa2f67c 100644 --- a/src/main/resources/tags/errors/secureprofiles.tag +++ b/src/main/resources/tags/errors/secureprofiles.tag @@ -1,17 +1,12 @@ type: text +title: :x: Requires Secure Profiles aliases: chat issues: This server requires secure profiles || multiplayer.disconnect.missing_public_key || Invalid signature for profile public key || Chat disabled due to missing profile public key +color: errors --- -Minecraft 1.19 adds key signing, which is currently only used to verify that chat messages are coming from the right player. -Floodgate and Geyser currently do not support this, so it should be disabled using the following instructions: - -**Spigot, Paper, & all forks** -Set `enforce-secure-profile=false` in [server.properties](https://minecraft.fandom.com/wiki/Server.properties) - -**Bungeecord** -Set `enforce_secure_profile: false` in [config.yml](https://www.spigotmc.org/wiki/bungeecord-configuration-guide/) - -**Velocity** -Set `force-key-authentication = false` in [velocity.toml](https://github.com/PaperMC/Velocity/blob/dev/3.0.0/proxy/src/main/resources/default-velocity.toml#L19) +Minecraft 1.19 adds key signing, which is currently only used to verify that chat messages are coming from the right player. Floodgate and Geyser currently do not support this, so it should be disabled using the following instructions: +- **Spigot/Paper, Fabric, and NeoForge:** Set `enforce-secure-profile=false` in [`server.properties`](https://minecraft.wiki/w/Server.properties) +- **Bungeecord:** Set `enforce_secure_profile: false` in [`config.yml`](https://www.spigotmc.org/wiki/bungeecord-configuration-guide/) +- **Velocity:** Set `force-key-authentication = false` in [`velocity.toml`](https://github.com/PaperMC/Velocity/blob/dev/3.0.0/proxy/src/main/resources/default-velocity.toml#L19) \ No newline at end of file diff --git a/src/main/resources/tags/errors/unabletoconnect.tag b/src/main/resources/tags/errors/unabletoconnect.tag deleted file mode 100644 index d7c8d665..00000000 --- a/src/main/resources/tags/errors/unabletoconnect.tag +++ /dev/null @@ -1,10 +0,0 @@ -type: text -issues: Unable to connect to world - ---- - -This means that the Bedrock client cannot find the server specified. -If you have not already, follow our [setup instructions](https://wiki.geysermc.org/geyser/setup/). Then, check the server console for any errors. -To verify Bedrock clients can connect, you can try running the `geyser connectiontest ` command with your server IP and Geyser port. - -Additionally, there are various fixes for this on our wiki, please see [here](https://wiki.geysermc.org/geyser/fixing-unable-to-connect-to-world/). diff --git a/src/main/resources/tags/fun/cat.tag b/src/main/resources/tags/fun/cat.tag index a7fd7a01..a135d36a 100644 --- a/src/main/resources/tags/fun/cat.tag +++ b/src/main/resources/tags/fun/cat.tag @@ -2,4 +2,4 @@ type: raw --- - + \ No newline at end of file diff --git a/src/main/resources/tags/fun/jet2.tag b/src/main/resources/tags/fun/jet2.tag index 2e787879..6588955a 100644 --- a/src/main/resources/tags/fun/jet2.tag +++ b/src/main/resources/tags/fun/jet2.tag @@ -1,4 +1,6 @@ type: text +title: :airplane: Jet2 Holiday +color: fun --- diff --git a/src/main/resources/tags/fun/tryitandsee.tag b/src/main/resources/tags/fun/tryitandsee.tag index e248cdc7..29d14154 100644 --- a/src/main/resources/tags/fun/tryitandsee.tag +++ b/src/main/resources/tags/fun/tryitandsee.tag @@ -3,4 +3,4 @@ aliases: tias, tryit --- -https://tryitands.ee/ +https://tryitands.ee/ \ No newline at end of file diff --git a/src/main/resources/tags/fun/xy.tag b/src/main/resources/tags/fun/xy.tag index 4f76a794..97aa2c24 100644 --- a/src/main/resources/tags/fun/xy.tag +++ b/src/main/resources/tags/fun/xy.tag @@ -1,7 +1,8 @@ type: text +title: :thinking: The XY Problem +color: fun +button: [XY Problem](https://xyproblem.info/) --- -**The XY Problem** -Asking about your attempted solution rather than your actual problem -http://xyproblem.info/ +Asking about your attempted solution rather than your actual problem. \ No newline at end of file diff --git a/src/main/resources/tags/help/beta.tag b/src/main/resources/tags/help/beta.tag deleted file mode 100644 index 3f4574b9..00000000 --- a/src/main/resources/tags/help/beta.tag +++ /dev/null @@ -1,7 +0,0 @@ -type: text -aliases: betas, preview - ---- - -Geyser does not support beta or preview versions usually, you can opt out of Bedrock betas using this guide: - diff --git a/src/main/resources/tags/help/commandfreezing.tag b/src/main/resources/tags/help/commandfreezing.tag index 9f70f117..e6f17b01 100644 --- a/src/main/resources/tags/help/commandfreezing.tag +++ b/src/main/resources/tags/help/commandfreezing.tag @@ -1,7 +1,8 @@ type: text +title: :geyser: Command Freezing +color: help +button: [HideCommands](https://modrinth.com/mod/hidecommands) --- -Disable `command-suggestions` in your config. This will stop `/` from freezing Bedrock clients but will also disable command suggestions being sent. - -Alternatively, you can try and reduce the amount of commands sent to Bedrock edition players - for example by using the [HideCommands extension](https://github.com/Redned235/HideCommands). +Disabling `command-suggestions` in your geyser config will stop `/` from freezing Bedrock clients, but will also stop command suggestions from being sent. You can try and reduce the amount of commands sent to Bedrock edition players using the HideCommands extension. \ No newline at end of file diff --git a/src/main/resources/tags/help/commands.tag b/src/main/resources/tags/help/commands.tag index 81694418..ef5182d9 100644 --- a/src/main/resources/tags/help/commands.tag +++ b/src/main/resources/tags/help/commands.tag @@ -1,7 +1,8 @@ type: text aliases: tp, op +title: :geyser: Commands With Bedrock Players +color: help --- -If you are having issues with using commands such as `/tp` with Bedrock players while using Floodgate; you could try using the format below. Setting the floodgate username prefix to `.` also solves this issue. -`/tp ".BedrockPlayer"` +If you are having issues with using commands such as `/tp` with Bedrock players while using Floodgate, try using this format: `/tp .BedrockPlayer`. Setting the floodgate username prefix to `.` (which is the default) or `+`, `-`, and `!` also solves this issue. \ No newline at end of file diff --git a/src/main/resources/tags/help/domain.tag b/src/main/resources/tags/help/domain.tag index 18bbe6f7..d348a7c1 100644 --- a/src/main/resources/tags/help/domain.tag +++ b/src/main/resources/tags/help/domain.tag @@ -1,14 +1,17 @@ type: text aliases: domains, srv, srvrecord, dns, domain +title: :geyser: Domain Guide +color: help +button: [Setup Guide](https://wiki.geysermc.org/geyser/setup/) --- -Domain guide: -First, configure Geyser, so that you are able to connect with the **numeric IP + port** (see the usual setup guide on https://wiki.geysermc.org/geyser/setup/) -When that is done & you are able to connect with the numeric IP + port, proceed with setting up the domain: -1. Get a domain (e.g. via Cloudflare) -2. Add an A-Record (Bedrock doesn't work with SRV DNS records, so you'll have to use an A record instead. Java players will be able to connect fine with an A record. A CNAME record will also work for redirecting both Java and Bedrock players). +Before starting this domain guide, please make you are able to connect to your Geyser server with the **Numeric IP + Port**. If not, use the Geyser setup guide. To setup a domain for Geyser: +1. Get a domain (e.g. via [Cloudflare](https://domains.cloudflare.com/)) +2. Add an A-Record: +└> Bedrock doesn't work with SRV DNS records, so you'll have to use an A record instead. +└> Java players will be able to connect fine with an A record. +└> A CNAME record will also work for redirecting both Java and Bedrock players. 3. Point the record to the IP of your server. 4. Do NOT enable "proxied" mode, it has to be DNS-only! - -Then, you should be able to use your domain together with the port to connect to your server. +5. Connect to your server with your domain and port (e.g. `play.example.com:19132`). \ No newline at end of file diff --git a/src/main/resources/tags/help/help.tag b/src/main/resources/tags/help/help.tag index 3bb3ef54..444eba12 100644 --- a/src/main/resources/tags/help/help.tag +++ b/src/main/resources/tags/help/help.tag @@ -1,7 +1,13 @@ type: text -aliases: help help: help +title: :geyser: Geyser Help +color: help +button: [GeyserMC Wiki](https://wiki.geysermc.org/) +button: [GeyserMC Bot Commands & Usage](https://wiki.geysermc.org/other/discord-bot-usage/) --- -If you're having trouble setting up Geyser or have an error for some reason, be sure to check out our [wiki](https://wiki.geysermc.org) page first. You can find most information there. Our bot has a number of helpful tools to help you with problems. The link for the bot commands and/or its use can be found here [bot command & usage](https://wiki.geysermc.org/other/discord-bot-usage/). Please use <#613194762249437245> for bot commands! +If you’re having trouble setting up Geyser or encounter an error: +- Check the GeyserMC wiki first as most information can be found there. +- This discord bot also provides several helpful tags/commands for troubleshooting which should only be used in <#613194762249437245>. +- Ask in <#613168464634576897> or make a new support post in <#1038995448100306964> with a detailed description of the issue your having. \ No newline at end of file diff --git a/src/main/resources/tags/help/howtoportforward.tag b/src/main/resources/tags/help/howtoportforward.tag index 6afbe818..27cee7be 100644 --- a/src/main/resources/tags/help/howtoportforward.tag +++ b/src/main/resources/tags/help/howtoportforward.tag @@ -1,7 +1,10 @@ type: text aliases: portforwarding help: portforward +title: :geyser: Port Forwarding Guide +color: help +button: [Port Forwarding](https://wiki.geysermc.org/geyser/port-forwarding/) --- -[Here](https://wiki.geysermc.org/geyser/port-forwarding/) you can find a guide on how to set up port forwarding. Geyser uses the UDP protocol and the default Minecraft Bedrock port is `19132`. +We have a guide for how to set up port forwarding for your Geyser server. Geyser uses the UDP protocol and the default Minecraft Bedrock port is `19132`. \ No newline at end of file diff --git a/src/main/resources/tags/help/ip.tag b/src/main/resources/tags/help/ip.tag index 86efafe8..861b9ddf 100644 --- a/src/main/resources/tags/help/ip.tag +++ b/src/main/resources/tags/help/ip.tag @@ -1,13 +1,10 @@ type: text aliases: address +title: :geyser: Bedrock Server IP +color: help --- -When using Geyser as a plugin, the IP is usually the same as your Java server's ip. - -That being said, there are a few other Geyser-related services that have their own IP: - -- If you're looking for a hosted version of the GeyserConnect software, run `!!geyserconnect` in <#613194762249437245> for more info. -It allows you to connect to most Java servers from Bedrock without having to install anything on the server. - -- If you just want to try out Geyser, we have a test server at `test.geysermc.org` - run `/tag testserver` in <#613194762249437245> for more info. +When using Geyser, the Bedrock server IP address is usually the same as your Java server's IP address. With that being said, there are a few other Geyser-related services that have their own IP address: +- If you're looking for a hosted version of the GeyserConnect software, run `!!geyserconnect` in <#613194762249437245> for more information. +- If you just want to try out Geyser, we have a test server at `test.geysermc.org`. Run `/tag testserver` in <#613194762249437245> for more information. \ No newline at end of file diff --git a/src/main/resources/tags/help/luckperms.tag b/src/main/resources/tags/help/luckperms.tag index 6fb2a4df..39036094 100644 --- a/src/main/resources/tags/help/luckperms.tag +++ b/src/main/resources/tags/help/luckperms.tag @@ -1,7 +1,9 @@ type: text aliases: lp issues: is not a valid username/uuid +title: :geyser: LuckPerms Not Recognizing Bedrock Players +color: help --- -To fix issues with luckperms not recognizing Bedrock players, you can set `allow-invalid-usernames` to `true` in LuckPerms’ config. \ No newline at end of file +To fix issues with LuckPerms not recognizing Bedrock players, set `allow-invalid-usernames` to `true` in LuckPerms’s config. \ No newline at end of file diff --git a/src/main/resources/tags/help/networkdebug.tag b/src/main/resources/tags/help/networkdebug.tag index 240a0568..58a3f165 100644 --- a/src/main/resources/tags/help/networkdebug.tag +++ b/src/main/resources/tags/help/networkdebug.tag @@ -1,4 +1,6 @@ type: text +title: :geyser: Network Debug +color: help aliases: nd --- @@ -6,5 +8,5 @@ aliases: nd If you are unable to connect to your server, this may be because you are using the wrong port, or you do not have a UDP port forwarded. Below you can find a list of steps to debug this: - Check if there is a setup guide for your host on the [setup guide](https://geysermc.org/wiki/geyser/setup). - Enable `clone-remote-port` in the Geyser config, restart, and try join with your Java IP and port. -- Look for a section in your panel for allocating ports, make a new allocation and use the port there in the Geyser config (ensuring you disable `clone-remote-port`). If you can't find a section for this, skip this step. -- Contact your host and ask about getting a UDP port allocation. If you don't know how to explain that, ask for a port to run Geyser. +- Look for a section in your panel for allocating ports, make a new allocation and use the port there as the Bedrock port in the Geyser config (ensure that you disable `clone-remote-port` before doing this). If you can't find a section for this, skip this step. +- Contact your host and ask about getting a UDP port allocation. If you don't know how to explain that, ask for a port to run Geyser. \ No newline at end of file diff --git a/src/main/resources/tags/help/playitdebug.tag b/src/main/resources/tags/help/playitdebug.tag new file mode 100644 index 00000000..514b8497 --- /dev/null +++ b/src/main/resources/tags/help/playitdebug.tag @@ -0,0 +1,15 @@ +type: text +aliases: playit.ggdebug, playitggdebug +title: :geyser: playit.gg Debugging +color: help +button: [playit.gg Setup Guide](https://geysermc.org/wiki/geyser/playit-gg/) + +--- + +The most common issue when setting up playit.gg is confusing the bedrock port and the playit.gg port which are entirely separate. To fix this, change the bedrock port back to the default of `19132` and ensure that `clone-remote-port` is set to `false` in the Geyser config. + +If you still have issues, make sure that: +- You are joining with playit.gg's IP and port. +- You are using the playit.gg program agent and not the playit.gg plugin. +- You have the program agent open while trying to join. +- You have followed the playit.gg setup guide's instructions correctly. \ No newline at end of file diff --git a/src/main/resources/tags/help/plugindebugging.tag b/src/main/resources/tags/help/plugindebugging.tag index b21911b8..09bbb000 100644 --- a/src/main/resources/tags/help/plugindebugging.tag +++ b/src/main/resources/tags/help/plugindebugging.tag @@ -1,4 +1,6 @@ type: text +title: :geyser: Plugin Debugging +color: help aliases: pd --- @@ -7,4 +9,4 @@ If you have a possible plugin interfering with Geyser or Floodgate, follow these - Temporarily remove/move half of your plugins from your server's plugins folder. - *If the problem persists*, remove another half. - *If the problem goes away*, swap that half of your plugins with the other half. -- Keep repeating this pattern, this time with the half that exhibits the problem, until you find your problematic plugin. +- Keep repeating this pattern, this time with the half that exhibits the problem, until you find your problematic plugin. \ No newline at end of file diff --git a/src/main/resources/tags/help/portforward.tag b/src/main/resources/tags/help/portforward.tag deleted file mode 100644 index 22f94cd9..00000000 --- a/src/main/resources/tags/help/portforward.tag +++ /dev/null @@ -1,10 +0,0 @@ -type: text -image: https://i.ibb.co/7J0HhZF/Portforward.png - ---- - -**Test your server's port forwarding** -1. Go [here](https://www.ipfingerprints.com/portscan.php) -2. Follow the guide on this picture. Use the port that your Geyser uses (19132 is the default) - -Note: UDP port scanning is fairly unreliable, so this is just a possible indicator whether the port is blocked (closed), or likely open. \ No newline at end of file diff --git a/src/main/resources/tags/help/prdownload.tag b/src/main/resources/tags/help/prdownload.tag index d1f7f05e..04e12d09 100644 --- a/src/main/resources/tags/help/prdownload.tag +++ b/src/main/resources/tags/help/prdownload.tag @@ -1,9 +1,12 @@ type: text +title: :geyser: Downloading A PR +aliases: pr +color: help image: https://i.ibb.co/tCcB1Qp/PR1.png --- -**To download a pull request (or a "PR") you need to:** -**1.** Make sure you are signed in with a GitHub account -**2.** Follow the pull request link that was sent to you (for example https://github.com/GeyserMC/Geyser/pull/699) -**3.** Follow the guide on this picture +To download a pull request (or a "PR"), you need to: +1. Make sure you are signed in with a GitHub account. +2. Click the pull request link that was sent to you (e.g. https://github.com/GeyserMC/Geyser/pull/699). +3. Follow the guide on this picture below. \ No newline at end of file diff --git a/src/main/resources/tags/info/account.tag b/src/main/resources/tags/info/account.tag deleted file mode 100644 index 69fb54ee..00000000 --- a/src/main/resources/tags/info/account.tag +++ /dev/null @@ -1,5 +0,0 @@ -type: text - ---- - -You don't always need a paid Java Edition account to use Geyser. If the server owner has the Floodgate and Geyser plugins installed, you can join directly with only your Bedrock Edition account. If you're setting up Geyser yourself you can also join cracked (offline mode) servers by setting `auth-type` in config.yml to `offline`, but keep in mind that Geyser doesn't condone cracked servers. diff --git a/src/main/resources/tags/info/accountlinking.tag b/src/main/resources/tags/info/accountlinking.tag index 37fdfd7f..9f6e982c 100644 --- a/src/main/resources/tags/info/accountlinking.tag +++ b/src/main/resources/tags/info/accountlinking.tag @@ -1,8 +1,10 @@ type: text -aliases: linkaccount, globallinking +aliases: linkaccount, globallinking, link, linking +title: :information_source: Account Linking +color: info --- -Information on how to use Global Linking can be found here: https://link.geysermc.org/ -Information on how to setup and use both Global Linking and Local Linking can be found here: https://wiki.geysermc.org/floodgate/linking/ -To unlink your accounts, join the Global Link Server on one of the linked accounts and use the `/unlinkaccount` command. +- Information on how to use Global Linking can be found here: https://link.geysermc.org/ +- Information on how to setup and use both Global Linking and Local Linking can be found here: https://wiki.geysermc.org/floodgate/linking/ +- To unlink your accounts, join the Global Link Server on one of the linked accounts and use the `/unlink` command. \ No newline at end of file diff --git a/src/main/resources/tags/info/anticheat.tag b/src/main/resources/tags/info/anticheat.tag deleted file mode 100644 index 3bd3cad2..00000000 --- a/src/main/resources/tags/info/anticheat.tag +++ /dev/null @@ -1,6 +0,0 @@ -type: text -aliases: ban, bans, hypixel - ---- - -Geyser does not perfectly replicate a Java client; anticheat on servers **especially Hypixel** can pick up irregular behavior from Geyser and ban you. Please exercise caution when going on large servers! diff --git a/src/main/resources/tags/info/api.tag b/src/main/resources/tags/info/api.tag index 0822d635..aeb93d2d 100644 --- a/src/main/resources/tags/info/api.tag +++ b/src/main/resources/tags/info/api.tag @@ -1,11 +1,16 @@ type: text aliases: forms, bedrockforms, cumulus +title: :geyser: Geyser APIs +color: info +button: [Floodgate API](https://wiki.geysermc.org/floodgate/api/) +button: [Geyser API](https://wiki.geysermc.org/geyser/api/) +button: [Global API](https://wiki.geysermc.org/geyser/global-api/) +button: [Cumulus API](https://wiki.geysermc.org/geyser/forms/) --- -There are multiple APIs available for different purposes. - -- The [Floodgate API](https://wiki.geysermc.org/floodgate/api/) allows plugins and mods to check for Bedrock players, or to get important information about them. -- The [Geyser API](https://wiki.geysermc.org/geyser/api/) can be used to interact with Geyser itself - for example, by registering custom items or blocks, and listening to events. -- You can use the [Global API](https://wiki.geysermc.org/geyser/global-api/) to get specific details about Bedrock players, such as linking status or converted Bedrock skins. -- Bedrock Edition features built-in GUIs. See the [Cumulus API](https://wiki.geysermc.org/geyser/forms/) for more information on how to create and send those. \ No newline at end of file +There are multiple APIs available for different purposes: +- The Floodgate API allows plugins and mods to check for Bedrock players, or to get important information about them. +- The Geyser API can be used to interact with Geyser itself - for example, by registering custom items or blocks, and listening to events. +- You can use the Global API to get specific details about Bedrock players, such as linking status or converted Bedrock skins. +- Bedrock Edition features built-in GUIs. See the Cumulus API for more information on how to create and send those. \ No newline at end of file diff --git a/src/main/resources/tags/info/bedrockplayermanagement.tag b/src/main/resources/tags/info/bedrockplayermanagement.tag index f0cad61b..4de91cec 100644 --- a/src/main/resources/tags/info/bedrockplayermanagement.tag +++ b/src/main/resources/tags/info/bedrockplayermanagement.tag @@ -1,8 +1,11 @@ type: text aliases: anticheat-bypass, bedrock-player-management, bedrockplayermanager +title: :busts_in_silhouette: Bedrock Player Management +color: info +button: [Bedrock Player Management Plugin](https://www.spigotmc.org/resources/bedrock-player-managment-for-floodgate-geyser.82278/) --- -You can allow Bedrock players to bypass the anticheat or run commands on player join for your server with this plugin: https://www.spigotmc.org/resources/bedrock-player-managment-for-floodgate-geyser.82278/ -For anticheat you can set it up to exempt them either from all checks or the ones that cause problems on join. -Note that this plugin is unofficial and not related to GeyserMC. +You can allow Bedrock players to bypass the anticheat or run commands on player join for your server with the Bedrock Player Management plugin. +- This plugin is unofficial and not related to GeyserMC. +- For anticheat, you can set it up to exempt them either from all checks or the ones that cause problems on join. \ No newline at end of file diff --git a/src/main/resources/tags/info/bstats.tag b/src/main/resources/tags/info/bstats.tag deleted file mode 100644 index 947ed319..00000000 --- a/src/main/resources/tags/info/bstats.tag +++ /dev/null @@ -1,6 +0,0 @@ -type: text -aliases: stats, statistics - ---- - -You can check our bStats page [here](https://bstats.org/plugin/server-implementation/GeyserMC/5273) diff --git a/src/main/resources/tags/info/bukkit.tag b/src/main/resources/tags/info/bukkit.tag deleted file mode 100644 index 0f5f512a..00000000 --- a/src/main/resources/tags/info/bukkit.tag +++ /dev/null @@ -1,7 +0,0 @@ -type: text - ---- - -CraftBukkit and Bukkit were discontinued ages ago, and is only maintained as a base for Spigot. You should use Spigot or Paper (we recommend Paper). You can download it from the below link. -https://papermc.io/ -They both run all of your Bukkit plugins and worlds, so you just have to replace the Bukkit jar with a Paper one. diff --git a/src/main/resources/tags/info/bungee.tag b/src/main/resources/tags/info/bungee.tag deleted file mode 100644 index 57431729..00000000 --- a/src/main/resources/tags/info/bungee.tag +++ /dev/null @@ -1,12 +0,0 @@ -type: text -aliases: bungeecord, velocity, proxies - ---- - -The Geyser and Floodgate BungeeCord/Velocity plugins only need to be installed on the BungeeCord/Velocity proxy unless you intend to use the Floodgate API. That way, you need Floodgate on the "backend" servers too. -Installing Floodgate on the backend servers also makes it so that Bedrock players don't have to switch backend servers for their skins to start displaying. - -To properly set up Floodgate on the proxy <-> Floodgate on the backend connection, follow the guide linked below. Do note that enabling "send-floodgate-data" in the Floodgate config requires having Floodgate on ALL backend servers. -https://wiki.geysermc.org/floodgate/setup/#installing-floodgate-also-on-spigot-servers-behind-bungeecord-or-velocity - -Run `!!api` in <#613194762249437245> for more information regarding the Floodgate API. diff --git a/src/main/resources/tags/info/comingsoon.tag b/src/main/resources/tags/info/comingsoon.tag deleted file mode 100644 index 2494535e..00000000 --- a/src/main/resources/tags/info/comingsoon.tag +++ /dev/null @@ -1,5 +0,0 @@ -type: text - ---- - -Sometimes in Bedrock Edition, featured servers won't come up and will say `Coming Soon`. To fix that, go to your Bedrock Settings, then to Settings Global Resources, click get more packs and then close the menu after it loads. diff --git a/src/main/resources/tags/info/create.tag b/src/main/resources/tags/info/create.tag deleted file mode 100644 index 8b740c50..00000000 --- a/src/main/resources/tags/info/create.tag +++ /dev/null @@ -1,5 +0,0 @@ -type: text - ---- - -If you wish to create a tag for the bot, please submit a PR to https://github.com/GeyserMC/GeyserDiscordBot and follow the format outlined https://github.com/GeyserMC/GeyserDiscordBot/blob/master/tags/README.md. diff --git a/src/main/resources/tags/info/developerguide.tag b/src/main/resources/tags/info/developerguide.tag index 3f25af2e..936a2d01 100644 --- a/src/main/resources/tags/info/developerguide.tag +++ b/src/main/resources/tags/info/developerguide.tag @@ -1,11 +1,12 @@ type: text aliases: learnjava, contribute, contributing +title: :geyser: Contributing To Geyser +color: info +button: [GeyserMC Developer Guide](https://wiki.geysermc.org/other/developer-guide/) +button: [Oracle Java Tutorial](https://docs.oracle.com/javase/tutorial/) +button: [Codecademy Java Course](https://www.codecademy.com/learn/learn-java) +button: [MOOC.fi Programming Part 1](http://mooc.fi/courses/2013/programming-part-1/) --- -You want to contribute to Geyser? [Here](https://wiki.geysermc.org/other/developer-guide/) you can find some useful things to start contributing to Geyser and links to some of the tools we use. - -And here are some useful Java guides: - - https://docs.oracle.com/javase/tutorial/ - - https://www.codecademy.com/learn/learn-java - - http://mooc.fi/courses/2013/programming-part-1/ +You want to contribute to Geyser? The GeyserMC Developer Guide has useful things and links to get you started with contributing to Geyser! Need to learn Java? We have links for that too! \ No newline at end of file diff --git a/src/main/resources/tags/info/extensions.tag b/src/main/resources/tags/info/extensions.tag index 40f8214d..a1392dcb 100644 --- a/src/main/resources/tags/info/extensions.tag +++ b/src/main/resources/tags/info/extensions.tag @@ -1,10 +1,14 @@ type: text aliases: extension, geyserextension, ext +title: :geyser: Geyser Extensions +color: info +button: [Modrinth](https://modrinth.com/discover/plugins) --- Geyser Extensions are similar to plugins, but specifically for Geyser, regardless of where Geyser runs on. -**Installing extensions**: -- Put the .jar file in Geyser`s 'extensions' folder -- Restart the server. +To install Geyser Extensions: +1. Go to the Modrinth page linked below, then set **"Geyser Extension"** as your platform and download an extension. +2. Put the Geyser Extension .jar file in Geyser's `extensions` folder. +3. Restart the server. diff --git a/src/main/resources/tags/info/floodgate.tag b/src/main/resources/tags/info/floodgate.tag new file mode 100644 index 00000000..fa252f91 --- /dev/null +++ b/src/main/resources/tags/info/floodgate.tag @@ -0,0 +1,10 @@ +type: text +aliases: floodgate, openthefloodgates +help: floodgate +color: info +title: :ocean: Floodgate +button: [Floodgate Setup Guide](https://wiki.geysermc.org/floodgate/setup/) + +--- + +Floodgate is a hybrid mode plugin/mod that allows Minecraft: Bedrock Accounts to join Minecraft: Java Edition servers without needing a Minecraft: Java Edition account. You can find the setup guide for Floodgate below. yeet \ No newline at end of file diff --git a/src/main/resources/tags/info/floodgateskins.tag b/src/main/resources/tags/info/floodgateskins.tag index 0e8f3dc1..b7ad851a 100644 --- a/src/main/resources/tags/info/floodgateskins.tag +++ b/src/main/resources/tags/info/floodgateskins.tag @@ -1,9 +1,12 @@ type: text aliases: skin, skins +title: :ocean: Bedrock Skins With Floodgate +color: info --- -Skins of Bedrock player should be visible to Java players on servers with [Floodgate](https://wiki.geysermc.org/floodgate/) installed. -If they aren't, it's possible that the skin the player is using isn't supported (Such as Persona Skins with drastically different 3D models), or that the queue for skin uploading has grown too large (and you must simply wait). - -If you are using BungeeCord/Velocity: Installing Floodgate on the backend servers also makes it so that Bedrock player's don't have to switch backend servers for their skins to start displaying. +Skins of Bedrock players should be visible to Java players on servers with [Floodgate](https://wiki.geysermc.org/floodgate/) installed. If they aren't visible, it's cause of one of four reasons: +1. The skin the player is using isn't supported (Such as Persona Skins with drastically different 3D models) +2. The queue for skin uploading has grown too large (and you must simply wait). +3. If you are using BungeeCord/Velocity, you need to install Floodgate on the backend servers to make it so that Bedrock player's don't have to switch backend servers for their skins to start displaying. +4. Your Geyser server is using offline mode which makes skins not load properly. \ No newline at end of file diff --git a/src/main/resources/tags/info/geyserconnect.tag b/src/main/resources/tags/info/geyserconnect.tag index 529eccf7..6d833b24 100644 --- a/src/main/resources/tags/info/geyserconnect.tag +++ b/src/main/resources/tags/info/geyserconnect.tag @@ -1,18 +1,22 @@ type: text aliases: gc +title: :geyser: GeyserConnect +color: info +button: [GeyserConnect GitHub](https://github.com/GeyserMC/GeyserConnect) +button: [Public GeyserConnect Website](https://www.geyserconnect.net) +button: [Public GeyserConnect Discord Server](https://discord.com/invite/3r7T9fXzDE) --- -There is an **Unofficial** public [GeyserConnect](https://github.com/GeyserMC/GeyserConnect) instance running. You can connect to it via -*Addresses:* -United States: `us.geyserconnect.net` -Port: `19132` +GeyserConnect allows you to connect to most Java servers from Bedrock without having to install anything on the server. -More information is available on their [website](https://www.geyserconnect.net) -[Xbox Users](https://www.geyserconnect.net/guide/xbox) -[Switch Users](https://www.geyserconnect.net/guide/switch) -[PlayStation Users](https://www.geyserconnect.net/guide/playstation) +There is an **unofficial** public [GeyserConnect](https://github.com/GeyserMC/GeyserConnect) instance running. You can connect to it using the IP address `us.geyserconnect.net` and the port `19132`. -You can also join the [Discord](https://discord.com/invite/3r7T9fXzDE) +More information is available on their website, and you can also join the Discord server with the link below. -**Warning:** Due to Geyser handling certain things different to a vanilla Java client you may get banned using this (see `!tag anticheat` for more info). As well as this, if you use online mode you are sending your Java account credentials to a third party. +Setup Guides for public GeyserConnect: +- [Xbox Users](https://www.geyserconnect.net/guide/xbox) +- [Switch Users](https://www.geyserconnect.net/guide/switch) +- [PlayStation Users](https://www.geyserconnect.net/guide/playstation) + +:warning:**Warning:** Due to Geyser handling certain things different to a vanilla Java client you may get banned using this. Run `!!anticheat` for more info. As well as this, if you use online mode, you are sending your Java account credentials to a third party. \ No newline at end of file diff --git a/src/main/resources/tags/info/mechanics.tag b/src/main/resources/tags/info/mechanics.tag index 2d7b0e7e..8739d0f3 100644 --- a/src/main/resources/tags/info/mechanics.tag +++ b/src/main/resources/tags/info/mechanics.tag @@ -1,7 +1,10 @@ type: text aliases: javamechanics, pvp, redstone +title: :geyser: Game Mechanics When On A Geyser Server +color: info --- -When a Bedrock player joins a server that is using Geyser, all mechanics are like Java for Bedrock players, as they are on a Java server. -The axes will do Java amounts of damage, doing damage has a cooldown, and redstone is like Java as well. +When a Bedrock player joins a server that is using Geyser: +- All mechanics are like Java for Bedrock players, as they are on a Java server. +- The axes will do Java amounts of damage, doing damage has a cooldown, and redstone is like Java as well. \ No newline at end of file diff --git a/src/main/resources/tags/info/mods.tag b/src/main/resources/tags/info/mods.tag index 24d8da6b..82b15141 100644 --- a/src/main/resources/tags/info/mods.tag +++ b/src/main/resources/tags/info/mods.tag @@ -1,5 +1,12 @@ type: text +title: :geyser: Mod Compatibility With Geyser +color: info +button: [Modrinth](https://modrinth.com/discover/mods) --- -Geyser emulates a vanilla Java Edition game client. If the mods installed on the server allow a full vanilla client to connect, then a Geyser player can. (Conversely, if a player must install mods, a Geyser player can not join.) +**Geyser only works with server-sided mods by default**, meaning mods that allow a vanilla client to join. On Modrinth (link below), you can filter by **server** to only show server-sided mods. Hydraulic which is a companion mod to Geyser can allow Bedrock players to join modded Minecraft: Java Edition servers and use client-sided mods. + +**Polymer-based mods are an exception.** Although server-sided, some work, partially don't work, or just don't work at all. You can try checking if Geyser/Bedrock support is listed on the mod page. If not, your best option is to try it and see. + +Mods labelled as **Client or server** will partially or not affect bedrock players at all. Keep in mind the limitations of Geyser which can cause issues with some functionality. Run `!!limitations` for more information. \ No newline at end of file diff --git a/src/main/resources/tags/info/olderversions.tag b/src/main/resources/tags/info/olderversions.tag index c7aed891..63eaf6ca 100644 --- a/src/main/resources/tags/info/olderversions.tag +++ b/src/main/resources/tags/info/olderversions.tag @@ -1,9 +1,19 @@ type: text aliases: oldversion, oldversions, olderversion, 1.8 help: 1.8 +title: :geyser: Using Old Versions Of Minecraft With Geyser +color: info +button: [Which version of Minecraft should your server use?](https://madelinemiller.dev/blog/which-minecraft-version/) +button: [ViaVersion](https://ci.viaversion.com/job/ViaVersion/) +button: [ViaProxy](https://github.com/ViaVersion/ViaProxy). --- -Geyser currently only officially supports servers running on 1.16.5 or higher. If the server is below the latest version of the game then ViaVersion must also be installed. +Geyser officially supports **1.16.5+** servers. -You can still join servers below 1.16.5 if you run Geyser on a proxy such as Velocity or as the Standalone platform, but keep in mind that you likely won't get support on these versions irregardless of how you're running it. Versions like 1.8 are over a decade old, and we highly recommend updating to a later version of the game. Read [this](https://madelinemiller.dev/blog/which-minecraft-version/) post for more information regarding which version is best for you. +For versions below 1.16.5, either: +- Install ViaVersion on the server and run Geyser on a proxy like Velocity. +- Use Geyser-Standalone. +- Run Geyser through ViaProxy. + +⚠️ Versions below 1.16.5 (e.g. 1.8) are outdated and not guaranteed to work. And you likely won't get support on these versions. We strongly recommend updating. See the blog post below for help choosing a version. \ No newline at end of file diff --git a/src/main/resources/tags/info/outdatedjava.tag b/src/main/resources/tags/info/outdatedjava.tag deleted file mode 100644 index 3cd5dd5a..00000000 --- a/src/main/resources/tags/info/outdatedjava.tag +++ /dev/null @@ -1,11 +0,0 @@ -type: text -aliases: j17, java17, latestjava, unsupportedclassversion, updatejava, openjdk, javadownload -issues: java.lang.UnsupportedClassVersionError - ---- - -Geyser currently requires Java 17 or later to run. You can download Java 17 at https://adoptium.net/temurin/releases/ -To find out how to change your Java version on hosts or other platforms, look at https://docs.papermc.io/java-install-update - -If you’re running a version of Paper that does not support Java 17 or later, you can add the flag `-DPaper.IgnoreJavaVersion=true` to your startup Java arguments to allow Paper to run on Java 17. -You can run Geyser standalone on another device if a server software cannot be updated to use Java 17. diff --git a/src/main/resources/tags/info/outdatedprogram.tag b/src/main/resources/tags/info/outdatedprogram.tag new file mode 100644 index 00000000..b8c3bd99 --- /dev/null +++ b/src/main/resources/tags/info/outdatedprogram.tag @@ -0,0 +1,7 @@ +type: text +title: :video_game: Outdated Third-Party Program +color: info + +--- + +You are currently using an outdated version of a third‑party program, such as BedrockConnect or BedrockTogether, to join Geyser servers on consoles. Please update to the latest version! \ No newline at end of file diff --git a/src/main/resources/tags/info/ovh.tag b/src/main/resources/tags/info/ovh.tag index 2dcb68b3..59c48f96 100644 --- a/src/main/resources/tags/info/ovh.tag +++ b/src/main/resources/tags/info/ovh.tag @@ -1,9 +1,9 @@ type: text aliases: oci, oracle +title: :information_source: Specific Firewall Instructions for OVH, SoYouStart and Oracle Cloud (OCI) +color: info +button: [Wiki Page](https://wiki.geysermc.org/geyser/port-forwarding/#ovh-and-soyoustart) --- -Some hosting providers, such as OVH, SoYouStart and Oracle Cloud (OCI) have firewall setups that block UDP traffic by default. - -For example, OVH's firewall requires an initial TCP ping before allowing UDP traffic, which prohibits clients from joining. -See [here](https://wiki.geysermc.org/geyser/port-forwarding/#ovh-and-soyoustart) for info on how to resolve these issues. +Some hosting providers, such as OVH, SoYouStart and Oracle Cloud (OCI) have firewall setups that block UDP traffic by default. For example, OVH's firewall requires an initial TCP ping before allowing UDP traffic, which prohibits clients from joining. See the wiki page below for info on how to resolve these issues. \ No newline at end of file diff --git a/src/main/resources/tags/info/paper.tag b/src/main/resources/tags/info/paper.tag index 8688c881..f874b838 100644 --- a/src/main/resources/tags/info/paper.tag +++ b/src/main/resources/tags/info/paper.tag @@ -1,6 +1,8 @@ type: text +title: :information_source: PaperMC +color: info +button: [Download PaperMC](https://papermc.io/downloads/paper/) --- -PaperMC is a highly optimised Minecraft server software. It was forked from Spigot, so it will run all of your plugins. Additionally, you can download it without having to run BuildTools. The download link is below. -https://papermc.io/ +PaperMC is a highly optimised Minecraft server software. It was forked from Spigot, so it will run all of your plugins. Additionally, you can download it using the link below without having to run BuildTools. \ No newline at end of file diff --git a/src/main/resources/tags/info/piracy.tag b/src/main/resources/tags/info/piracy.tag deleted file mode 100644 index b96895e3..00000000 --- a/src/main/resources/tags/info/piracy.tag +++ /dev/null @@ -1,11 +0,0 @@ -type: text -aliases: offline, offlinemode, cracked - ---- - -Cracked servers are not supported here and by setting your server as so, __***you will not receive support here any further.***__ -"Cracked" or "offline mode" servers basically disable any sort of Mojang authentication and allow people with non-genuine versions of the game to join. Unless the server is behind an online mode BungeeCord instance, **This is software piracy and is illegal!**. By setting your server as so, you are condoning the use of piracy. - -If you are simply just wanting Bedrock players to be able to join your Java server without a Java account, we recommend using our plugin [Floodgate](https://wiki.geysermc.org/floodgate/) which allows them to join the server with it being in online mode. If you did not mean to set your server to offline mode or don't understand what it means, please read the above and set your server to online mode. - -If you are intending to allow non-genuine Minecraft accounts on your server and are aware that you're supporting software piracy, you are on your own in terms of Geyser support. Please seek support elsewhere. diff --git a/src/main/resources/tags/info/playit.tag b/src/main/resources/tags/info/playit.tag index 3162af0f..fc7b0ccb 100644 --- a/src/main/resources/tags/info/playit.tag +++ b/src/main/resources/tags/info/playit.tag @@ -1,9 +1,9 @@ type: text -aliases: playit.gg +aliases: playit.gg, playitgg +color: info +title: :geyser: playit.gg Setup Guide For Geyser +button: [playit.gg Setup Guide](https://geysermc.org/wiki/geyser/playit-gg/) --- -playit.gg is a simple tunneling service that lets Minecraft servers using the GeyserMC plugin securely expose local or private servers to the internet without forwarding ports. - -Please follow the tutorial below to set up playit.gg: -https://geysermc.org/wiki/geyser/playit-gg/ +playit.gg is a simple tunneling service that lets Minecraft servers using the GeyserMC plugin securely expose local or private servers to the internet without forwarding ports. Please follow the guide linked below to set up playit.gg for Geyser. \ No newline at end of file diff --git a/src/main/resources/tags/info/prefix.tag b/src/main/resources/tags/info/prefix.tag index 22f4843a..7d390edd 100644 --- a/src/main/resources/tags/info/prefix.tag +++ b/src/main/resources/tags/info/prefix.tag @@ -1,12 +1,9 @@ type: text +title: :ocean: Floodgate Prefix +color: info --- -The prefix is added by Floodgate to indicate that the player is Bedrock; and more importantly, to minimize the possibility of player name conflict issues. +We strongly recommend that you **do not remove** the prefix, but instead change it. **Without a prefix, things could break, usernames would cause conflicts in commands and the users could lose their data!** -We strongly recommend that you **do not remove** the prefix, but instead change it. **Should a Java player and a Bedrock player with the exact same name join your server at the same time, things could break and the users could lose their data!** - -You can change the prefix (`.`) in players' names by editing the option in Floodgate's config.yml file. Characters that a Java player cannot normally choose to be part of their names are recommended. -Our recommend prefixes are: `.` `+` and `-`. - -**Using "*" as a prefix while on Windows will cause issues**, as some plugins store player data by username - Windows does not allow files to start with "*". +You can change the prefix in players' names by editing the option in Floodgate's config.yml file. We recommend characters that a Java player cannot normally use to avoid conflicts. Our recommended prefixes are: `.` (default), `+`, and `-`. **Using `*` as a prefix while on Windows will cause issues with some plugins.** \ No newline at end of file diff --git a/src/main/resources/tags/info/proxies.tag b/src/main/resources/tags/info/proxies.tag new file mode 100644 index 00000000..3a3c651e --- /dev/null +++ b/src/main/resources/tags/info/proxies.tag @@ -0,0 +1,11 @@ +type: text +aliases: bungeecord, bungee, velocity, proxy +title: :geyser: Proxy Setups +color: info +button: [Floodgate Proxy Setup Guide](https://geysermc.org/wiki/floodgate/setup/?platform=proxy-servers) + +--- + +**Install Geyser and Floodgate on BungeeCord/Velocity only.** You will only need Floodgate on backend servers for one of two reasons: +1. You want to use the Floodgate API. Run `!!api` in <#613194762249437245> for more information regarding the Floodgate API. +2. You want Bedrock players to not have to switch backend servers for their skins to start displaying. \ No newline at end of file diff --git a/src/main/resources/tags/info/reload.tag b/src/main/resources/tags/info/reload.tag deleted file mode 100644 index cc2ab77e..00000000 --- a/src/main/resources/tags/info/reload.tag +++ /dev/null @@ -1,7 +0,0 @@ -type: text -aliases: reloading -help: reload - ---- - -Doing `/reload` on a server can and most likely will cause issues; please do a full restart after installing, updating or altering the config. See https://madelinemiller.dev/blog/problem-with-reload/ for more info. diff --git a/src/main/resources/tags/info/resourcepacks.tag b/src/main/resources/tags/info/resourcepacks.tag index f9bf23c0..774bbe37 100644 --- a/src/main/resources/tags/info/resourcepacks.tag +++ b/src/main/resources/tags/info/resourcepacks.tag @@ -1,6 +1,11 @@ type: text aliases: packs, texturepacks, resourcepack, resourcepacks, rp, texturepack +title: :package: Adding Resource Packs To Geyser +color: info --- -To add a Bedrock resource pack to your server, take a .zip or .mcpack file and put it in Geyser's `packs` folder. The resource pack needs to be a Bedrock resource pack, and if you only have it in Java format, you can do `!!rpconvert` in <#613194762249437245> for a link to convert Java resource packs to Bedrock ones. +To add a Bedrock resource pack to your server, take a .zip or .mcpack file and put it in Geyser's `packs` folder. +- If it also contains a custom_mappings.json file, put it in Geyser's `custom_mappings` folder. +- The resource pack needs to be a Bedrock resource pack. +- If you only have it in Java format, run `!!rpconvert` in <#613194762249437245> for information about converting Java resource packs to Bedrock ones. \ No newline at end of file diff --git a/src/main/resources/tags/info/spigotmovementfix.tag b/src/main/resources/tags/info/spigotmovementfix.tag index b69c905b..0993b651 100644 --- a/src/main/resources/tags/info/spigotmovementfix.tag +++ b/src/main/resources/tags/info/spigotmovementfix.tag @@ -1,5 +1,7 @@ type: text +title: :information_source: Spigot Movement Fix +color: info --- -If you own the server, you can set `moved-wrongly-threshold` in your `spigot.yml` to the value 1.0075 to partially fix Bedrock movement at the expense of making it slightly easier to movement hack. +If you own the server, you can set `moved-wrongly-threshold` in your `spigot.yml` to the value `1.0075` to partially fix Bedrock movement at the expense of making it slightly easier to movement hack. \ No newline at end of file diff --git a/src/main/resources/tags/info/testserver.tag b/src/main/resources/tags/info/testserver.tag index 45ca29bb..de791021 100644 --- a/src/main/resources/tags/info/testserver.tag +++ b/src/main/resources/tags/info/testserver.tag @@ -1,5 +1,8 @@ type: text +title: :geyser: GeyserMC Test Server +color: info +button: [Wiki Page](https://wiki.geysermc.org/other/test-server/) --- -Geyser has a test server available; you can find more info at https://wiki.geysermc.org/other/test-server/ +GeyserMC provides a test server for Geyser. More information can be found in the wiki page linked below. \ No newline at end of file diff --git a/src/main/resources/tags/info/thirdpartyextensions.tag b/src/main/resources/tags/info/thirdpartyextensions.tag new file mode 100644 index 00000000..fac2d7fd --- /dev/null +++ b/src/main/resources/tags/info/thirdpartyextensions.tag @@ -0,0 +1,9 @@ +type: text +aliases: geyserextras, geyserutils, geysermodelengine, geysermeg +title: :information_source: Third-Party Extensions And Plugins Or Mods +color: info + +--- + +Third-party extensions, plugins, or mods like GeyserUtils, GeyserExtras, and GeyserModelEngine are not affiliated with GeyserMC! +- If you are experiencing issues with third-party Geyser-related extensions, plugins, or mods, please try updating them or contacting the developers behind it. \ No newline at end of file diff --git a/src/main/resources/tags/info/update.tag b/src/main/resources/tags/info/update.tag index 4ab468b8..03c393b1 100644 --- a/src/main/resources/tags/info/update.tag +++ b/src/main/resources/tags/info/update.tag @@ -1,10 +1,16 @@ type: text -aliases: updategeyser +aliases: updategeyser, updatefloodgate help: update || updating +title: :geyser: Updating Geyser Or Floodgate +color: info +button: [GeyserUpdater](https://www.spigotmc.org/resources/geyserupdater.88555/) --- +**You do not need to remove or modify your config when updating Geyser or Floodgate.** -To update Geyser or Floodgate, shut down your server, run `!download geyser` or `!download floodgate` in <#613194762249437245>, and replace your current jar file with the new version from the link. -You do not need to remove or modify your config when updating Geyser or Floodgate. +To update Geyser or Floodgate: +1. Shut down your Geyser server +2. Run `!download geyser` or `!download floodgate` in <#613194762249437245>. +3. Replace your current jar file with the new version from the link. -To automatically keep Geyser updated, you can use a third-party plugin, such as [GeyserUpdater](https://github.com/kejonaMC/GeyserUpdater). \ No newline at end of file +To automatically keep Geyser updated, you can use a third-party plugin, such as GeyserUpdater. \ No newline at end of file diff --git a/src/main/resources/tags/links/bedrocklinux.tag b/src/main/resources/tags/links/bedrocklinux.tag index 849bb1e0..9623f56a 100644 --- a/src/main/resources/tags/links/bedrocklinux.tag +++ b/src/main/resources/tags/links/bedrocklinux.tag @@ -1,6 +1,10 @@ type: text +title: :penguin: Minecraft: Bedrock Edition On Linux +color: links +button: [Unofficial Minecraft Bedrock Launcher](https://flathub.org/apps/io.mrarm.mcpelauncher) --- -If you wish to run Minecraft: Bedrock Edition on Linux please see the below 'Getting Started' guide. -https://mcpelauncher.readthedocs.io/en/latest/getting_started.html +:warning: **You must own Minecraft on the Google Play Store to use this launcher.** + +If you wish to run Minecraft: Bedrock Edition on Linux, you can download the unofficial Minecraft Bedrock Launcher on Linux linked below. \ No newline at end of file diff --git a/src/main/resources/tags/links/bstats.tag b/src/main/resources/tags/links/bstats.tag new file mode 100644 index 00000000..ed9084a6 --- /dev/null +++ b/src/main/resources/tags/links/bstats.tag @@ -0,0 +1,9 @@ +type: text +aliases: stats, statistics +title: :bar_chart: Geyser bStats Page +color: links +button: [bStats Page](https://bstats.org/plugin/server-implementation/GeyserMC/5273) + +--- + +Geyser has a bStats page which you can check out using link below. \ No newline at end of file diff --git a/src/main/resources/tags/links/common-issues.tag b/src/main/resources/tags/links/common-issues.tag index 30b8578c..f23ad8f3 100644 --- a/src/main/resources/tags/links/common-issues.tag +++ b/src/main/resources/tags/links/common-issues.tag @@ -1,6 +1,9 @@ type: text aliases: commonissues +title: :geyser: Common Issues With Geyser +color: links +button: [Wiki Page](https://wiki.geysermc.org/geyser/common-issues/) --- -This link contains fixes for a lot of the issues you may come across using Geyser. https://wiki.geysermc.org/geyser/common-issues/ +The common issues wiki page contains fixes for a lot of the issues you may come across while using Geyser. \ No newline at end of file diff --git a/src/main/resources/tags/links/config.tag b/src/main/resources/tags/links/config.tag deleted file mode 100644 index bc2e1cba..00000000 --- a/src/main/resources/tags/links/config.tag +++ /dev/null @@ -1,5 +0,0 @@ -type: text - ---- - -This link contains information on what each option in Geyser's `config.yml` file does. https://wiki.geysermc.org/geyser/understanding-the-config/ diff --git a/src/main/resources/tags/links/configeditor.tag b/src/main/resources/tags/links/configeditor.tag deleted file mode 100644 index 33846d21..00000000 --- a/src/main/resources/tags/links/configeditor.tag +++ /dev/null @@ -1,8 +0,0 @@ -type: text - ---- - -Below you can find a simple browser based config editor for Geyser. -https://geysermc.org/utilities/config-editor - -Do note: Uploading your old config will not update it. If you wish to create a new, updated config, start with the default config and then add your settings. diff --git a/src/main/resources/tags/links/consoles.tag b/src/main/resources/tags/links/consoles.tag index 45f145ee..90468b3c 100644 --- a/src/main/resources/tags/links/consoles.tag +++ b/src/main/resources/tags/links/consoles.tag @@ -1,7 +1,9 @@ type: text aliases: bedrockconnect, ps4, ps5, xbox, switch +color: links +title: :video_game: Connecting Consoles To Geyser +button: [Wiki Page](https://wiki.geysermc.org/geyser/using-geyser-with-consoles/) --- -See this wiki page to learn how to connect your console or mobile device to a Geyser server. -https://wiki.geysermc.org/geyser/using-geyser-with-consoles/ +Use wiki page link below to learn how to connect your console to a Geyser server. \ No newline at end of file diff --git a/src/main/resources/tags/links/currentlimitations.tag b/src/main/resources/tags/links/currentlimitations.tag deleted file mode 100644 index cd4b75f0..00000000 --- a/src/main/resources/tags/links/currentlimitations.tag +++ /dev/null @@ -1,7 +0,0 @@ -type: text -aliases: limitations - ---- - -A list of limitations in Geyser that cannot be fixed without changes to Bedrock Edition or Java Edition can be found here: https://wiki.geysermc.org/geyser/current-limitations/ -Limitations that can be fixed or improved by Geyser in the future can be found here: https://github.com/GeyserMC/Geyser#whats-left-to-be-addedfixed diff --git a/src/main/resources/tags/links/custom.tag b/src/main/resources/tags/links/custom.tag index 1e7a512c..bd79604c 100644 --- a/src/main/resources/tags/links/custom.tag +++ b/src/main/resources/tags/links/custom.tag @@ -1,18 +1,19 @@ type: text aliases: customblocks, customitems, skulls +color: links +title: :geyser: Custom Items, Blocks, And Player Heads +button: [Custom Items](https://wiki.geysermc.org/geyser/custom-items/) +button: [Custom Blocks](https://wiki.geysermc.org/geyser/custom-blocks/) +button: [Custom Player Heads](https://wiki.geysermc.org/geyser/custom-skulls/) --- -Geyser has support for custom items and custom blocks! Player heads can also be registered to show up in the Bedrock player inventory. - -For information on custom items, see [here](https://wiki.geysermc.org/geyser/custom-items/). -For custom blocks, see [here](https://wiki.geysermc.org/geyser/custom-blocks/). -For player heads, see [here](https://wiki.geysermc.org/geyser/custom-skulls/). +Geyser has support for custom items and custom blocks! Player heads can also be registered to show up in the Bedrock player inventory. For information on custom items, blocks, and player heads, use the links below. Some conversions must be done manually. For example: - [Converting glyphs or rank icons](https://wiki.bedrock.dev/concepts/emojis.html) -- [Custom sounds](https://wiki.bedrock.dev/concepts/sounds.html). Do note: Custom sounds should be registered under a custom namespace! +- [Custom sounds](https://wiki.bedrock.dev/concepts/sounds.html). Note: Custom sounds should be registered under a custom namespace! - [Armor textures](https://wiki.bedrock.dev/items/custom-armor.html). - JSON UI can be used to create inventory menus, change scoreboard titles, and overall beautify your Minecraft Bedrock UI experience. See [JSON UI](https://wiki.bedrock.dev/json-ui/json-ui-intro.html) for more information. -For help with Bedrock edition resource packs, <#1139296287179677857> features useful information in the pinned messages. +For help with Minecraft: Bedrock Edition resource packs, <#1139296287179677857> features useful information in the pinned messages. \ No newline at end of file diff --git a/src/main/resources/tags/links/donate.tag b/src/main/resources/tags/links/donate.tag index 7bb0b7af..33b0e7f4 100644 --- a/src/main/resources/tags/links/donate.tag +++ b/src/main/resources/tags/links/donate.tag @@ -1,9 +1,11 @@ type: text aliases: donating, howtodonate +title: :money_with_wings: How To Donate To GeyserMC +color: links +button: [GeyserMC Open Collective](https://opencollective.com/geysermc) --- -If you want to donate money to Geyser, you can do it through our Open Collective page here: https://opencollective.com/geysermc. -If you have donated please contact a member of the team with proof of donation and we will assign you the <@&613278600929476608> role. - -Please don’t donate specifically to request a specific feature. If you would like a feature to be implemented, create an issue on the GitHub repo and fill out the correct template! +If you want to donate money to GeyserMC, you can do it through our Open Collective page linked below. +- If you have donated, please contact a member of the team with proof of donation and we will assign you the <@&613278600929476608> role. +- Please don’t donate specifically to request a specific feature. If you would like a feature to be implemented, create an issue on the GitHub repo and fill out the correct template! \ No newline at end of file diff --git a/src/main/resources/tags/links/faq.tag b/src/main/resources/tags/links/faq.tag index a987a34b..25510fba 100644 --- a/src/main/resources/tags/links/faq.tag +++ b/src/main/resources/tags/links/faq.tag @@ -1,6 +1,8 @@ type: text +title: :question: Frequently Asked Questions +color: links +button: [FAQ Wiki Page](https://wiki.geysermc.org/geyser/faq/) --- -This link contains some frequently asked questions and answers to them. -https://wiki.geysermc.org/geyser/faq/ +The wiki page below contains some frequently asked questions and answers to them. \ No newline at end of file diff --git a/src/main/resources/tags/links/feature.tag b/src/main/resources/tags/links/feature.tag index 176e471d..bda65ddc 100644 --- a/src/main/resources/tags/links/feature.tag +++ b/src/main/resources/tags/links/feature.tag @@ -1,5 +1,8 @@ type: text +title: :mailbox_with_mail: Geyser Feature Request +color: links +button: [Create Feature Request](https://github.com/GeyserMC/Geyser/issues/new?assignees=&labels=Feature+Request&template=feature_request.yml) --- -Request a feature here: https://github.com/GeyserMC/Geyser/issues/new?assignees=&labels=Feature+Request&template=feature_request.yml +Request a feature to be added to Geyser using the link below. \ No newline at end of file diff --git a/src/main/resources/tags/links/floodgate.tag b/src/main/resources/tags/links/floodgate.tag deleted file mode 100644 index cee29e61..00000000 --- a/src/main/resources/tags/links/floodgate.tag +++ /dev/null @@ -1,8 +0,0 @@ -type: text -aliases: floodgate, openthefloodgates -help: floodgate - ---- - -Floodgate is a hybrid mode plugin that allows Minecraft: Bedrock Accounts to join Minecraft: Java Edition servers without needing a Minecraft: Java Edition account. -You can find the setup guide [here](https://wiki.geysermc.org/floodgate/setup/). yeet diff --git a/src/main/resources/tags/links/issue.tag b/src/main/resources/tags/links/issue.tag index 2929cf9f..8a097cda 100644 --- a/src/main/resources/tags/links/issue.tag +++ b/src/main/resources/tags/links/issue.tag @@ -1,10 +1,15 @@ type: text +title: :geyser: Reporting Issues For Geyser Or Floodgate +color: links +button: [Create Geyser Issue](https://github.com/GeyserMC/Geyser/issues/new?assignees=&labels=&template=bug_report.yml) +button: [Create Floodgate Issue](https://github.com/GeyserMC/Floodgate/issues/new) --- If you're experiencing a bug in Geyser or Floodgate, the best way for us to keep track of the issue is to document it on our GitHub issue tracker. -First, search to see if the issue has already been documented. For Geyser, check [here](https://github.com/GeyserMC/Geyser/issues). For Floodgate, check [here](https://github.com/GeyserMC/Floodgate/issues). +First, search to see if the issue has already been documented. +- For Geyser, check [here](https://github.com/GeyserMC/Geyser/issues). +- For Floodgate, check [here](https://github.com/GeyserMC/Floodgate/issues). -If the issue doesn't already exist, create a new issue for Geyser [here](https://github.com/GeyserMC/Geyser/issues/new?assignees=&labels=&template=bug_report.yml) or for Floodgate [here](https://github.com/GeyserMC/Floodgate/issues/new). -**Please provide replication steps!** +If the issue doesn't already exist, create a new issue for Geyser or Floodgate using the links below. **Please provide replication steps!** \ No newline at end of file diff --git a/src/main/resources/tags/links/limitations.tag b/src/main/resources/tags/links/limitations.tag new file mode 100644 index 00000000..54d37671 --- /dev/null +++ b/src/main/resources/tags/links/limitations.tag @@ -0,0 +1,9 @@ +type: text +aliases: currentlimitations +title: :geyser: Geyser Limitations +color: links +button: [Current Limitations Wiki Page](https://wiki.geysermc.org/geyser/current-limitations/) + +--- + +A list of limitations in Geyser that cannot be fixed without changes to Bedrock Edition or Java Edition as well as some fixable limitations can be found in the wiki page linked below. \ No newline at end of file diff --git a/src/main/resources/tags/links/mcxboxbroadcast.tag b/src/main/resources/tags/links/mcxboxbroadcast.tag index 3766d6ab..380c3758 100644 --- a/src/main/resources/tags/links/mcxboxbroadcast.tag +++ b/src/main/resources/tags/links/mcxboxbroadcast.tag @@ -1,11 +1,14 @@ type: text aliases: minecraftxboxbroadcast, mcxb -button: [Support Server](https://discord.gg/Tp3tA2kdCN) -button: [Download](https://github.com/MCXboxBroadcast/Broadcaster/) +color: links +title: :link: MCXboxBroadcast +button: [Support Server](https://discord.com/invite/Tp3tA2kdCN) +button: [Download](https://modrinth.com/mod/mcxboxbroadcast) --- MCXboxBroadcast is tool for Geyser servers developed by rtm516. It allows you to join a Geyser server by following or friending someone in Minecraft then joining that user. - -It comes as a standalone application or an extension for Geyser. Support is not typically provided here; however, there exists a support server linked below. - +- It comes as a Geyser extension which you can download below. +- It also comes as a standalone application for running it separately that you can find [here](https://github.com/MCXboxBroadcast/Broadcaster). +- Support is not typically provided in the GeyserMC discord server. +- MCXboxBroadcast has a support server which is linked below. \ No newline at end of file diff --git a/src/main/resources/tags/links/placeholderapi.tag b/src/main/resources/tags/links/placeholderapi.tag index 9099f5f9..99be3ccc 100644 --- a/src/main/resources/tags/links/placeholderapi.tag +++ b/src/main/resources/tags/links/placeholderapi.tag @@ -1,7 +1,10 @@ type: text aliases: placeholder-api, papi +color: links +title: :ocean: FloodgatePlaceholders +button: [FloodgatePlaceholders](https://github.com/rtm516/FloodgatePlaceholders) --- -Geyser does not natively support Placeholder API, but you can use the following plugin: -- rtm516's FloodgatePlaceholders: https://github.com/rtm516/FloodgatePlaceholders +Geyser does not natively support Placeholder API. +- Please install rtm516's FloodgatePlaceholders with PlaceholderAPI for PlaceholderAPI support. \ No newline at end of file diff --git a/src/main/resources/tags/links/providers.tag b/src/main/resources/tags/links/providers.tag index c944551e..0f458634 100644 --- a/src/main/resources/tags/links/providers.tag +++ b/src/main/resources/tags/links/providers.tag @@ -1,6 +1,9 @@ type: text +title: :geyser: GeyserMC Hosting Providers +color: links +button: [Supported Hosting Providers Wiki Page](https://wiki.geysermc.org/geyser/supported-hosting-providers/) --- -See the list of supported providers [here](https://wiki.geysermc.org/geyser/supported-hosting-providers/). -To search for a specific provider, use `/provider `. +- To see the list of supported providers, use the wiki page link below. +- To search for a specific provider, use `/provider ` in <#613194762249437245>. \ No newline at end of file diff --git a/src/main/resources/tags/links/rpconvert.tag b/src/main/resources/tags/links/rpconvert.tag index 8d3ad13f..7c549c42 100644 --- a/src/main/resources/tags/links/rpconvert.tag +++ b/src/main/resources/tags/links/rpconvert.tag @@ -1,23 +1,26 @@ type: text +title: :arrows_counterclockwise: Converting Java Resource Packs To Bedrock +color: links +button: [Kastle's Converter](https://github.com/Kas-tle/java2bedrock.sh) +button: [JavaTextureToBedrock](https://rtm516.github.io/ConvertJavaTextureToBedrock/) +button: [Rainbow](https://geysermc.org/download?project=other-projects&rainbow=expanded) +button: [Thunder](https://geysermc.org/download?project=other-projects&thunder=expanded) --- -**Converting general resource packs** -Use this tool to convert your Java resource pack into a Bedrock resource pack to use in Geyser's `packs` folder. -https://rtm516.github.io/ConvertJavaTextureToBedrock/ -Unfortunately, this tool is not updated to support packs for versions newer than 1.17. +**Resource Packs for 1.21.3 and below:** +- For packs with CustomModelData (datapack textures, ItemsAdder, etc.), use Kastle’s Converter. +- For general Java resource packs (vanilla textures only), use JavaTextureToBedrock. Only updated up to 1.17, may still work on later versions. +- For manual conversion, see the pinned messages <#1139296287179677857>. -**Packs with CustomModelData** -To convert a resource pack with CustomModelData, use the following converter: https://github.com/Kas-tle/java2bedrock.sh -For more info on how to use it, see the pinned messages in <#1139296287179677857>. Be advised: Converting a pack to make it Bedrock compatible, especially with CustomModelData isn't always an automated process. If you need help, ask in the aforementioned channel! -Helpful links to get started with CustomModelData: -https://wiki.geysermc.org/geyser/custom-items/ -https://github.com/GeyserCustomModelData +**Resource Packs for 1.21.4 and above: ** +- For converting custom items, use Rainbow. +- For general Java resource packs (vanilla textures only), use Thunder. +- For manual conversion with API V1/V2, see the pinned messages in <#1139296287179677857>. -**Custom GUIs on Bedrock** -Custom GUIs on Bedrock need to be done using JsonUI, however, you can use this tool to upload your GUI pngs & their unicodes -and convert them into a Bedrock resource pack to use in Geyser's `packs` folder: -https://abishekbhusal.com/j2b_gui/ -If you'd like to manually convert custom GUIs using JsonUI, here are some helpful links: -https://wiki.bedrock.dev/json-ui/json-ui-documentation -https://github.com/ofunny/ofunnysBedrockExamples/tree/main/geysermc.chestBackgroundExample +**Custom GUIs on Bedrock:** +Use [this tool](https://abishekbhusal.com/j2b_gui/) to upload GUI pngs + unicodes and convert them into a Bedrock pack for Geyser. + +Alternatively, here are resources for manually converting using JSON UI: +- [Bedrock JSON UI docs](https://wiki.bedrock.dev/json-ui/json-ui-documentation) +- [ofunny's Bedrock Examples - Custom Inventory Menu](https://github.com/ofunny/ofunnysBedrockExamples/tree/main/geysermc.chestBackgroundExample) \ No newline at end of file diff --git a/src/main/resources/tags/links/setup.tag b/src/main/resources/tags/links/setup.tag index 10d0a6ae..a8c28717 100644 --- a/src/main/resources/tags/links/setup.tag +++ b/src/main/resources/tags/links/setup.tag @@ -1,7 +1,9 @@ type: text +color: links +title: :geyser: Geyser Setup Guide help: geyser +button: [Setup Guide](https://wiki.geysermc.org/geyser/setup/) --- -Please read this page on how to setup Geyser for any supported platform. -https://wiki.geysermc.org/geyser/setup/ +Please read the setup guide linked below to setup Geyser for any supported platform. \ No newline at end of file diff --git a/src/main/resources/tags/links/startup.tag b/src/main/resources/tags/links/startup.tag index 473d7fe4..a213b25a 100644 --- a/src/main/resources/tags/links/startup.tag +++ b/src/main/resources/tags/links/startup.tag @@ -1,6 +1,8 @@ type: text +title: :geyser: Geyser Standalone Startup Script +color: links +button: [Startup Script Guide](https://wiki.geysermc.org/geyser/creating-a-startup-script/) --- -If you wish to create a startup script for Geyser standalone please follow the guide for your platform at the below link. -https://wiki.geysermc.org/geyser/creating-a-startup-script/ +If you want to create a startup script for Geyser Standalone, please follow the startup script guide linked below. \ No newline at end of file diff --git a/src/main/resources/tags/links/termux.tag b/src/main/resources/tags/links/termux.tag index c8dca20a..4383adb1 100644 --- a/src/main/resources/tags/links/termux.tag +++ b/src/main/resources/tags/links/termux.tag @@ -1,8 +1,9 @@ type: text +color: links +title: :geyser: Geyser Setup Using Termux +button: [Setup Guide](https://geysermc.org/wiki/geyser/setup/?host=self&platform=standalone#running-geyser-standalone-on-android) --- -The included link contains a guide on how to set up Geyser on Android using the third-party program called Termux. -https://wiki.geysermc.org/geyser/setup/ (navigate to self-host, then Geyser-Standalone). - -Note: Applications such as Termux on Android are capable of running Geyser-Standalone, but this largely depends on how powerful your Android device is. Please do so at your own risk. +The setup guide linked below tells you how to set up Geyser Standalone on Android using a third-party app called Termux. +- Applications such as Termux on Android are capable of running Geyser-Standalone, but this largely depends on how powerful your Android device is. **Please do so at your own risk.** \ No newline at end of file diff --git a/src/main/resources/tags/links/translate.tag b/src/main/resources/tags/links/translate.tag index 63d9f8d6..6e1e9a03 100644 --- a/src/main/resources/tags/links/translate.tag +++ b/src/main/resources/tags/links/translate.tag @@ -1,5 +1,8 @@ type: text +color: links +title: :geyser: Translating Geyser +button: [Crowdin](https://translate.geysermc.org/) --- -One way of contributing to Geyser is by translating it to your language on Crowdin. https://translate.geysermc.org/ +Want to contribute to Geyser? One way of contributing to Geyser is by translating it to your language on the Crowdin page linked below. \ No newline at end of file diff --git a/src/main/resources/tags/links/uuid.tag b/src/main/resources/tags/links/uuid.tag index 5593fc83..3e528ecd 100644 --- a/src/main/resources/tags/links/uuid.tag +++ b/src/main/resources/tags/links/uuid.tag @@ -1,13 +1,15 @@ type: text aliases: xuid, floodgateuuid, bedrockuuid +color: links +title: :ocean: Floodgate UUID +button: [MCProfile](https://mcprofile.io) --- + Automatic method: -Use https://mcprofile.io to look up your Floodgate UUID with your Xbox Gamertag. -Alternatively, use the "/UUID" command in <#613194762249437245>. +- Use MCProfile (linked below) to look up your Floodgate UUID with your Xbox Gamertag. +- Alternatively, use the `/uuid` command in <#613194762249437245>. -Manual method: You can manually format a hexadecimal Bedrock XUID to a Floodgate UUID: - -XUID Search Result: 000901F82546F8F0 -Floodgate UUID: 00000000-0000-0000-0009-01F82546F8F0 +- XUID Search Result: 000901F82546F8F0 +- Floodgate UUID: 00000000-0000-0000-0009-01F82546F8F0 \ No newline at end of file diff --git a/src/main/resources/tags/links/viaversion.tag b/src/main/resources/tags/links/viaversion.tag deleted file mode 100644 index c9a42c79..00000000 --- a/src/main/resources/tags/links/viaversion.tag +++ /dev/null @@ -1,6 +0,0 @@ -type: text -aliases: vv - ---- -Geyser emulates the latest version of Minecraft: Java Edition, so ViaVersion must be installed if your Java server is not on the latest version that Geyser supports. -https://ci.viaversion.com/job/ViaVersion/ diff --git a/src/main/resources/tags/links/whitelist.tag b/src/main/resources/tags/links/whitelist.tag index 96a5658f..b058f8b0 100644 --- a/src/main/resources/tags/links/whitelist.tag +++ b/src/main/resources/tags/links/whitelist.tag @@ -1,9 +1,10 @@ type: text aliases: whitelisting, howtowhitelist +color: links +title: :link: Whitelisting Bedrock Players +button: [Whitelist Command](https://wiki.geysermc.org/floodgate/features/#whitelist-command) +button: [MCProfile](https://mcprofile.io/) --- -See here for information about adding Bedrock players to the whitelist. -https://wiki.geysermc.org/floodgate/features/#whitelist-command - -If whitelisting using the username does not work, you can get the Bedrock player's Floodgate UUID [here](https://mcprofile.io/) and whitelist it instead. +See the whitelist command link below for information about adding Bedrock players to the whitelist. If whitelisting using the username does not work, you can get the Bedrock player's Floodgate UUID using MCProfile and whitelist it instead. \ No newline at end of file diff --git a/src/main/resources/tags/roles/devnews.tag b/src/main/resources/tags/roles/devnews.tag index 2ed3d1c4..f5c3091b 100644 --- a/src/main/resources/tags/roles/devnews.tag +++ b/src/main/resources/tags/roles/devnews.tag @@ -1,5 +1,7 @@ type: text +title: :computer: Dev News +color: roles --- -Run `/rank devnews` in the <#613194762249437245> channel if you wish to get notified when API changes come out. +Run `/rank devnews` in the <#613194762249437245> channel if you wish to get notified when API changes come out. \ No newline at end of file diff --git a/src/main/resources/tags/roles/news.tag b/src/main/resources/tags/roles/news.tag index a0214f00..816f490b 100644 --- a/src/main/resources/tags/roles/news.tag +++ b/src/main/resources/tags/roles/news.tag @@ -1,6 +1,8 @@ type: text +title: :newspaper: Geyser News aliases: geysernews +color: roles --- -Run `/rank geysernews` in the <#613194762249437245> channel if you wish to get notified when big updates come out. +Run `/rank geysernews` in the <#613194762249437245> channel if you wish to get notified when big updates come out. \ No newline at end of file diff --git a/src/main/resources/tags/roles/tester.tag b/src/main/resources/tags/roles/tester.tag index 0b232dd1..8654f49f 100644 --- a/src/main/resources/tags/roles/tester.tag +++ b/src/main/resources/tags/roles/tester.tag @@ -1,6 +1,8 @@ type: text +title: :test_tube: Geyser Testers aliases: testers, testing +color: roles --- -Want to test new Geyser features? Run `/rank Tester` in the <#613194762249437245> channel. +Want to test new Geyser features? Run `/rank Tester` in the <#613194762249437245> channel. \ No newline at end of file diff --git a/src/main/resources/tags/util/asking.tag b/src/main/resources/tags/util/asking.tag index 5cba6bf1..a224f553 100644 --- a/src/main/resources/tags/util/asking.tag +++ b/src/main/resources/tags/util/asking.tag @@ -3,4 +3,4 @@ aliases: ask --- -Don't ask to ask, just ask your question. Don't ask if someone can help you. Just explain what you need help with, and provide as much information about your issue and server as possible. +Don't ask to ask, just ask your question. Don't ask if someone can help you. Just explain what you need help with, and provide as much information about your issue and server as possible. \ No newline at end of file diff --git a/src/main/resources/tags/util/connectiontest.tag b/src/main/resources/tags/util/connectiontest.tag deleted file mode 100644 index 1f804bb6..00000000 --- a/src/main/resources/tags/util/connectiontest.tag +++ /dev/null @@ -1,10 +0,0 @@ -type: text -aliases: test, serverstatus - ---- - -To check whether Bedrock players can connect or if port forwarding for Geyser is working, run the following command in your Minecraft server console: - -`geyser connectiontest ` - -For example, if your server is running on the IP 12.34.56.78 and port 19132, you would run `geyser connectiontest 12.34.56.78 19132`. diff --git a/src/main/resources/tags/util/dump.tag b/src/main/resources/tags/util/dump.tag index 4445bbe1..c67dcc91 100644 --- a/src/main/resources/tags/util/dump.tag +++ b/src/main/resources/tags/util/dump.tag @@ -1,5 +1,9 @@ type: text +title: :geyser: Geyser Dump +color: util --- -Run `geyser dump` (server console) / `/geyser dump` (ingame chat) on your Geyser instance or server, then copy the link it will give you and paste it here. A Geyser dump is a way of providing us with a bunch of useful information about your server and Geyser config. This doesn't include any IPs or sensitive data. +A Geyser dump is a way of providing us with a bunch of useful information about your server and Geyser config without giving us any IPs or sensitive data. +- Run `geyser dump` in the server console or `/geyser dump` in the in‑game chat. +- Then, copy the Geyser dump link it gives you and paste it here. \ No newline at end of file diff --git a/src/main/resources/tags/util/eta.tag b/src/main/resources/tags/util/eta.tag index 78591df9..484431f1 100644 --- a/src/main/resources/tags/util/eta.tag +++ b/src/main/resources/tags/util/eta.tag @@ -1,5 +1,7 @@ type: text +title: :alarm_clock: ETA +color: util --- -It'll be done when it's done. Considering the type of software Geyser is, we can't just throw out ETAs left and right. It could be a matter of a few hours before your feature or bug is fixed, or a few months. Sometimes we hit roadblocks or run into issues that we didn't expect. Please be patient; we'll get around to it when we have time or more information is learned. +It'll be done when it's done. Considering the type of software Geyser is, we can't just throw out ETAs left and right. It could be a matter of a few hours before your feature or bug is fixed, or a few months. Sometimes we hit roadblocks or run into issues that we didn't expect. Please be patient; we'll get around to it when we have time or more information is learned. \ No newline at end of file diff --git a/src/main/resources/tags/util/fulldump.tag b/src/main/resources/tags/util/fulldump.tag index 26fffe3f..8cea2356 100644 --- a/src/main/resources/tags/util/fulldump.tag +++ b/src/main/resources/tags/util/fulldump.tag @@ -1,5 +1,9 @@ type: text +title: :geyser: Geyser Full Dump +color: util --- -Run `geyser dump full` (server console) / `/geyser dump full` (ingame chat) on your Geyser instance or server, then copy the link it will give you and paste it here. This will show all IPs on your dump so we can correctly identify your issue. +A Geyser full dump is a way of providing us with a bunch of useful information about your server and Geyser config with all IPs. +- Run `geyser dump full` in the server console or `/geyser dump full` in the in‑game chat. +- Then, copy the Geyser dump link it gives you and paste it here. \ No newline at end of file diff --git a/src/main/resources/tags/util/logs.tag b/src/main/resources/tags/util/logs.tag index 1162872b..dbf8446b 100644 --- a/src/main/resources/tags/util/logs.tag +++ b/src/main/resources/tags/util/logs.tag @@ -1,9 +1,16 @@ type: text aliases: log, mclogs +color: util +title: :scroll: Logs +button: [MCLogs](https://mclo.gs/) --- -An entire log file is a very useful way of debugging any issues with plugins. Sometimes a snippet of a log doesn't tell the whole story! +A full log file is essential for debugging any issues. Snippets rarely tell the whole story. +MCLogs censors IPs and improves readability, making it the best way to share logs. -You can upload your log file into this channel, or you can use https://mclo.gs/ to censor all IPs present in your log. -For BungeeCord (not Waterfall) there is a `proxy.log.0` file in the root and for everything else it is `latest.log` in `logs` folder. +Upload your log file to MCLogs (linked below) and share the link here. + +Log file locations: +- NeoForge, Fabric, Spigot/Paper, Standalone, Velocity, ViaProxy: `logs/latest.log` +- BungeeCord: `proxy.log.0` \ No newline at end of file diff --git a/src/main/resources/tags/util/logsdump.tag b/src/main/resources/tags/util/logsdump.tag index 04e84297..964aa594 100644 --- a/src/main/resources/tags/util/logsdump.tag +++ b/src/main/resources/tags/util/logsdump.tag @@ -1,5 +1,9 @@ type: text +title: :geyser: Geyser Logs Dump +color: util --- -Run `geyser dump logs` (server console) / `/geyser dump logs` (ingame chat) on your Geyser instance or server, then copy the link it will give you and paste it here. This will automatically upload the server logs to [mclo.gs](https://mclo.gs/) and add the link in the dump. +A Geyser logs dump is a way of providing us with a bunch of useful information about your server and Geyser config with the logs from your server. +- Run `geyser dump logs` in the server console or `/geyser dump logs` in the in‑game chat. +- Then, copy the Geyser dump link it gives you and paste it here. \ No newline at end of file diff --git a/src/main/resources/tags/util/plshelp.tag b/src/main/resources/tags/util/plshelp.tag index c8b9e663..44ee35cc 100644 --- a/src/main/resources/tags/util/plshelp.tag +++ b/src/main/resources/tags/util/plshelp.tag @@ -2,4 +2,4 @@ type: raw --- -https://raw.githubusercontent.com/GeyserMC/GeyserDiscordBot/master/src/main/resources/assets/new_pleasehelp.png +https://raw.githubusercontent.com/GeyserMC/GeyserDiscordBot/master/src/main/resources/assets/new_pleasehelp.png \ No newline at end of file diff --git a/src/main/resources/tags/util/spark.tag b/src/main/resources/tags/util/spark.tag index 781e9e5f..ef244628 100644 --- a/src/main/resources/tags/util/spark.tag +++ b/src/main/resources/tags/util/spark.tag @@ -1,11 +1,14 @@ type: text +title: :zap: Spark Performance Monitoring +color: util +button: [Download Spark](https://spark.lucko.me/download) --- -Spark is a plugin that helps you monitor performance for you server. - +Spark is a plugin/mod that helps you monitor performance for your server. Spark does not require manual installation on Paper as Paper has Spark built-in. The download link for Spark can be found below. -To record performance on your server use: -`/spark profiler --thread * --timeout 60`. This will run for 60 seconds then it will automatically stop. -(On Velocity, replace `/spark` with `/sparkv`; on BungeeCord, replace with `sparkb`) -It'll probably lag the server a good deal but it'll give us a link we might be able to process. +To record performance on your server use `/spark profiler --thread * --timeout 60`. +- This will run for 60 seconds and then automatically stop. +- It'll probably lag the server a good deal while it runs, but it'll give us a link we might be able to process. +- On Velocity, replace `/spark` with `/sparkv`. +- On BungeeCord, replace `/spark` with `/sparkb`. \ No newline at end of file diff --git a/src/main/resources/tags/warns/anticheat.tag b/src/main/resources/tags/warns/anticheat.tag new file mode 100644 index 00000000..7a71b7e8 --- /dev/null +++ b/src/main/resources/tags/warns/anticheat.tag @@ -0,0 +1,8 @@ +type: text +aliases: ban, bans, hypixel +title: :warning: Anticheat On Large Servers +color: warns + +--- + +**Please exercise caution when going on large servers!** Geyser does not perfectly replicate a Java client; anticheat on servers **especially Hypixel** can pick up irregular behavior from Geyser and ban you. \ No newline at end of file diff --git a/src/main/resources/tags/warns/beta.tag b/src/main/resources/tags/warns/beta.tag new file mode 100644 index 00000000..2b864057 --- /dev/null +++ b/src/main/resources/tags/warns/beta.tag @@ -0,0 +1,9 @@ +type: text +aliases: betas, preview +title: :warning: Beta/Preview Versions +color: warns +button: [Guide](https://help.minecraft.net/hc/en-us/articles/360040841471-How-to-Join-and-leave-a-Minecraft-Beta/) + +--- + +Geyser does not support beta or preview versions of Bedrock. You can opt out of beta or preview versions of Bedrock using the guide below. \ No newline at end of file diff --git a/src/main/resources/tags/util/ping.tag b/src/main/resources/tags/warns/ping.tag similarity index 70% rename from src/main/resources/tags/util/ping.tag rename to src/main/resources/tags/warns/ping.tag index c3a34642..fffa8f70 100644 --- a/src/main/resources/tags/util/ping.tag +++ b/src/main/resources/tags/warns/ping.tag @@ -1,7 +1,9 @@ type: text aliases: pings, pinging +title: :no_bell: No Pinging +color: warns --- -> 2. Only use the support channels if you need help. **Please do not ping or DM project staff & helpers if you need support.** We all have lives outside of Geyser and it may take some time for us to respond. With that being said, please don't ask for support in non-support channels as well. -Please read the rules in <#613195277938982953> +Please read the rules in <#613195277938982953>. +> 2. Only use the support channels if you need help. **Please do not ping or DM project staff & helpers if you need support.** We all have lives outside of Geyser and it may take some time for us to respond. With that being said, please don't ask for support in non-support channels as well. \ No newline at end of file diff --git a/src/main/resources/tags/warns/piracy.tag b/src/main/resources/tags/warns/piracy.tag new file mode 100644 index 00000000..f8c4b9c6 --- /dev/null +++ b/src/main/resources/tags/warns/piracy.tag @@ -0,0 +1,9 @@ +type: text +aliases: offline, offlinemode, cracked +title: :no_entry_sign: Cracked/Offline Servers +color: warns +button: [Floodgate](https://geysermc.org/wiki/floodgate/setup/) + +--- + +We do not provide support for cracked (offline mode) servers as they allow pirated accounts to join which are illegal. While Geyser can run potentially run on cracked servers, you are on your own and should seek support elsewhere for any issues that arise. For allowing Bedrock players without a Minecraft Java Edition account on your Geyser server, please use Floodgate with `online-mode` set to `true` in [`server.properties`](https://minecraft.wiki/w/Server.properties). \ No newline at end of file diff --git a/src/main/resources/tags/warns/reload.tag b/src/main/resources/tags/warns/reload.tag new file mode 100644 index 00000000..22b4e17a --- /dev/null +++ b/src/main/resources/tags/warns/reload.tag @@ -0,0 +1,10 @@ +type: text +aliases: reloading +help: reload +title: :arrows_clockwise: Avoid Using The /reload Command +color: warns +button: [Why you should never /reload on Spigot and Paper](https://madelinemiller.dev/blog/problem-with-reload/) + +--- + +Doing `/reload` on a server can and most likely will cause issues; please do a full restart after installing, updating or altering any config files. See the blog page linked below for more info. \ No newline at end of file