diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..de5ae02 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,2 @@ +# All .md files should be treated as Jekyll files + diff --git a/.gitignore b/.gitignore index f40fbd8..23c03c4 100755 --- a/.gitignore +++ b/.gitignore @@ -3,3 +3,26 @@ _site .jekyll-cache .jekyll-metadata vendor + +.idea/ + +# Dependencies +/node_modules + +# Production +/build + +# Generated files +.docusaurus +.cache-loader + +# Misc +.DS_Store +.env.local +.env.development.local +.env.test.local +.env.production.local + +npm-debug.log* +yarn-debug.log* +yarn-error.log* diff --git a/.idea/.gitignore b/.idea/.gitignore new file mode 100644 index 0000000..13566b8 --- /dev/null +++ b/.idea/.gitignore @@ -0,0 +1,8 @@ +# Default ignored files +/shelf/ +/workspace.xml +# Editor-based HTTP Client requests +/httpRequests/ +# Datasource local storage ignored files +/dataSources/ +/dataSources.local.xml diff --git a/.idea/GeyserWiki.iml b/.idea/GeyserWiki.iml new file mode 100644 index 0000000..4bdccbe --- /dev/null +++ b/.idea/GeyserWiki.iml @@ -0,0 +1,118 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/.idea/codeStyles/codeStyleConfig.xml b/.idea/codeStyles/codeStyleConfig.xml new file mode 100644 index 0000000..1a0176a --- /dev/null +++ b/.idea/codeStyles/codeStyleConfig.xml @@ -0,0 +1,5 @@ + + + + diff --git a/.idea/discord.xml b/.idea/discord.xml new file mode 100644 index 0000000..d8e9561 --- /dev/null +++ b/.idea/discord.xml @@ -0,0 +1,7 @@ + + + + + \ No newline at end of file diff --git a/.idea/git_toolbox_prj.xml b/.idea/git_toolbox_prj.xml new file mode 100644 index 0000000..150f33c --- /dev/null +++ b/.idea/git_toolbox_prj.xml @@ -0,0 +1,20 @@ + + + + + + + + diff --git a/.idea/inspectionProfiles/Project_Default.xml b/.idea/inspectionProfiles/Project_Default.xml new file mode 100644 index 0000000..19df18a --- /dev/null +++ b/.idea/inspectionProfiles/Project_Default.xml @@ -0,0 +1,6 @@ + + + + diff --git a/.idea/misc.xml b/.idea/misc.xml new file mode 100644 index 0000000..34f468f --- /dev/null +++ b/.idea/misc.xml @@ -0,0 +1,4 @@ + + + + diff --git a/.idea/modules.xml b/.idea/modules.xml new file mode 100644 index 0000000..5af8ed6 --- /dev/null +++ b/.idea/modules.xml @@ -0,0 +1,8 @@ + + + + + + + + diff --git a/.idea/vcs.xml b/.idea/vcs.xml new file mode 100644 index 0000000..dcb6b8c --- /dev/null +++ b/.idea/vcs.xml @@ -0,0 +1,6 @@ + + + + + + diff --git a/Gemfile.lock b/Gemfile.lock index 3d2620e..71c84ac 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -29,7 +29,7 @@ GEM ruby2_keywords (>= 0.0.4) faraday-net_http (3.0.2) ffi (1.15.5) - ffi (1.15.5-x64-mingw-ucrt) + ffi (1.15.5-x64-unknown) forwardable-extended (2.6.0) gemoji (3.0.1) github-pages (228) @@ -211,7 +211,9 @@ GEM jekyll-feed (~> 0.9) jekyll-seo-tag (~> 2.1) minitest (5.18.0) - nokogiri (1.14.3-x64-mingw-ucrt) + nokogiri (1.14.3-arm64-darwin) + racc (~> 1.4) + nokogiri (1.14.3-x64-unknown) racc (~> 1.4) nokogiri (1.14.3-x86_64-linux) racc (~> 1.4) @@ -246,18 +248,16 @@ GEM ethon (>= 0.9.0) tzinfo (2.0.6) concurrent-ruby (~> 1.0) - tzinfo-data (1.2022.7) - tzinfo (>= 1.0.0) unf (0.1.4) unf_ext unf_ext (0.0.8.2) - unf_ext (0.0.8.2-x64-mingw-ucrt) + unf_ext (0.0.8.2-x64-unknown) unicode-display_width (1.8.0) - wdm (0.1.1) webrick (1.8.1) PLATFORMS - x64-mingw-ucrt + arm64-darwin-22 + x64-unknown x86_64-linux DEPENDENCIES diff --git a/README.md b/README.md index 5d72d42..aaba2fa 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,41 @@ -# GeyserMC Wiki +# Website -This is the repository that contains the wiki for all of GeyserMCs projects. +This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator. -The wiki can be accessed using [this link](https://wiki.geysermc.org). \ No newline at end of file +### Installation + +``` +$ yarn +``` + +### Local Development + +``` +$ yarn start +``` + +This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server. + +### Build + +``` +$ yarn build +``` + +This command generates static content into the `build` directory and can be served using any static contents hosting service. + +### Deployment + +Using SSH: + +``` +$ USE_SSH=true yarn deploy +``` + +Not using SSH: + +``` +$ GIT_USER= yarn deploy +``` + +If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch. diff --git a/_data/faq.yml b/_data/faq.yml index bfee81d..5923ce1 100644 --- a/_data/faq.yml +++ b/_data/faq.yml @@ -37,9 +37,9 @@ content: | The Geyser-Spigot plugin supports any Minecraft server version 1.13.2 or later. Any earlier version is not supported by the plugin - use a proxy version or the standalone build instead. Since Geyser emulates a {{ site.data.versions.java }} Java Edition client, you need to [install ViaVersion](https://www.spigotmc.org/resources/viaversion.19254/) on your server - if it is not running the latest version of Minecraft.
+ if it is not running the latest version of Minecraft. - In order for Bedrock players to chat (1.19.3+) or join (1.19.1/1.19.2), you need to disable chat signing. More information about that can be read on the [chat signing page](/geyser/secure-chat/).
+ In order for Bedrock players to chat (1.19.3+) or join (1.19.1/1.19.2), you need to disable chat signing. More information about that can be read on the [chat signing page](/geyser/secure-chat/). You will also need to run at least Java 16 or later to use Geyser. See [here](https://docs.papermc.io/misc/java-install) for more info on updating Java. Paper versions not supporting Java 16 can add `-DPaper.IgnoreJavaVersion=true` flag to the Java startup arguments to allow Paper to run on Java 16. diff --git a/_docs/floodgate/setup.md b/_docs/floodgate/setup.md deleted file mode 100644 index 32bd6c3..0000000 --- a/_docs/floodgate/setup.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Floodgate Setup -page_sidebar: false ---- - -# Floodgate Setup - - - - - -
-
- {% capture my_include %}{% include setup/instructions/floodgate/spigot.md %}{% endcapture %} - {{ my_include | markdownify }} -
-
- {% capture my_include %}{% include setup/instructions/floodgate/fabric.md %}{% endcapture %} - {{ my_include | markdownify }} -
-
- {% capture my_include %}{% include setup/instructions/floodgate/proxy.md %}{% endcapture %} - {{ my_include | markdownify }} -
-
- {% capture my_include %}{% include setup/instructions/floodgate/standalone.md %}{% endcapture %} - {{ my_include | markdownify }} -
-
- -

Further information:

- \ No newline at end of file diff --git a/_docs/geyser/anticheat-compatibility.md b/_docs/geyser/anticheat-compatibility.md deleted file mode 100644 index afb4ffc..0000000 --- a/_docs/geyser/anticheat-compatibility.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Anticheat Compatibility ---- - - - -### AntiCheat compatibility reports - -Full Compatibility (Checks Bedrock Players Accurately) - -- [AntiAura](https://www.spigotmc.org/resources/1368/){:target="_blank"} (Paid) - Last Updated on 19th August 2021 -- [Themis](https://www.spigotmc.org/resources/90766/){:target="_blank"} - Last Updated on 15th Jun 2022 -- [Negativity V2](https://www.spigotmc.org/resources/86874/){:target="_blank"} (Paid) - Last Updated on 21st March 2022 -- [SoaromaSAC](https://www.spigotmc.org/resources/87702/){:target="_blank"} - Last Updated on 27th March 2022 -- [Spartan: Bedrock Edition](https://builtbybit.com/resources/12832/){:target="_blank"} (Paid) - Last Updated on 22nd May 2023 - -Partially Compatible (Does not Check/Ignores Bedrock Players) - -- [AAC](https://www.spigotmc.org/resources/6442/){:target="_blank"} (Paid) - Last Updated on 19th August 2021 -- [Flappy Anticheat](https://www.spigotmc.org/resources/92180/){:target="_blank"} - Last Updated on 14th September 2021 -- [GrimAC](https://github.com/MWHunter/Grim){:target="_blank"} - Last Updated on 24th March 2022 -- [Intave](https://intave.ac){:target="_blank"} (Paid) Requires [GeyserMC addon](https://github.com/intave/bedrock){:target="_blank"} - Last Updated on 24th October 2022 -- [Matrix](https://matrix.rip/){:target="_blank"} (Paid) - Last updated on 2nd September 2021 -- [Spartan: Java Edition](https://www.spigotmc.org/resources/25638/){:target="_blank"} (Paid) - Last Updated on 22nd May 2023 -- [Vulcan](https://www.spigotmc.org/resources/83626/){:target="_blank"} (Paid) - Last Updated on 19th August 2021 -- [Verus](https://verus.ac){:target="_blank"} (Paid) - Last Updated on 13th July 2022 - -Incompatible (False Positives on Bedrock Players, no Compatibility at All) - -- [AntiCheatReloaded](https://www.spigotmc.org/resources/23799/){:target="_blank"} - Last Updated on 19th August 2021 -- [Negativity V1](https://www.spigotmc.org/resources/48399/){:target="_blank"} - Last Updated on 21st March 2022 -- [NoCheatPlus](https://ci.codemc.io/job/Updated-NoCheatPlus/job/Updated-NoCheatPlus/){:target="_blank"} ([Compat NCP](https://github.com/Updated-NoCheatPlus/CompatNoCheatPlus/){:target="_blank"} is an addon that enables Partial Compatibility) - Last Updated on 19th August 2021 -- [GodsEye](https://www.spigotmc.org/resources/69595/){:target="_blank"} ([GodsEyeGeyserMC](https://github.com/TheDejavu/GodsEyeGeyserMC/releases){:target="_blank"} is an addon that enables Partial Compatibility) (Paid) - Last Updated on 21st March 2022 -- [Kauri](https://www.spigotmc.org/resources/53721/){:target="_blank"} (Paid) - Last Updated on 21st March 2022 -- [Reflex](https://www.spigotmc.org/resources/21122/){:target="_blank"} (Paid) - Last Updated on 19th August 2021 -- [Wraith](https://www.spigotmc.org/resources/66887/){:target="_blank"} (Paid) - Last Updated on 19th August 2021 diff --git a/_docs/geyser/commands.md b/_docs/geyser/commands.md deleted file mode 100644 index 9d7aa1d..0000000 --- a/_docs/geyser/commands.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Commands ---- - -# Commands and Permissions - -| Command | Permission | Description | -|:---:|:---:|:---:| -| `geyser help`
`geyser ?` | `geyser.command.help` | Shows help for all registered commands. | -| `geyser advancements` | `geyser.command.advancements` | Open the Java advancements menu. | -| `geyser dump` | `geyser.command.dump` | Dumps Geyser debug information for bug reports. | -| `geyser list` | `geyser.command.list` | List all players connected through Geyser. | -| `geyser offhand` | `geyser.command.offhand` | Puts an item in your offhand. | -| `geyser reload` | `geyser.command.reload` | Reloads the Geyser configurations. Kicks all players when used! | -| `geyser settings` | `geyser.command.settings` | Opens a settings menu allowing you to modify aspects of the world. | -| `geyser shutdown`
`geyser stop` | `geyser.command.shutdown` | Shuts down Geyser.
*This command only works on Standalone.* | -| `geyser statistics` | `geyser.command.statistics` | Open the Java statistics menu. | -| `geyser version` | `geyser.command.version` | Shows the current Geyser version and checks for updates. | -| `geyser tooltips` | `geyser.command.tooltips`| Toggle showing Advanced Tooltips (F3 + H on Java) | - - -For Floodgate commands, see [here](/floodgate/commands/). diff --git a/_docs/geyser/faq.md b/_docs/geyser/faq.md deleted file mode 100644 index 6bfedbf..0000000 --- a/_docs/geyser/faq.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: FAQ ---- - -{% for section in site.data.faq %} -

{{ section.title }}

- {% if section.desc != nil %}

{{ section.desc | markdownify }}

{% endif %} -
- {% for question in section.items %} - {% assign id = question.title | slugify %} -
-

- -

-
-
- {{ question.content | markdownify }} -
-
-
- {% endfor %} -
-{% endfor %} diff --git a/_docs/geyser/setup.md b/_docs/geyser/setup.md deleted file mode 100644 index bde658c..0000000 --- a/_docs/geyser/setup.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: Setup -page_sidebar: false ---- -
- Host Provider - Self Host -
- -
-
- {% include setup/host-provider.html %} - - {% include setup/instructions/geyser/tabs.html type="provider" %} -
- -
- {% include setup/instructions/geyser/tabs.html type="selfhost" show_standalone=true %} -
-
- - - -

Further information:

- diff --git a/_docs/geyser/supported-hosting-providers.md b/_docs/geyser/supported-hosting-providers.md deleted file mode 100644 index 2eafc19..0000000 --- a/_docs/geyser/supported-hosting-providers.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Supported Hosting Providers ---- - - - - - - - - - -## Built-in Geyser -{% for provider in site.data.providers.built_in %} -* [{{ provider.name}}]({{ provider.url }}){% if provider.description != nil or provider.description_template != nil %} - {{ site.data.providers.description_templates[provider.description_template] }} {{ provider.description }}{% endif %} -{% endfor %} - -## Support for Geyser -{% for provider in site.data.providers.support %} -* [{{ provider.name}}]({{ provider.url }}){% if provider.description != nil or provider.description_template != nil %} - {{ site.data.providers.description_templates[provider.description_template] }} {{ provider.description }}{% endif %} -{% endfor %} - -## Does not support Geyser -{% for provider in site.data.providers.no_support %} -* [{{ provider.name}}]({{ provider.url }}){% if provider.description != nil or provider.description_template != nil %} - {{ site.data.providers.description_templates[provider.description_template] }} {{ provider.description }}{% endif %} -{% endfor %} diff --git a/_includes/setup/host-provider.html b/_includes/setup/host-provider.html index 9ef34c1..b69dabc 100644 --- a/_includes/setup/host-provider.html +++ b/_includes/setup/host-provider.html @@ -13,7 +13,7 @@ - + - \ No newline at end of file + diff --git a/_site/CNAME b/_site/CNAME new file mode 100644 index 0000000..c824192 --- /dev/null +++ b/_site/CNAME @@ -0,0 +1 @@ +wiki.geysermc.org diff --git a/_site/CONTRIBUTING.md b/_site/CONTRIBUTING.md new file mode 100644 index 0000000..13f7a49 --- /dev/null +++ b/_site/CONTRIBUTING.md @@ -0,0 +1,50 @@ +# Contributing + +If you would like to contribute to the wiki, please [open a pull request](https://github.com/GeyserMC/GeyserWiki/pulls). + +### Creating a new page + +Most documentation is in the `docs` folder, where you can add new pages or edit the current ones. +If a new page is being added make sure you add its page properties at the beginning of the file. +Make sure that the file extension is .md - in this case `pagetitle.md`. + +### Example page layout + +```md +--- +title: Page title +page_sidebar: false (optional) +--- + +# Page title +This is an example page. +``` + +### Adding page to the sidebar + +Once you have added the file you can add a sidebar link. All sidebar links + sub links are in the _data/toc.yml file. + +### Example sidebar structure + +``` +- title: Page Title Documentation + url: "page/" + links: + - title: "Pagetitle sub link" + url: "page/pagetitle/" + children: + - title: PageChild sub link + url: "page/pagetitle/#headerLink" +``` + +### GeyserWiki development - Local deployment on Windows. + +* Download and install Ruby using the Ruby+Devkit from https://rubyinstaller.org/downloads/. + +* Once installed, run 'ridk install' in console to open the RubyInstaller. +For this usecase, it is recommended to choose the third option, "MSYS and MINGW". After that, the Ruby installation is completed. + +* Open the GeyserWiki folder in VScode. There, open a terminal to install the bundle using the 'bundle install' command. +Installing it for the first time can take a while. + +* Once installed, you can start the webserver locally with the 'bundle exec jekyll serve' command in the VSC terminal. diff --git a/_site/COPYRIGHT b/_site/COPYRIGHT new file mode 100644 index 0000000..34031b6 --- /dev/null +++ b/_site/COPYRIGHT @@ -0,0 +1,13 @@ +Copyright 2019-2021 Vanessa Sochat + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. diff --git a/_site/Gemfile b/_site/Gemfile new file mode 100644 index 0000000..33c4b64 --- /dev/null +++ b/_site/Gemfile @@ -0,0 +1,35 @@ +source "https://rubygems.org" +# Hello! This is where you manage which Jekyll version is used to run. +# When you want to use a different version, change it below, save the +# file and run `bundle install`. Run Jekyll with `bundle exec`, like so: +# +# bundle exec jekyll serve +# +# This will help ensure the proper Jekyll version is running. +# Happy Jekylling! +#gem "jekyll", "~> 4.3.2" +# This is the default theme for new Jekyll sites. You may change this to anything you like. +# gem "minima", "~> 2.5" +# If you want to use GitHub Pages, remove the "gem "jekyll"" above and +# uncomment the line below. To upgrade, run `bundle update github-pages`. +gem "github-pages", group: :jekyll_plugins +# If you have any plugins, put them here! +group :jekyll_plugins do + # gem "jekyll-feed", "~> 0.12" +end + +gem 'webrick' + +# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem +# and associated library. +platforms :mingw, :x64_mingw, :mswin, :jruby do + gem "tzinfo", ">= 1", "< 3" + gem "tzinfo-data" +end + +# Performance-booster for watching directories on Windows +gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin] + +# Lock `http_parser.rb` gem to `v0.6.x` on JRuby builds since newer versions of the gem +# do not have a Java counterpart. +gem "http_parser.rb", "~> 0.6.0", :platforms => [:jruby] diff --git a/_site/Gemfile.lock b/_site/Gemfile.lock new file mode 100644 index 0000000..71c84ac --- /dev/null +++ b/_site/Gemfile.lock @@ -0,0 +1,272 @@ +GEM + remote: https://rubygems.org/ + specs: + activesupport (7.0.4.3) + concurrent-ruby (~> 1.0, >= 1.0.2) + i18n (>= 1.6, < 2) + minitest (>= 5.1) + tzinfo (~> 2.0) + addressable (2.8.1) + public_suffix (>= 2.0.2, < 6.0) + coffee-script (2.4.1) + coffee-script-source + execjs + coffee-script-source (1.11.1) + colorator (1.1.0) + commonmarker (0.23.9) + concurrent-ruby (1.2.2) + dnsruby (1.61.9) + simpleidn (~> 0.1) + em-websocket (0.5.3) + eventmachine (>= 0.12.9) + http_parser.rb (~> 0) + ethon (0.16.0) + ffi (>= 1.15.0) + eventmachine (1.2.7) + execjs (2.8.1) + faraday (2.7.4) + faraday-net_http (>= 2.0, < 3.1) + ruby2_keywords (>= 0.0.4) + faraday-net_http (3.0.2) + ffi (1.15.5) + ffi (1.15.5-x64-unknown) + forwardable-extended (2.6.0) + gemoji (3.0.1) + github-pages (228) + github-pages-health-check (= 1.17.9) + jekyll (= 3.9.3) + jekyll-avatar (= 0.7.0) + jekyll-coffeescript (= 1.1.1) + jekyll-commonmark-ghpages (= 0.4.0) + jekyll-default-layout (= 0.1.4) + jekyll-feed (= 0.15.1) + jekyll-gist (= 1.5.0) + jekyll-github-metadata (= 2.13.0) + jekyll-include-cache (= 0.2.1) + jekyll-mentions (= 1.6.0) + jekyll-optional-front-matter (= 0.3.2) + jekyll-paginate (= 1.1.0) + jekyll-readme-index (= 0.3.0) + jekyll-redirect-from (= 0.16.0) + jekyll-relative-links (= 0.6.1) + jekyll-remote-theme (= 0.4.3) + jekyll-sass-converter (= 1.5.2) + jekyll-seo-tag (= 2.8.0) + jekyll-sitemap (= 1.4.0) + jekyll-swiss (= 1.0.0) + jekyll-theme-architect (= 0.2.0) + jekyll-theme-cayman (= 0.2.0) + jekyll-theme-dinky (= 0.2.0) + jekyll-theme-hacker (= 0.2.0) + jekyll-theme-leap-day (= 0.2.0) + jekyll-theme-merlot (= 0.2.0) + jekyll-theme-midnight (= 0.2.0) + jekyll-theme-minimal (= 0.2.0) + jekyll-theme-modernist (= 0.2.0) + jekyll-theme-primer (= 0.6.0) + jekyll-theme-slate (= 0.2.0) + jekyll-theme-tactile (= 0.2.0) + jekyll-theme-time-machine (= 0.2.0) + jekyll-titles-from-headings (= 0.5.3) + jemoji (= 0.12.0) + kramdown (= 2.3.2) + kramdown-parser-gfm (= 1.1.0) + liquid (= 4.0.4) + mercenary (~> 0.3) + minima (= 2.5.1) + nokogiri (>= 1.13.6, < 2.0) + rouge (= 3.26.0) + terminal-table (~> 1.4) + github-pages-health-check (1.17.9) + addressable (~> 2.3) + dnsruby (~> 1.60) + octokit (~> 4.0) + public_suffix (>= 3.0, < 5.0) + typhoeus (~> 1.3) + html-pipeline (2.14.3) + activesupport (>= 2) + nokogiri (>= 1.4) + http_parser.rb (0.8.0) + i18n (1.12.0) + concurrent-ruby (~> 1.0) + jekyll (3.9.3) + addressable (~> 2.4) + colorator (~> 1.0) + em-websocket (~> 0.5) + i18n (>= 0.7, < 2) + jekyll-sass-converter (~> 1.0) + jekyll-watch (~> 2.0) + kramdown (>= 1.17, < 3) + liquid (~> 4.0) + mercenary (~> 0.3.3) + pathutil (~> 0.9) + rouge (>= 1.7, < 4) + safe_yaml (~> 1.0) + jekyll-avatar (0.7.0) + jekyll (>= 3.0, < 5.0) + jekyll-coffeescript (1.1.1) + coffee-script (~> 2.2) + coffee-script-source (~> 1.11.1) + jekyll-commonmark (1.4.0) + commonmarker (~> 0.22) + jekyll-commonmark-ghpages (0.4.0) + commonmarker (~> 0.23.7) + jekyll (~> 3.9.0) + jekyll-commonmark (~> 1.4.0) + rouge (>= 2.0, < 5.0) + jekyll-default-layout (0.1.4) + jekyll (~> 3.0) + jekyll-feed (0.15.1) + jekyll (>= 3.7, < 5.0) + jekyll-gist (1.5.0) + octokit (~> 4.2) + jekyll-github-metadata (2.13.0) + jekyll (>= 3.4, < 5.0) + octokit (~> 4.0, != 4.4.0) + jekyll-include-cache (0.2.1) + jekyll (>= 3.7, < 5.0) + jekyll-mentions (1.6.0) + html-pipeline (~> 2.3) + jekyll (>= 3.7, < 5.0) + jekyll-optional-front-matter (0.3.2) + jekyll (>= 3.0, < 5.0) + jekyll-paginate (1.1.0) + jekyll-readme-index (0.3.0) + jekyll (>= 3.0, < 5.0) + jekyll-redirect-from (0.16.0) + jekyll (>= 3.3, < 5.0) + jekyll-relative-links (0.6.1) + jekyll (>= 3.3, < 5.0) + jekyll-remote-theme (0.4.3) + addressable (~> 2.0) + jekyll (>= 3.5, < 5.0) + jekyll-sass-converter (>= 1.0, <= 3.0.0, != 2.0.0) + rubyzip (>= 1.3.0, < 3.0) + jekyll-sass-converter (1.5.2) + sass (~> 3.4) + jekyll-seo-tag (2.8.0) + jekyll (>= 3.8, < 5.0) + jekyll-sitemap (1.4.0) + jekyll (>= 3.7, < 5.0) + jekyll-swiss (1.0.0) + jekyll-theme-architect (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-cayman (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-dinky (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-hacker (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-leap-day (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-merlot (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-midnight (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-minimal (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-modernist (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-primer (0.6.0) + jekyll (> 3.5, < 5.0) + jekyll-github-metadata (~> 2.9) + jekyll-seo-tag (~> 2.0) + jekyll-theme-slate (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-tactile (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-time-machine (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-titles-from-headings (0.5.3) + jekyll (>= 3.3, < 5.0) + jekyll-watch (2.2.1) + listen (~> 3.0) + jemoji (0.12.0) + gemoji (~> 3.0) + html-pipeline (~> 2.2) + jekyll (>= 3.0, < 5.0) + kramdown (2.3.2) + rexml + kramdown-parser-gfm (1.1.0) + kramdown (~> 2.0) + liquid (4.0.4) + listen (3.8.0) + rb-fsevent (~> 0.10, >= 0.10.3) + rb-inotify (~> 0.9, >= 0.9.10) + mercenary (0.3.6) + minima (2.5.1) + jekyll (>= 3.5, < 5.0) + jekyll-feed (~> 0.9) + jekyll-seo-tag (~> 2.1) + minitest (5.18.0) + nokogiri (1.14.3-arm64-darwin) + racc (~> 1.4) + nokogiri (1.14.3-x64-unknown) + racc (~> 1.4) + nokogiri (1.14.3-x86_64-linux) + racc (~> 1.4) + octokit (4.25.1) + faraday (>= 1, < 3) + sawyer (~> 0.9) + pathutil (0.16.2) + forwardable-extended (~> 2.6) + public_suffix (4.0.7) + racc (1.6.2) + rb-fsevent (0.11.2) + rb-inotify (0.10.1) + ffi (~> 1.0) + rexml (3.2.5) + rouge (3.26.0) + ruby2_keywords (0.0.5) + rubyzip (2.3.2) + safe_yaml (1.0.5) + sass (3.7.4) + sass-listen (~> 4.0.0) + sass-listen (4.0.0) + rb-fsevent (~> 0.9, >= 0.9.4) + rb-inotify (~> 0.9, >= 0.9.7) + sawyer (0.9.2) + addressable (>= 2.3.5) + faraday (>= 0.17.3, < 3) + simpleidn (0.2.1) + unf (~> 0.1.4) + terminal-table (1.8.0) + unicode-display_width (~> 1.1, >= 1.1.1) + typhoeus (1.4.0) + ethon (>= 0.9.0) + tzinfo (2.0.6) + concurrent-ruby (~> 1.0) + unf (0.1.4) + unf_ext + unf_ext (0.0.8.2) + unf_ext (0.0.8.2-x64-unknown) + unicode-display_width (1.8.0) + webrick (1.8.1) + +PLATFORMS + arm64-darwin-22 + x64-unknown + x86_64-linux + +DEPENDENCIES + github-pages + http_parser.rb (~> 0.6.0) + tzinfo (>= 1, < 3) + tzinfo-data + wdm (~> 0.1.1) + webrick + +BUNDLED WITH + 2.4.6 diff --git a/android-chrome-192x192.png b/_site/android-chrome-192x192.png similarity index 100% rename from android-chrome-192x192.png rename to _site/android-chrome-192x192.png diff --git a/android-chrome-512x512.png b/_site/android-chrome-512x512.png similarity index 100% rename from android-chrome-512x512.png rename to _site/android-chrome-512x512.png diff --git a/apple-touch-icon.png b/_site/apple-touch-icon.png similarity index 100% rename from apple-touch-icon.png rename to _site/apple-touch-icon.png diff --git a/_site/assets/css/style.css b/_site/assets/css/style.css new file mode 100644 index 0000000..bc2033b --- /dev/null +++ b/_site/assets/css/style.css @@ -0,0 +1,2883 @@ +/*! normalize.css v4.1.1 | MIT License | github.com/necolas/normalize.css */ +/** 1. Change the default font family in all browsers (opinionated). 2. Prevent adjustments of font size after orientation changes in IE and iOS. */ +html { font-family: sans-serif; /* 1 */ -ms-text-size-adjust: 100%; /* 2 */ -webkit-text-size-adjust: 100%; /* 2 */ } + +/** Remove the margin in all browsers (opinionated). */ +body { margin: 0; } + +/* HTML5 display definitions ========================================================================== */ +/** Add the correct display in IE 9-. 1. Add the correct display in Edge, IE, and Firefox. 2. Add the correct display in IE. */ +article, aside, details, figcaption, figure, footer, header, main, menu, nav, section { /* 1 */ display: block; } + +summary { display: list-item; } + +/** Add the correct display in IE 9-. */ +audio, canvas, progress, video { display: inline-block; } + +/** Add the correct display in iOS 4-7. */ +audio:not([controls]) { display: none; height: 0; } + +/** Add the correct vertical alignment in Chrome, Firefox, and Opera. */ +progress { vertical-align: baseline; } + +/** Add the correct display in IE 10-. 1. Add the correct display in IE. */ +template, [hidden] { display: none !important; } + +/* Links ========================================================================== */ +/** Remove the gray background on active links in IE 10. */ +a { background-color: transparent; /* 1 */ } + +/** Remove the outline on focused links when they are also active or hovered in all browsers (opinionated). */ +a:active, a:hover { outline-width: 0; } + +/* Text-level semantics ========================================================================== */ +/** 1. Remove the bottom border in Firefox 39-. 2. Add the correct text decoration in Chrome, Edge, IE, Opera, and Safari. */ +abbr[title] { border-bottom: none; /* 1 */ text-decoration: underline; /* 2 */ text-decoration: underline dotted; /* 2 */ } + +/** Prevent the duplicate application of `bolder` by the next rule in Safari 6. */ +b, strong { font-weight: inherit; } + +/** Add the correct font weight in Chrome, Edge, and Safari. */ +b, strong { font-weight: bolder; } + +/** Add the correct font style in Android 4.3-. */ +dfn { font-style: italic; } + +/** Correct the font size and margin on `h1` elements within `section` and `article` contexts in Chrome, Firefox, and Safari. */ +h1 { font-size: 2em; margin: 0.67em 0; } + +/** Add the correct background and color in IE 9-. */ +mark { background-color: #ff0; color: #000; } + +/** Add the correct font size in all browsers. */ +small { font-size: 80%; } + +/** Prevent `sub` and `sup` elements from affecting the line height in all browsers. */ +sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; } + +sub { bottom: -0.25em; } + +sup { top: -0.5em; } + +/* Embedded content ========================================================================== */ +/** Remove the border on images inside links in IE 10-. */ +img { border-style: none; } + +/** Hide the overflow in IE. */ +svg:not(:root) { overflow: hidden; } + +/* Grouping content ========================================================================== */ +/** 1. Correct the inheritance and scaling of font size in all browsers. 2. Correct the odd `em` font sizing in all browsers. */ +code, kbd, pre, samp { font-family: monospace, monospace; /* 1 */ font-size: 1em; /* 2 */ } + +/** Add the correct margin in IE 8. */ +figure { margin: 1em 40px; } + +/** 1. Add the correct box sizing in Firefox. 2. Show the overflow in Edge and IE. */ +hr { box-sizing: content-box; /* 1 */ height: 0; /* 1 */ overflow: visible; /* 2 */ } + +/* Forms ========================================================================== */ +/** 1. Change font properties to `inherit` in all browsers (opinionated). 2. Remove the margin in Firefox and Safari. */ +button, input, select, textarea { font: inherit; /* 1 */ margin: 0; /* 2 */ } + +/** Restore the font weight unset by the previous rule. */ +optgroup { font-weight: bold; } + +/** Show the overflow in IE. 1. Show the overflow in Edge. */ +button, input { /* 1 */ overflow: visible; } + +/** Remove the inheritance of text transform in Edge, Firefox, and IE. 1. Remove the inheritance of text transform in Firefox. */ +button, select { /* 1 */ text-transform: none; } + +/** 1. Prevent a WebKit bug where (2) destroys native `audio` and `video` controls in Android 4. 2. Correct the inability to style clickable types in iOS and Safari. */ +button, html [type="button"], [type="reset"], [type="submit"] { -webkit-appearance: button; /* 2 */ } + +/** Remove the inner border and padding in Firefox. */ +button::-moz-focus-inner, [type="button"]::-moz-focus-inner, [type="reset"]::-moz-focus-inner, [type="submit"]::-moz-focus-inner { border-style: none; padding: 0; } + +/** Restore the focus styles unset by the previous rule. */ +button:-moz-focusring, [type="button"]:-moz-focusring, [type="reset"]:-moz-focusring, [type="submit"]:-moz-focusring { outline: 1px dotted ButtonText; } + +/** Change the border, margin, and padding in all browsers (opinionated). */ +fieldset { border: 1px solid #c0c0c0; margin: 0 2px; padding: 0.35em 0.625em 0.75em; } + +/** 1. Correct the text wrapping in Edge and IE. 2. Correct the color inheritance from `fieldset` elements in IE. 3. Remove the padding so developers are not caught out when they zero out `fieldset` elements in all browsers. */ +legend { box-sizing: border-box; /* 1 */ color: inherit; /* 2 */ display: table; /* 1 */ max-width: 100%; /* 1 */ padding: 0; /* 3 */ white-space: normal; /* 1 */ } + +/** Remove the default vertical scrollbar in IE. */ +textarea { overflow: auto; } + +/** 1. Add the correct box sizing in IE 10-. 2. Remove the padding in IE 10-. */ +[type="checkbox"], [type="radio"] { box-sizing: border-box; /* 1 */ padding: 0; /* 2 */ } + +/** Correct the cursor style of increment and decrement buttons in Chrome. */ +[type="number"]::-webkit-inner-spin-button, [type="number"]::-webkit-outer-spin-button { height: auto; } + +/** 1. Correct the odd appearance in Chrome and Safari. 2. Correct the outline style in Safari. */ +[type="search"] { -webkit-appearance: textfield; /* 1 */ outline-offset: -2px; /* 2 */ } + +/** Remove the inner padding and cancel buttons in Chrome and Safari on OS X. */ +[type="search"]::-webkit-search-cancel-button, [type="search"]::-webkit-search-decoration { -webkit-appearance: none; } + +/** Correct the text style of placeholders in Chrome, Edge, and Safari. */ +::-webkit-input-placeholder { color: inherit; opacity: 0.54; } + +/** 1. Correct the inability to style clickable types in iOS and Safari. 2. Change font properties to `inherit` in Safari. */ +::-webkit-file-upload-button { -webkit-appearance: button; /* 1 */ font: inherit; /* 2 */ } + +* { box-sizing: border-box; } + +input, select, textarea, button { font-family: inherit; font-size: inherit; line-height: inherit; } + +body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"; font-size: 14px; line-height: 1.5; color: #24292e; background-color: #fff; } + +a { color: #0366d6; text-decoration: none; } +a:hover { text-decoration: underline; } + +b, strong { font-weight: 600; } + +hr, .rule { height: 0; margin: 15px 0; overflow: hidden; background: transparent; border: 0; border-bottom: 1px solid #dfe2e5; } +hr::before, .rule::before { display: table; content: ""; } +hr::after, .rule::after { display: table; clear: both; content: ""; } + +table { border-spacing: 0; border-collapse: collapse; } + +td, th { padding: 0; } + +button { cursor: pointer; border-radius: 0; } + +[hidden][hidden] { display: none !important; } + +details summary { cursor: pointer; } +details:not([open]) > *:not(summary) { display: none !important; } + +h1, h2, h3, h4, h5, h6 { margin-top: 0; margin-bottom: 0; } + +h1 { font-size: 32px; font-weight: 600; } + +h2 { font-size: 24px; font-weight: 600; } + +h3 { font-size: 20px; font-weight: 600; } + +h4 { font-size: 16px; font-weight: 600; } + +h5 { font-size: 14px; font-weight: 600; } + +h6 { font-size: 12px; font-weight: 600; } + +p { margin-top: 0; margin-bottom: 10px; } + +small { font-size: 90%; } + +blockquote { margin: 0; } + +ul, ol { padding-left: 0; margin-top: 0; margin-bottom: 0; } + +ol ol, ul ol { list-style-type: lower-roman; } + +ul ul ol, ul ol ol, ol ul ol, ol ol ol { list-style-type: lower-alpha; } + +dd { margin-left: 0; } + +tt, code { font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, Courier, monospace; font-size: 12px; } + +pre { margin-top: 0; margin-bottom: 0; font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, Courier, monospace; font-size: 12px; } + +.octicon { vertical-align: text-bottom; } + +/* Fade in an element */ +.anim-fade-in { animation-name: fade-in; animation-duration: 1s; animation-timing-function: ease-in-out; } +.anim-fade-in.fast { animation-duration: 300ms; } + +@keyframes fade-in { 0% { opacity: 0; } + 100% { opacity: 1; } } +/* Fade out an element */ +.anim-fade-out { animation-name: fade-out; animation-duration: 1s; animation-timing-function: ease-out; } +.anim-fade-out.fast { animation-duration: 0.3s; } + +@keyframes fade-out { 0% { opacity: 1; } + 100% { opacity: 0; } } +/* Fade in and slide up an element */ +.anim-fade-up { opacity: 0; animation-name: fade-up; animation-duration: 0.3s; animation-fill-mode: forwards; animation-timing-function: ease-out; animation-delay: 1s; } + +@keyframes fade-up { 0% { opacity: 0.8; transform: translateY(100%); } + 100% { opacity: 1; transform: translateY(0); } } +/* Fade an element out and slide down */ +.anim-fade-down { animation-name: fade-down; animation-duration: 0.3s; animation-fill-mode: forwards; animation-timing-function: ease-in; } + +@keyframes fade-down { 0% { opacity: 1; transform: translateY(0); } + 100% { opacity: 0.5; transform: translateY(100%); } } +/* Grow an element width from 0 to 100% */ +.anim-grow-x { width: 0%; animation-name: grow-x; animation-duration: 0.3s; animation-fill-mode: forwards; animation-timing-function: ease; animation-delay: 0.5s; } + +@keyframes grow-x { to { width: 100%; } } +/* Shrink an element from 100% to 0% */ +.anim-shrink-x { animation-name: shrink-x; animation-duration: 0.3s; animation-fill-mode: forwards; animation-timing-function: ease-in-out; animation-delay: 0.5s; } + +@keyframes shrink-x { to { width: 0%; } } +/* Fade in an element and scale it fast */ +.anim-scale-in { animation-name: scale-in; animation-duration: 0.15s; animation-timing-function: cubic-bezier(0.2, 0, 0.13, 1.5); } + +@keyframes scale-in { 0% { opacity: 0; transform: scale(0.5); } + 100% { opacity: 1; transform: scale(1); } } +/* Pulse an element's opacity */ +.anim-pulse { animation-name: pulse; animation-duration: 2s; animation-timing-function: linear; animation-iteration-count: infinite; } + +@keyframes pulse { 0% { opacity: 0.3; } + 10% { opacity: 1; } + 100% { opacity: 0.3; } } +/* Pulse in an element */ +.anim-pulse-in { animation-name: pulse-in; animation-duration: 0.5s; } + +@keyframes pulse-in { 0% { transform: scale3d(1, 1, 1); } + 50% { transform: scale3d(1.1, 1.1, 1.1); } + 100% { transform: scale3d(1, 1, 1); } } +/* Increase scale of an element on hover */ +.hover-grow { transition: transform 0.3s; backface-visibility: hidden; } +.hover-grow:hover { transform: scale(1.025); } + +/* Add a gray border on all sides */ +.border { border: 1px #e1e4e8 solid !important; } + +/* Add a gray border to the left and right */ +.border-y { border-top: 1px #e1e4e8 solid !important; border-bottom: 1px #e1e4e8 solid !important; } + +/* Remove borders from all sides */ +.border-0 { border: 0 !important; } + +.border-dashed { border-style: dashed !important; } + +/* Use with .border to turn the border blue */ +.border-blue { border-color: #0366d6 !important; } + +/* Use with .border to turn the border blue-light */ +.border-blue-light { border-color: #c8e1ff !important; } + +/* Use with .border to turn the border green */ +.border-green { border-color: #34d058 !important; } + +/* Use with .border to turn the border green light */ +.border-green-light { border-color: #a2cbac !important; } + +/* Use with .border to turn the border red */ +.border-red { border-color: #d73a49 !important; } + +/* Use with .border to turn the border red-light */ +.border-red-light { border-color: #cea0a5 !important; } + +/* Use with .border to turn the border purple */ +.border-purple { border-color: #6f42c1 !important; } + +/* Use with .border to turn the border yellow */ +.border-yellow { border-color: #d9d0a5 !important; } + +/* Use with .border to turn the border gray-light */ +.border-gray-light { border-color: #eaecef !important; } + +/* Use with .border to turn the border gray-dark */ +.border-gray-dark { border-color: #d1d5da !important; } + +/* Use with .border to turn the border rgba black 0.15 */ +.border-black-fade { border-color: rgba(27, 31, 35, 0.15) !important; } + +/* Add a gray border */ +/* Add a gray border to the top */ +.border-top { border-top: 1px #e1e4e8 solid !important; } + +/* Add a gray border to the right */ +.border-right { border-right: 1px #e1e4e8 solid !important; } + +/* Add a gray border to the bottom */ +.border-bottom { border-bottom: 1px #e1e4e8 solid !important; } + +/* Add a gray border to the left */ +.border-left { border-left: 1px #e1e4e8 solid !important; } + +/* Remove the top border */ +.border-top-0 { border-top: 0 !important; } + +/* Remove the right border */ +.border-right-0 { border-right: 0 !important; } + +/* Remove the bottom border */ +.border-bottom-0 { border-bottom: 0 !important; } + +/* Remove the left border */ +.border-left-0 { border-left: 0 !important; } + +/* Remove the border-radius */ +.rounded-0 { border-radius: 0 !important; } + +/* Add a border-radius to all corners */ +.rounded-1 { border-radius: 3px !important; } + +/* Add a 2x border-radius to all corners */ +.rounded-2 { border-radius: 6px !important; } + +.rounded-top-0 { border-top-left-radius: 0 !important; border-top-right-radius: 0 !important; } + +.rounded-top-1 { border-top-left-radius: 3px !important; border-top-right-radius: 3px !important; } + +.rounded-top-2 { border-top-left-radius: 6px !important; border-top-right-radius: 6px !important; } + +.rounded-right-0 { border-top-right-radius: 0 !important; border-bottom-right-radius: 0 !important; } + +.rounded-right-1 { border-top-right-radius: 3px !important; border-bottom-right-radius: 3px !important; } + +.rounded-right-2 { border-top-right-radius: 6px !important; border-bottom-right-radius: 6px !important; } + +.rounded-bottom-0 { border-bottom-right-radius: 0 !important; border-bottom-left-radius: 0 !important; } + +.rounded-bottom-1 { border-bottom-right-radius: 3px !important; border-bottom-left-radius: 3px !important; } + +.rounded-bottom-2 { border-bottom-right-radius: 6px !important; border-bottom-left-radius: 6px !important; } + +.rounded-left-0 { border-bottom-left-radius: 0 !important; border-top-left-radius: 0 !important; } + +.rounded-left-1 { border-bottom-left-radius: 3px !important; border-top-left-radius: 3px !important; } + +.rounded-left-2 { border-bottom-left-radius: 6px !important; border-top-left-radius: 6px !important; } + +@media (min-width: 544px) { /* Add a gray border */ + /* Add a gray border to the top */ + .border-sm-top { border-top: 1px #e1e4e8 solid !important; } + /* Add a gray border to the right */ + .border-sm-right { border-right: 1px #e1e4e8 solid !important; } + /* Add a gray border to the bottom */ + .border-sm-bottom { border-bottom: 1px #e1e4e8 solid !important; } + /* Add a gray border to the left */ + .border-sm-left { border-left: 1px #e1e4e8 solid !important; } + /* Remove the top border */ + .border-sm-top-0 { border-top: 0 !important; } + /* Remove the right border */ + .border-sm-right-0 { border-right: 0 !important; } + /* Remove the bottom border */ + .border-sm-bottom-0 { border-bottom: 0 !important; } + /* Remove the left border */ + .border-sm-left-0 { border-left: 0 !important; } + /* Remove the border-radius */ + .rounded-sm-0 { border-radius: 0 !important; } + /* Add a border-radius to all corners */ + .rounded-sm-1 { border-radius: 3px !important; } + /* Add a 2x border-radius to all corners */ + .rounded-sm-2 { border-radius: 6px !important; } + .rounded-sm-top-0 { border-top-left-radius: 0 !important; border-top-right-radius: 0 !important; } + .rounded-sm-top-1 { border-top-left-radius: 3px !important; border-top-right-radius: 3px !important; } + .rounded-sm-top-2 { border-top-left-radius: 6px !important; border-top-right-radius: 6px !important; } + .rounded-sm-right-0 { border-top-right-radius: 0 !important; border-bottom-right-radius: 0 !important; } + .rounded-sm-right-1 { border-top-right-radius: 3px !important; border-bottom-right-radius: 3px !important; } + .rounded-sm-right-2 { border-top-right-radius: 6px !important; border-bottom-right-radius: 6px !important; } + .rounded-sm-bottom-0 { border-bottom-right-radius: 0 !important; border-bottom-left-radius: 0 !important; } + .rounded-sm-bottom-1 { border-bottom-right-radius: 3px !important; border-bottom-left-radius: 3px !important; } + .rounded-sm-bottom-2 { border-bottom-right-radius: 6px !important; border-bottom-left-radius: 6px !important; } + .rounded-sm-left-0 { border-bottom-left-radius: 0 !important; border-top-left-radius: 0 !important; } + .rounded-sm-left-1 { border-bottom-left-radius: 3px !important; border-top-left-radius: 3px !important; } + .rounded-sm-left-2 { border-bottom-left-radius: 6px !important; border-top-left-radius: 6px !important; } } +@media (min-width: 768px) { /* Add a gray border */ + /* Add a gray border to the top */ + .border-md-top { border-top: 1px #e1e4e8 solid !important; } + /* Add a gray border to the right */ + .border-md-right { border-right: 1px #e1e4e8 solid !important; } + /* Add a gray border to the bottom */ + .border-md-bottom { border-bottom: 1px #e1e4e8 solid !important; } + /* Add a gray border to the left */ + .border-md-left { border-left: 1px #e1e4e8 solid !important; } + /* Remove the top border */ + .border-md-top-0 { border-top: 0 !important; } + /* Remove the right border */ + .border-md-right-0 { border-right: 0 !important; } + /* Remove the bottom border */ + .border-md-bottom-0 { border-bottom: 0 !important; } + /* Remove the left border */ + .border-md-left-0 { border-left: 0 !important; } + /* Remove the border-radius */ + .rounded-md-0 { border-radius: 0 !important; } + /* Add a border-radius to all corners */ + .rounded-md-1 { border-radius: 3px !important; } + /* Add a 2x border-radius to all corners */ + .rounded-md-2 { border-radius: 6px !important; } + .rounded-md-top-0 { border-top-left-radius: 0 !important; border-top-right-radius: 0 !important; } + .rounded-md-top-1 { border-top-left-radius: 3px !important; border-top-right-radius: 3px !important; } + .rounded-md-top-2 { border-top-left-radius: 6px !important; border-top-right-radius: 6px !important; } + .rounded-md-right-0 { border-top-right-radius: 0 !important; border-bottom-right-radius: 0 !important; } + .rounded-md-right-1 { border-top-right-radius: 3px !important; border-bottom-right-radius: 3px !important; } + .rounded-md-right-2 { border-top-right-radius: 6px !important; border-bottom-right-radius: 6px !important; } + .rounded-md-bottom-0 { border-bottom-right-radius: 0 !important; border-bottom-left-radius: 0 !important; } + .rounded-md-bottom-1 { border-bottom-right-radius: 3px !important; border-bottom-left-radius: 3px !important; } + .rounded-md-bottom-2 { border-bottom-right-radius: 6px !important; border-bottom-left-radius: 6px !important; } + .rounded-md-left-0 { border-bottom-left-radius: 0 !important; border-top-left-radius: 0 !important; } + .rounded-md-left-1 { border-bottom-left-radius: 3px !important; border-top-left-radius: 3px !important; } + .rounded-md-left-2 { border-bottom-left-radius: 6px !important; border-top-left-radius: 6px !important; } } +@media (min-width: 1012px) { /* Add a gray border */ + /* Add a gray border to the top */ + .border-lg-top { border-top: 1px #e1e4e8 solid !important; } + /* Add a gray border to the right */ + .border-lg-right { border-right: 1px #e1e4e8 solid !important; } + /* Add a gray border to the bottom */ + .border-lg-bottom { border-bottom: 1px #e1e4e8 solid !important; } + /* Add a gray border to the left */ + .border-lg-left { border-left: 1px #e1e4e8 solid !important; } + /* Remove the top border */ + .border-lg-top-0 { border-top: 0 !important; } + /* Remove the right border */ + .border-lg-right-0 { border-right: 0 !important; } + /* Remove the bottom border */ + .border-lg-bottom-0 { border-bottom: 0 !important; } + /* Remove the left border */ + .border-lg-left-0 { border-left: 0 !important; } + /* Remove the border-radius */ + .rounded-lg-0 { border-radius: 0 !important; } + /* Add a border-radius to all corners */ + .rounded-lg-1 { border-radius: 3px !important; } + /* Add a 2x border-radius to all corners */ + .rounded-lg-2 { border-radius: 6px !important; } + .rounded-lg-top-0 { border-top-left-radius: 0 !important; border-top-right-radius: 0 !important; } + .rounded-lg-top-1 { border-top-left-radius: 3px !important; border-top-right-radius: 3px !important; } + .rounded-lg-top-2 { border-top-left-radius: 6px !important; border-top-right-radius: 6px !important; } + .rounded-lg-right-0 { border-top-right-radius: 0 !important; border-bottom-right-radius: 0 !important; } + .rounded-lg-right-1 { border-top-right-radius: 3px !important; border-bottom-right-radius: 3px !important; } + .rounded-lg-right-2 { border-top-right-radius: 6px !important; border-bottom-right-radius: 6px !important; } + .rounded-lg-bottom-0 { border-bottom-right-radius: 0 !important; border-bottom-left-radius: 0 !important; } + .rounded-lg-bottom-1 { border-bottom-right-radius: 3px !important; border-bottom-left-radius: 3px !important; } + .rounded-lg-bottom-2 { border-bottom-right-radius: 6px !important; border-bottom-left-radius: 6px !important; } + .rounded-lg-left-0 { border-bottom-left-radius: 0 !important; border-top-left-radius: 0 !important; } + .rounded-lg-left-1 { border-bottom-left-radius: 3px !important; border-top-left-radius: 3px !important; } + .rounded-lg-left-2 { border-bottom-left-radius: 6px !important; border-top-left-radius: 6px !important; } } +@media (min-width: 1280px) { /* Add a gray border */ + /* Add a gray border to the top */ + .border-xl-top { border-top: 1px #e1e4e8 solid !important; } + /* Add a gray border to the right */ + .border-xl-right { border-right: 1px #e1e4e8 solid !important; } + /* Add a gray border to the bottom */ + .border-xl-bottom { border-bottom: 1px #e1e4e8 solid !important; } + /* Add a gray border to the left */ + .border-xl-left { border-left: 1px #e1e4e8 solid !important; } + /* Remove the top border */ + .border-xl-top-0 { border-top: 0 !important; } + /* Remove the right border */ + .border-xl-right-0 { border-right: 0 !important; } + /* Remove the bottom border */ + .border-xl-bottom-0 { border-bottom: 0 !important; } + /* Remove the left border */ + .border-xl-left-0 { border-left: 0 !important; } + /* Remove the border-radius */ + .rounded-xl-0 { border-radius: 0 !important; } + /* Add a border-radius to all corners */ + .rounded-xl-1 { border-radius: 3px !important; } + /* Add a 2x border-radius to all corners */ + .rounded-xl-2 { border-radius: 6px !important; } + .rounded-xl-top-0 { border-top-left-radius: 0 !important; border-top-right-radius: 0 !important; } + .rounded-xl-top-1 { border-top-left-radius: 3px !important; border-top-right-radius: 3px !important; } + .rounded-xl-top-2 { border-top-left-radius: 6px !important; border-top-right-radius: 6px !important; } + .rounded-xl-right-0 { border-top-right-radius: 0 !important; border-bottom-right-radius: 0 !important; } + .rounded-xl-right-1 { border-top-right-radius: 3px !important; border-bottom-right-radius: 3px !important; } + .rounded-xl-right-2 { border-top-right-radius: 6px !important; border-bottom-right-radius: 6px !important; } + .rounded-xl-bottom-0 { border-bottom-right-radius: 0 !important; border-bottom-left-radius: 0 !important; } + .rounded-xl-bottom-1 { border-bottom-right-radius: 3px !important; border-bottom-left-radius: 3px !important; } + .rounded-xl-bottom-2 { border-bottom-right-radius: 6px !important; border-bottom-left-radius: 6px !important; } + .rounded-xl-left-0 { border-bottom-left-radius: 0 !important; border-top-left-radius: 0 !important; } + .rounded-xl-left-1 { border-bottom-left-radius: 3px !important; border-top-left-radius: 3px !important; } + .rounded-xl-left-2 { border-bottom-left-radius: 6px !important; border-top-left-radius: 6px !important; } } +/* Add a 50% border-radius to make something into a circle */ +.circle { border-radius: 50% !important; } + +.box-shadow { box-shadow: 0 1px 1px rgba(27, 31, 35, 0.1) !important; } + +.box-shadow-medium { box-shadow: 0 1px 5px rgba(27, 31, 35, 0.15) !important; } + +.box-shadow-large { box-shadow: 0 1px 15px rgba(27, 31, 35, 0.15) !important; } + +.box-shadow-extra-large { box-shadow: 0 10px 50px rgba(27, 31, 35, 0.07) !important; } + +.box-shadow-none { box-shadow: none !important; } + +/* Set the background to $bg-white */ +.bg-white { background-color: #fff !important; } + +/* Set the background to $bg-blue */ +.bg-blue { background-color: #0366d6 !important; } + +/* Set the background to $bg-blue-light */ +.bg-blue-light { background-color: #f1f8ff !important; } + +/* Set the background to $bg-gray-dark */ +.bg-gray-dark { background-color: #24292e !important; } + +/* Set the background to $bg-gray */ +.bg-gray { background-color: #f6f8fa !important; } + +/* Set the background to $bg-gray-light */ +.bg-gray-light { background-color: #fafbfc !important; } + +/* Set the background to $bg-green */ +.bg-green { background-color: #28a745 !important; } + +/* Set the background to $bg-green-light */ +.bg-green-light { background-color: #dcffe4 !important; } + +/* Set the background to $bg-red */ +.bg-red { background-color: #d73a49 !important; } + +/* Set the background to $bg-red-light */ +.bg-red-light { background-color: #ffdce0 !important; } + +/* Set the background to $bg-yellow */ +.bg-yellow { background-color: #ffd33d !important; } + +/* Set the background to $bg-yellow-light */ +.bg-yellow-light { background-color: #fff5b1 !important; } + +/* Set the background to $bg-purple */ +.bg-purple { background-color: #6f42c1 !important; } + +/* Set the background to $bg-purple-light */ +.bg-purple-light { background-color: #f5f0ff !important; } + +.bg-shade-gradient { background-image: linear-gradient(180deg, rgba(27, 31, 35, 0.065), rgba(27, 31, 35, 0)) !important; background-repeat: no-repeat !important; background-size: 100% 200px !important; } + +/* Set the text color to $text-blue */ +.text-blue { color: #0366d6 !important; } + +/* Set the text color to $text-red */ +.text-red { color: #cb2431 !important; } + +/* Set the text color to $text-gray-light */ +.text-gray-light { color: #6a737d !important; } + +/* Set the text color to $text-gray */ +.text-gray { color: #586069 !important; } + +/* Set the text color to $text-gray-dark */ +.text-gray-dark { color: #24292e !important; } + +/* Set the text color to $text-green */ +.text-green { color: #28a745 !important; } + +/* Set the text color to $text-orange */ +.text-orange { color: #a04100 !important; } + +/* Set the text color to $text-orange-light */ +.text-orange-light { color: #e36209 !important; } + +/* Set the text color to $text-purple */ +.text-purple { color: #6f42c1 !important; } + +/* Set the text color to $text-white */ +.text-white { color: #fff !important; } + +/* Set the text color to inherit */ +.text-inherit { color: inherit !important; } + +.text-pending { color: #b08800 !important; } + +.bg-pending { color: #dbab09 !important; } + +.link-gray { color: #586069 !important; } +.link-gray:hover { color: #0366d6 !important; } + +.link-gray-dark { color: #24292e !important; } +.link-gray-dark:hover { color: #0366d6 !important; } + +/* Set the link color to $text-blue on hover Useful when you want only part of a link to turn blue on hover */ +.link-hover-blue:hover { color: #0366d6 !important; } + +/* Make a link $text-gray, then $text-blue on hover and removes the underline */ +.muted-link { color: #586069 !important; } +.muted-link:hover { color: #0366d6 !important; text-decoration: none; } + +.details-overlay[open] > summary::before { position: fixed; top: 0; right: 0; bottom: 0; left: 0; z-index: 80; display: block; cursor: default; content: " "; background: transparent; } + +.details-overlay-dark[open] > summary::before { z-index: 99; background: rgba(27, 31, 35, 0.5); } + +.flex-row { flex-direction: row !important; } + +.flex-row-reverse { flex-direction: row-reverse !important; } + +.flex-column { flex-direction: column !important; } + +.flex-wrap { flex-wrap: wrap !important; } + +.flex-nowrap { flex-wrap: nowrap !important; } + +.flex-justify-start { justify-content: flex-start !important; } + +.flex-justify-end { justify-content: flex-end !important; } + +.flex-justify-center { justify-content: center !important; } + +.flex-justify-between { justify-content: space-between !important; } + +.flex-justify-around { justify-content: space-around !important; } + +.flex-items-start { align-items: flex-start !important; } + +.flex-items-end { align-items: flex-end !important; } + +.flex-items-center { align-items: center !important; } + +.flex-items-baseline { align-items: baseline !important; } + +.flex-items-stretch { align-items: stretch !important; } + +.flex-content-start { align-content: flex-start !important; } + +.flex-content-end { align-content: flex-end !important; } + +.flex-content-center { align-content: center !important; } + +.flex-content-between { align-content: space-between !important; } + +.flex-content-around { align-content: space-around !important; } + +.flex-content-stretch { align-content: stretch !important; } + +.flex-auto { flex: 1 1 auto !important; } + +.flex-shrink-0 { flex-shrink: 0 !important; } + +.flex-self-auto { align-self: auto !important; } + +.flex-self-start { align-self: flex-start !important; } + +.flex-self-end { align-self: flex-end !important; } + +.flex-self-center { align-self: center !important; } + +.flex-self-baseline { align-self: baseline !important; } + +.flex-self-stretch { align-self: stretch !important; } + +.flex-item-equal { flex-grow: 1; flex-basis: 0; } + +@media (min-width: 544px) { .flex-sm-row { flex-direction: row !important; } + .flex-sm-row-reverse { flex-direction: row-reverse !important; } + .flex-sm-column { flex-direction: column !important; } + .flex-sm-wrap { flex-wrap: wrap !important; } + .flex-sm-nowrap { flex-wrap: nowrap !important; } + .flex-sm-justify-start { justify-content: flex-start !important; } + .flex-sm-justify-end { justify-content: flex-end !important; } + .flex-sm-justify-center { justify-content: center !important; } + .flex-sm-justify-between { justify-content: space-between !important; } + .flex-sm-justify-around { justify-content: space-around !important; } + .flex-sm-items-start { align-items: flex-start !important; } + .flex-sm-items-end { align-items: flex-end !important; } + .flex-sm-items-center { align-items: center !important; } + .flex-sm-items-baseline { align-items: baseline !important; } + .flex-sm-items-stretch { align-items: stretch !important; } + .flex-sm-content-start { align-content: flex-start !important; } + .flex-sm-content-end { align-content: flex-end !important; } + .flex-sm-content-center { align-content: center !important; } + .flex-sm-content-between { align-content: space-between !important; } + .flex-sm-content-around { align-content: space-around !important; } + .flex-sm-content-stretch { align-content: stretch !important; } + .flex-sm-auto { flex: 1 1 auto !important; } + .flex-sm-shrink-0 { flex-shrink: 0 !important; } + .flex-sm-self-auto { align-self: auto !important; } + .flex-sm-self-start { align-self: flex-start !important; } + .flex-sm-self-end { align-self: flex-end !important; } + .flex-sm-self-center { align-self: center !important; } + .flex-sm-self-baseline { align-self: baseline !important; } + .flex-sm-self-stretch { align-self: stretch !important; } + .flex-sm-item-equal { flex-grow: 1; flex-basis: 0; } } +@media (min-width: 768px) { .flex-md-row { flex-direction: row !important; } + .flex-md-row-reverse { flex-direction: row-reverse !important; } + .flex-md-column { flex-direction: column !important; } + .flex-md-wrap { flex-wrap: wrap !important; } + .flex-md-nowrap { flex-wrap: nowrap !important; } + .flex-md-justify-start { justify-content: flex-start !important; } + .flex-md-justify-end { justify-content: flex-end !important; } + .flex-md-justify-center { justify-content: center !important; } + .flex-md-justify-between { justify-content: space-between !important; } + .flex-md-justify-around { justify-content: space-around !important; } + .flex-md-items-start { align-items: flex-start !important; } + .flex-md-items-end { align-items: flex-end !important; } + .flex-md-items-center { align-items: center !important; } + .flex-md-items-baseline { align-items: baseline !important; } + .flex-md-items-stretch { align-items: stretch !important; } + .flex-md-content-start { align-content: flex-start !important; } + .flex-md-content-end { align-content: flex-end !important; } + .flex-md-content-center { align-content: center !important; } + .flex-md-content-between { align-content: space-between !important; } + .flex-md-content-around { align-content: space-around !important; } + .flex-md-content-stretch { align-content: stretch !important; } + .flex-md-auto { flex: 1 1 auto !important; } + .flex-md-shrink-0 { flex-shrink: 0 !important; } + .flex-md-self-auto { align-self: auto !important; } + .flex-md-self-start { align-self: flex-start !important; } + .flex-md-self-end { align-self: flex-end !important; } + .flex-md-self-center { align-self: center !important; } + .flex-md-self-baseline { align-self: baseline !important; } + .flex-md-self-stretch { align-self: stretch !important; } + .flex-md-item-equal { flex-grow: 1; flex-basis: 0; } } +@media (min-width: 1012px) { .flex-lg-row { flex-direction: row !important; } + .flex-lg-row-reverse { flex-direction: row-reverse !important; } + .flex-lg-column { flex-direction: column !important; } + .flex-lg-wrap { flex-wrap: wrap !important; } + .flex-lg-nowrap { flex-wrap: nowrap !important; } + .flex-lg-justify-start { justify-content: flex-start !important; } + .flex-lg-justify-end { justify-content: flex-end !important; } + .flex-lg-justify-center { justify-content: center !important; } + .flex-lg-justify-between { justify-content: space-between !important; } + .flex-lg-justify-around { justify-content: space-around !important; } + .flex-lg-items-start { align-items: flex-start !important; } + .flex-lg-items-end { align-items: flex-end !important; } + .flex-lg-items-center { align-items: center !important; } + .flex-lg-items-baseline { align-items: baseline !important; } + .flex-lg-items-stretch { align-items: stretch !important; } + .flex-lg-content-start { align-content: flex-start !important; } + .flex-lg-content-end { align-content: flex-end !important; } + .flex-lg-content-center { align-content: center !important; } + .flex-lg-content-between { align-content: space-between !important; } + .flex-lg-content-around { align-content: space-around !important; } + .flex-lg-content-stretch { align-content: stretch !important; } + .flex-lg-auto { flex: 1 1 auto !important; } + .flex-lg-shrink-0 { flex-shrink: 0 !important; } + .flex-lg-self-auto { align-self: auto !important; } + .flex-lg-self-start { align-self: flex-start !important; } + .flex-lg-self-end { align-self: flex-end !important; } + .flex-lg-self-center { align-self: center !important; } + .flex-lg-self-baseline { align-self: baseline !important; } + .flex-lg-self-stretch { align-self: stretch !important; } + .flex-lg-item-equal { flex-grow: 1; flex-basis: 0; } } +@media (min-width: 1280px) { .flex-xl-row { flex-direction: row !important; } + .flex-xl-row-reverse { flex-direction: row-reverse !important; } + .flex-xl-column { flex-direction: column !important; } + .flex-xl-wrap { flex-wrap: wrap !important; } + .flex-xl-nowrap { flex-wrap: nowrap !important; } + .flex-xl-justify-start { justify-content: flex-start !important; } + .flex-xl-justify-end { justify-content: flex-end !important; } + .flex-xl-justify-center { justify-content: center !important; } + .flex-xl-justify-between { justify-content: space-between !important; } + .flex-xl-justify-around { justify-content: space-around !important; } + .flex-xl-items-start { align-items: flex-start !important; } + .flex-xl-items-end { align-items: flex-end !important; } + .flex-xl-items-center { align-items: center !important; } + .flex-xl-items-baseline { align-items: baseline !important; } + .flex-xl-items-stretch { align-items: stretch !important; } + .flex-xl-content-start { align-content: flex-start !important; } + .flex-xl-content-end { align-content: flex-end !important; } + .flex-xl-content-center { align-content: center !important; } + .flex-xl-content-between { align-content: space-between !important; } + .flex-xl-content-around { align-content: space-around !important; } + .flex-xl-content-stretch { align-content: stretch !important; } + .flex-xl-auto { flex: 1 1 auto !important; } + .flex-xl-shrink-0 { flex-shrink: 0 !important; } + .flex-xl-self-auto { align-self: auto !important; } + .flex-xl-self-start { align-self: flex-start !important; } + .flex-xl-self-end { align-self: flex-end !important; } + .flex-xl-self-center { align-self: center !important; } + .flex-xl-self-baseline { align-self: baseline !important; } + .flex-xl-self-stretch { align-self: stretch !important; } + .flex-xl-item-equal { flex-grow: 1; flex-basis: 0; } } +/* Set position to static */ +.position-static { position: static !important; } + +/* Set position to relative */ +.position-relative { position: relative !important; } + +/* Set position to absolute */ +.position-absolute { position: absolute !important; } + +/* Set position to fixed */ +.position-fixed { position: fixed !important; } + +/* Set top 0 */ +.top-0 { top: 0 !important; } + +/* Set right 0 */ +.right-0 { right: 0 !important; } + +/* Set bottom 0 */ +.bottom-0 { bottom: 0 !important; } + +/* Set left 0 */ +.left-0 { left: 0 !important; } + +/* Vertical align middle */ +.v-align-middle { vertical-align: middle !important; } + +/* Vertical align top */ +.v-align-top { vertical-align: top !important; } + +/* Vertical align bottom */ +.v-align-bottom { vertical-align: bottom !important; } + +/* Vertical align to the top of the text */ +.v-align-text-top { vertical-align: text-top !important; } + +/* Vertical align to the bottom of the text */ +.v-align-text-bottom { vertical-align: text-bottom !important; } + +/* Vertical align to the parent's baseline */ +.v-align-baseline { vertical-align: baseline !important; } + +/* Set the overflow hidden */ +.overflow-hidden { overflow: hidden !important; } + +/* Set the overflow scroll */ +.overflow-scroll { overflow: scroll !important; } + +/* Set the overflow auto */ +.overflow-auto { overflow: auto !important; } + +/* Clear floats around the element */ +.clearfix::before { display: table; content: ""; } +.clearfix::after { display: table; clear: both; content: ""; } + +/* Float to the left */ +.float-left { float: left !important; } + +/* Float to the right */ +.float-right { float: right !important; } + +/* No float */ +.float-none { float: none !important; } + +@media (min-width: 544px) { /* Float to the left */ + .float-sm-left { float: left !important; } + /* Float to the right */ + .float-sm-right { float: right !important; } + /* No float */ + .float-sm-none { float: none !important; } } +@media (min-width: 768px) { /* Float to the left */ + .float-md-left { float: left !important; } + /* Float to the right */ + .float-md-right { float: right !important; } + /* No float */ + .float-md-none { float: none !important; } } +@media (min-width: 1012px) { /* Float to the left */ + .float-lg-left { float: left !important; } + /* Float to the right */ + .float-lg-right { float: right !important; } + /* No float */ + .float-lg-none { float: none !important; } } +@media (min-width: 1280px) { /* Float to the left */ + .float-xl-left { float: left !important; } + /* Float to the right */ + .float-xl-right { float: right !important; } + /* No float */ + .float-xl-none { float: none !important; } } +/* Max width 100% */ +.width-fit { max-width: 100% !important; } + +/* Set the width to 100% */ +.width-full { width: 100% !important; } + +/* Max height 100% */ +.height-fit { max-height: 100% !important; } + +/* Set the height to 100% */ +.height-full { height: 100% !important; } + +/* Remove min-width from element */ +.min-width-0 { min-width: 0 !important; } + +/* Set the direction to rtl */ +.direction-rtl { direction: rtl !important; } + +/* Set the direction to ltr */ +.direction-ltr { direction: ltr !important; } + +@media (min-width: 544px) { /* Set the direction to rtl */ + .direction-sm-rtl { direction: rtl !important; } + /* Set the direction to ltr */ + .direction-sm-ltr { direction: ltr !important; } } +@media (min-width: 768px) { /* Set the direction to rtl */ + .direction-md-rtl { direction: rtl !important; } + /* Set the direction to ltr */ + .direction-md-ltr { direction: ltr !important; } } +@media (min-width: 1012px) { /* Set the direction to rtl */ + .direction-lg-rtl { direction: rtl !important; } + /* Set the direction to ltr */ + .direction-lg-ltr { direction: ltr !important; } } +@media (min-width: 1280px) { /* Set the direction to rtl */ + .direction-xl-rtl { direction: rtl !important; } + /* Set the direction to ltr */ + .direction-xl-ltr { direction: ltr !important; } } +/* Set a $size margin to all sides at $breakpoint */ +.m-0 { margin: 0 !important; } + +/* Set a $size margin on the top at $breakpoint */ +.mt-0 { margin-top: 0 !important; } + +/* Set a $size margin on the right at $breakpoint */ +.mr-0 { margin-right: 0 !important; } + +/* Set a $size margin on the bottom at $breakpoint */ +.mb-0 { margin-bottom: 0 !important; } + +/* Set a $size margin on the left at $breakpoint */ +.ml-0 { margin-left: 0 !important; } + +/* Set a $size margin on the left & right at $breakpoint */ +.mx-0 { margin-right: 0 !important; margin-left: 0 !important; } + +/* Set a $size margin on the top & bottom at $breakpoint */ +.my-0 { margin-top: 0 !important; margin-bottom: 0 !important; } + +/* Set a $size margin to all sides at $breakpoint */ +.m-1 { margin: 4px !important; } + +/* Set a $size margin on the top at $breakpoint */ +.mt-1 { margin-top: 4px !important; } + +/* Set a $size margin on the right at $breakpoint */ +.mr-1 { margin-right: 4px !important; } + +/* Set a $size margin on the bottom at $breakpoint */ +.mb-1 { margin-bottom: 4px !important; } + +/* Set a $size margin on the left at $breakpoint */ +.ml-1 { margin-left: 4px !important; } + +/* Set a negative $size margin on top at $breakpoint */ +.mt-n1 { margin-top: -4px !important; } + +/* Set a negative $size margin on the right at $breakpoint */ +.mr-n1 { margin-right: -4px !important; } + +/* Set a negative $size margin on the bottom at $breakpoint */ +.mb-n1 { margin-bottom: -4px !important; } + +/* Set a negative $size margin on the left at $breakpoint */ +.ml-n1 { margin-left: -4px !important; } + +/* Set a $size margin on the left & right at $breakpoint */ +.mx-1 { margin-right: 4px !important; margin-left: 4px !important; } + +/* Set a $size margin on the top & bottom at $breakpoint */ +.my-1 { margin-top: 4px !important; margin-bottom: 4px !important; } + +/* Set a $size margin to all sides at $breakpoint */ +.m-2 { margin: 8px !important; } + +/* Set a $size margin on the top at $breakpoint */ +.mt-2 { margin-top: 8px !important; } + +/* Set a $size margin on the right at $breakpoint */ +.mr-2 { margin-right: 8px !important; } + +/* Set a $size margin on the bottom at $breakpoint */ +.mb-2 { margin-bottom: 8px !important; } + +/* Set a $size margin on the left at $breakpoint */ +.ml-2 { margin-left: 8px !important; } + +/* Set a negative $size margin on top at $breakpoint */ +.mt-n2 { margin-top: -8px !important; } + +/* Set a negative $size margin on the right at $breakpoint */ +.mr-n2 { margin-right: -8px !important; } + +/* Set a negative $size margin on the bottom at $breakpoint */ +.mb-n2 { margin-bottom: -8px !important; } + +/* Set a negative $size margin on the left at $breakpoint */ +.ml-n2 { margin-left: -8px !important; } + +/* Set a $size margin on the left & right at $breakpoint */ +.mx-2 { margin-right: 8px !important; margin-left: 8px !important; } + +/* Set a $size margin on the top & bottom at $breakpoint */ +.my-2 { margin-top: 8px !important; margin-bottom: 8px !important; } + +/* Set a $size margin to all sides at $breakpoint */ +.m-3 { margin: 16px !important; } + +/* Set a $size margin on the top at $breakpoint */ +.mt-3 { margin-top: 16px !important; } + +/* Set a $size margin on the right at $breakpoint */ +.mr-3 { margin-right: 16px !important; } + +/* Set a $size margin on the bottom at $breakpoint */ +.mb-3 { margin-bottom: 16px !important; } + +/* Set a $size margin on the left at $breakpoint */ +.ml-3 { margin-left: 16px !important; } + +/* Set a negative $size margin on top at $breakpoint */ +.mt-n3 { margin-top: -16px !important; } + +/* Set a negative $size margin on the right at $breakpoint */ +.mr-n3 { margin-right: -16px !important; } + +/* Set a negative $size margin on the bottom at $breakpoint */ +.mb-n3 { margin-bottom: -16px !important; } + +/* Set a negative $size margin on the left at $breakpoint */ +.ml-n3 { margin-left: -16px !important; } + +/* Set a $size margin on the left & right at $breakpoint */ +.mx-3 { margin-right: 16px !important; margin-left: 16px !important; } + +/* Set a $size margin on the top & bottom at $breakpoint */ +.my-3 { margin-top: 16px !important; margin-bottom: 16px !important; } + +/* Set a $size margin to all sides at $breakpoint */ +.m-4 { margin: 24px !important; } + +/* Set a $size margin on the top at $breakpoint */ +.mt-4 { margin-top: 24px !important; } + +/* Set a $size margin on the right at $breakpoint */ +.mr-4 { margin-right: 24px !important; } + +/* Set a $size margin on the bottom at $breakpoint */ +.mb-4 { margin-bottom: 24px !important; } + +/* Set a $size margin on the left at $breakpoint */ +.ml-4 { margin-left: 24px !important; } + +/* Set a negative $size margin on top at $breakpoint */ +.mt-n4 { margin-top: -24px !important; } + +/* Set a negative $size margin on the right at $breakpoint */ +.mr-n4 { margin-right: -24px !important; } + +/* Set a negative $size margin on the bottom at $breakpoint */ +.mb-n4 { margin-bottom: -24px !important; } + +/* Set a negative $size margin on the left at $breakpoint */ +.ml-n4 { margin-left: -24px !important; } + +/* Set a $size margin on the left & right at $breakpoint */ +.mx-4 { margin-right: 24px !important; margin-left: 24px !important; } + +/* Set a $size margin on the top & bottom at $breakpoint */ +.my-4 { margin-top: 24px !important; margin-bottom: 24px !important; } + +/* Set a $size margin to all sides at $breakpoint */ +.m-5 { margin: 32px !important; } + +/* Set a $size margin on the top at $breakpoint */ +.mt-5 { margin-top: 32px !important; } + +/* Set a $size margin on the right at $breakpoint */ +.mr-5 { margin-right: 32px !important; } + +/* Set a $size margin on the bottom at $breakpoint */ +.mb-5 { margin-bottom: 32px !important; } + +/* Set a $size margin on the left at $breakpoint */ +.ml-5 { margin-left: 32px !important; } + +/* Set a negative $size margin on top at $breakpoint */ +.mt-n5 { margin-top: -32px !important; } + +/* Set a negative $size margin on the right at $breakpoint */ +.mr-n5 { margin-right: -32px !important; } + +/* Set a negative $size margin on the bottom at $breakpoint */ +.mb-n5 { margin-bottom: -32px !important; } + +/* Set a negative $size margin on the left at $breakpoint */ +.ml-n5 { margin-left: -32px !important; } + +/* Set a $size margin on the left & right at $breakpoint */ +.mx-5 { margin-right: 32px !important; margin-left: 32px !important; } + +/* Set a $size margin on the top & bottom at $breakpoint */ +.my-5 { margin-top: 32px !important; margin-bottom: 32px !important; } + +/* Set a $size margin to all sides at $breakpoint */ +.m-6 { margin: 40px !important; } + +/* Set a $size margin on the top at $breakpoint */ +.mt-6 { margin-top: 40px !important; } + +/* Set a $size margin on the right at $breakpoint */ +.mr-6 { margin-right: 40px !important; } + +/* Set a $size margin on the bottom at $breakpoint */ +.mb-6 { margin-bottom: 40px !important; } + +/* Set a $size margin on the left at $breakpoint */ +.ml-6 { margin-left: 40px !important; } + +/* Set a negative $size margin on top at $breakpoint */ +.mt-n6 { margin-top: -40px !important; } + +/* Set a negative $size margin on the right at $breakpoint */ +.mr-n6 { margin-right: -40px !important; } + +/* Set a negative $size margin on the bottom at $breakpoint */ +.mb-n6 { margin-bottom: -40px !important; } + +/* Set a negative $size margin on the left at $breakpoint */ +.ml-n6 { margin-left: -40px !important; } + +/* Set a $size margin on the left & right at $breakpoint */ +.mx-6 { margin-right: 40px !important; margin-left: 40px !important; } + +/* Set a $size margin on the top & bottom at $breakpoint */ +.my-6 { margin-top: 40px !important; margin-bottom: 40px !important; } + +/* responsive horizontal auto margins */ +.mx-auto { margin-right: auto !important; margin-left: auto !important; } + +@media (min-width: 544px) { /* Set a $size margin to all sides at $breakpoint */ + .m-sm-0 { margin: 0 !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-sm-0 { margin-top: 0 !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-sm-0 { margin-right: 0 !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-sm-0 { margin-bottom: 0 !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-sm-0 { margin-left: 0 !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-sm-0 { margin-right: 0 !important; margin-left: 0 !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-sm-0 { margin-top: 0 !important; margin-bottom: 0 !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-sm-1 { margin: 4px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-sm-1 { margin-top: 4px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-sm-1 { margin-right: 4px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-sm-1 { margin-bottom: 4px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-sm-1 { margin-left: 4px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-sm-n1 { margin-top: -4px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-sm-n1 { margin-right: -4px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-sm-n1 { margin-bottom: -4px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-sm-n1 { margin-left: -4px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-sm-1 { margin-right: 4px !important; margin-left: 4px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-sm-1 { margin-top: 4px !important; margin-bottom: 4px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-sm-2 { margin: 8px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-sm-2 { margin-top: 8px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-sm-2 { margin-right: 8px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-sm-2 { margin-bottom: 8px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-sm-2 { margin-left: 8px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-sm-n2 { margin-top: -8px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-sm-n2 { margin-right: -8px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-sm-n2 { margin-bottom: -8px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-sm-n2 { margin-left: -8px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-sm-2 { margin-right: 8px !important; margin-left: 8px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-sm-2 { margin-top: 8px !important; margin-bottom: 8px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-sm-3 { margin: 16px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-sm-3 { margin-top: 16px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-sm-3 { margin-right: 16px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-sm-3 { margin-bottom: 16px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-sm-3 { margin-left: 16px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-sm-n3 { margin-top: -16px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-sm-n3 { margin-right: -16px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-sm-n3 { margin-bottom: -16px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-sm-n3 { margin-left: -16px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-sm-3 { margin-right: 16px !important; margin-left: 16px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-sm-3 { margin-top: 16px !important; margin-bottom: 16px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-sm-4 { margin: 24px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-sm-4 { margin-top: 24px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-sm-4 { margin-right: 24px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-sm-4 { margin-bottom: 24px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-sm-4 { margin-left: 24px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-sm-n4 { margin-top: -24px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-sm-n4 { margin-right: -24px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-sm-n4 { margin-bottom: -24px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-sm-n4 { margin-left: -24px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-sm-4 { margin-right: 24px !important; margin-left: 24px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-sm-4 { margin-top: 24px !important; margin-bottom: 24px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-sm-5 { margin: 32px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-sm-5 { margin-top: 32px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-sm-5 { margin-right: 32px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-sm-5 { margin-bottom: 32px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-sm-5 { margin-left: 32px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-sm-n5 { margin-top: -32px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-sm-n5 { margin-right: -32px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-sm-n5 { margin-bottom: -32px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-sm-n5 { margin-left: -32px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-sm-5 { margin-right: 32px !important; margin-left: 32px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-sm-5 { margin-top: 32px !important; margin-bottom: 32px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-sm-6 { margin: 40px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-sm-6 { margin-top: 40px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-sm-6 { margin-right: 40px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-sm-6 { margin-bottom: 40px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-sm-6 { margin-left: 40px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-sm-n6 { margin-top: -40px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-sm-n6 { margin-right: -40px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-sm-n6 { margin-bottom: -40px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-sm-n6 { margin-left: -40px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-sm-6 { margin-right: 40px !important; margin-left: 40px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-sm-6 { margin-top: 40px !important; margin-bottom: 40px !important; } + /* responsive horizontal auto margins */ + .mx-sm-auto { margin-right: auto !important; margin-left: auto !important; } } +@media (min-width: 768px) { /* Set a $size margin to all sides at $breakpoint */ + .m-md-0 { margin: 0 !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-md-0 { margin-top: 0 !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-md-0 { margin-right: 0 !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-md-0 { margin-bottom: 0 !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-md-0 { margin-left: 0 !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-md-0 { margin-right: 0 !important; margin-left: 0 !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-md-0 { margin-top: 0 !important; margin-bottom: 0 !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-md-1 { margin: 4px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-md-1 { margin-top: 4px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-md-1 { margin-right: 4px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-md-1 { margin-bottom: 4px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-md-1 { margin-left: 4px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-md-n1 { margin-top: -4px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-md-n1 { margin-right: -4px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-md-n1 { margin-bottom: -4px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-md-n1 { margin-left: -4px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-md-1 { margin-right: 4px !important; margin-left: 4px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-md-1 { margin-top: 4px !important; margin-bottom: 4px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-md-2 { margin: 8px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-md-2 { margin-top: 8px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-md-2 { margin-right: 8px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-md-2 { margin-bottom: 8px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-md-2 { margin-left: 8px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-md-n2 { margin-top: -8px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-md-n2 { margin-right: -8px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-md-n2 { margin-bottom: -8px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-md-n2 { margin-left: -8px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-md-2 { margin-right: 8px !important; margin-left: 8px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-md-2 { margin-top: 8px !important; margin-bottom: 8px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-md-3 { margin: 16px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-md-3 { margin-top: 16px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-md-3 { margin-right: 16px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-md-3 { margin-bottom: 16px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-md-3 { margin-left: 16px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-md-n3 { margin-top: -16px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-md-n3 { margin-right: -16px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-md-n3 { margin-bottom: -16px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-md-n3 { margin-left: -16px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-md-3 { margin-right: 16px !important; margin-left: 16px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-md-3 { margin-top: 16px !important; margin-bottom: 16px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-md-4 { margin: 24px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-md-4 { margin-top: 24px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-md-4 { margin-right: 24px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-md-4 { margin-bottom: 24px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-md-4 { margin-left: 24px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-md-n4 { margin-top: -24px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-md-n4 { margin-right: -24px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-md-n4 { margin-bottom: -24px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-md-n4 { margin-left: -24px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-md-4 { margin-right: 24px !important; margin-left: 24px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-md-4 { margin-top: 24px !important; margin-bottom: 24px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-md-5 { margin: 32px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-md-5 { margin-top: 32px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-md-5 { margin-right: 32px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-md-5 { margin-bottom: 32px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-md-5 { margin-left: 32px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-md-n5 { margin-top: -32px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-md-n5 { margin-right: -32px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-md-n5 { margin-bottom: -32px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-md-n5 { margin-left: -32px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-md-5 { margin-right: 32px !important; margin-left: 32px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-md-5 { margin-top: 32px !important; margin-bottom: 32px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-md-6 { margin: 40px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-md-6 { margin-top: 40px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-md-6 { margin-right: 40px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-md-6 { margin-bottom: 40px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-md-6 { margin-left: 40px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-md-n6 { margin-top: -40px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-md-n6 { margin-right: -40px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-md-n6 { margin-bottom: -40px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-md-n6 { margin-left: -40px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-md-6 { margin-right: 40px !important; margin-left: 40px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-md-6 { margin-top: 40px !important; margin-bottom: 40px !important; } + /* responsive horizontal auto margins */ + .mx-md-auto { margin-right: auto !important; margin-left: auto !important; } } +@media (min-width: 1012px) { /* Set a $size margin to all sides at $breakpoint */ + .m-lg-0 { margin: 0 !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-lg-0 { margin-top: 0 !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-lg-0 { margin-right: 0 !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-lg-0 { margin-bottom: 0 !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-lg-0 { margin-left: 0 !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-lg-0 { margin-right: 0 !important; margin-left: 0 !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-lg-0 { margin-top: 0 !important; margin-bottom: 0 !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-lg-1 { margin: 4px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-lg-1 { margin-top: 4px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-lg-1 { margin-right: 4px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-lg-1 { margin-bottom: 4px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-lg-1 { margin-left: 4px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-lg-n1 { margin-top: -4px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-lg-n1 { margin-right: -4px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-lg-n1 { margin-bottom: -4px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-lg-n1 { margin-left: -4px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-lg-1 { margin-right: 4px !important; margin-left: 4px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-lg-1 { margin-top: 4px !important; margin-bottom: 4px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-lg-2 { margin: 8px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-lg-2 { margin-top: 8px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-lg-2 { margin-right: 8px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-lg-2 { margin-bottom: 8px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-lg-2 { margin-left: 8px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-lg-n2 { margin-top: -8px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-lg-n2 { margin-right: -8px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-lg-n2 { margin-bottom: -8px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-lg-n2 { margin-left: -8px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-lg-2 { margin-right: 8px !important; margin-left: 8px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-lg-2 { margin-top: 8px !important; margin-bottom: 8px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-lg-3 { margin: 16px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-lg-3 { margin-top: 16px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-lg-3 { margin-right: 16px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-lg-3 { margin-bottom: 16px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-lg-3 { margin-left: 16px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-lg-n3 { margin-top: -16px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-lg-n3 { margin-right: -16px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-lg-n3 { margin-bottom: -16px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-lg-n3 { margin-left: -16px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-lg-3 { margin-right: 16px !important; margin-left: 16px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-lg-3 { margin-top: 16px !important; margin-bottom: 16px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-lg-4 { margin: 24px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-lg-4 { margin-top: 24px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-lg-4 { margin-right: 24px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-lg-4 { margin-bottom: 24px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-lg-4 { margin-left: 24px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-lg-n4 { margin-top: -24px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-lg-n4 { margin-right: -24px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-lg-n4 { margin-bottom: -24px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-lg-n4 { margin-left: -24px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-lg-4 { margin-right: 24px !important; margin-left: 24px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-lg-4 { margin-top: 24px !important; margin-bottom: 24px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-lg-5 { margin: 32px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-lg-5 { margin-top: 32px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-lg-5 { margin-right: 32px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-lg-5 { margin-bottom: 32px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-lg-5 { margin-left: 32px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-lg-n5 { margin-top: -32px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-lg-n5 { margin-right: -32px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-lg-n5 { margin-bottom: -32px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-lg-n5 { margin-left: -32px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-lg-5 { margin-right: 32px !important; margin-left: 32px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-lg-5 { margin-top: 32px !important; margin-bottom: 32px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-lg-6 { margin: 40px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-lg-6 { margin-top: 40px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-lg-6 { margin-right: 40px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-lg-6 { margin-bottom: 40px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-lg-6 { margin-left: 40px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-lg-n6 { margin-top: -40px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-lg-n6 { margin-right: -40px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-lg-n6 { margin-bottom: -40px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-lg-n6 { margin-left: -40px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-lg-6 { margin-right: 40px !important; margin-left: 40px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-lg-6 { margin-top: 40px !important; margin-bottom: 40px !important; } + /* responsive horizontal auto margins */ + .mx-lg-auto { margin-right: auto !important; margin-left: auto !important; } } +@media (min-width: 1280px) { /* Set a $size margin to all sides at $breakpoint */ + .m-xl-0 { margin: 0 !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-xl-0 { margin-top: 0 !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-xl-0 { margin-right: 0 !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-xl-0 { margin-bottom: 0 !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-xl-0 { margin-left: 0 !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-xl-0 { margin-right: 0 !important; margin-left: 0 !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-xl-0 { margin-top: 0 !important; margin-bottom: 0 !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-xl-1 { margin: 4px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-xl-1 { margin-top: 4px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-xl-1 { margin-right: 4px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-xl-1 { margin-bottom: 4px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-xl-1 { margin-left: 4px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-xl-n1 { margin-top: -4px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-xl-n1 { margin-right: -4px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-xl-n1 { margin-bottom: -4px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-xl-n1 { margin-left: -4px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-xl-1 { margin-right: 4px !important; margin-left: 4px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-xl-1 { margin-top: 4px !important; margin-bottom: 4px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-xl-2 { margin: 8px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-xl-2 { margin-top: 8px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-xl-2 { margin-right: 8px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-xl-2 { margin-bottom: 8px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-xl-2 { margin-left: 8px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-xl-n2 { margin-top: -8px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-xl-n2 { margin-right: -8px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-xl-n2 { margin-bottom: -8px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-xl-n2 { margin-left: -8px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-xl-2 { margin-right: 8px !important; margin-left: 8px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-xl-2 { margin-top: 8px !important; margin-bottom: 8px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-xl-3 { margin: 16px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-xl-3 { margin-top: 16px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-xl-3 { margin-right: 16px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-xl-3 { margin-bottom: 16px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-xl-3 { margin-left: 16px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-xl-n3 { margin-top: -16px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-xl-n3 { margin-right: -16px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-xl-n3 { margin-bottom: -16px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-xl-n3 { margin-left: -16px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-xl-3 { margin-right: 16px !important; margin-left: 16px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-xl-3 { margin-top: 16px !important; margin-bottom: 16px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-xl-4 { margin: 24px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-xl-4 { margin-top: 24px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-xl-4 { margin-right: 24px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-xl-4 { margin-bottom: 24px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-xl-4 { margin-left: 24px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-xl-n4 { margin-top: -24px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-xl-n4 { margin-right: -24px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-xl-n4 { margin-bottom: -24px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-xl-n4 { margin-left: -24px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-xl-4 { margin-right: 24px !important; margin-left: 24px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-xl-4 { margin-top: 24px !important; margin-bottom: 24px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-xl-5 { margin: 32px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-xl-5 { margin-top: 32px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-xl-5 { margin-right: 32px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-xl-5 { margin-bottom: 32px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-xl-5 { margin-left: 32px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-xl-n5 { margin-top: -32px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-xl-n5 { margin-right: -32px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-xl-n5 { margin-bottom: -32px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-xl-n5 { margin-left: -32px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-xl-5 { margin-right: 32px !important; margin-left: 32px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-xl-5 { margin-top: 32px !important; margin-bottom: 32px !important; } + /* Set a $size margin to all sides at $breakpoint */ + .m-xl-6 { margin: 40px !important; } + /* Set a $size margin on the top at $breakpoint */ + .mt-xl-6 { margin-top: 40px !important; } + /* Set a $size margin on the right at $breakpoint */ + .mr-xl-6 { margin-right: 40px !important; } + /* Set a $size margin on the bottom at $breakpoint */ + .mb-xl-6 { margin-bottom: 40px !important; } + /* Set a $size margin on the left at $breakpoint */ + .ml-xl-6 { margin-left: 40px !important; } + /* Set a negative $size margin on top at $breakpoint */ + .mt-xl-n6 { margin-top: -40px !important; } + /* Set a negative $size margin on the right at $breakpoint */ + .mr-xl-n6 { margin-right: -40px !important; } + /* Set a negative $size margin on the bottom at $breakpoint */ + .mb-xl-n6 { margin-bottom: -40px !important; } + /* Set a negative $size margin on the left at $breakpoint */ + .ml-xl-n6 { margin-left: -40px !important; } + /* Set a $size margin on the left & right at $breakpoint */ + .mx-xl-6 { margin-right: 40px !important; margin-left: 40px !important; } + /* Set a $size margin on the top & bottom at $breakpoint */ + .my-xl-6 { margin-top: 40px !important; margin-bottom: 40px !important; } + /* responsive horizontal auto margins */ + .mx-xl-auto { margin-right: auto !important; margin-left: auto !important; } } +/* Set a $size padding to all sides at $breakpoint */ +.p-0 { padding: 0 !important; } + +/* Set a $size padding to the top at $breakpoint */ +.pt-0 { padding-top: 0 !important; } + +/* Set a $size padding to the right at $breakpoint */ +.pr-0 { padding-right: 0 !important; } + +/* Set a $size padding to the bottom at $breakpoint */ +.pb-0 { padding-bottom: 0 !important; } + +/* Set a $size padding to the left at $breakpoint */ +.pl-0 { padding-left: 0 !important; } + +/* Set a $size padding to the left & right at $breakpoint */ +.px-0 { padding-right: 0 !important; padding-left: 0 !important; } + +/* Set a $size padding to the top & bottom at $breakpoint */ +.py-0 { padding-top: 0 !important; padding-bottom: 0 !important; } + +/* Set a $size padding to all sides at $breakpoint */ +.p-1 { padding: 4px !important; } + +/* Set a $size padding to the top at $breakpoint */ +.pt-1 { padding-top: 4px !important; } + +/* Set a $size padding to the right at $breakpoint */ +.pr-1 { padding-right: 4px !important; } + +/* Set a $size padding to the bottom at $breakpoint */ +.pb-1 { padding-bottom: 4px !important; } + +/* Set a $size padding to the left at $breakpoint */ +.pl-1 { padding-left: 4px !important; } + +/* Set a $size padding to the left & right at $breakpoint */ +.px-1 { padding-right: 4px !important; padding-left: 4px !important; } + +/* Set a $size padding to the top & bottom at $breakpoint */ +.py-1 { padding-top: 4px !important; padding-bottom: 4px !important; } + +/* Set a $size padding to all sides at $breakpoint */ +.p-2 { padding: 8px !important; } + +/* Set a $size padding to the top at $breakpoint */ +.pt-2 { padding-top: 8px !important; } + +/* Set a $size padding to the right at $breakpoint */ +.pr-2 { padding-right: 8px !important; } + +/* Set a $size padding to the bottom at $breakpoint */ +.pb-2 { padding-bottom: 8px !important; } + +/* Set a $size padding to the left at $breakpoint */ +.pl-2 { padding-left: 8px !important; } + +/* Set a $size padding to the left & right at $breakpoint */ +.px-2 { padding-right: 8px !important; padding-left: 8px !important; } + +/* Set a $size padding to the top & bottom at $breakpoint */ +.py-2 { padding-top: 8px !important; padding-bottom: 8px !important; } + +/* Set a $size padding to all sides at $breakpoint */ +.p-3 { padding: 16px !important; } + +/* Set a $size padding to the top at $breakpoint */ +.pt-3 { padding-top: 16px !important; } + +/* Set a $size padding to the right at $breakpoint */ +.pr-3 { padding-right: 16px !important; } + +/* Set a $size padding to the bottom at $breakpoint */ +.pb-3 { padding-bottom: 16px !important; } + +/* Set a $size padding to the left at $breakpoint */ +.pl-3 { padding-left: 16px !important; } + +/* Set a $size padding to the left & right at $breakpoint */ +.px-3 { padding-right: 16px !important; padding-left: 16px !important; } + +/* Set a $size padding to the top & bottom at $breakpoint */ +.py-3 { padding-top: 16px !important; padding-bottom: 16px !important; } + +/* Set a $size padding to all sides at $breakpoint */ +.p-4 { padding: 24px !important; } + +/* Set a $size padding to the top at $breakpoint */ +.pt-4 { padding-top: 24px !important; } + +/* Set a $size padding to the right at $breakpoint */ +.pr-4 { padding-right: 24px !important; } + +/* Set a $size padding to the bottom at $breakpoint */ +.pb-4 { padding-bottom: 24px !important; } + +/* Set a $size padding to the left at $breakpoint */ +.pl-4 { padding-left: 24px !important; } + +/* Set a $size padding to the left & right at $breakpoint */ +.px-4 { padding-right: 24px !important; padding-left: 24px !important; } + +/* Set a $size padding to the top & bottom at $breakpoint */ +.py-4 { padding-top: 24px !important; padding-bottom: 24px !important; } + +/* Set a $size padding to all sides at $breakpoint */ +.p-5 { padding: 32px !important; } + +/* Set a $size padding to the top at $breakpoint */ +.pt-5 { padding-top: 32px !important; } + +/* Set a $size padding to the right at $breakpoint */ +.pr-5 { padding-right: 32px !important; } + +/* Set a $size padding to the bottom at $breakpoint */ +.pb-5 { padding-bottom: 32px !important; } + +/* Set a $size padding to the left at $breakpoint */ +.pl-5 { padding-left: 32px !important; } + +/* Set a $size padding to the left & right at $breakpoint */ +.px-5 { padding-right: 32px !important; padding-left: 32px !important; } + +/* Set a $size padding to the top & bottom at $breakpoint */ +.py-5 { padding-top: 32px !important; padding-bottom: 32px !important; } + +/* Set a $size padding to all sides at $breakpoint */ +.p-6 { padding: 40px !important; } + +/* Set a $size padding to the top at $breakpoint */ +.pt-6 { padding-top: 40px !important; } + +/* Set a $size padding to the right at $breakpoint */ +.pr-6 { padding-right: 40px !important; } + +/* Set a $size padding to the bottom at $breakpoint */ +.pb-6 { padding-bottom: 40px !important; } + +/* Set a $size padding to the left at $breakpoint */ +.pl-6 { padding-left: 40px !important; } + +/* Set a $size padding to the left & right at $breakpoint */ +.px-6 { padding-right: 40px !important; padding-left: 40px !important; } + +/* Set a $size padding to the top & bottom at $breakpoint */ +.py-6 { padding-top: 40px !important; padding-bottom: 40px !important; } + +@media (min-width: 544px) { /* Set a $size padding to all sides at $breakpoint */ + .p-sm-0 { padding: 0 !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-sm-0 { padding-top: 0 !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-sm-0 { padding-right: 0 !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-sm-0 { padding-bottom: 0 !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-sm-0 { padding-left: 0 !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-sm-0 { padding-right: 0 !important; padding-left: 0 !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-sm-0 { padding-top: 0 !important; padding-bottom: 0 !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-sm-1 { padding: 4px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-sm-1 { padding-top: 4px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-sm-1 { padding-right: 4px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-sm-1 { padding-bottom: 4px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-sm-1 { padding-left: 4px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-sm-1 { padding-right: 4px !important; padding-left: 4px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-sm-1 { padding-top: 4px !important; padding-bottom: 4px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-sm-2 { padding: 8px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-sm-2 { padding-top: 8px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-sm-2 { padding-right: 8px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-sm-2 { padding-bottom: 8px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-sm-2 { padding-left: 8px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-sm-2 { padding-right: 8px !important; padding-left: 8px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-sm-2 { padding-top: 8px !important; padding-bottom: 8px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-sm-3 { padding: 16px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-sm-3 { padding-top: 16px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-sm-3 { padding-right: 16px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-sm-3 { padding-bottom: 16px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-sm-3 { padding-left: 16px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-sm-3 { padding-right: 16px !important; padding-left: 16px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-sm-3 { padding-top: 16px !important; padding-bottom: 16px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-sm-4 { padding: 24px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-sm-4 { padding-top: 24px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-sm-4 { padding-right: 24px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-sm-4 { padding-bottom: 24px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-sm-4 { padding-left: 24px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-sm-4 { padding-right: 24px !important; padding-left: 24px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-sm-4 { padding-top: 24px !important; padding-bottom: 24px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-sm-5 { padding: 32px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-sm-5 { padding-top: 32px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-sm-5 { padding-right: 32px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-sm-5 { padding-bottom: 32px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-sm-5 { padding-left: 32px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-sm-5 { padding-right: 32px !important; padding-left: 32px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-sm-5 { padding-top: 32px !important; padding-bottom: 32px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-sm-6 { padding: 40px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-sm-6 { padding-top: 40px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-sm-6 { padding-right: 40px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-sm-6 { padding-bottom: 40px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-sm-6 { padding-left: 40px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-sm-6 { padding-right: 40px !important; padding-left: 40px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-sm-6 { padding-top: 40px !important; padding-bottom: 40px !important; } } +@media (min-width: 768px) { /* Set a $size padding to all sides at $breakpoint */ + .p-md-0 { padding: 0 !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-md-0 { padding-top: 0 !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-md-0 { padding-right: 0 !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-md-0 { padding-bottom: 0 !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-md-0 { padding-left: 0 !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-md-0 { padding-right: 0 !important; padding-left: 0 !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-md-0 { padding-top: 0 !important; padding-bottom: 0 !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-md-1 { padding: 4px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-md-1 { padding-top: 4px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-md-1 { padding-right: 4px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-md-1 { padding-bottom: 4px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-md-1 { padding-left: 4px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-md-1 { padding-right: 4px !important; padding-left: 4px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-md-1 { padding-top: 4px !important; padding-bottom: 4px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-md-2 { padding: 8px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-md-2 { padding-top: 8px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-md-2 { padding-right: 8px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-md-2 { padding-bottom: 8px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-md-2 { padding-left: 8px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-md-2 { padding-right: 8px !important; padding-left: 8px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-md-2 { padding-top: 8px !important; padding-bottom: 8px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-md-3 { padding: 16px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-md-3 { padding-top: 16px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-md-3 { padding-right: 16px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-md-3 { padding-bottom: 16px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-md-3 { padding-left: 16px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-md-3 { padding-right: 16px !important; padding-left: 16px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-md-3 { padding-top: 16px !important; padding-bottom: 16px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-md-4 { padding: 24px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-md-4 { padding-top: 24px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-md-4 { padding-right: 24px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-md-4 { padding-bottom: 24px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-md-4 { padding-left: 24px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-md-4 { padding-right: 24px !important; padding-left: 24px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-md-4 { padding-top: 24px !important; padding-bottom: 24px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-md-5 { padding: 32px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-md-5 { padding-top: 32px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-md-5 { padding-right: 32px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-md-5 { padding-bottom: 32px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-md-5 { padding-left: 32px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-md-5 { padding-right: 32px !important; padding-left: 32px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-md-5 { padding-top: 32px !important; padding-bottom: 32px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-md-6 { padding: 40px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-md-6 { padding-top: 40px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-md-6 { padding-right: 40px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-md-6 { padding-bottom: 40px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-md-6 { padding-left: 40px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-md-6 { padding-right: 40px !important; padding-left: 40px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-md-6 { padding-top: 40px !important; padding-bottom: 40px !important; } } +@media (min-width: 1012px) { /* Set a $size padding to all sides at $breakpoint */ + .p-lg-0 { padding: 0 !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-lg-0 { padding-top: 0 !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-lg-0 { padding-right: 0 !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-lg-0 { padding-bottom: 0 !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-lg-0 { padding-left: 0 !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-lg-0 { padding-right: 0 !important; padding-left: 0 !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-lg-0 { padding-top: 0 !important; padding-bottom: 0 !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-lg-1 { padding: 4px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-lg-1 { padding-top: 4px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-lg-1 { padding-right: 4px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-lg-1 { padding-bottom: 4px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-lg-1 { padding-left: 4px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-lg-1 { padding-right: 4px !important; padding-left: 4px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-lg-1 { padding-top: 4px !important; padding-bottom: 4px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-lg-2 { padding: 8px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-lg-2 { padding-top: 8px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-lg-2 { padding-right: 8px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-lg-2 { padding-bottom: 8px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-lg-2 { padding-left: 8px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-lg-2 { padding-right: 8px !important; padding-left: 8px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-lg-2 { padding-top: 8px !important; padding-bottom: 8px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-lg-3 { padding: 16px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-lg-3 { padding-top: 16px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-lg-3 { padding-right: 16px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-lg-3 { padding-bottom: 16px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-lg-3 { padding-left: 16px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-lg-3 { padding-right: 16px !important; padding-left: 16px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-lg-3 { padding-top: 16px !important; padding-bottom: 16px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-lg-4 { padding: 24px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-lg-4 { padding-top: 24px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-lg-4 { padding-right: 24px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-lg-4 { padding-bottom: 24px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-lg-4 { padding-left: 24px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-lg-4 { padding-right: 24px !important; padding-left: 24px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-lg-4 { padding-top: 24px !important; padding-bottom: 24px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-lg-5 { padding: 32px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-lg-5 { padding-top: 32px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-lg-5 { padding-right: 32px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-lg-5 { padding-bottom: 32px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-lg-5 { padding-left: 32px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-lg-5 { padding-right: 32px !important; padding-left: 32px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-lg-5 { padding-top: 32px !important; padding-bottom: 32px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-lg-6 { padding: 40px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-lg-6 { padding-top: 40px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-lg-6 { padding-right: 40px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-lg-6 { padding-bottom: 40px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-lg-6 { padding-left: 40px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-lg-6 { padding-right: 40px !important; padding-left: 40px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-lg-6 { padding-top: 40px !important; padding-bottom: 40px !important; } } +@media (min-width: 1280px) { /* Set a $size padding to all sides at $breakpoint */ + .p-xl-0 { padding: 0 !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-xl-0 { padding-top: 0 !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-xl-0 { padding-right: 0 !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-xl-0 { padding-bottom: 0 !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-xl-0 { padding-left: 0 !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-xl-0 { padding-right: 0 !important; padding-left: 0 !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-xl-0 { padding-top: 0 !important; padding-bottom: 0 !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-xl-1 { padding: 4px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-xl-1 { padding-top: 4px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-xl-1 { padding-right: 4px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-xl-1 { padding-bottom: 4px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-xl-1 { padding-left: 4px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-xl-1 { padding-right: 4px !important; padding-left: 4px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-xl-1 { padding-top: 4px !important; padding-bottom: 4px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-xl-2 { padding: 8px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-xl-2 { padding-top: 8px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-xl-2 { padding-right: 8px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-xl-2 { padding-bottom: 8px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-xl-2 { padding-left: 8px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-xl-2 { padding-right: 8px !important; padding-left: 8px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-xl-2 { padding-top: 8px !important; padding-bottom: 8px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-xl-3 { padding: 16px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-xl-3 { padding-top: 16px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-xl-3 { padding-right: 16px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-xl-3 { padding-bottom: 16px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-xl-3 { padding-left: 16px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-xl-3 { padding-right: 16px !important; padding-left: 16px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-xl-3 { padding-top: 16px !important; padding-bottom: 16px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-xl-4 { padding: 24px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-xl-4 { padding-top: 24px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-xl-4 { padding-right: 24px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-xl-4 { padding-bottom: 24px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-xl-4 { padding-left: 24px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-xl-4 { padding-right: 24px !important; padding-left: 24px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-xl-4 { padding-top: 24px !important; padding-bottom: 24px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-xl-5 { padding: 32px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-xl-5 { padding-top: 32px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-xl-5 { padding-right: 32px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-xl-5 { padding-bottom: 32px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-xl-5 { padding-left: 32px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-xl-5 { padding-right: 32px !important; padding-left: 32px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-xl-5 { padding-top: 32px !important; padding-bottom: 32px !important; } + /* Set a $size padding to all sides at $breakpoint */ + .p-xl-6 { padding: 40px !important; } + /* Set a $size padding to the top at $breakpoint */ + .pt-xl-6 { padding-top: 40px !important; } + /* Set a $size padding to the right at $breakpoint */ + .pr-xl-6 { padding-right: 40px !important; } + /* Set a $size padding to the bottom at $breakpoint */ + .pb-xl-6 { padding-bottom: 40px !important; } + /* Set a $size padding to the left at $breakpoint */ + .pl-xl-6 { padding-left: 40px !important; } + /* Set a $size padding to the left & right at $breakpoint */ + .px-xl-6 { padding-right: 40px !important; padding-left: 40px !important; } + /* Set a $size padding to the top & bottom at $breakpoint */ + .py-xl-6 { padding-top: 40px !important; padding-bottom: 40px !important; } } +.p-responsive { padding-right: 16px !important; padding-left: 16px !important; } +@media (min-width: 544px) { .p-responsive { padding-right: 40px !important; padding-left: 40px !important; } } +@media (min-width: 1012px) { .p-responsive { padding-right: 16px !important; padding-left: 16px !important; } } + +/* Set the font size to 26px */ +.h1 { font-size: 26px !important; } +@media (min-width: 768px) { .h1 { font-size: 32px !important; } } + +/* Set the font size to 22px */ +.h2 { font-size: 22px !important; } +@media (min-width: 768px) { .h2 { font-size: 24px !important; } } + +/* Set the font size to 18px */ +.h3 { font-size: 18px !important; } +@media (min-width: 768px) { .h3 { font-size: 20px !important; } } + +/* Set the font size to 16px */ +.h4 { font-size: 16px !important; } + +/* Set the font size to 14px */ +.h5 { font-size: 14px !important; } + +/* Set the font size to 12px */ +.h6 { font-size: 12px !important; } + +.h1, .h2, .h3, .h4, .h5, .h6 { font-weight: 600 !important; } + +/* Set the font size to 26px */ +.f1 { font-size: 26px !important; } +@media (min-width: 768px) { .f1 { font-size: 32px !important; } } + +/* Set the font size to 22px */ +.f2 { font-size: 22px !important; } +@media (min-width: 768px) { .f2 { font-size: 24px !important; } } + +/* Set the font size to 18px */ +.f3 { font-size: 18px !important; } +@media (min-width: 768px) { .f3 { font-size: 20px !important; } } + +/* Set the font size to 16px */ +.f4 { font-size: 16px !important; } +@media (min-width: 768px) { .f4 { font-size: 16px !important; } } + +/* Set the font size to 14px */ +.f5 { font-size: 14px !important; } + +/* Set the font size to 12px */ +.f6 { font-size: 12px !important; } + +/* Set the font size to 40px and weight to light */ +.f00-light { font-size: 40px !important; font-weight: 300 !important; } +@media (min-width: 768px) { .f00-light { font-size: 48px !important; } } + +/* Set the font size to 32px and weight to light */ +.f0-light { font-size: 32px !important; font-weight: 300 !important; } +@media (min-width: 768px) { .f0-light { font-size: 40px !important; } } + +/* Set the font size to 26px and weight to light */ +.f1-light { font-size: 26px !important; font-weight: 300 !important; } +@media (min-width: 768px) { .f1-light { font-size: 32px !important; } } + +/* Set the font size to 22px and weight to light */ +.f2-light { font-size: 22px !important; font-weight: 300 !important; } +@media (min-width: 768px) { .f2-light { font-size: 24px !important; } } + +/* Set the font size to 18px and weight to light */ +.f3-light { font-size: 18px !important; font-weight: 300 !important; } +@media (min-width: 768px) { .f3-light { font-size: 20px !important; } } + +/* Set the font size to ${#h6-size} */ +.text-small { font-size: 12px !important; } + +/* Large leading paragraphs */ +.lead { margin-bottom: 30px; font-size: 20px; font-weight: 300; color: #586069; } + +/* Set the line height to ultra condensed */ +.lh-condensed-ultra { line-height: 1 !important; } + +/* Set the line height to condensed */ +.lh-condensed { line-height: 1.25 !important; } + +/* Set the line height to default */ +.lh-default { line-height: 1.5 !important; } + +/* Set the line height to zero */ +.lh-0 { line-height: 0 !important; } + +/* Text align to the right */ +.text-right { text-align: right !important; } + +/* Text align to the left */ +.text-left { text-align: left !important; } + +/* Text align to the center */ +.text-center { text-align: center !important; } + +@media (min-width: 544px) { /* Text align to the right */ + .text-sm-right { text-align: right !important; } + /* Text align to the left */ + .text-sm-left { text-align: left !important; } + /* Text align to the center */ + .text-sm-center { text-align: center !important; } } +@media (min-width: 768px) { /* Text align to the right */ + .text-md-right { text-align: right !important; } + /* Text align to the left */ + .text-md-left { text-align: left !important; } + /* Text align to the center */ + .text-md-center { text-align: center !important; } } +@media (min-width: 1012px) { /* Text align to the right */ + .text-lg-right { text-align: right !important; } + /* Text align to the left */ + .text-lg-left { text-align: left !important; } + /* Text align to the center */ + .text-lg-center { text-align: center !important; } } +@media (min-width: 1280px) { /* Text align to the right */ + .text-xl-right { text-align: right !important; } + /* Text align to the left */ + .text-xl-left { text-align: left !important; } + /* Text align to the center */ + .text-xl-center { text-align: center !important; } } +/* Set the font weight to normal */ +.text-normal { font-weight: 400 !important; } + +/* Set the font weight to bold */ +.text-bold { font-weight: 600 !important; } + +/* Set the font to italic */ +.text-italic { font-style: italic !important; } + +/* Make text uppercase */ +.text-uppercase { text-transform: uppercase !important; } + +/* Underline text */ +.text-underline { text-decoration: underline !important; } + +/* Don't underline text */ +.no-underline { text-decoration: none !important; } + +/* Don't wrap white space */ +.no-wrap { white-space: nowrap !important; } + +/* Normal white space */ +.ws-normal { white-space: normal !important; } + +/* Allow long lines with no spaces to line break */ +.wb-break-all { word-break: break-all !important; } + +.text-emphasized { font-weight: 600; color: #24292e; } + +.list-style-none { list-style: none !important; } + +/* Add a dark text shadow */ +.text-shadow-dark { text-shadow: 0 1px 1px rgba(27, 31, 35, 0.25), 0 1px 25px rgba(27, 31, 35, 0.75); } + +/* Add a light text shadow */ +.text-shadow-light { text-shadow: 0 1px 0 rgba(255, 255, 255, 0.5); } + +/* Set to monospace font */ +.text-mono { font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, Courier, monospace; } + +/* Disallow user from selecting text */ +.user-select-none { user-select: none !important; } + +.d-block { display: block !important; } + +.d-flex { display: flex !important; } + +.d-inline { display: inline !important; } + +.d-inline-block { display: inline-block !important; } + +.d-inline-flex { display: inline-flex !important; } + +.d-none { display: none !important; } + +.d-table { display: table !important; } + +.d-table-cell { display: table-cell !important; } + +@media (min-width: 544px) { .d-sm-block { display: block !important; } + .d-sm-flex { display: flex !important; } + .d-sm-inline { display: inline !important; } + .d-sm-inline-block { display: inline-block !important; } + .d-sm-inline-flex { display: inline-flex !important; } + .d-sm-none { display: none !important; } + .d-sm-table { display: table !important; } + .d-sm-table-cell { display: table-cell !important; } } +@media (min-width: 768px) { .d-md-block { display: block !important; } + .d-md-flex { display: flex !important; } + .d-md-inline { display: inline !important; } + .d-md-inline-block { display: inline-block !important; } + .d-md-inline-flex { display: inline-flex !important; } + .d-md-none { display: none !important; } + .d-md-table { display: table !important; } + .d-md-table-cell { display: table-cell !important; } } +@media (min-width: 1012px) { .d-lg-block { display: block !important; } + .d-lg-flex { display: flex !important; } + .d-lg-inline { display: inline !important; } + .d-lg-inline-block { display: inline-block !important; } + .d-lg-inline-flex { display: inline-flex !important; } + .d-lg-none { display: none !important; } + .d-lg-table { display: table !important; } + .d-lg-table-cell { display: table-cell !important; } } +@media (min-width: 1280px) { .d-xl-block { display: block !important; } + .d-xl-flex { display: flex !important; } + .d-xl-inline { display: inline !important; } + .d-xl-inline-block { display: inline-block !important; } + .d-xl-inline-flex { display: inline-flex !important; } + .d-xl-none { display: none !important; } + .d-xl-table { display: table !important; } + .d-xl-table-cell { display: table-cell !important; } } +.v-hidden { visibility: hidden !important; } + +.v-visible { visibility: visible !important; } + +@media (max-width: 544px) { .hide-sm { display: none !important; } } +@media (min-width: 544px) and (max-width: 768px) { .hide-md { display: none !important; } } +@media (min-width: 768px) and (max-width: 1012px) { .hide-lg { display: none !important; } } +@media (min-width: 1012px) { .hide-xl { display: none !important; } } +/* Set the table-layout to fixed */ +.table-fixed { table-layout: fixed !important; } + +.sr-only { position: absolute; width: 1px; height: 1px; padding: 0; overflow: hidden; clip: rect(0, 0, 0, 0); word-wrap: normal; border: 0; } + +.show-on-focus { position: absolute; width: 1px; height: 1px; margin: 0; overflow: hidden; clip: rect(1px, 1px, 1px, 1px); } +.show-on-focus:focus { z-index: 20; width: auto; height: auto; clip: auto; } + +.container { width: 980px; margin-right: auto; margin-left: auto; } +.container::before { display: table; content: ""; } +.container::after { display: table; clear: both; content: ""; } + +.container-md { max-width: 768px; margin-right: auto; margin-left: auto; } + +.container-lg { max-width: 1012px; margin-right: auto; margin-left: auto; } + +.container-xl { max-width: 1280px; margin-right: auto; margin-left: auto; } + +.columns { margin-right: -10px; margin-left: -10px; } +.columns::before { display: table; content: ""; } +.columns::after { display: table; clear: both; content: ""; } + +.column { float: left; padding-right: 10px; padding-left: 10px; } + +.one-third { width: 33.333333%; } + +.two-thirds { width: 66.666667%; } + +.one-fourth { width: 25%; } + +.one-half { width: 50%; } + +.three-fourths { width: 75%; } + +.one-fifth { width: 20%; } + +.four-fifths { width: 80%; } + +.centered { display: block; float: none; margin-right: auto; margin-left: auto; } + +.col-1 { width: 8.3333333333%; } + +.col-2 { width: 16.6666666667%; } + +.col-3 { width: 25%; } + +.col-4 { width: 33.3333333333%; } + +.col-5 { width: 41.6666666667%; } + +.col-6 { width: 50%; } + +.col-7 { width: 58.3333333333%; } + +.col-8 { width: 66.6666666667%; } + +.col-9 { width: 75%; } + +.col-10 { width: 83.3333333333%; } + +.col-11 { width: 91.6666666667%; } + +.col-12 { width: 100%; } + +@media (min-width: 544px) { .col-sm-1 { width: 8.3333333333%; } + .col-sm-2 { width: 16.6666666667%; } + .col-sm-3 { width: 25%; } + .col-sm-4 { width: 33.3333333333%; } + .col-sm-5 { width: 41.6666666667%; } + .col-sm-6 { width: 50%; } + .col-sm-7 { width: 58.3333333333%; } + .col-sm-8 { width: 66.6666666667%; } + .col-sm-9 { width: 75%; } + .col-sm-10 { width: 83.3333333333%; } + .col-sm-11 { width: 91.6666666667%; } + .col-sm-12 { width: 100%; } } +@media (min-width: 768px) { .col-md-1 { width: 8.3333333333%; } + .col-md-2 { width: 16.6666666667%; } + .col-md-3 { width: 25%; } + .col-md-4 { width: 33.3333333333%; } + .col-md-5 { width: 41.6666666667%; } + .col-md-6 { width: 50%; } + .col-md-7 { width: 58.3333333333%; } + .col-md-8 { width: 66.6666666667%; } + .col-md-9 { width: 75%; } + .col-md-10 { width: 83.3333333333%; } + .col-md-11 { width: 91.6666666667%; } + .col-md-12 { width: 100%; } } +@media (min-width: 1012px) { .col-lg-1 { width: 8.3333333333%; } + .col-lg-2 { width: 16.6666666667%; } + .col-lg-3 { width: 25%; } + .col-lg-4 { width: 33.3333333333%; } + .col-lg-5 { width: 41.6666666667%; } + .col-lg-6 { width: 50%; } + .col-lg-7 { width: 58.3333333333%; } + .col-lg-8 { width: 66.6666666667%; } + .col-lg-9 { width: 75%; } + .col-lg-10 { width: 83.3333333333%; } + .col-lg-11 { width: 91.6666666667%; } + .col-lg-12 { width: 100%; } } +@media (min-width: 1280px) { .col-xl-1 { width: 8.3333333333%; } + .col-xl-2 { width: 16.6666666667%; } + .col-xl-3 { width: 25%; } + .col-xl-4 { width: 33.3333333333%; } + .col-xl-5 { width: 41.6666666667%; } + .col-xl-6 { width: 50%; } + .col-xl-7 { width: 58.3333333333%; } + .col-xl-8 { width: 66.6666666667%; } + .col-xl-9 { width: 75%; } + .col-xl-10 { width: 83.3333333333%; } + .col-xl-11 { width: 91.6666666667%; } + .col-xl-12 { width: 100%; } } +.gutter { margin-right: -16px; margin-left: -16px; } +.gutter > [class*="col-"] { padding-right: 16px !important; padding-left: 16px !important; } + +.gutter-condensed { margin-right: -8px; margin-left: -8px; } +.gutter-condensed > [class*="col-"] { padding-right: 8px !important; padding-left: 8px !important; } + +.gutter-spacious { margin-right: -24px; margin-left: -24px; } +.gutter-spacious > [class*="col-"] { padding-right: 24px !important; padding-left: 24px !important; } + +@media (min-width: 544px) { .gutter-sm { margin-right: -16px; margin-left: -16px; } + .gutter-sm > [class*="col-"] { padding-right: 16px !important; padding-left: 16px !important; } + .gutter-sm-condensed { margin-right: -8px; margin-left: -8px; } + .gutter-sm-condensed > [class*="col-"] { padding-right: 8px !important; padding-left: 8px !important; } + .gutter-sm-spacious { margin-right: -24px; margin-left: -24px; } + .gutter-sm-spacious > [class*="col-"] { padding-right: 24px !important; padding-left: 24px !important; } } +@media (min-width: 768px) { .gutter-md { margin-right: -16px; margin-left: -16px; } + .gutter-md > [class*="col-"] { padding-right: 16px !important; padding-left: 16px !important; } + .gutter-md-condensed { margin-right: -8px; margin-left: -8px; } + .gutter-md-condensed > [class*="col-"] { padding-right: 8px !important; padding-left: 8px !important; } + .gutter-md-spacious { margin-right: -24px; margin-left: -24px; } + .gutter-md-spacious > [class*="col-"] { padding-right: 24px !important; padding-left: 24px !important; } } +@media (min-width: 1012px) { .gutter-lg { margin-right: -16px; margin-left: -16px; } + .gutter-lg > [class*="col-"] { padding-right: 16px !important; padding-left: 16px !important; } + .gutter-lg-condensed { margin-right: -8px; margin-left: -8px; } + .gutter-lg-condensed > [class*="col-"] { padding-right: 8px !important; padding-left: 8px !important; } + .gutter-lg-spacious { margin-right: -24px; margin-left: -24px; } + .gutter-lg-spacious > [class*="col-"] { padding-right: 24px !important; padding-left: 24px !important; } } +@media (min-width: 1280px) { .gutter-xl { margin-right: -16px; margin-left: -16px; } + .gutter-xl > [class*="col-"] { padding-right: 16px !important; padding-left: 16px !important; } + .gutter-xl-condensed { margin-right: -8px; margin-left: -8px; } + .gutter-xl-condensed > [class*="col-"] { padding-right: 8px !important; padding-left: 8px !important; } + .gutter-xl-spacious { margin-right: -24px; margin-left: -24px; } + .gutter-xl-spacious > [class*="col-"] { padding-right: 24px !important; padding-left: 24px !important; } } +.offset-1 { margin-left: 8.3333333333% !important; } + +.offset-2 { margin-left: 16.6666666667% !important; } + +.offset-3 { margin-left: 25% !important; } + +.offset-4 { margin-left: 33.3333333333% !important; } + +.offset-5 { margin-left: 41.6666666667% !important; } + +.offset-6 { margin-left: 50% !important; } + +.offset-7 { margin-left: 58.3333333333% !important; } + +.offset-8 { margin-left: 66.6666666667% !important; } + +.offset-9 { margin-left: 75% !important; } + +.offset-10 { margin-left: 83.3333333333% !important; } + +.offset-11 { margin-left: 91.6666666667% !important; } + +@media (min-width: 544px) { .offset-sm-1 { margin-left: 8.3333333333% !important; } + .offset-sm-2 { margin-left: 16.6666666667% !important; } + .offset-sm-3 { margin-left: 25% !important; } + .offset-sm-4 { margin-left: 33.3333333333% !important; } + .offset-sm-5 { margin-left: 41.6666666667% !important; } + .offset-sm-6 { margin-left: 50% !important; } + .offset-sm-7 { margin-left: 58.3333333333% !important; } + .offset-sm-8 { margin-left: 66.6666666667% !important; } + .offset-sm-9 { margin-left: 75% !important; } + .offset-sm-10 { margin-left: 83.3333333333% !important; } + .offset-sm-11 { margin-left: 91.6666666667% !important; } } +@media (min-width: 768px) { .offset-md-1 { margin-left: 8.3333333333% !important; } + .offset-md-2 { margin-left: 16.6666666667% !important; } + .offset-md-3 { margin-left: 25% !important; } + .offset-md-4 { margin-left: 33.3333333333% !important; } + .offset-md-5 { margin-left: 41.6666666667% !important; } + .offset-md-6 { margin-left: 50% !important; } + .offset-md-7 { margin-left: 58.3333333333% !important; } + .offset-md-8 { margin-left: 66.6666666667% !important; } + .offset-md-9 { margin-left: 75% !important; } + .offset-md-10 { margin-left: 83.3333333333% !important; } + .offset-md-11 { margin-left: 91.6666666667% !important; } } +@media (min-width: 1012px) { .offset-lg-1 { margin-left: 8.3333333333% !important; } + .offset-lg-2 { margin-left: 16.6666666667% !important; } + .offset-lg-3 { margin-left: 25% !important; } + .offset-lg-4 { margin-left: 33.3333333333% !important; } + .offset-lg-5 { margin-left: 41.6666666667% !important; } + .offset-lg-6 { margin-left: 50% !important; } + .offset-lg-7 { margin-left: 58.3333333333% !important; } + .offset-lg-8 { margin-left: 66.6666666667% !important; } + .offset-lg-9 { margin-left: 75% !important; } + .offset-lg-10 { margin-left: 83.3333333333% !important; } + .offset-lg-11 { margin-left: 91.6666666667% !important; } } +@media (min-width: 1280px) { .offset-xl-1 { margin-left: 8.3333333333% !important; } + .offset-xl-2 { margin-left: 16.6666666667% !important; } + .offset-xl-3 { margin-left: 25% !important; } + .offset-xl-4 { margin-left: 33.3333333333% !important; } + .offset-xl-5 { margin-left: 41.6666666667% !important; } + .offset-xl-6 { margin-left: 50% !important; } + .offset-xl-7 { margin-left: 58.3333333333% !important; } + .offset-xl-8 { margin-left: 66.6666666667% !important; } + .offset-xl-9 { margin-left: 75% !important; } + .offset-xl-10 { margin-left: 83.3333333333% !important; } + .offset-xl-11 { margin-left: 91.6666666667% !important; } } +.markdown-body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"; font-size: 16px; line-height: 1.5; word-wrap: break-word; } +.markdown-body::before { display: table; content: ""; } +.markdown-body::after { display: table; clear: both; content: ""; } +.markdown-body > *:first-child { margin-top: 0 !important; } +.markdown-body > *:last-child { margin-bottom: 0 !important; } +.markdown-body a:not([href]) { color: inherit; text-decoration: none; } +.markdown-body .absent { color: #cb2431; } +.markdown-body .anchor { float: left; padding-right: 4px; margin-left: -20px; line-height: 1; } +.markdown-body .anchor:focus { outline: none; } +.markdown-body p, .markdown-body blockquote, .markdown-body ul, .markdown-body ol, .markdown-body dl, .markdown-body table, .markdown-body pre { margin-top: 0; margin-bottom: 16px; } +.markdown-body hr { height: 0.25em; padding: 0; margin: 24px 0; background-color: #e1e4e8; border: 0; } +.markdown-body blockquote { padding: 0 1em; color: #6a737d; border-left: 0.25em solid #dfe2e5; } +.markdown-body blockquote > :first-child { margin-top: 0; } +.markdown-body blockquote > :last-child { margin-bottom: 0; } +.markdown-body kbd { display: inline-block; padding: 3px 5px; font-size: 11px; line-height: 10px; color: #444d56; vertical-align: middle; background-color: #fafbfc; border: solid 1px #c6cbd1; border-bottom-color: #959da5; border-radius: 3px; box-shadow: inset 0 -1px 0 #959da5; } + +.markdown-body h1, .markdown-body h2, .markdown-body h3, .markdown-body h4, .markdown-body h5, .markdown-body h6 { margin-top: 24px; margin-bottom: 16px; font-weight: 600; line-height: 1.25; } +.markdown-body h1 .octicon-link, .markdown-body h2 .octicon-link, .markdown-body h3 .octicon-link, .markdown-body h4 .octicon-link, .markdown-body h5 .octicon-link, .markdown-body h6 .octicon-link { color: #1b1f23; vertical-align: middle; visibility: hidden; } +.markdown-body h1:hover .anchor, .markdown-body h2:hover .anchor, .markdown-body h3:hover .anchor, .markdown-body h4:hover .anchor, .markdown-body h5:hover .anchor, .markdown-body h6:hover .anchor { text-decoration: none; } +.markdown-body h1:hover .anchor .octicon-link, .markdown-body h2:hover .anchor .octicon-link, .markdown-body h3:hover .anchor .octicon-link, .markdown-body h4:hover .anchor .octicon-link, .markdown-body h5:hover .anchor .octicon-link, .markdown-body h6:hover .anchor .octicon-link { visibility: visible; } +.markdown-body h1 tt, .markdown-body h1 code, .markdown-body h2 tt, .markdown-body h2 code, .markdown-body h3 tt, .markdown-body h3 code, .markdown-body h4 tt, .markdown-body h4 code, .markdown-body h5 tt, .markdown-body h5 code, .markdown-body h6 tt, .markdown-body h6 code { font-size: inherit; } +.markdown-body h1 { padding-bottom: 0.3em; font-size: 2em; border-bottom: 1px solid #eaecef; } +.markdown-body h2 { padding-bottom: 0.3em; font-size: 1.5em; border-bottom: 1px solid #eaecef; } +.markdown-body h3 { font-size: 1.25em; } +.markdown-body h4 { font-size: 1em; } +.markdown-body h5 { font-size: 0.875em; } +.markdown-body h6 { font-size: 0.85em; color: #6a737d; } + +.markdown-body ul, .markdown-body ol { padding-left: 2em; } +.markdown-body ul.no-list, .markdown-body ol.no-list { padding: 0; list-style-type: none; } +.markdown-body ul ul, .markdown-body ul ol, .markdown-body ol ol, .markdown-body ol ul { margin-top: 0; margin-bottom: 0; } +.markdown-body li { word-wrap: break-all; } +.markdown-body li > p { margin-top: 16px; } +.markdown-body li + li { margin-top: 0.25em; } +.markdown-body dl { padding: 0; } +.markdown-body dl dt { padding: 0; margin-top: 16px; font-size: 1em; font-style: italic; font-weight: 600; } +.markdown-body dl dd { padding: 0 16px; margin-bottom: 16px; } + +.markdown-body table { display: block; width: 100%; overflow: auto; } +.markdown-body table th { font-weight: 600; } +.markdown-body table th, .markdown-body table td { padding: 6px 13px; border: 1px solid #dfe2e5; } +.markdown-body table tr { background-color: #fff; border-top: 1px solid #c6cbd1; } +.markdown-body table tr:nth-child(2n) { background-color: #f6f8fa; } +.markdown-body table img { background-color: transparent; } + +.markdown-body img { max-width: 100%; box-sizing: content-box; background-color: #fff; } +.markdown-body img[align=right] { padding-left: 20px; } +.markdown-body img[align=left] { padding-right: 20px; } +.markdown-body .emoji { max-width: none; vertical-align: text-top; background-color: transparent; } +.markdown-body span.frame { display: block; overflow: hidden; } +.markdown-body span.frame > span { display: block; float: left; width: auto; padding: 7px; margin: 13px 0 0; overflow: hidden; border: 1px solid #dfe2e5; } +.markdown-body span.frame span img { display: block; float: left; } +.markdown-body span.frame span span { display: block; padding: 5px 0 0; clear: both; color: #24292e; } +.markdown-body span.align-center { display: block; overflow: hidden; clear: both; } +.markdown-body span.align-center > span { display: block; margin: 13px auto 0; overflow: hidden; text-align: center; } +.markdown-body span.align-center span img { margin: 0 auto; text-align: center; } +.markdown-body span.align-right { display: block; overflow: hidden; clear: both; } +.markdown-body span.align-right > span { display: block; margin: 13px 0 0; overflow: hidden; text-align: right; } +.markdown-body span.align-right span img { margin: 0; text-align: right; } +.markdown-body span.float-left { display: block; float: left; margin-right: 13px; overflow: hidden; } +.markdown-body span.float-left span { margin: 13px 0 0; } +.markdown-body span.float-right { display: block; float: right; margin-left: 13px; overflow: hidden; } +.markdown-body span.float-right > span { display: block; margin: 13px auto 0; overflow: hidden; text-align: right; } + +.markdown-body code, .markdown-body tt { padding: 0.2em 0.4em; margin: 0; font-size: 85%; background-color: rgba(27, 31, 35, 0.05); border-radius: 3px; } +.markdown-body code br, .markdown-body tt br { display: none; } +.markdown-body del code { text-decoration: inherit; } +.markdown-body pre { word-wrap: normal; } +.markdown-body pre > code { padding: 0; margin: 0; font-size: 100%; word-break: normal; white-space: pre; background: transparent; border: 0; } +.markdown-body .highlight { margin-bottom: 16px; } +.markdown-body .highlight pre { margin-bottom: 0; word-break: normal; } +.markdown-body .highlight pre, .markdown-body pre { padding: 16px; overflow: auto; font-size: 85%; line-height: 1.45; background-color: #f6f8fa; border-radius: 3px; } +.markdown-body pre code, .markdown-body pre tt { display: inline; max-width: auto; padding: 0; margin: 0; overflow: visible; line-height: inherit; word-wrap: normal; background-color: transparent; border: 0; } + +.markdown-body .csv-data td, .markdown-body .csv-data th { padding: 5px; overflow: hidden; font-size: 12px; line-height: 1; text-align: left; white-space: nowrap; } +.markdown-body .csv-data .blob-num { padding: 10px 8px 9px; text-align: right; background: #fff; border: 0; } +.markdown-body .csv-data tr { border-top: 0; } +.markdown-body .csv-data th { font-weight: 600; background: #f6f8fa; border-top: 0; } + +.highlight table td { padding: 5px; } + +.highlight table pre { margin: 0; } + +.highlight .cm { color: #999988; font-style: italic; } + +.highlight .cp { color: #999999; font-weight: bold; } + +.highlight .c1 { color: #999988; font-style: italic; } + +.highlight .cs { color: #999999; font-weight: bold; font-style: italic; } + +.highlight .c, .highlight .cd { color: #999988; font-style: italic; } + +.highlight .err { color: #a61717; background-color: #e3d2d2; } + +.highlight .gd { color: #000000; background-color: #ffdddd; } + +.highlight .ge { color: #000000; font-style: italic; } + +.highlight .gr { color: #aa0000; } + +.highlight .gh { color: #999999; } + +.highlight .gi { color: #000000; background-color: #ddffdd; } + +.highlight .go { color: #888888; } + +.highlight .gp { color: #555555; } + +.highlight .gs { font-weight: bold; } + +.highlight .gu { color: #aaaaaa; } + +.highlight .gt { color: #aa0000; } + +.highlight .kc { color: #000000; font-weight: bold; } + +.highlight .kd { color: #000000; font-weight: bold; } + +.highlight .kn { color: #000000; font-weight: bold; } + +.highlight .kp { color: #000000; font-weight: bold; } + +.highlight .kr { color: #000000; font-weight: bold; } + +.highlight .kt { color: #445588; font-weight: bold; } + +.highlight .k, .highlight .kv { color: #000000; font-weight: bold; } + +.highlight .mf { color: #009999; } + +.highlight .mh { color: #009999; } + +.highlight .il { color: #009999; } + +.highlight .mi { color: #009999; } + +.highlight .mo { color: #009999; } + +.highlight .m, .highlight .mb, .highlight .mx { color: #009999; } + +.highlight .sb { color: #d14; } + +.highlight .sc { color: #d14; } + +.highlight .sd { color: #d14; } + +.highlight .s2 { color: #d14; } + +.highlight .se { color: #d14; } + +.highlight .sh { color: #d14; } + +.highlight .si { color: #d14; } + +.highlight .sx { color: #d14; } + +.highlight .sr { color: #009926; } + +.highlight .s1 { color: #d14; } + +.highlight .ss { color: #990073; } + +.highlight .s { color: #d14; } + +.highlight .na { color: #008080; } + +.highlight .bp { color: #999999; } + +.highlight .nb { color: #0086B3; } + +.highlight .nc { color: #445588; font-weight: bold; } + +.highlight .no { color: #008080; } + +.highlight .nd { color: #3c5d5d; font-weight: bold; } + +.highlight .ni { color: #800080; } + +.highlight .ne { color: #990000; font-weight: bold; } + +.highlight .nf { color: #990000; font-weight: bold; } + +.highlight .nl { color: #990000; font-weight: bold; } + +.highlight .nn { color: #555555; } + +.highlight .nt { color: #000080; } + +.highlight .vc { color: #008080; } + +.highlight .vg { color: #008080; } + +.highlight .vi { color: #008080; } + +.highlight .nv { color: #008080; } + +.highlight .ow { color: #000000; font-weight: bold; } + +.highlight .o { color: #000000; font-weight: bold; } + +.highlight .w { color: #bbbbbb; } + +.highlight { background-color: #f8f8f8; } diff --git a/_site/css/darcula.css b/_site/css/darcula.css new file mode 100644 index 0000000..02a06bc --- /dev/null +++ b/_site/css/darcula.css @@ -0,0 +1,147 @@ +/** + * Syntax highlighting styles + * Based on the Darcula theme for JetBrains IDEs + * https://github.com/shadowfacts/RougeDarcula + * Author: Shadowfacts + */ + .highlight { + background-color: #2B2B2B; + margin-bottom: 15px; + color: #A9B7C6; } + .highlight pre { + background-color: #2B2B2B; } + .highlight pre code { + background-color: #2B2B2B; } + .highlight .lineno { + color: #888888; } + .highlighter-rouge .highlight { + background: #2B2B2B; } + .highlight .c { + color: #808080; } + .highlight .err { + color: #BC3F3C; } + .highlight .k { + color: #CC7832; } + .highlight .o { + color: #A9B7C6; } + .highlight .cm { + color: #808080; } + .highlight .cp { + color: #808080; + font-style: italic; } + .highlight .c1 { + color: #808080; } + .highlight .cs { + color: #629755; + font-style: italic; } + .highlight .gd { + color: #BBBBBB; + background-color: #450505; + text-decoration: line-through; } + .highlight .gd .x { + color: #BBBBBB; + background-color: #450505; + text-decoration: line-through; } + .highlight .ge { + font-style: italic; } + .highlight .gr { + color: #BC3F3C; } + .highlight .gh { + color: #999; } + .highlight .gi { + background-color: #364135; } + .highlight .gi .x { + background-color: #364135; } + .highlight .go { + color: #A9B7C6; } + .highlight .gp { + color: #007F00; } + .highlight .gs { + font-weight: bold; } + .highlight .gu { + color: #aaa; } + .highlight .gt { + color: #a00; } + .highlight .kc { + color: #CC7832; } + .highlight .kd { + color: #CC7832; } + .highlight .kn { + color: #CC7832; } + .highlight .kp { + color: #CC7832; + font-weight: bold; } + .highlight .kr { + color: #CC7832; } + .highlight .kt { + color: #CC7832; } + .highlight .m { + color: #6897BB; } + .highlight .s { + color: #6A8759; } + .highlight .n { + color: #A9B7C6; } + .highlight .na { + color: #A9B7C6; } + .highlight .nb { + color: #CC7832; } + .highlight .nc { + color: #A9B7C6; } + .highlight .no { + color: #9876AA; } + .highlight .ni { + color: #9876AA; } + .highlight .ne { + color: #A9B7C6; } + .highlight .nf { + color: #A9B7C6; } + .highlight .nn { + color: #A9B7C6; } + .highlight .nt { + color: #E8BF6A; } + .highlight .nv { + color: #A9B7C6; } + .highlight .ow { + color: #A9B7C6; } + .highlight .mf { + color: #6897BB; } + .highlight .mh { + color: #6897BB; } + .highlight .mi { + color: #6897BB; } + .highlight .mo { + color: #6897BB; } + .highlight .sb { + color: #d14; } + .highlight .sc { + color: #6A8759; } + .highlight .sd { + color: #6A8759; } + .highlight .s2 { + color: #6A8759; } + .highlight .se { + color: #CC7832; } + .highlight .sh { + color: #6A8759; } + .highlight .si { + color: #6A8759; } + .highlight .sx { + color: #6A8759; } + .highlight .sr { + background-color: #364135; } + .highlight .s1 { + color: #6A8759; } + .highlight .ss { + color: #6A8759; } + .highlight .bp { + color: #CC7832; } + .highlight .vc { + color: #A9B7C6; } + .highlight .vg { + color: #A9B7C6; } + .highlight .vi { + color: #A9B7C6; } + .highlight .il { + color: #6897BB; } + .highlight .p { + color: #A9B7C6; } diff --git a/_site/css/style.css b/_site/css/style.css new file mode 100644 index 0000000..9acf72e --- /dev/null +++ b/_site/css/style.css @@ -0,0 +1,98 @@ +:root { + --bs-body-font-family: 'Montserrat', sans-serif; +} + +body { + display: flex; + min-height: 100vh; + flex-direction: column; + padding-top: 3.75rem; +} + +.sticky-top { + top: 3.75rem; +} + +.sidebar { + max-height: calc(100vh - 3.75rem); + overflow-y: auto; +} + +.sidebar a { + text-decoration: none; + --bs-link-color-rgb: var(--bs-body-color); +} + +.sidebar a:hover { + --bs-link-color-rgb: var(--bs-link-hover-color-rgb); +} + +#page-content { + flex-grow: 1; +} + +h1[id]::before, h2[id]::before, h3[id]::before { + content: ''; + display: block; + position: relative; + width: 0; + height: 3.75rem; + margin-top: -3.75rem; +} + +h1 { + margin-bottom: 2rem; + padding-bottom: 0.5rem; + border-bottom: 1px solid var(--bs-secondary-color); +} + +div.highlight { + margin: 1rem; + padding: 0.5rem; + border-radius: 5px; +} + +.highlight pre { + margin: 0; + tab-size: 4; +} + + +div.long-list { + overflow-x: scroll; +} + +.long-list > ul { + min-width: 500px; +} + + +.long-list ul { + padding-left: 15px; +} + + +.no-p-margin p { + margin: 0; +} + +.list-disc { + list-style: disc; +} + +main img { + max-width: 100%; +} + +.setup-tabs .nav-link { + color: var(--bs-white) !important; +} + +.setup-tabs .nav-link img { + width: 1.5em; + height: 1.5em; +} + +table { + margin-bottom: 1rem; +} diff --git a/_site/debug.log b/_site/debug.log new file mode 100644 index 0000000..7c8d383 --- /dev/null +++ b/_site/debug.log @@ -0,0 +1 @@ +# Logfile created on 2022-02-20 17:51:46 -0600 by logger.rb/v1.4.3 diff --git a/favicon-16x16.png b/_site/favicon-16x16.png similarity index 100% rename from favicon-16x16.png rename to _site/favicon-16x16.png diff --git a/favicon-32x32.png b/_site/favicon-32x32.png similarity index 100% rename from favicon-32x32.png rename to _site/favicon-32x32.png diff --git a/favicon.ico b/_site/favicon.ico similarity index 100% rename from favicon.ico rename to _site/favicon.ico diff --git a/_site/floodgate/api/index.html b/_site/floodgate/api/index.html new file mode 100644 index 0000000..8ef82c7 --- /dev/null +++ b/_site/floodgate/api/index.html @@ -0,0 +1,479 @@ + + + + + + + + GeyserMC Wiki: Floodgate API + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Floodgate has an API to extend what is possible and allow servers to get information about the Bedrock client. It also allows other plugins access to Cumulus

+ +

This page will contain information about class FloodgateApi.
+See the sidebar for more information about other parts of the API.

+ +

Accessing the Floodgate API

+

See here for how to include the Floodgate API in your project.

+ +

The Floodgate API has changed in Floodgate 2.0. The most important change is that the API methods are no longer static and instead instance-based, as shown below.

+ +

The class FloodgateApi is the base class of the API and you need to use it to access any part of the API.
+To access it, you simply type:

+
FloodgateApi.getInstance();
+
+ +

After you got the instance, you have access to all the methods.
+Use the documentation in the API module to see (and get info about) every single method available.
+Most API methods have a simple explanation.

+ + + +

We’ll highlight a few to get you started quickly:

+

FloodgateApi#isFloodgatePlayer(UUID)
+Used to check if the given UUID of an online player is a Bedrock player.

+ +

FloodgateApi#getPlayer(UUID)
+Used to get the FloodgatePlayer instance of an online player.
+Click here to get more information about the FloodgatePlayer class.

+ +

Note: You don’t need to wait until the Bedrock player is online to use the getPlayer and isFloodgatePlayer methods.
+You can even use them in the pre-login events.

+ +

FloodgateApi#getPlayerLink()
+Used to get the PlayerLink instance used by Floodgate to check for linked accounts.
+Click here to get more information about the PlayerLink class

+ +

FloodgateApi#sendForm(UUID, Form(Builder))
+Used to send a form to the Bedrock player with the given UUID.
+Click here to get more information about Forms.

+ +

Using the API on backend servers

+

In order to successfully use the API on backend Spigot servers when using a proxy, send-floodgate-data must be set to true on the proxy Floodgate’s config, and the key.pem file must be identical between all Floodgate instances.

+ + +
+ +
+
+ + + + + diff --git a/_site/floodgate/commands/index.html b/_site/floodgate/commands/index.html new file mode 100644 index 0000000..960de60 --- /dev/null +++ b/_site/floodgate/commands/index.html @@ -0,0 +1,461 @@ + + + + + + + + GeyserMC Wiki: Commands + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
CommandPermissionDescription
fwhitelistfloodgate.command.fwhitelistWhitelist command for Floodgate players. See here for details.
linkaccountfloodgate.command.linkaccountLink your account for local linking.
unlinkaccountfloodgate.command.unlinkaccountUnlink your account for local linking.
+ + +
+ +
+
+ + + + + diff --git a/_site/floodgate/faq/index.html b/_site/floodgate/faq/index.html new file mode 100644 index 0000000..6ed4b97 --- /dev/null +++ b/_site/floodgate/faq/index.html @@ -0,0 +1,455 @@ + + + + + + + + GeyserMC Wiki: FAQ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

FAQ

+ +

Changing/disabling the prefix

+ +

Please note: we do not recommend removing the prefix unless you are certain that no one will share a username between a Java and Bedrock player. Duplicated usernames will cause weird situations, like being unable to teleport to one of the players.

+ +

In your Floodgate config, change username-prefix to whichever prefix you desire - you can set it to "" and there will be no prefix.

+ +

On some older Paper servers (or any forks that use them), you may need to also shut down your server and delete your usercache.json file located in the same folder as your server jar to prevent users who already joined from having the old prefix. See this issue for more information.

+ +

Obtaining UUIDs for Floodgate players

+

Check your server logs, or use this page. If this doesn’t work, then try this method:

+ +

First, you’ll need to get the XUID of the player. There are several third-party websites to find this, for example, this one (unaffiliated with Geyser). Make sure to choose “Hexidecimal.” You’ll need to enter the player’s Xbox Gamertag, and, once submitted, and it should display the XUID in the format of xxxxxxxxxxxxxxxx. To turn the XUID into a UUID that Java Edition can recognize, you need to put the XUID in this format: 00000000-0000-0000-xxxx-xxxxxxxxxxxx. If formatted right, Java Edition should accept it as a UUID.

+ +

Using PlaceholderAPI

+

If you’re using the Spigot version of Floodgate, download the Placeholder plugin here. Using the placeholders shouldn’t require additional setup other than having PlaceholderAPI installed. See the section above on installing Floodgate on backend servers if you wish to use this on BungeeCord.

+ +

Using Skript

+

If you’re using the Spigot version of Floodgate, there is an unofficial plugin that adds Skript support here.

+ + +
+ +
+
+ + + + + diff --git a/_site/floodgate/features/index.html b/_site/floodgate/features/index.html new file mode 100644 index 0000000..f2b5c35 --- /dev/null +++ b/_site/floodgate/features/index.html @@ -0,0 +1,454 @@ + + + + + + + + GeyserMC Wiki: Features + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Whitelist command

+ +

Floodgate 2.0 has a whitelist command, fwhitelist, that should be used for adding or removing Floodgate players to whitelist.json. The username prefix doesn’t need to be included. +fwhitelist add Tim203 +fwhitelist remove Tim203

+ +

You can also specify a UUID: fwhitelist add 00000000-0000-0000-0009-01f64f65c7c3

+ +

The permission node is floodgate.command.fwhitelist.

+ +

What is skin uploading?

+

Skins of Bedrock player should be visible to Java players on servers with Floodgate 2.0 installed.
+If they aren’t, it’s most likely that the skin uploading queue has grown too large and can take a while to upload your skin.

+ +

Skin uploading is also a part of the Global Api. It is responsible for converting Bedrock skins to Java skins and uploading them to Mojang servers make them show up on Java Edition.

+ +

We’re using MineSkin internally. MineSkin is running on accounts donated by the community. So if you want to support MineSkin and make the upload times faster, feel free to look at this page for more info.

+ +

Example skin upload

+ + +
+ +
+
+ + + + + diff --git a/_site/floodgate/index.html b/_site/floodgate/index.html new file mode 100644 index 0000000..3299478 --- /dev/null +++ b/_site/floodgate/index.html @@ -0,0 +1,439 @@ + + + + + + + + GeyserMC Wiki: Floodgate + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Floodgate

+

What is 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. +This is something you install in addition to Geyser. Unlike Geyser, Floodgate can only be installed as a plugin on Spigot (including Paper and forks), Bungeecord, Velocity, and as a mod on Fabric servers, and can only be utilized on servers that have it installed.

+ +

What has Floodgate 2.0 to offer?

+

Floodgate 2.0 is a rewrite of Floodgate 1.0, with various bugfixes and improvements. It also introduces new features: being able to see Bedrock player skins on Java edition, +being able to use Bedrock forms, link your account once and login on every server that has Global Linking enabled, +and the Global Api.

+ + +
+ +
+
+ + + + + diff --git a/_site/floodgate/issues/index.html b/_site/floodgate/issues/index.html new file mode 100644 index 0000000..03d00aa --- /dev/null +++ b/_site/floodgate/issues/index.html @@ -0,0 +1,490 @@ + + + + + + + + GeyserMC Wiki: Issues + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Known Issues & Caveats

+

If an issue you’re experiencing is not listed here, please consider joining the Geyser Discord.

+ +

Running commands

+

In some instances, like if you have the username-prefix set to *, you may need to wrap the Bedrock player’s username in quotes; for example: /tp "*BedrockPlayer". Setting the prefix to . should also fix this.

+ +

If you wish to use IP forwarding, please enable it in your BungeeCord config as well!

+

It is likely you have enabled send-floodgate-data in your Floodgate config but either Floodgate isn’t installed on the target server, or your floodgate key isn’t the same between the installs of the plugin (please copy them so they all use the same key).

+ +

java.lang.IllegalStateException: Cannot reply to EncryptionRequestPacket without profile and access token.

+ +

Make sure the server has Floodgate installed and started up correctly. Otherwise, see if the next line fixes your error.

+ +

javax.crypto.AEADBadTagException: Tag mismatch!

+ +

If Geyser and Floodgate are on the same server, shut down your server, delete the floodgate plugin folder, delete any key file in the Geyser folder, and restart your server. +If Geyser and Floodgate are not on the same server and you had to copy the key file, this could also be an error related to uploading through FTP. Using ASCII will not work here, and you need to make sure you’re on binary when uploading. We recommend using WinSCP if you need to use FTP.

+ +

java.lang.NumberFormatException: For input string: “”

+ +

You’re trying to log in without an Xbox account. Floodgate requires an Xbox account to authenticate the Bedrock player.

+ +

Geyser-Floodgate:51777 lost connection: Internal Exception: java.lang.NumberFormatException: For input string: “SfqdXv36” (or a similar error)

+ +

Set ip-forwarding in your BungeeCord to true.

+ +

“Please connect through the official Geyser” disconnect message

+ +

Ensure that Floodgate and Geyser are both up-to-date.

+ +

Prefix is not changing on the server after changing it in the config.

+ +

Between the Paper builds of 1.15.2-355 and 1.16.5-505, there was a bug where Floodgate players who had already connected to the server would not have their prefixed changed. Paper builds 1.16.5-506 and later fix this issue.

+ +

Ensure that you removed the usercache.json file from the server root directory and restart your server.

+ +

Issues with LuckPerms and prefixes

+ +

Set allow-invalid-usernames to true in LuckPerms’ config.

+ +

Failed to verify username! (with Paper)

+ +

To completely mitigate this issue, disable perform-username-validation in the unsupported settings of the config/paper-global.yml file (paper.yml in the root server folder on servers below 1.19). Using Floodgate on the backend servers will also mitigate this issue.

+ +

Error with Forge or Fabric Bukkit Hybrid

+ +

At this time, there is no way to run Floodgate on servers that mix Forge and Bukkit or Fabric and Bukkit (For example: Magma, Mohist, and Cardboard/Bukkit4Fabric) - most hybrids do not support the complicated procedures we need to do in order to allow Bedrock players to connect (for the technically minded: these server softwares typically don’t support NMS).

+ +

If you wish to use Floodgate in combination with hybrid servers, we recommend putting these servers behind a BungeeCord or Velocity proxy, and running Floodgate on the proxy.

+ +

After enabling global linking in offline mode, player data is not synced between Java and Bedrock players.

+ +

This occurs in offline mode because the UUID of the Java account linked to the Bedrock account does not match the online mode UUID returned by Floodgate’s global linking server.

+ +

When using global linking, ensure online-mode in server.properties is set to true. Otherwise, Bedrock players will not be authenticated with the same UUID they receive when playing on Java Edition, resulting in lost progress. This does not occur with local linking.

+ + +
+ +
+
+ + + + + diff --git a/_site/floodgate/linking/index.html b/_site/floodgate/linking/index.html new file mode 100644 index 0000000..d78edbd --- /dev/null +++ b/_site/floodgate/linking/index.html @@ -0,0 +1,487 @@ + + + + + + + + GeyserMC Wiki: Linking + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

What is Global Linking?

+

Instructions and information about how to link can also be found here: https://link.geysermc.org/

+ +

Before we introduced Global Linking, you always had to link your Java and Bedrock account on every individual server you visited (that has Floodgate). Global Linking is here to fix that problem. Link once, join everywhere.

+ +

Keep in mind: While having your accounts linked, you will use the Java account’s location, inventory data, and achievements etc. regardless of which platform you sign in from (therefore, “synchronising” the player data). The player data from the Bedrock account will not be accessible until you unlink again. As a result, you should transfer everything (ender chest contents, items, armor) to the Java account before linking to not “lose” your Bedrock progress. If you forgot to do this, you can unlink, transfer everything over, and link again.

+ +

Global Linking is part of the Global Api and uses the GlobalLinkServer to link your account. To be able to link your account you have to do the following:

+
    +
  1. Join the GlobalLinkServer with both your Java and Bedrock account
    +(IP: link.geysermc.org, Java port: 25565, Bedrock port: 19132)
  2. +
  3. Start the linking process by typing /linkaccount on your Java or Bedrock account
  4. +
  5. You’ll get a message with a random number that you have to enter on the account that you did not start the linking process on.
  6. +
  7. Enter the random number on the other account by typing /linkaccount <code>
  8. +
  9. You should get kicked from the server on both your Bedrock and Java account with the message that it had successfully linked your accounts.
  10. +
+ +

To unlink your globally linked accounts, join the GlobalLinkServer (as described above for linking) on either Java or Bedrock, and use the /unlinkaccount command.

+ +

Global Linking should be enabled by default on every server running Floodgate 2.0, but in the case that you disabled it, you can enable it again by opening your Floodgate config and make sure that the player-link section looks similar to this:

+
# Configuration for player linking
+player-link:
+  # Whether to enable the linking system. Turning this off will prevent
+  # players from using the linking feature even if they are already linked.
+  enabled: true
+  # Whether to use global linking. Global linking uses a central server to request link
+  # accounts, allowing people to link once, join everywhere (on servers with global linking).
+  use-global-linking: true
+
+

(see the default config)

+ +

Once you saved the config and restarted your server you should be using Global Linking.

+ +

If you don’t want to use Global Linking, you can disable enable-global-linking in the Floodgate config.

+ +

Local Linking

+

You can also set up a local linking database on your server. Local linking can work with Global Linking at the same time. Link entries in your local database will override entries in the Global Linking Server.

+ +

Note that you only have to follow these steps on your proxy (BungeeCord or Velocity), if you have one.

+ +
    +
  1. Download one of the linking databases extensions here. +If you need help picking the right one: choose mysql if you already have a database or want to have a multi-proxy setup. For anything else choose sqlite. The full name should be floodgate-*type*-database.jar.
  2. +
  3. Copy the database extension jar you just downloaded into the floodgate 2.0 plugin folder (e.g. /plugins/floodgate/).
  4. +
  5. Enable enable-own-linking in the player-link section of Floodgate.
  6. +
  7. Set type in the player-link section to your database type (currently either mysql or sqlite). (If you used Floodgate 1.0 and had linking enabled back then; the database type was sqlite).
  8. +
  9. Restart your server
  10. +
+ +

If you have selected mysql a new data folder for the database should be generated inside the Floodgate data folder. You can enter your database credentials in there. After you did that restart your server once more.

+ +

That should be it. You can then link your accounts by following the instructions you get when typing /linkaccount.

+ + +
+ +
+
+ + + + + diff --git a/_site/floodgate/player/index.html b/_site/floodgate/player/index.html new file mode 100644 index 0000000..b6e5c85 --- /dev/null +++ b/_site/floodgate/player/index.html @@ -0,0 +1,439 @@ + + + + + + + + GeyserMC Wiki: FloodgatePlayer + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

FloodgatePlayer is something that every player who’s connect through Floodgate has.
+It contains information about the Bedrock client which can be useful in various situations.

+ +

You can get a FloodgatePlayer by using the FloodgateApi#getPlayer(uuid) method (where uuid is the unique id of the connected player)

+ + +
+ +
+
+ + + + + diff --git a/_site/floodgate/setup/index.html b/_site/floodgate/setup/index.html new file mode 100644 index 0000000..1bf908b --- /dev/null +++ b/_site/floodgate/setup/index.html @@ -0,0 +1,548 @@ + + + + + + + + GeyserMC Wiki: Floodgate Setup + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Floodgate Setup

+ + + + + +
+
+ +

Floodgate-Spigot setup

+ +
    +
  1. Download Floodgate-Spigot from the download page.
  2. +
  3. Place the Floodgate-Spigot.jar in the plugins folder, and restart the server.
  4. +
  5. Change auth-type in Geyser’s config to floodgate.
  6. +
  7. Restart the server.
  8. +
+ +
+
+ + +

Floodgate-Fabric setup

+ +
    +
  1. Download Floodgate-Fabric from the modrinth page.
  2. +
  3. Place the Floodgate-Fabric.jar in the mods folder, and restart the server. You also need FabricAPI installed.
  4. +
  5. Change auth-type in Geyser’s config to floodgate.
  6. +
  7. Restart the server.
  8. +
+ +

Note for Fabric behind a Velocity proxy: +You will need to configure FabricProxyLite to allow the Fabric server to receive data from Velocity.

+ +
+
+ +

Floodgate setup on a BungeeCord/Velocity proxy

+ + + +
    +
  1. Download Floodgate for your proxy software from the download page.
  2. +
  3. Place the Floodgate jar in the plugins folder, and restart the proxy server.
  4. +
  5. Change auth-type in Geyser’s config to floodgate.
  6. +
  7. Restart the server.
  8. +
+ +

Installing Floodgate on servers behind the proxy

+ +

This is only needed when you want to use the Floodgate API on your backend server(s) behind a proxy.

+ +
    +
  1. After installing Floodgate on the proxy, install Floodgate on the backend servers (either Floodgate-Spigot, or Floodgate-Fabric).
  2. +
  3. Enable ip_forward in your BungeeCord config.yml if using BungeeCord. For Velocity, set up player information forwarding.
  4. +
  5. Set bungeecord to true in your spigot.yml. When using Velocity, see their guide, as they have multiple options that require different setups.
  6. +
  7. Start the proxy server.
  8. +
  9. Edit the Floodgate config on your proxy server and set send-floodgate-data to true.
  10. +
  11. Copy the key.pem file in the proxy Floodgate config folder to all backend servers’ Floodgate config folder.
  12. +
  13. Restart the backend servers and proxy server.
  14. +
+ + + +
+
+ +

Floodgate setup with Geyser-Standalone

+ + + +
    +
  1. Download Floodgate from the download page.
  2. +
  3. Install the Floodgate jar - see the platform instructions for detailed info.
  4. +
  5. Change auth-type in Geyser Standalone’s config to floodgate.
  6. +
  7. Copy the key.pem file in the Floodgate config folder to the same directory as Geyser Standalone.
  8. +
  9. Restart Geyser-Standalone.
  10. +
+ + + +
+
+ +

Further information:

+ + + +
+ +
+
+ + + + + diff --git a/_site/geyser/anticheat-compatibility/index.html b/_site/geyser/anticheat-compatibility/index.html new file mode 100644 index 0000000..9771be7 --- /dev/null +++ b/_site/geyser/anticheat-compatibility/index.html @@ -0,0 +1,475 @@ + + + + + + + + GeyserMC Wiki: Anticheat Compatibility + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + + + +

AntiCheat compatibility reports

+ +

Full Compatibility (Checks Bedrock Players Accurately)

+ + + +

Partially Compatible (Does not Check/Ignores Bedrock Players)

+ +
    +
  • AAC (Paid) - Last Updated on 19th August 2021
  • +
  • Flappy Anticheat - Last Updated on 14th September 2021
  • +
  • GrimAC - Last Updated on 24th March 2022
  • +
  • Intave (Paid) Requires GeyserMC addon - Last Updated on 24th October 2022
  • +
  • Matrix (Paid) - Last updated on 2nd September 2021
  • +
  • Spartan: Java Edition (Paid) - Last Updated on 22nd May 2023
  • +
  • Vulcan (Paid) - Last Updated on 19th August 2021
  • +
  • Verus (Paid) - Last Updated on 13th July 2022
  • +
+ +

Incompatible (False Positives on Bedrock Players, no Compatibility at All)

+ +
    +
  • AntiCheatReloaded - Last Updated on 19th August 2021
  • +
  • Negativity V1 - Last Updated on 21st March 2022
  • +
  • NoCheatPlus (Compat NCP is an addon that enables Partial Compatibility) - Last Updated on 19th August 2021
  • +
  • GodsEye (GodsEyeGeyserMC is an addon that enables Partial Compatibility) (Paid) - Last Updated on 21st March 2022
  • +
  • Kauri (Paid) - Last Updated on 21st March 2022
  • +
  • Reflex (Paid) - Last Updated on 19th August 2021
  • +
  • Wraith (Paid) - Last Updated on 19th August 2021
  • +
+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/api/index.html b/_site/geyser/api/index.html new file mode 100644 index 0000000..e64b242 --- /dev/null +++ b/_site/geyser/api/index.html @@ -0,0 +1,536 @@ + + + + + + + + GeyserMC Wiki: Geyser API + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Geyser has an API to extend what is possible with Geyser, and to allow you to interact with Geyser in your own plugins, mods, or extensions.

+ +

Where can I use the Geyser API?

+

You could use the Geyser API in:

+
    +
  • A plugin for Paper/Spigot, Velocity, Waterfall/BungeeCord, etc.
  • +
  • A mod for Fabric or Forge
  • +
  • A Geyser Extension
  • +
+ +

Accessing the Geyser API

+

See here for how to include the Geyser API dependency in your project.

+ +

Documentation

+ +

The Geyser API offers events to subscribe to, or information on whether a player is joining through Geyser, and gives you the ability to enhance what is possible with Geyser (i.e. register custom items). +(soon, blocks and entities too). +It can be used easily in Geyser Extensions, see here for details on those.

+ +

Quick overview:

+ + +

GeyserApi:

+

The GeyserApi interface serves as a central access point to various functionalities provided by the Geyser API, providing methods to e.g. interact with player connections. +It extends the Base API interface, which provides basic information about individual players.

+ +

The class GeyserApi is the base class of the API and you need to use it to access any part of the API.
+To access it, you simply type:

+
GeyserApi.api();
+
+ +

After you got the instance, you have access to all the methods.
+Use the documentation in the API module to see (and get info about) every single method available.
+Most API methods have a simple explanation. +Since the Geyser API extends the Base API that is shared across Floodgate and Geyser, you can also use the methods from the Base API.

+ +

We’ll highlight a few to get you started quickly:

+

GeyserApi#isBedrockPlayer(UUID)
+Used to check if the given UUID of an online player is a Bedrock player.

+ +

GeyserApi#connectionByUuid(UUID)
+Used to get the Connection of an online player.
+This method will return null if the player is not a Bedrock player.

+ + + +

GeyserApi#sendForm(UUID, Form(Builder))
+Used to send a form to the Bedrock player with the given UUID.
+Click here to get more information about Forms.

+ +

GeyserApi#onlineConnectionsCount()
+Used to get the amount of online Bedrock players.

+ +

Short Overview of the Geyser API

+ +

Cumulus

+

While technically not directly in the Geyser API, the Cumulus library is also provided by the Geyser API. +It allows you to send Bedrock edition forms to players. See Cumulus for more information.

+ +

Events

+

The event package contains all the events that Geyser fires. See here for detailed information on how to listen to Geyser events.

+ +

Command

+

This package contains classes and interfaces related to commands in Geyser, which allows Geyser Extensions to register custom commands.

+ +

Entity

+

The Entity package contains classes and interfaces related to entities in Geyser, like the GeyserPlayerEntity interface, +which represents a player entity in Geyser. This interface extends the GeyserEntity interface, while providing additional functionality specifically for player entities, +like currently, showing emotes.

+ +

Item

+

The item package contains classes and interfaces related to items in Geyser. You can create custom items and register them using the Geyser API. +See here for detailed information on how to register custom items.

+ +

Block

+

The block package contains classes and interfaces related to blocks in Geyser. You can create custom blocks using this package, and register them in using the GeyserDefineCustomBlocksEvent. +See here for detailed information.

+ +

Network

+

The network package contains basic information about the remote server via the +RemoteServer +interface, such as the server’s IP address and port, and the protocol version of the remote server. Or the auth type. +You can also get the port/IP that Geyser listens to via the BedrockListener interface.

+ +

Pack

+

The pack package contains classes and interfaces related to resource packs in Geyser. You can create custom resource packs and send them to individual sessions before they log in using the SessionLoadResourcePacksEvent. +If you wish to send a resource pack to all sessions, you can use the GeyserLoadResourcePacksEvent.

+ +

Packs can be created using a PackCodec, such as the provided PathPackCodec. +This allows you to load a Bedrock resource pack from a file path:

+
ResourcePack pack = ResourcePack.create(PackCodec.path(path));
+
+ +

Extension

+

This package provides the necessary components to create and manage extensions. +For a more detailed explanation of extensions, see here.

+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/commands/index.html b/_site/geyser/commands/index.html new file mode 100644 index 0000000..8246444 --- /dev/null +++ b/_site/geyser/commands/index.html @@ -0,0 +1,535 @@ + + + + + + + + GeyserMC Wiki: Commands + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Commands and Permissions

+ +

Geyser features many built-in commands that can be used by players or server owners.

+ + + +

Geyser commands & their permissions

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CommandPermissionDescription
geyser help
geyser ?
geyser.command.helpShows help for all registered commands.
geyser advancementsgeyser.command.advancementsOpen the Java advancements menu.
geyser dumpgeyser.command.dumpDumps Geyser debug information for bug reports.
geyser listgeyser.command.listList all players connected through Geyser.
geyser offhandgeyser.command.offhandPuts an item in your offhand.
geyser reloadgeyser.command.reloadReloads the Geyser configurations. Kicks all players when used!
geyser settingsgeyser.command.settingsOpens a settings menu allowing you to modify aspects of the world.
geyser shutdown
geyser stop
geyser.command.shutdownShuts down Geyser.
This command only works on Standalone.
geyser statisticsgeyser.command.statisticsOpen the Java statistics menu.
geyser versiongeyser.command.versionShows the current Geyser version and checks for updates.
geyser tooltipsgeyser.command.tooltipsToggle showing Advanced Tooltips (F3 + H on Java)
+ +

Other Permissions

+ +

Besides commands, there are other permissions that are used to guard specific Geyser features.

+ + + + + + + + + + + + + + +
PermissionDescription
geyser.settings.serverAllow players to use the game settings menu. (Also requires player to have op.)
+ +

Floodgate commands and permissions

+ +

For Floodgate commands, see here.

+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/common-issues/index.html b/_site/geyser/common-issues/index.html new file mode 100644 index 0000000..b8e5a4b --- /dev/null +++ b/_site/geyser/common-issues/index.html @@ -0,0 +1,570 @@ + + + + + + + + GeyserMC Wiki: Common Issues + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Commonly, people may have issues with Geyser not showing up in their server list or run into similar issues. +This page contains a few common issues people may encounter that you might have as well as potential fixes for them. +If you still can’t make it work, join our Discord for support.

+ +

Floodgate

+

For Floodgate issues see: Floodgate: Known Issues/Caveats.

+ +

I can’t connect! (Either the server doesn’t show up in the friends list or I get “Unable to connect to world”)

+
    +
  • If you don’t use a reverse proxy such as TCPShield make sure that enable-proxy-protocol is set to false. +To fix “Unable to connect to world” with no console errors, see here.
  • +
+ +

If the server doesn’t show up in the friends list

+ +
    +
  • If using Windows 10, iOS, or Android: try adding the server to the Servers list in-game.
  • +
  • If using Xbox One: try connecting with BedrockConnect.
  • +
  • If using PS4: try using a LAN proxy.
  • +
  • If using Nintendo Switch: there is currently no way for local servers to show up in the Friends tab, but you can still connect using BedrockConnect.
  • +
+ +

If the Geyser instance is locally hosted: try using localhost or 0.0.0.0 as the IP address. +If that doesn’t work, or your Geyser instance is on another computer in the network: use your local IPv4 address.

+ +

See here for fixing “Unable to Connect to World” with no console errors

+ +

java.net.BindException: Address already in use: bind on startup.

+

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.

+ +

[…] has been compiled by a more recent version of the Java Runtime (class file version 60.0)

+ +

See this link for updating to Java 16: https://paper.readthedocs.io/en/latest/java-update/index.html.

+ +

Hosting provider will not immediately open up UDP.

+ +

These steps only apply for the standalone version of Geyser. +This usually has something to do on your host’s end. Most commonly, it’s because they do not open up ports over the UDP protocol, which is what Minecraft: Bedrock Edition uses, opposed to Minecraft: Java Edition using TCP. +One way to get around this (if you’re using an online host) is to shut down your server, and when asking for a server jar, select Nukkit, or any other Bedrock edition server software (you won’t actually be switching to Nukkit). Afterward, open up your FTP file manager and find the Nukkit jar. Then, replace this jar with the server software you’re using. Upon starting up the server, it should open up ports over UDP whilst still allowing you to use the server jar you desire.

+ +

PLEASE NOTE: If your server automatically redownloads jars upon startup, such as with an autoupdate system, this workaround will not work. Please contact your host if this does not work for you as there is nothing we can do.

+ +

Stuck on “Locating Server” with no errors

+ +

You may need to update your Java version. If so, update at Adoptium.net.

+ +

Sometimes this happens in poor-network environments. There is an mtu option in the Geyser config; lower this number slowly (in batches of 100), restart each time, and re-test joining.

+ +

This option will most likely not help if you are getting “Unable to Connect to World” with no console logs indicating a connection.

+ +

Login Failed

+ +

If you are using a plugin version: in your Geyser config, set your remote address to 127.0.0.1. If that does not work, check your startup log for a message about Docker, and use that address in the remote address

+ +

Cannot reply to EncryptionRequestPacket without profile and access token

+ +

There are two causes of this message:

+ +

Floodgate issue:

+ +

This message can occur with a Floodgate setup. Usually, it means that a misconfiguration occurred, or another plugin is conflicting. If you copied the Floodgate key from its folder to the Geyser folder on the same server, this is now unnecessary and you can safely remove the Geyser copy, restart, and try again.

+ +

Server is in Online Mode while Geyser is in Offline Mode:

+ +

If you have your configuration set up like this, put simply, it won’t work. If authentication for the Java server is set to online, it is expected Geyser is configured the same way. The server requires a valid Minecraft: Java Edition account, and if you aren’t logging into one with Geyser, then you will be unable to join the server. If your configuration is set up properly and you’re still getting this issue, it could be that your credentials are invalid.

+ +

Connection Refused: <INSERT IP AND/OR DOMAIN>

+ +

Connection Refused usually means that a Java server could not be found on that port, or the server denied access to the connection on a network level. +The latter can happen with anti-DDOS plugins such as TCPShield, but otherwise ensure that the server you’re trying to connect to is spelled correctly in the config, is up and is port forwarded correctly.

+ +

If you’re updating from an old build of Geyser, set your remote address to auto and try again.

+ +

Floodgate Misconfiguration

+

See this page for more information.

+ +

Missing profile key. This server requires secure profiles.

+ +

See this page.

+ +

Mojang Resetting Account Credentials

+

This is unfortunately something we have no control over, and is most likely the case when you’re running Geyser as a plugin on a server host or joining a friend far away from your location. If you’re running Geyser locally, this should not happen to you, but what we recommend for servers is a plugin we make called Floodgate, which allows for Bedrock clients to join your server without needing a Java Edition account. Take a look here for more information.

+ +

“Invalid IP address!” from Bedrock

+

This can happen if the domain you are entering resolves to a SRV record, which Bedrock does not support. Try using the IPv4 address instead. +Additionally, this can happen when trying to specify both the ip and port in the ip tab - in which case, see here for how to properly connect to “test.geysermc.org:19132”.

+ +

Bedrock clients freeze when opening up commands for the first time

+

Disable command-suggestions in your Geyser config. This will stop the freezing at the expense of removing command suggestions from Bedrock clients. +If you’re a dedicated server admin, you can have a list of commands players should be using. This will remove any unnecessary commands from tab completion as well for Java players. +It has other benefits too. Here’s a plugin that can just do that: +CommandWhitelist. Alternatively, use the HideCommands Geyser extension to hide commands just for Bedrock players.

+ +

Failed to load locale asset cache: Unrecognized token ‘Cannot’

+

This or anything else related to failing to download a locale file on startup is usually caused by java trying to connect using IPv6 and Mojang only use IPv4, so start Geyser or the server up with this flag -Djava.net.preferIPv4Stack=true, EG: java -Xms1024M -Djava.net.preferIPv4Stack=true -jar Geyser.jar

+ +

Outdated client! Please use 1.x.x

+ +

The server is too new or Geyser is outdated. Make sure you’re on the latest Geyser.

+ +

Outdated server! I’m still on 1.x.x

+ +

Update the server or ask them to install ViaVersion. You can also try VIAaaS (ViaVersion as a Service).

+ +

Query: Incorrect Magic!

+ +

See here: https://www.spigotmc.org/threads/query-incorrect-magic-and-high-cpu-usage.159386/#post-2709057

+ +
    +
  • If you don’t use a reverse proxy such as TCPShield make sure that enable-proxy-protocol is set to false.
  • +
+ +

Only for BungeeCord with floodgate

+ +

If you use floodgate ensure that it is installed on all of your Spigot backend servers as following:

+ +
    +
  1. Bungee: Geyser and Floodgate
  2. +
  3. Lobby: floodgate
  4. +
  5. Server-1: floodgate
  6. +
  7. Server-2: floodgate
  8. +
+ +

And so on.

+ +
    +
  • Please also make sure that you have the same key.pem and config.yml on all of your servers.
  • +
+ +

If your players can’t connect from the lobby to another backend server, check console.

+ +

Plugins that can cause issues

+
    +
  • HamsterAPI
  • +
+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/creating-a-startup-script/index.html b/_site/geyser/creating-a-startup-script/index.html new file mode 100644 index 0000000..bcf5174 --- /dev/null +++ b/_site/geyser/creating-a-startup-script/index.html @@ -0,0 +1,475 @@ + + + + + + + + GeyserMC Wiki: Creating a Startup Script + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Creating a Startup Script for Geyser-Standalone

+ +

In order for this to work, you MUST have Java 16 (or higher) installed!

+ +

Once you have downloaded and placed Geyser into its own folder, you will need to create a startup script; similar to how you’d run a Bukkit/Spigot/Paper server.

+ +

Windows

+
    +
  • Create a new text file in the same location as the Geyser-Standalone jar file, and call it run.bat. Open this with a text editor (preferably Notepad++), and insert the text below: +
    @echo off
    +java -Xms1024M -jar Geyser-Standalone.jar
    +pause
    +
    +
  • +
  • Double-click the run.bat, and Geyser should start up. Geyser will generate all the needed files.
  • +
+ +

macOS

+
    +
  • Create a text file called run.command, and open it with a text editor such as TextEdit or TextMate. Type the text below into the run.command file: +
    #!/bin/bash 
    +cd "$( dirname "$0" )"
    +java -Xms1024M -jar Geyser-Standalone.jar
    +
    +
  • +
  • Open Terminal, and type in chmod a+x (Do NOT press return!), and drag your run.command file into the Terminal.
  • +
  • Press return on your keyboard, and Geyser will start up. Geyser will generate all the needed files.
  • +
+ +

Linux

+
    +
  • Create a file called run.sh, and open it with a text editor. Type the text below into your run.sh file: +
    #!/bin/sh 
    +cd "$( dirname "$0" )"
    +java -Xms1024M -jar Geyser-Standalone.jar
    +
    +
  • +
  • In your default terminal application, make the file executable by running chmod +x ~(dir)/run.sh where dir is the name of the folder Geyser is in, or by changing the file permissions;
  • +
  • Open your default terminal application, and type ./run.sh to run Geyser. Geyser will generate all the needed files.
  • +
+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/current-limitations/index.html b/_site/geyser/current-limitations/index.html new file mode 100644 index 0000000..9dcad2f --- /dev/null +++ b/_site/geyser/current-limitations/index.html @@ -0,0 +1,471 @@ + + + + + + + + GeyserMC Wiki: Current Limitations + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

With Geyser being a protocol translator between two different games with two different codebases, there are a handful of limitations that Geyser is unfortunately unable to handle. Despite Minecraft Bedrock and Java being quite close in comparison, there are some vast differences in many areas.

+ +

The following things cannot be fixed without changes to Bedrock or the Java protocol in general. As of now, they are not fixable in Geyser.

+ +
    +
  • Custom heads in inventories
  • +
  • Clickable links in chat
  • +
  • Glowing effect
  • +
  • Crafting in the 2x2 menu while in creative mode
  • +
  • Distinguishing between left and right clicks in inventories
  • +
  • Redstone dot blockstates
  • +
  • “Can be placed on/destroyed” tag for some blocks - for example, different colors of clay/wool that don’t exist as separate blocks
  • +
  • Potion colors implemented using NBT
  • +
  • Various command arguments for any command that doesn’t use the Minecraft Brigadier library
  • +
  • Anything that relies on tab complete or typing in the chat UI (related to the above) - Bedrock sends no packet that indicates they are in this menu
  • +
  • Unable to see banner layers past 6
  • +
  • Movement issues around bamboo due to offset differences between Java and Bedrock: Hurricane can work around it.
  • +
  • Can’t move mounted entities with carrot/warped fungus on a stick. Hurricane also works around this.
  • +
  • Custom anvil recipes
  • +
  • Heights lower than -64 or higher than 320 in the overworld with extended height enabled, and heights lower than 0 or higher than 256 in other dimensions
  • +
  • Dolphin’s Grace potion effect visuals (effects should still work correctly)
  • +
  • Invisible item frames
  • +
  • Blocks (excluding jack-o-lantern) on entity heads (E.G. armor stands, players)
  • +
  • Saddled camels unmoveable/unrideable on bedrock.
  • +
  • Bedrock edition players cannot see the changes to fence block states made by the Java Debug Stick.
  • +
+ +

The following changes are supported with the GeyserOptionalPack, which is a Bedrock resource pack you can install for additional functionality for features Bedrock does not natively support:

+
    +
  • Custom armor stand poses
  • +
  • Illusioners
  • +
  • Hit particles and other miscellaneous particles not natively in Bedrock
  • +
  • Offhand animations
  • +
  • Shulker invisibility
  • +
  • Spectral arrow texture
  • +
+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/custom-blocks/index.html b/_site/geyser/custom-blocks/index.html new file mode 100644 index 0000000..22601bc --- /dev/null +++ b/_site/geyser/custom-blocks/index.html @@ -0,0 +1,1324 @@ + + + + + + + + GeyserMC Wiki: Custom blocks with Geyser + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Custom blocks with Geyser

+ +

To setup custom blocks in geyser, you have to choose how you are going to register your blocks. The easiest is using a json file but you can also use a Geyser extension.

+ +

It should be noted that blocks and their associated components are not very stable. Mojang tends to make changes to these much more often than they do for items. This means that any components Geyser allows you to register are liable to break in future versions of Bedrock.

+ +

Enabling custom blocks

+ +

Before beginning, ensure that add-non-bedrock-items is set to true in your config.yml file.

+ +
# Whether to add any items and blocks which normally does not exist in Bedrock Edition.
+# This should only need to be disabled if using a proxy that does not use the "transfer packet" style of server switching.
+# If this is disabled, furnace minecart items will be mapped to hopper minecart items.
+# Geyser's block, item, and skull mappings systems will also be disabled.
+# This option requires a restart of Geyser in order to change its setting.
+add-non-bedrock-items: true
+
+ +

JSON mappings

+ +

The JSON mappings use a similar structure to that of behavior packs registering blocks. The equivalent components are listed in the Minecraft: Bedrock Edition Creator Documentation.

+ +

Custom mappings files that register blocks or items should be placed in the custom_mappings folder. This folder is created when you start your server. It is located in the same folder as the Geyser-Standalone.jar file for standalone and inside your Geyser data folder for a plugin. If you do not have this folder, ensure you are on the latest version of Geyser.

+ +

Example mappings file

+ +
{
+	"format_version": 1,
+	"blocks": {
+		"minecraft:granite_wall": {
+			"name": "my_block",
+			"display_name": "Custom Granite Wall",
+			"geometry": "geometry.blocks.my_block_geo",
+			"material_instances": {
+				"*": {
+					"texture": "some_texture",
+					"render_method": "alpha_test",
+					"face_dimming": true,
+					"ambient_occlusion": true
+				}
+			},
+			"tags": ["stone", "wall"],
+			"state_overrides": {
+				"east=none,north=none,south=none,up=true,waterlogged=true,west=none": {
+					"geometry": "geometry.blocks.my_other_block_geo",
+					"destructible_by_mining": 10,
+					"place_air": false
+				},
+				"east=none,north=none,south=none,up=false,waterlogged=true,west=tall": {
+					"friction": 0.6,
+					"light_emission": 7,
+					"light_dampening": 8,
+					"transformation": {
+                        "scale": [0.5, 0.5, 0.5],
+                        "translation": [1, 0, 0],
+                        "rotation": [0, 90, 0]
+                    }
+				},
+				"east=none,north=none,south=low,up=true,waterlogged=true,west=tall": {
+					"placement_filter": {
+						"conditions": [{
+							"allowed_faces": ["up", "down"],
+							"block_filter": [{
+									"tags": "!query.any_tag('stone')"
+								},
+								"minecraft:dirt"
+							]
+						}]
+					}
+				}
+			}
+		}
+	}
+}
+
+ +

Schema

+ +

The following details the schema for the mappings file. Only the name field is strictly required. All other fields are optional.

+ +
+ +
    +
  • format_version: +
      +
    • Type: integer +
        +
      • Description: The version of the format of the mappings file.
      • +
      +
    • +
    +
  • +
  • blocks: +
      +
    • Type: object +
        +
      • Description: An object containing a list of block definitions. +
          +
        • minecraft:some_block: +
            +
          • Type: object +
              +
            • Description: A block definition to be used to override the specified java block. +
                +
              • name: +
                  +
                • Type: string +
                    +
                  • Default: none
                  • +
                  • Description: The name of the custom block.
                  • +
                  +
                • +
                +
              • +
              • collision_box: +
                  +
                • Type: object +
                    +
                  • origin: +
                      +
                    • Type: array +
                        +
                      • Default: Inferred from overridden block
                      • +
                      • Description: An array of x, y, and z origin values
                      • +
                      • Range: Must be in range [-8, 0, -8] to [8, 16, 8], inclusive +
                          +
                        • items: +
                            +
                          • Type: float +
                              +
                            • Default: Inferred from overridden block
                            • +
                            • Description: An origin value for a single axis
                            • +
                            +
                          • +
                          +
                        • +
                        +
                      • +
                      +
                    • +
                    +
                  • +
                  • size: +
                      +
                    • Type: array +
                        +
                      • Default: Inferred from overridden block
                      • +
                      • Description: An array of x, y, and z size values +
                          +
                        • items: +
                            +
                          • Type: float +
                              +
                            • Default: Inferred from overridden block
                            • +
                            • Description: An size value for a single axis
                            • +
                            +
                          • +
                          +
                        • +
                        +
                      • +
                      +
                    • +
                    +
                  • +
                  • Range: Addittion of origin and size must be in range [-8, 0, -8] to [8, 16, 8], inclusive.
                  • +
                  +
                • +
                +
              • +
              • destructible_by_mining: +
                  +
                • Type: integer +
                    +
                  • Default: Inferred from overridden block
                  • +
                  • Description: The time in seconds to mine the block with base tools.
                  • +
                  +
                • +
                +
              • +
              • display_name: +
                  +
                • Type: string +
                    +
                  • Default: the name of the custom block
                  • +
                  • Description: The display name of the block.
                  • +
                  +
                • +
                +
              • +
              • extended_collision_box: +
                  +
                • Type: object +
                    +
                  • origin: +
                      +
                    • Type: array +
                        +
                      • Default: Inferred from overridden block
                      • +
                      • Description: An array of x, y, and z origin values
                      • +
                      • Range: Must be in range [-8, 0, -8] to [8, 16, 8], inclusive +
                          +
                        • items: +
                            +
                          • Type: float +
                              +
                            • Default: Inferred from overridden block
                            • +
                            • Description: An origin value for a single axis
                            • +
                            +
                          • +
                          +
                        • +
                        +
                      • +
                      +
                    • +
                    +
                  • +
                  • size: +
                      +
                    • Type: array +
                        +
                      • Default: Inferred from overridden block
                      • +
                      • Description: An array of x, y, and z size values +
                          +
                        • items: +
                            +
                          • Type: float +
                              +
                            • Default: Inferred from overridden block
                            • +
                            • Description: An size value for a single axis
                            • +
                            +
                          • +
                          +
                        • +
                        +
                      • +
                      +
                    • +
                    +
                  • +
                  • Range: Addittion of origin and size must be in range [-8, 0, -8] to [8, 16, 8], inclusive.
                  • +
                  +
                • +
                +
              • +
              • friction: +
                  +
                • Type: float +
                    +
                  • Range: 0.0 to 1.0
                  • +
                  • Default: 0.4
                  • +
                  • Description: The friction value for entities traversing the block.
                  • +
                  +
                • +
                +
              • +
              • geometry: +
                  +
                • Type: string +
                    +
                  • Default: none
                  • +
                  • Description: The geometry identifier of the block.
                  • +
                  +
                • +
                • Type: object +
                    +
                  • Description: The geometry of the block with bone visbility filters +
                      +
                    • identifier +
                        +
                      • Type: string +
                          +
                        • Default: none
                        • +
                        • Description: The geometry identifier of the block.
                        • +
                        +
                      • +
                      +
                    • +
                    • bone_visibility: +
                        +
                      • Type: object +
                          +
                        • Description: An object containing the bone visibility filters for the block. +
                            +
                          • bone_name: +
                              +
                            • Type: string +
                                +
                              • Default: none
                              • +
                              • Description: A molang string dictating whether the bone is visible.
                              • +
                              +
                            • +
                            • Type: boolean +
                                +
                              • Default: none
                              • +
                              • Description: Whether the bone is visible.
                              • +
                              +
                            • +
                            +
                          • +
                          +
                        • +
                        +
                      • +
                      +
                    • +
                    +
                  • +
                  +
                • +
                +
              • +
              • light_emission: +
                  +
                • Type: integer +
                    +
                  • Range: 0 to 15
                  • +
                  • Default: 0
                  • +
                  • Description: The amount of light emitted by the block.
                  • +
                  +
                • +
                +
              • +
              • light_dampening: +
                  +
                • Type: integer +
                    +
                  • Range: 0 to 15
                  • +
                  • Default: 15
                  • +
                  • Description: The amount of light dampened by the block as it passes through.
                  • +
                  +
                • +
                +
              • +
              • material_instances: +
                  +
                • Type: object +
                    +
                  • Description: An object containing the material instances for the block. +
                      +
                    • key: +
                        +
                      • Type: object +
                          +
                        • Description: The default material instance for the block. Other globs or specific instances can be used. +
                            +
                          • texture: +
                              +
                            • Type: string +
                                +
                              • Default: the name of the custom block
                              • +
                              • Description: The texture resource path of the block.
                              • +
                              +
                            • +
                            +
                          • +
                          • render_method: +
                              +
                            • Type: string +
                                +
                              • Default: alpha_test
                              • +
                              • Description: The render method used for the block.
                              • +
                              +
                            • +
                            +
                          • +
                          • face_dimming: +
                              +
                            • Type: boolean +
                                +
                              • Default: false
                              • +
                              • Description: Whether face dimming is enabled for the block.
                              • +
                              +
                            • +
                            +
                          • +
                          • ambient_occlusion: +
                              +
                            • Type: boolean +
                                +
                              • Default: false
                              • +
                              • Description: Whether ambient occlusion is enabled for the block.
                              • +
                              +
                            • +
                            +
                          • +
                          +
                        • +
                        +
                      • +
                      +
                    • +
                    +
                  • +
                  +
                • +
                +
              • +
              • place_air: +
                  +
                • Type: boolean +
                    +
                  • Default: true
                  • +
                  • Description: Whether the block should place air to prevent double placement.
                  • +
                  +
                • +
                +
              • +
              • placement_filter: +
                  +
                • Type: object +
                    +
                  • Description: An object containing the placement filter for the block. +
                      +
                    • conditions: +
                        +
                      • Type: array +
                          +
                        • Description: An array of conditions that must be met for the block to be placed. +
                            +
                          • allowed_faces: +
                              +
                            • Type: array +
                                +
                              • Description: An array of faces that the block can be placed on. +
                                  +
                                • items: +
                                    +
                                  • Type: string +
                                      +
                                    • Range: up, down, north, south, east, west
                                    • +
                                    • Description: A face that the block can be placed on.
                                    • +
                                    +
                                  • +
                                  +
                                • +
                                • block_filter: +
                                    +
                                  • Type: array +
                                      +
                                    • Description: An array of blocks or true molang queries that the block can be placed on. +
                                        +
                                      • items: +
                                          +
                                        • Type: string +
                                            +
                                          • Description: A block that the block can be placed on. +
                                              +
                                            • Type object +
                                                +
                                              • Description: Holds a true molang query that the block can be placed on. +
                                                  +
                                                • tags: +
                                                    +
                                                  • Type: array +
                                                      +
                                                    • Description: A true molang query that the block can be placed on.
                                                    • +
                                                    +
                                                  • +
                                                  +
                                                • +
                                                +
                                              • +
                                              +
                                            • +
                                            +
                                          • +
                                          +
                                        • +
                                        +
                                      • +
                                      +
                                    • +
                                    +
                                  • +
                                  +
                                • +
                                +
                              • +
                              +
                            • +
                            +
                          • +
                          +
                        • +
                        +
                      • +
                      +
                    • +
                    +
                  • +
                  +
                • +
                +
              • +
              • selection_box: +
                  +
                • Type: object +
                    +
                  • origin: +
                      +
                    • Type: array +
                        +
                      • Default: Inferred from overridden block
                      • +
                      • Description: An array of x, y, and z origin values
                      • +
                      • Range: Must be in range [-8, 0, -8] to [8, 16, 8], inclusive +
                          +
                        • items: +
                            +
                          • Type: float +
                              +
                            • Default: Inferred from overridden block
                            • +
                            • Description: An origin value for a single axis
                            • +
                            +
                          • +
                          +
                        • +
                        +
                      • +
                      +
                    • +
                    +
                  • +
                  • size: +
                      +
                    • Type: array +
                        +
                      • Default: Inferred from overridden block
                      • +
                      • Description: An array of x, y, and z size values +
                          +
                        • items: +
                            +
                          • Type: float +
                              +
                            • Default: Inferred from overridden block
                            • +
                            • Description: An size value for a single axis
                            • +
                            +
                          • +
                          +
                        • +
                        +
                      • +
                      +
                    • +
                    +
                  • +
                  • Range: Addittion of origin and size must be in range [-8, 0, -8] to [8, 16, 8], inclusive.
                  • +
                  +
                • +
                +
              • +
              • tags: +
                  +
                • Type: array +
                    +
                  • Description: An array of tags associated with the block. +
                      +
                    • items: +
                        +
                      • Type: string
                      • +
                      +
                    • +
                    +
                  • +
                  +
                • +
                +
              • +
              • transformation: +
                  +
                • Type: object +
                    +
                  • Description: Translation, scale, and rotation values to apply to the block. +
                      +
                    • scale +
                        +
                      • Type: array +
                          +
                        • Default: [1, 1, 1]
                        • +
                        • Description: An array of x, y, and z scale values +
                            +
                          • items: +
                              +
                            • Type: float +
                                +
                              • Default: 1
                              • +
                              • Description: A scale value for a single axis
                              • +
                              +
                            • +
                            +
                          • +
                          +
                        • +
                        +
                      • +
                      +
                    • +
                    • translation: +
                        +
                      • Type: array +
                          +
                        • Default: [0, 0, 0]
                        • +
                        • Description: An array of x, y, and z translation values +
                            +
                          • items: +
                              +
                            • Type: float +
                                +
                              • Default: 0
                              • +
                              • Description: A translation value for a single axis
                              • +
                              +
                            • +
                            +
                          • +
                          +
                        • +
                        +
                      • +
                      +
                    • +
                    • rotation +
                        +
                      • Type: array +
                          +
                        • Default: [0, 0, 0]
                        • +
                        • Description: An array of x, y, and z rotation values in increments of 90 degrees (e.g. [90, -180, 0]) +
                            +
                          • items: +
                              +
                            • Type: integer +
                                +
                              • Range: 0, 90, 180, & 270
                              • +
                              • Default: 0
                              • +
                              • Description: A rotation value for a single axis
                              • +
                              +
                            • +
                            +
                          • +
                          +
                        • +
                        +
                      • +
                      +
                    • +
                    +
                  • +
                  +
                • +
                +
              • +
              • unit_cube: +
                  +
                • Type: boolean +
                    +
                  • Default: false
                  • +
                  • Description: Whether a unit cube is to be used with tessellation.
                  • +
                  +
                • +
                +
              • +
              • creative_category: +
                  +
                • Type: string +
                    +
                  • Default: building_blocks
                  • +
                  • Description: The creative category to place the block in.
                  • +
                  • Range: See Creative Categories on the Bedrock Wiki.
                  • +
                  +
                • +
                +
              • +
              • creative_group: +
                  +
                • Type: string +
                    +
                  • Default: none
                  • +
                  • Description: The creative group to place the block in.
                  • +
                  • Range: See Creative Tabs on the Bedrock Wiki.
                  • +
                  +
                • +
                +
              • +
              • included_in_creative_inventory: +
                  +
                • Type: boolean +
                    +
                  • Default: true
                  • +
                  • Description: Whether the block is included in the creative inventory.
                  • +
                  +
                • +
                +
              • +
              • only_override_states: +
                  +
                • Type: boolean +
                    +
                  • Default: false
                  • +
                  • Description: Whether the block should only override the states specified in state_overrides.
                  • +
                  +
                • +
                +
              • +
              • state_overrides: +
                  +
                • Type: object +
                    +
                  • Description: An object containing state overrides for the block. +
                      +
                    • property1=value1,property2=value2,...: +
                        +
                      • Type: object +
                          +
                        • Description: An override for a specific block state. Possible states are listed in Geyser’s Block Mappings
                        • +
                        • Accepts all of the same properties as a block definition except creative_category, creative_group, included_in_creative_inventory, only_override_states, and state_overrides.
                        • +
                        +
                      • +
                      +
                    • +
                    +
                  • +
                  +
                • +
                +
              • +
              +
            • +
            +
          • +
          +
        • +
        +
      • +
      +
    • +
    +
  • +
+ +
+ +

Geyser extensions

+ +

In this example, we will create a custom block that overrides the vanilla redstone dot. This block will be placed on top of a block and will emit a visible redstone signal when powered.

+ +

First, create a class that implements Geyser’s Extension class:

+ +
public class RedstoneDot implements Extension {
+    //...
+}
+
+ +

Next, create a method to register your blocks in the GeyserDefineCustomBlocksEvent:

+ +
public class RedstoneDot implements Extension {
+    @Subscribe
+    public void onDefineCustomBlocks(GeyserDefineCustomBlocksEvent event) {
+        //...
+    }
+}
+
+ +

Build the CustomBlockComponents, CustomBlockData, and list of CustomBlockPermutation (if needed) for the block:

+ +
public class RedstoneDot implements Extension {
+    @Subscribe
+    public void onDefineCustomBlocks(GeyserDefineCustomBlocksEvent event) {
+        BoxComponent selectionBox = new BoxComponent(-5, 0, -5, 10, 1f, 10);
+
+        CustomBlockComponents components = CustomBlockComponents.builder()
+                .collisionBox(BoxComponent.EMPTY_BOX)
+                .selectionBox(selectionBox)
+                .geometry(new GeometryComponentBuilder()
+                    .identifier("geometry.amberichu.redstone_dot")
+                    .build())
+                .destroyTime(0f)
+                .lightEmission(0)
+                .lightDampening(0)
+                .friction(1f)
+                .build();
+
+        CustomBlockData redstoneDot = CustomBlockData.builder()
+                .name("redstone_dot")
+                .intProperty(POWER_PROPERTY, IntStream.range(0, 16).boxed().toList())
+                .components(components)
+                .permutations(createRedstoneDotPermutations())
+                .build();
+
+        // ...
+    }
+
+    private List<CustomBlockPermutation> createRedstoneDotPermutations() {
+        List<CustomBlockPermutation> permutations = new ArrayList<>();
+        for (int power = 0; power < 16; power++) {
+            String texture = "amberichu.redstone_dot" + power;
+            MaterialInstance invisMaterialInstance = MaterialInstance.builder()
+                        .texture("amberichu.invisible")
+                        .renderMethod("alpha_test")
+                        .faceDimming(false)
+                        .ambientOcclusion(false)
+                        .build();
+            CustomBlockComponents components = CustomBlockComponents.builder()
+                    .materialInstance("up", MaterialInstance.builder()
+                        .texture(texture)
+                        .renderMethod("alpha_test")
+                        .faceDimming(false)
+                        .ambientOcclusion(false)
+                        .build())
+                    .materialInstance("down", invisMaterialInstance)
+                    .materialInstance("north", invisMaterialInstance)
+                    .materialInstance("south", invisMaterialInstance)
+                    .materialInstance("east", invisMaterialInstance)
+                    .materialInstance("west", invisMaterialInstance)
+                    .build();
+            String condition = String.format("query.block_property('%s') == %d", POWER_PROPERTY, power);
+            permutations.add(new CustomBlockPermutation(components, condition));
+        }
+        return permutations;
+    }
+}
+
+ +

Finally, register the custom block, block state overrides, and block item overrides:

+ +
public class RedstoneDot implements Extension {
+    @Subscribe
+    public void onDefineCustomBlocks(GeyserDefineCustomBlocksEvent event) {
+        BoxComponent selectionBox = new BoxComponent(-5, 0, -5, 10, 1f, 10);
+
+        CustomBlockComponents components = CustomBlockComponents.builder()
+                .collisionBox(BoxComponent.EMPTY_BOX)
+                .selectionBox(selectionBox)
+                .geometry(new GeometryComponentBuilder()
+                    .identifier("geometry.amberichu.redstone_dot")
+                    .build())
+                .destroyTime(0f)
+                .lightEmission(0)
+                .lightDampening(0)
+                .friction(1f)
+                .build();
+
+        CustomBlockData redstoneDot = CustomBlockData.builder()
+                .name("redstone_dot")
+                .intProperty(POWER_PROPERTY, IntStream.range(0, 16).boxed().toList())
+                .components(components)
+                .permutations(createRedstoneDotPermutations())
+                .build();
+
+        event.registerCustomBlock(redstoneDot);
+        event.registerBlockItemOverride("minecraft:redstone_wire", redstoneDot);
+
+        for (int power = 0; power < 16; power++) {
+            String javaIdentifier = String.format("minecraft:redstone_wire[east=none,north=none,power=%d,south=none,west=none]", power);
+            event.registerBlockStateOverride(javaIdentifier, redstoneDot.blockStateBuilder()
+                    .intProperty(POWER_PROPERTY, power)
+                    .build());
+        }
+    }
+
+    private List<CustomBlockPermutation> createRedstoneDotPermutations() {
+        List<CustomBlockPermutation> permutations = new ArrayList<>();
+        for (int power = 0; power < 16; power++) {
+            String texture = "amberichu.redstone_dot" + power;
+            MaterialInstance invisMaterialInstance = MaterialInstance.builder()
+                        .texture("amberichu.invisible")
+                        .renderMethod("alpha_test")
+                        .faceDimming(false)
+                        .ambientOcclusion(false)
+                        .build();
+            CustomBlockComponents components = CustomBlockComponents.builder()
+                    .materialInstance("up", MaterialInstance.builder()
+                        .texture(texture)
+                        .renderMethod("alpha_test")
+                        .faceDimming(false)
+                        .ambientOcclusion(false)
+                        .build())
+                    .materialInstance("down", invisMaterialInstance)
+                    .materialInstance("north", invisMaterialInstance)
+                    .materialInstance("south", invisMaterialInstance)
+                    .materialInstance("east", invisMaterialInstance)
+                    .materialInstance("west", invisMaterialInstance)
+                    .build();
+            String condition = String.format("query.block_property('%s') == %d", POWER_PROPERTY, power);
+            permutations.add(new CustomBlockPermutation(components, condition));
+        }
+        return permutations;
+    }
+}
+
+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/custom-items/index.html b/_site/geyser/custom-items/index.html new file mode 100644 index 0000000..ec80e58 --- /dev/null +++ b/_site/geyser/custom-items/index.html @@ -0,0 +1,601 @@ + + + + + + + + GeyserMC Wiki: Custom items with Geyser + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Custom items with Geyser

+ +

To setup custom items in geyser, you have to choose how you are going to register your items. The easiest is using a json file but you can also use a Geyser extension.

+ +

JSON mappings

+ +
    +
  1. Start your server, and you should have a folder called custom_mappings that is created. That would be with the folder of Geyser.jar file for standalone and inside your Geyser data folder for a plugin.
  2. +
  3. Create a .json file, it can be any name you like and as many files as you like. You don’t need to make one file per item. Here is the structure of the file: +
    {
    + "format_version": 1,
    + "items": {
    +
    + }
    +}
    +
    +
  4. +
  5. Inside the items entry, you can add your java item to extend:
  6. +
+ +
"minecraft:JAVA_ITEM": [
+
+]
+
+
    +
  1. Inside this java item, goes an array of all your custom items.
  2. +
+ +
{
+    "name": "my_item"
+}
+
+
    +
  1. Then, you need to set one or more item options or registrations, they can be stacked, so that all of the specified types need to match. +
      +
    • Custom model data: custom_model_data (int)
    • +
    • Damage predicate: damage_predicate (int) This is a fractional value of damage/max damage and not a number between 0 and 1.
    • +
    • Unbreakable: unbreakable (boolean)
    • +
    +
  2. +
  3. You also have some extra modifiers that you can set to further customise your item. Note that the following modifiers are NOT required. +
      +
    • display_name (string) default: item name
    • +
    • icon (string) default: item name
    • +
    • allow_offhand (boolean) default: false
    • +
    • texture_size (int) default: 16
    • +
    • render_offsets (object) It works as follows. Note that all the sub-objects are optional, except x, y and z. You can have for example only a main hand with a position, and noting else. default: no render offset +
       "render_offsets": {
      +  "main_hand": {
      +      "first_person": {
      +          "position": {
      +              "x": 0,
      +              "y": 0,
      +              "z": 0
      +          },
      +          "rotation": {
      +              "x": 0,
      +              "y": 0,
      +              "z": 0
      +          },
      +          "scale": {
      +              "x": 0,
      +              "y": 0,
      +              "z": 0
      +          }
      +      },
      +      "third_person": {
      +
      +      }
      +  },
      +  "off_hand": {
      +
      +  }
      + }
      +
      +
    • +
    +
  4. +
+ +

Geyser extensions

+ +

Extending a vanilla item

+ +
    +
  1. Create your custom item options or registrations, to which you can add any of the following. They can be stacked, so that all of the specified types need to match, but you do NOT need all of them. +
    CustomItemOptions itemOptions = CustomItemOptions.builder()
    +     .customModelData(1)
    +     .damagePredicate(1) //This is a fractional value of damage/max damage and not a number between 0 and 1.
    +     .unbreakable(true)
    +     .build();
    +
    +
  2. +
  3. Create your custom item, and store it somewhere: +
    CustomItemData data = CustomItemData.builder()
    +     .name("my_item")
    +     .customItemOptions(itemOptions)
    +     .build();
    +
    +
  4. +
  5. You have some modifiers that you can set to further customise your item. Note that the following modifiers are NOT required. +
    .displayName("displayName"); //Default: item name
    +.icon("my_icon"); //Default: item name
    +.allowOffhand(false); //Default: false
    +.textureSize(16); //Default: 16
    +.renderOffsets(new CustomRenderOffsets(...)); //Default: no render offset
    +
    +
  6. +
  7. Then, in your pre init event, you can register your item: +
    @Subscribe
    +public void onGeyserPreInitializeEvent(GeyserDefineCustomItemsEvent event) {
    + event.registerCustomItem("minecraft:JAVA_ITEM", data);
    +}
    +
    +
  8. +
+ +

Non vanilla (modded) items with Geyser extensions (for example to use with Fabric)

+ +
    +
  1. Create your item data: +
    NonVanillaCustomItemData data = NonVanillaCustomItemData.builder()
    +     .name("my_item")
    +     .identifier("my_mod:my_item")
    +     .javaId(1)
    +
    +
  2. +
  3. There are many other options you can set to match the behavior that you require for your item. You can see them here
  4. +
  5. Register your item in the GeyserDefineCustomItems event: +
    @Subscribe
    +public void onGeyserDefineCustomItemsEvent(GeyserDefineCustomItemsEvent event) {
    + event.register(data);
    +}
    +
    +
  6. +
+ +

Resource pack

+ +
    +
  1. Setup a basic bedrock resource pack. If you need help, you can find it here.
  2. +
  3. Make a textures folder.
  4. +
  5. Create item_texture.json in the textures, and put this in it:
  6. +
+ +
{
+  "resource_pack_name": "MY_PACK_NAME_HERE",
+  "texture_name": "atlas.items",
+  "texture_data": {
+
+  }
+}
+
+
    +
  1. Inside texture data, you can add your items. The texture name and path must match the name that you set in your mappings.
  2. +
+ +
"my_item": {
+    "textures": [
+        "textures/items/my_item"
+    ]
+}
+
+
    +
  1. Then you need to put your textures inside the textures/items. Make sure to have it match the texture path that you specified in item_texture.json!
  2. +
+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/custom-skulls/index.html b/_site/geyser/custom-skulls/index.html new file mode 100644 index 0000000..1287221 --- /dev/null +++ b/_site/geyser/custom-skulls/index.html @@ -0,0 +1,562 @@ + + + + + + + + GeyserMC Wiki: Custom skulls with Geyser + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Custom skulls with Geyser

+ +

Unlike Java Edition, Bedrock does not have native support for custom skull items. As a result, any method to display custom skulls with Geyser is, to some extent, a workaround. Geyser has long supported in-world custom skulls via the spawning of player entities. This, however, does not allow for the use of custom skulls in inventories, nor does it allow them to be worn by entities. To resolve this, Geyser now allows for the pre-registration of custom skulls via a config file. Geyser will then use this config file to generate a custom resource pack on start that contains the geometry and textures for the pre-registered custom skulls. To the client, these skulls are blocks. Therefore, they can be held in player inventories. In additional, attachables are defined for each skull block so that it is displayed correctly when worn and held by entities.

+ +

To setup custom skulls in geyser, you have to choose how you are going to register your blocks. The easiest is using custom-skulls.yml but you can also use a Geyser extension.

+ +

Enabling custom skulls

+ +

To enable custom skulls, you must set add-non-bedrock-items to true in the config.yml file. This will enable the generation of the custom resource pack and the translation of custom skulls to custom blocks. You can then add custom skulls to the custom-skulls.yml file.

+ +
# Whether to add any items and blocks which normally does not exist in Bedrock Edition.
+# This should only need to be disabled if using a proxy that does not use the "transfer packet" style of server switching.
+# If this is disabled, furnace minecart items will be mapped to hopper minecart items.
+# Geyser's block, item, and skull mappings systems will also be disabled.
+# This option requires a restart of Geyser in order to change its setting.
+add-non-bedrock-items: true
+
+ +

custom-skulls.yml

+ +

The configuration file custom-skulls.yml is present in Geyser’s configuration folder and is laid out as follows:

+ +
# --------------------------------
+# Geyser Custom Skull Configuration Files
+#
+# This file is ignored with `add-custom-skull-blocks` disabled.
+# See `config.yml` for the main set of configuration values
+#
+# Custom skulls with the player username, UUID, or texture specified in this file
+# will be translated as custom blocks and be displayed in the inventory and on entities.
+# --------------------------------
+
+# Java player usernames
+# Skins will be updated when Geyser starts and players will have to re-download
+# the resource pack if any players had changed their skin.
+player-usernames:
+  - GeyserMC
+
+# Java player UUIDs
+# Skins will be updated when Geyser starts and players will have to re-download
+# the resource pack if any players had changed their skin.
+player-uuids:
+  - 8b8d8e8f-2759-47c6-acb5-5827de8a72b8
+
+# The long string of characters found in the NBT of custom player heads
+player-profiles:
+  - ewogICJ0aW1lc3RhbXAiIDogMTY1NzMyMjIzOTgzMywKICAicHJvZmlsZUlkIiA6ICJjZGRiZTUyMGQwNDM0YThiYTFjYzlmYzkyZmRlMmJjZiIsCiAgInByb2ZpbGVOYW1lIiA6ICJBbWJlcmljaHUiLAogICJ0ZXh0dXJlcyIgOiB7CiAgICAiU0tJTiIgOiB7CiAgICAgICJ1cmwiIDogImh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYTkwNzkwYzU3ZTE4MWVkMTNhZGVkMTRjNDdlZTJmN2M4ZGUzNTMzZTAxN2JhOTU3YWY3YmRmOWRmMWJkZTk0ZiIsCiAgICAgICJtZXRhZGF0YSIgOiB7CiAgICAgICAgIm1vZGVsIiA6ICJzbGltIgogICAgICB9CiAgICB9CiAgfQp9
+
+# The hash of the skin on Minecraft's skin server
+skin-hashes:
+  - a90790c57e181ed13aded14c47ee2f7c8de3533e017ba957af7bdf9df1bde94f
+
+ +

Player usernames

+ +

Skulls can be registered in this section via player usernames. These will be updated when Geyser starts. As a result, they may change if the player’s username or skin changes.

+ +

Player UUIDs

+ +

Skulls can be registered in this section via player UUIDs. These will be updated when Geyser starts. As a result, they may change if skin changes.

+ +

Player profiles

+ +

Skulls can be registered in this section via the texture string found in the NBT of custom player heads. Unless the value is changed manually, these will not be updated when Geyser starts. As a result, they will not change if the player’s username or skin changes. The data is simply base64 encoded JSON. For instance, the example given in the config decodes as follows:

+ +
{
+  "timestamp" : 1657322239833,
+  "profileId" : "cddbe520d0434a8ba1cc9fc92fde2bcf",
+  "profileName" : "Amberichu",
+  "textures" : {
+    "SKIN" : {
+      "url" : "http://textures.minecraft.net/texture/a90790c57e181ed13aded14c47ee2f7c8de3533e017ba957af7bdf9df1bde94f",
+      "metadata" : {
+        "model" : "slim"
+      }
+    }
+  }
+}
+
+ +

If on a paper server, this data can be obtained for a skull by holding the item in hand, and running the command /paper dumpitem. This will output the NBT data of the item to chat and console. The texture string is found in the SkullOwner tag, under the Properties tag, under the textures tag, under the Value tag. For example:

+ +
[05:58:07 INFO]: .KastleFirefox issued server command: /paper dumpitem
+[05:58:07 INFO]: minecraft:player_head{display: {Name: '{"text":"Test"}'}, SkullOwner: {Properties: {textures: [{Value: "ewogICJ0aW1lc3RhbXAiIDogMTY1NzMyMjIzOTgzMywKICAicHJvZmlsZUlkIiA6ICJjZGRiZTUyMGQwNDM0YThiYTFjYzlmYzkyZmRlMmJjZiIsCiAgInByb2ZpbGVOYW1lIiA6ICJkYXZjaG9vIiwKICAidGV4dHVyZXMiIDogewogICAgIlNLSU4iIDogewogICAgICAidXJsIiA6ICJodHRwOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlL2E5MDc5MGM1N2UxODFlZDEzYWRlZDE0YzQ3ZWUyZjdjOGRlMzUzM2UwMTdiYTk1N2FmN2JkZjlkZjFiZGU5NGYiLAogICAgICAibWV0YWRhdGEiIDogewogICAgICAgICJtb2RlbCIgOiAic2xpbSIKICAgICAgfQogICAgfQogIH0KfQ"}]}, Id: [I; -229048314, -553040501, -1407961158, 465313087]}}
+
+ +

Skin Hashes

+ +

Skulls can be registered in this section via the hash of the skin on Minecraft’s skin server. This is found at the end of the URL. For example, in the URL http://textures.minecraft.net/texture/a90790c57e181ed13aded14c47ee2f7c8de3533e017ba957af7bdf9df1bde94f the hash is a90790c57e181ed13aded14c47ee2f7c8de3533e017ba957af7bdf9df1bde94f.Unless the value is changed manually, these will not be updated when Geyser starts. As a result, they will not change if the player’s username or skin changes.

+ +

This can be obtained by decoding the base64 data obtained from a player profile.

+ +

Geyser extensions

+ +

In this example, we will register a custom skull from a player profile. We will use the player profile from the example above.

+ +

First, create a class that implements Geyser’s Extension class:

+ +
public class RegisterCustomSkull implements Extension {
+    //...
+}
+
+ +

Next, create a method to register your blocks in the GeyserDefineCustomSkullsEvent:

+ +
public class RegisterCustomSkull implements Extension {
+    @Subscribe
+    public void onDefineCustomSkulls(GeyserDefineCustomSkullsEvent event) {
+        //...
+    }
+}
+
+ +

Finally, register your skull in the event. Use the enum SkullTextureType to specify that the value being passed is a player profile:

+ +
public class RegisterCustomSkull implements Extension {
+    @Subscribe
+    public void onDefineCustomSkulls(GeyserDefineCustomSkullsEvent event) {
+        String profile = "ewogICJ0aW1lc3RhbXAiIDogMTY1NzMyMjIzOTgzMywKICAicHJvZmlsZUlkIiA6ICJjZGRiZTUyMGQwNDM0YThiYTFjYzlmYzkyZmRlMmJjZiIsCiAgInByb2ZpbGVOYW1lIiA6ICJkYXZjaG9vIiwKICAidGV4dHVyZXMiIDogewogICAgIlNLSU4iIDogewogICAgICAidXJsIiA6ICJodHRwOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlL2E5MDc5MGM1N2UxODFlZDEzYWRlZDE0YzQ3ZWUyZjdjOGRlMzUzM2UwMTdiYTk1N2FmN2JkZjlkZjFiZGU5NGYiLAogICAgICAibWV0YWRhdGEiIDogewogICAgICAgICJtb2RlbCIgOiAic2xpbSIKICAgICAgfQogICAgfQogIH0KfQ"
+        event.registerCustomSkull(profile, SkullTextureType.PROFILE);
+    }
+}
+
+ +

Scraping custom skulls from a world

+ +

Custom skulls can be extracted from an existing world for easy implementation via mappings or API using the tool HeadExtractor made by Amberichu. See the linked repository for usage instructions.

+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/events/index.html b/_site/geyser/events/index.html new file mode 100644 index 0000000..b37acde --- /dev/null +++ b/_site/geyser/events/index.html @@ -0,0 +1,533 @@ + + + + + + + + GeyserMC Wiki: Geyser Events + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Geyser Events

+

Geyser has a powerful event system that allows you to listen to events that are sent by Geyser. Events are at the heart of Geyser Extensions, and can be used by plugins and mods as well.

+ +

Full documentation can be found here.

+ +

Event Categories

+

To use events in a Spigot/Paper plugin or a Fabric mod, you need to register the Geyser Event Bus as a listener and then subscribe to the events you want to listen to. +Extensions can use the @Subscribe annotation.

+ +

Events are categorized into the following categories:

+
    +
  • Bedrock: Events that are sent for each connecting Bedrock client, +for example the ClientEmoteEvent that is sent when a Bedrock player uses an emote - or the SessionLoginEvent that is sent when a Bedrock player logged in and is about to join a server.
  • +
  • Java: Events that are sent for the java server, for example +the ServerDefineCommandsEvent - it is fired when the Java sends the commands to show for Bedrock players.
  • +
  • Connection: Connection-related events, such as a ping event to return e.g. a custom MOTD.
  • +
  • Lifecycle: Events that are sent during Geyser’s lifecycle, such as the loading of custom items, resource packs, or Geyser commands.
  • +
+ +

To see all the events in the respective categories, click on the links above.

+ +

Usage Examples:

+ +

Each method that you want to subscribe to an event needs to be annotated with the @Subscribe annotation (from the GeyserMC events package).

+
@Subscribe
+public void onGeyserLoadResourcePacksEvent(GeyserLoadResourcePacksEvent event) {
+    logger().info("Loading: " + event.resourcePacks().size() + " resource packs.");
+    // you could add a resource pack with event.resourcePacks().add(path-to-pack)
+}
+
+

If you wish to listen to events in a Spigot/Paper plugin or a Fabric mod, you need to register the Geyser Event Bus as a listener first. Just make sure you implement EventRegistrar in the main class of your mod or plugin. +Extensions do not need to do that - they are automatically registered, so a simple @Subscribe annotation is enough.

+ +

Fabric mod example:

+
public class ExampleMod implements ModInitializer, EventRegistrar {
+    public static final Logger LOGGER = LoggerFactory.getLogger("modid");
+
+    @Override
+    public void onInitialize() {
+        ServerLifecycleEvents.SERVER_STARTING.register((server) -> {
+            GeyserApi.api().eventBus().register(this, ExampleMod.class); // register your mod & this class as a listener
+        });
+
+        LOGGER.info("Geyser is cool!");
+    }
+
+    // here an event, we subscribe as usual with the @Subscribe annotation
+    @Subscribe
+    public void onGeyserPostInitializeEvent(GeyserPostInitializeEvent eventad {
+        LOGGER.info("Geyser started!");
+    }
+}
+
+ + +

Therefore, we register it in the server starting event provided by the Fabric API.

+ +

Paper/Spigot plugin example:

+ +
    +
  1. In your plugin.yml, add the following lines: +
      depend: ["Geyser-Spigot"]
    +
    +

    This ensures that your plugin loads after Geyser has, so the Geyser API would be available.

    +
  2. +
  3. In your main class, implement the EventRegistrar interface and register the event bus in the onEnable method: +
    public class ExamplePlugin extends JavaPlugin implements EventRegistrar {
    +
    + @Override
    + public void onEnable(){
    +     getLogger().info("Registering Geyser event bus!");
    +     GeyserApi.api().eventBus().register(this, this); // register your plugin & this class as a listener
    + }
    +
    + // here an event, we subscribe as usual with the @Subscribe annotation
    + @Subscribe
    + public void onGeyserPostInitializeEvent(GeyserPostInitializeEvent event) {
    +     getLogger().info("Geyser started!");
    + }
    +}
    +
    +
  4. +
  5. If you want to provide your event with a consumer, rather than annotating it, you can also manually subscribe your method to the event bus: +
    // replace GeyserEvent.class with the event class you want to listen to
    +GeyserApi.api().eventBus().subscribe(this, GeyserEvent.class, this::yourMethod);
    +
    +
  6. +
+ +

Event Priority

+

Events can have a priority, which is used to determine the order in which the listeners are called. The default priority is NORMAL. +To (optionally) set the priority of your event listener, you can add the priority to the @Subscribe annotation:

+
@Subscribe(postOrder = PostOrder.EARLY)
+
+

If you do not specify a priority, the default priority is used. For all available priorities, see +here.

+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/extensions/index.html b/_site/geyser/extensions/index.html new file mode 100644 index 0000000..0307f69 --- /dev/null +++ b/_site/geyser/extensions/index.html @@ -0,0 +1,560 @@ + + + + + + + + GeyserMC Wiki: Geyser Extensions + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Geyser Extensions

+

Geyser Extensions are the equivalent of “plugins”, but specifically for the Geyser platform. This brings the advantage of them being platform-agnostic, meaning that you won’t have to worry about supporting all platforms individually. Additionally, they will be, by design, only applied for Bedrock players joining via Geyser.

+ +

What can Geyser Extensions do?

+

Extensions can fully utilize the Geyser API to add additional functionality to Geyser. See Geyser API docs for info on what is currently possible. To name a few examples:

+
    +
  • Register custom items and blocks
  • +
  • Hide commands from being suggested
  • +
  • Change the MOTD
  • +
  • Register your own commands
  • +
  • Listen to events, e.g. the emote event.
  • +
+ +

The underlying Geyser API is steadily expanding, creating more and more opportunities.

+ +

Which Geyser Extensions exist?

+

At the moment, extensions are still a new system, so there is only a small list of known extensions for Geyser. However, new extensions are always being created! +There is an official list of available extensions you can check out. If you have an extension you’d like to see on this list, feel free to open a PR!

+ +

Installing Extensions

+

To install an extension, simply put the extension .jar file into Geyser’s ‘extensions’ folder. Then, restart Geyser (or the server Geyser runs on).

+ +

Creating Geyser Extensions

+

The easiest way to create an extension would be utilizing this official template. Simply create a new repository from the template, customize the ‘extension.yml’ & ‘settings.gradle’ files, and get started making the extension.

+ +

Geyser recognizes extensions when they have a file called ‘extension.yml’ in the jars ‘resources’ folder.

+ +

extension.yml:

+
id: exampleid
+name: ExampleExtension
+main: org.geyser.extension.exampleid.ExampleExtension
+api: 1.0.0
+version: 1.0.0
+authors: [ExampleAuthor]
+
+ +

Explanations for the individual fields:

+
    +
  • id: The id of the extension. Every extension needs to have their unique id - all lowercase letters. If you e.g. register a command for your extension, it will have the id as a prefix: e.g. ‘/exampleid command’.
  • +
  • name: The name of the extension.
  • +
  • main: The main class of your extension.
  • +
  • api: The Base API version your extension targets.
  • +
  • authors: The author(s) of the extension. To add more than one entry, separate entries with a comma.
  • +
+ +

Creating the main class

+ +

The main class, the entrypoint for the extension, needs to implement the ‘Extension’ interface provided by Geyser. +That way, Geyser recognizes the extension, and gives you access to important methods - such as ‘logger()’, to get your extensions logger.
+To see all the methods provided by that interface, see here.

+ +

Unlike plugins, extensions do not have a ‘onEnable’ or ‘onDisable’ method. Instead, most actions are done in events at different stages during Geyser’s lifecycle using events. +Some important ones are:

+
    +
  • GeyserPreInitializeEvent: This event is fired when Geyser starts to initialize. If you e.g. need to register extension commands that are configured in your config, +you would need to load the config here to ensure that your config is ready before the GeyserDefineCommandsEvent is fired.
  • +
  • GeyserPostInitializeEvent: It is called when Geyser has completed initializing. The bulk of your code should go here, as the GeyserAPI is fully available at this stage.
  • +
  • GeyserShutdownEvent: Called when Geyser is shutting down. You can use this to e.g. save data, or clean up resources.
  • +
+ +

See below for an example:

+
@Subscribe
+public void onPostInitialize(GeyserPostInitializeEvent event) {
+    // example: show that your extension is loading.
+    this.logger().info("Loading example extension...");
+}
+
+

If you wish to register custom items, global resource packs (or soon, custom blocks and entities), you will need to subscribe to the event using the @Subscribe annotation, +and register them in the event. You can find an example for custom items here. For other events, see here for documentation.

+ +

To build your extension, run the Gradle build task, and install the extension.

+ +

Creating commands with Geyser Extensions

+

To create a command, you would need to use the “Commands” package in the Geyser API. Brief rundown:

+
    +
  • Command.java +This interface represents a command in Geyser - to make one, you can use the CommandBuilder. You can register it with the +GeyserDefineCommandsEvent
  • +
  • CommandExecutor.java +This interface represents a command execute handler in Geyser, and extends the CommandSource interface.
  • +
  • CommandSource.java +This interface represents a command source in Geyser. It can be used to e.g. send messages to the source, check if the source has permission to execute a command, or get the locale.
  • +
+ +
Command command = Command.builder(this) // "this" is the extension's main class
+        .name("ExampleCommand")
+        .bedrockOnly(true)
+        .source(CommandSource.class)
+        .aliases(List.of("example", "ex"))
+        .description("An example command")
+        .executableOnConsole(false)
+        .suggestedOpOnly(false)
+        .permission("example.command")
+        .executor((source, cmd, args) -> {
+            // this is the command executor - this is where you would put your code to execute the command.
+            // source is the source that executed the command
+            // cmd is the command that was executed
+            // args are the arguments passed to the command
+            source.sendMessage("Hello World");
+        })
+        .build();
+
+ +

To register the command, you would need to subscribe to the GeyserDefineCommandsEvent, and register the command there:

+
@Subscribe
+public void onDefineCommands(GeyserDefineCommandsEvent event) {
+    event.register(command);
+}
+
+

If everything went right, you should be able to execute the command in-game by running “/extesionid [command]” - in our case, “/exampleid examplecommand”. +Here, it would send “Hello World” to the source that ran the command. +Since we also set aliases, you could also run “/exampleid example” or “/exampleid ex” for the same command. +To provide args, simple run “/exampleid examplecommand [args]” - replacing [args] with the arguments you want to pass to the command.

+ +

Listening to Events

+

See here for documentation. You do not need to register the event listener, Geyser will do that for you.

+ +
+ +

Facing troubles with extensions?

+
    +
  • Make sure you are using the latest version of Geyser - older versions might not have the latest API changes.
  • +
  • Add debug prints.
  • +
  • Ask in the #development channel in the Geyser Discord server.
  • +
+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/faq/index.html b/_site/geyser/faq/index.html new file mode 100644 index 0000000..a9702cb --- /dev/null +++ b/_site/geyser/faq/index.html @@ -0,0 +1,1187 @@ + + + + + + + + GeyserMC Wiki: FAQ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + + +

Frequently Asked Questions

+

Here you can find answers to frequently asked questions about Geyser - if you have a question that isn’t answered here, feel free to ask in our Discord!

+

+
+ + +
+

+ +

+
+
+

Geyser works as a translator, translating both the incoming and outgoing packets to a format both the client and server can understand. With this being said, it emulates a Minecraft: Java Edition client, so the server actually thinks you’re joining from Java Edition. Regardless of the server or what plugins it has installed, you can join it with Geyser (as long as the server supports the latest vanilla (unmodified) Minecraft version).

+ +
+
+
+ + +
+

+ +

+
+
+

Redstone, along with any other mechanics like commands, farms, etc., will work exactly like Java Edition since joining a Java Edition server and Geyser does not modify server behavior.

+ +
+
+
+ + +
+

+ +

+
+
+

No, Geyser and all related projects are completely free and open-source, licensed under the MIT license.

+ +
+
+
+ + +
+

+ +

+
+
+

Geyser should generally work fine with plugins, as we emulate a Java client. There are exceptions, though:

+ +
    +
  • TCPShield requires only-allow-proxy-connections disabled without a paid plan. However, their “Premium” plan will allow the support of Geyser - please see here for setup instructions.
  • +
+ +

Floodgate can cause issues with plugins as it modifies the login process. Please note that any offline mode authenticator plugins are only here for documentation; Geyser does not support offline mode usage.

+ +
    +
  • DynamicBungeeAuth Currently working on latest version 10.28B+ (10.27B and older versions produces invalid credentials for Bedrock players)
  • +
  • FastLogin does not let floodgate add player prefix.
  • +
  • ExploitFixer thinks that Floodgate users are UUID spoofing - disable the uuidspoof setting in ExploitFixer’s config.
  • +
  • JPremium alters the UUID of a player, causing Floodgate not to be able to get the Bedrock data from its map.
  • +
  • LibHatesMods causes authentication to fail with com.github.steveice10.mc.auth.exception.request.InvalidCredentialsException
  • +
  • ProtocolSupport is currently incompatible with Floodgate. Works with Floodgate, but we recommend using ViaBackwards instead.
  • +
  • ProtocolSupportBungee changes how the login process works and therefore breaks the Floodgate injection code.
  • +
  • SayNoToMcLeaks prevents Floodgate from finishing its login system.
  • +
+ +

If you come across any more, please let us know via Discord.

+ +
+
+
+ + +
+

+ +

+
+
+

The Geyser-Spigot plugin supports any Minecraft server version 1.13.2 or later. Any earlier version is not supported by the plugin - use a proxy version or the standalone build instead. +Since Geyser emulates a {{ site.data.versions.java }} Java Edition client, you need to install ViaVersion on your server +if it is not running the latest version of Minecraft.

+ +

In order for Bedrock players to chat (1.19.3+) or join (1.19.1/1.19.2), you need to disable chat signing. More information about that can be read on the chat signing page.

+ +

You will also need to run at least Java 16 or later to use Geyser. See here for more info on updating Java. +Paper versions not supporting Java 16 can add -DPaper.IgnoreJavaVersion=true flag to the Java startup arguments to allow Paper to run on Java 16.

+ +
+
+
+ + +
+

+ +

+
+
+

This is a non-complete list of what platform each plugin version of Geyser is for, and the standalone version can be used for any as it isn’t a plugin.

+
    +
  • Geyser-Spigot works with: +
      +
    • Spigot
    • +
    • Paper (recommended)
    • +
    • Any other forks of the above
    • +
    +
  • +
  • Geyser-Bungee works with: + +
  • +
  • Geyser-Velocity works with Velocity
  • +
  • Geyser-Fabric works with Fabric, and requires FabricAPI to be installed on the server as well.
  • +
+ +
+
+
+ + +
+

+ +

+
+
+

Because of optimizations that hook into the plugin platforms, plugin versions of Geyser are preferable compared to standalone Geyser. On Spigot, Velocity, and BungeeCord versions of Geyser, direct connections allow for faster loading times, lower latency, and accurate IP addresses without requiring Floodgate. Geyser-Spigot has further optimizations due to having direct world access, including lower memory usage and greater translation accuracy. However, large server networks might prefer standalone Geyser because it can be updated without needing to restart any other proxies or servers, and can offload resource usage onto seperate machines.

+ +
+
+
+ + +
+

+ +

+
+
+

You only need Geyser and/or Floodgate on the BungeeCord server, as long as not using the Floodgate API. In this case, Floodgate is needed on the “backend” servers as well.

+ +
+
+
+ + +
+

+ +

+
+
+

Generally, the IP that Bedrock players will join with is your Java IP and the defined port in your Geyser config in the bedrock section under port. For example, if the IP address Java players join with is test.geysermc.org, and the bedrock port is set as 19132, Bedrock players should join with the IP test.geysermc.org and port 19132.

+ +
+
+
+ + +
+

+ +

+
+
+

You can add Bedrock resource packs to your Geyser installation in the packs folder of wherever the Geyser config is located. Bedrock clients will automatically download and load those resource packs. There is currently no automatic Java-to-Bedrock resource pack conversion, but you can convert any Java resource pack to Bedrock using this tool and add that to your server. The converter currently only works with packs up until 1.17; you will need to use another converter, or, convert the pack yourself.

+ +
+
+
+ + +
+

+ +

+
+
+

You can use the command /geyser offhand, which will swap the item in their main hand and offhand. There is also a setting you can enable in the config (emote-offhand-workaround) to allow Bedrock players to perform an emote in order to switch their main hand and offhand.

+ +
+
+
+ + +
+

+ +

+
+
+

If there is a prefix on Floodgate players, you must include the prefix in the name. Floodgate also replaces all spaces in names with underscores, so be sure to replace any spaces with underscores when executing the command. If this does not work, put double quotes around the name.

+ +

Example: /tp ".<bedrock_username>"

+ +
+
+
+ + +
+

+ +

+
+
+

There are three ways you can do this.

+ +
    +
  1. +

    Use Floodgate’s built-in whitelist command: /fwhitelist add <bedrock_username>. This will only work if the player has joined any Geyser server already.

    +
  2. +
  3. +

    Turn off the whitelist using /whitelist off, then get the Geyser player to join. After that, run /whitelist add ".<bedrock_username>", and finally, turn the whitelist back on using /whitelist on. +When using Local Linking: If you’re linking a Bedrock account to an existing whitelisted Java account, you don’t need to whitelist the Bedrock account separately. You can link the accounts and immediately turn the whitelist back on.

    +
  4. +
  5. +

    Add the player’s UUID, as given by Floodgate, to the whitelist.json file. Then, run /whitelist reload to update the whitelist.

    +
  6. +
+ +

Choose the method that suits your preferences and server setup.

+ +
+
+
+ + +
+

+ +

+
+
+

Use this page. If this doesn’t work, then try this method:

+ +

First, you’ll need to get the XUID of the player. There are several third-party websites to find this, for example, this one (unaffiliated with Geyser). Make sure to choose “Hexidecimal.” You’ll need to enter the player’s Xbox Gamertag, and, once submitted, it should display the XUID in the format of xxxxxxxxxxxxxxxx. To turn the XUID into a UUID that Java Edition can recognize, you need to put the XUID in this format: 00000000-0000-0000-xxxx-xxxxxxxxxxxx. If formatted right, Java Edition should accept it as a UUID.

+ +
+
+
+ + +
+

+ +

+
+
+

While you can remove the prefix, it is generally recommended not to remove the prefix to prevent situations where player usernames are the same on both editions (Ex: Bedrock Username: JohnDoe, Java Username: JohnDoe). While they have different UUIDs, they have the same username, which may cause conflicts with commands that involve a player name. If you want to remove the prefix to use commands, Try adding quotation marks around the name. Example: /tp ".<bedrock_username>" Otherwise, the prefix is located in the Floodgate config.yml under username-prefix:.

+ +
+
+
+ + +
+

+ +

+
+
+

No; Floodgate is only required if you wish to allow Bedrock clients to join without authenticating to Java servers. Without the Floodgate plugin, Geyser can either authenticate to Mojang in online mode, or join without authentication in an offline mode server (though this is unsupportable and dangerous as anyone can join your server and is against Mojang’s EULA).

+ +
+
+
+ + +
+

+ +

+
+
+

This is a Bedrock client issue caused by Bedrock being 32-bit and Java being 64-bit. For more information read here.

+ +
+
+
+ + +
+

+ +

+
+
+

No, this is a translation tool to allow Bedrock players to connect to Java servers. It does not work the opposite way.

+ +
+
+
+ + +
+

+ +

+
+
+

Yes, you can use Geyser as a plugin or a mod for your Minecraft server software running on Pterodactyl. There is also an official egg for the standalone version. It supports auto-updating and has all config options easily editable. You can find it here, download the JSON egg, and import it into your panel. Make sure the Geyser port (using UDP) is exported out to the host & allocated the port to the server.

+ +
+
+
+ + +
+

+ +

+
+
+

Unfortunately, Ngrok is TCP-only, so you will not be able to use Geyser with Ngrok. As an alternative, you can use playit.gg, which supports both TCP and UDP.

+ +
+
+
+ + +
+

+ +

+
+
+
    +
  1. You will need access to the host systems terminal. Note: This guide is for Linux systems only!
  2. +
  3. Setup a “Guard” select gaming then Minecraft: Bedrock edition.
  4. +
  5. Click setup for linux and run the guardian installer and start the service.
  6. +
  7. Run “guardian status” and take note of the “Local IP” it starts with “10.31.x.x”.
  8. +
  9. Go to the Geyser config.yml and update the Bedrock address to the Local IP which you found above.
  10. +
  11. Restart the mc server and test it out, it should work for both Java and Bedrock.
  12. +
+ +
+
+
+ + +
+

+ +

+
+
+

If the server has ViaVersion and/or supports the latest Minecraft version, yes. However, we are unable to support older versions of Minecraft due to a limitation in our Java support library.

+ +
+
+
+ + +
+

+ +

+
+
+

The short answer: if a vanilla client can join the server, then so can Geyser.

+ +

The long answer: currently, there is no way for Geyser to translate the features that most mods add (blocks, items, etc.). Therefore, servers that require mods to be installed clientside are unsupportable through Geyser.

+ +
+
+
+ + +
+

+ +

+
+
+

GeyserUpdater (GitHub page/Spigot page) is a Spigot/BungeeCord plugin option for auto-updating. Please note that this plugin is also unaffiliated and unsupported by Geyser, and users should redirect support for the plugin to its Discord.

+ +
+
+
+ + +
+

+ +

+
+
+

Replace the AvatarUrl line in your DiscordSRV config with this: AvatarUrl: https://mc-heads.net/avatar/{texture}/{size}.png

+ +

Note: you need to be running DiscordSRV v1.22.0 or newer. Floodgate 2.0 or GeyserSkinRestorer is still required for skins to show up for Java players and for this to work.

+ +

Alternatively, if you cannot get the above AvatarUrl to work with DiscordSRV, or you’d like to use it with another plugin that does not support texture ids, you can use the TydiumCraft Skin API.

+ +
+
+
+ + +
+

+ +

+
+
+

You sure can! Buycraft supports Java & Bedrock players via the Offline store mode (Recommended to be used with Floodgate)

+ +

(Currently, Buycraft does not support special symbols like * or -, so you’ll have to change the Floodgate prefix to _ or remove it entirely.)

+

Steps to create a store to support both versions

+
    +
  • Buycraft-> Create Webstore
  • +
  • Select Game-> Minecraft Offline
  • +
  • Continue-> Click “Create my Webstore”
  • +
  • Name your server & Select currency-> Continue
  • +
  • Select Game Server-> Continue
  • +
  • Download the plugin version that best suits your server.
  • +
  • Execute the secret command from your server’s console
  • +
+ +

Your store is now set up to support Bedrock & Java players.

+ +

(Please note, if you are using a prefix with Floodgate, Bedrock players will have to enter the prefix.)

+ +
+
+
+ + +
+

+ +

+
+
+

You sure can! Buycraft supports Java & Bedrock players via the Offline store mode (Recommended to be used with Floodgate)

+ +

(Currently, Buycraft does not support special symbols like * or -, so you’ll have to change the Floodgate prefix to _ or remove it entirely.)

+

Steps to create a store to support both versions

+
    +
  • Buycraft-> Create Webstore
  • +
  • Select Game-> Minecraft Offline
  • +
  • Continue-> Click “Create my Webstore”
  • +
  • Name your server & Select currency-> Continue
  • +
  • Select Game Server-> Continue
  • +
  • Download the plugin version that best suits your server.
  • +
  • Execute the secret command from your server’s console
  • +
+ +

Your store is now set up to support Bedrock & Java players.

+ +

(Please note, if you are using a prefix with Floodgate, Bedrock players will have to enter the prefix.)

+ +
+
+
+ + +
+

+ +

+
+
+

We aim to support any of the bedrock languages; see here for our Crowdin page, and below is a list of all the language codes. We also can add support for more languages, and please request them in the Discord server if you are willing to translate them. (Enabled clientside via https://www.curseforge.com/minecraft/mc-addons/translations-for-minecraft)

+ +

Bedrock languages

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameCode
Bulgarianbg_bg
Czechcs_cz
Danishda_dk
Germande_de
Greekel_gr
British Englishen_gb
American Englishen_us
Spanishes_es
Mexican Spanishes_mx
Finnishfi_fi
Canadian Frenchfr_ca
Frenchfr_fr
Hungarianhu_hu
Indonesianid_id
Italianit_it
Japaneseja_jp
Koreanko_kr
Dutchnl_nl
Norwegian Bokmålnb_no
Polishpl_pl
Brazilian Portuguesept_br
Portuguesept_pt
Russianru_ru
Slovaksk_sk
Swedishsv_se
Turkishtr_tr
Ukrainianuk_ua
Chinese Simplified (China)zh_cn
Chinese Traditional (Taiwan)zh_tw
+ +

Additional languages

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
NameCode
Afrikaansaf_za
Belarusianbe_by
Hebrewhe_il
Hindihi_in
+ +
+
+
+ + +
+

+ +

+
+
+

Please note that you cannot add strings that work in Minecraft formatting - these strings are only for places where Geyser uses them.

+ +

To start, create a languages folder in the same directory as the Geyser config file. +Inside of it, you’ll need to add a file with your desired locale ending in .properties. You can see +here for the locale files that Geyser uses - +you can download these as a starting point, or you can just add the strings you want to overwrite.

+ +

You must restart Geyser for the changes to apply.

+ +
+
+
+ +
+ +

Questions not related to gameplay

+ +
+ + +
+

+ +

+
+
+

Redned started Geyser in July 2019. In May 2020, CubeCraft acquired the GeyserMC brand. This means that they govern the project (though at this time, they govern lightly). CubeCraft does not own the code of Geyser.

+ +
+
+
+ + +
+

+ +

+
+
+

No

+ +
+
+
+ +
+ + + +
+ +
+
+ + + + + diff --git a/_site/geyser/fixing-unable-to-connect-to-world/index.html b/_site/geyser/fixing-unable-to-connect-to-world/index.html new file mode 100644 index 0000000..c1028fe --- /dev/null +++ b/_site/geyser/fixing-unable-to-connect-to-world/index.html @@ -0,0 +1,550 @@ + + + + + + + + GeyserMC Wiki: Fixing 'Unable to Connect to World' + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Fixing ‘Unable to Connect to World’ errors

+

This is by far the most common error people get when attempting to set up Geyser. Here’s some steps on how to solve it. +Usually, this error is caused by improper configuration of Geyser, or issues with your network.

+ + + +

If you are not using a Minecraft server hosting provider, carry on.

+ + + +

Java Edition players can’t connect!

+ +

This should not be a Geyser problem. Geyser does not modify server behavior. Floodgate does modify the login structure, but only for Bedrock players. +Contact your hosting provider or look elsewhere for fixing this connection issue.

+ +

Connecting fails after updating Geyser

+ +

If this occurred after updating a plugin version of Geyser, ensure that you shut off your server, swapped the Geyser jar, and then started up your server. +Incase you reset your configuration file, check out the setup guide again.

+ +

There are errors in my console!

+ +

Please read through the common issues page. If there is another error not documented there, join us on our Discord.

+ +

Try restarting the server and game

+ +

Especially on mobile devices, sometimes just restarting Minecraft fixes the issue.

+ +

Is it the server or the client?

+ +

Run your Java server IP and Bedrock address here: https://mcsrvstat.us/. It’s a great way of determining if the server is reachable in the first place. +Additionally, check if you can see a connection attempt in the server console. If you can’t, it’s likely a network issue.

+ +

For console players specifically: If only they can’t join, while other Bedrock players can, it is likely an issue with their console connecting method.

+ +

General troubleshooting steps

+ +

Ensure you’re connecting on the right IP and Port

+ +

You should be connecting with the Java server IP and the Bedrock port (set in the Geyser config). If you port forwarded 19132, for example, you should specify port 19132 when connecting from Bedrock.

+ +

I’m using a hosting provider or VPS!

+ +

Please read this page on supported hosting providers to see if there are extra configuration steps required for your hosting or server provider. +Some VPS/KVM providers may require further setup, such as OVH, SoYouStart, and Oracle Cloud. Please read this note for more information.

+ +

Issues using Docker or Pterodactyl

+

Make sure you assign the port to pterodactyl, and on docker, to the docker compose file. See our port-forwarding page for fixes.

+ +

Port forwarding issues

+ +

Your server does need to be port forwarded to allow connections from outside the local network. See our port-forwarding guide for more information.

+ +

Using TCP in DNS options/port forwarding instead of UDP

+ +

Minecraft: Java Edition uses TCP for connecting; Minecraft: Bedrock Edition uses UDP. Port forwarding your Bedrock Edition port with only TCP will not work, it has to be UDP. Forwarding your Bedrock Edition port with TCP/UDP (both protocols) should also work but is not recommended unless Java Edition and Bedrock Edition is sharing the same port.

+ +

Bedrock port is less than 10000

+ +

Historically, having a Bedrock port that is a lower number will cause issues. Setting it to 10000 or above seems safe.

+ +

Bedrock players can connect after hitting the server on a TCP port (e.g. on Java or a website on the same server), OR only people who also play on Java Edition can join from Geyser

+ +

This is likely a firewall issue on your server. Try the following workaround: +Attempt to connect to the Bedrock IP and port through a web browser - for example, http://test.geysermc.org:19132. It won’t work, but then try connecting through Bedrock, and it should work.

+ +

Specific host fixes for OVH/SoYouStart can be found here.

+ +

Changing the bedrock address in the Geyser config.

+ +

Except for a few specific hosting providers, you generally do not need to change this part of the Geyser config. +However, in rare instances, it does fix issues - for example, when Windows has multiple network adapters (check by running ipconfig in cmd), +it can help to set the address to the local IP of the adapter you want to use.

+ +

Using a hosting provider or other location

+ +

Pterodactyl

+ +

If you get this error while using the Pterodactyl Panel, try editing the Geyser config and changing the port to something besides 19132 (e.g. 25566).

+ +

Hosting Geyser on another computer on the same network

+ +

Can only connect from the same computer and not anywhere else

+ +

Your firewall is likely in the way. Try adding an exception to Java, or disable the firewall for testing purposes.

+ +

As a last resort for troubleshooting…

+ +

Minecraft offers a vanilla Bedrock server here. Downloading, running, and attempting to connect to it may help isolate if the issue is on Geyser’s end, or your computer/network’s end.

+ +

Using Geyser on the same computer

+ +

Windows 10/11

+ +

This only affects people trying to join Geyser from Windows 10/11 Edition with Geyser hosted on the same computer.

+ +

This is an issue caused by Loopback restrictions not being lifted. By default, Microsoft Apps have this restriction on all their apps for local connections. Geyser will attempt to resolve this automatically; however, if you’re still having connection problems, you can lift it by typing the following in Windows PowerShell in administrator mode: (it should return OK. if it worked)

+
CheckNetIsolation LoopbackExempt -a -n="Microsoft.MinecraftUWP_8wekyb3d8bbwe"
+
+ +

Should this not work, you can try this set of steps:

+ +
    +
  1. Hold down Windows Key + R
  2. +
  3. In the prompt, type hdwwiz.exe, then press Enter then Next
  4. +
  5. Install the Hardware Manually
  6. +
  7. Choose Network Adapter > Next > Microsoft > “Microsoft KM-TEST Loopback Adapter” then hit Next until it’s done.
  8. +
+ + + +
+ +
+
+ + + + + diff --git a/_site/geyser/forms/index.html b/_site/geyser/forms/index.html new file mode 100644 index 0000000..305a1f7 --- /dev/null +++ b/_site/geyser/forms/index.html @@ -0,0 +1,570 @@ + + + + + + + + GeyserMC Wiki: Forms and Cumulus + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

What is Cumulus?

+ +

Bedrock Edition has a cool exclusive feature called Forms.
+Cumulus is the Forms API that we use in Geyser and Floodgate.
+The source code is available here. You can access the Cumulus API through the Floodgate API, or the Geyser API.

+ +

Bedrock knows three types of Forms:

+
    +
  • ModalForm
  • +
  • SimpleForm
  • +
  • CustomForm
  • +
+ +

We’ll discuss them one by one starting with the easiest and ending with the least easy form type.
+After that, you get an overview of every single component.
+Then we’ll talk about sending the form, receiving a response and doing advanced stuff.

+ +

ModalForm

+ +

While this is the easiest form type it’s also the least customisable.
+You have a title, description (content) and two buttons.

+ +

Example of a ModalForm

+ +

Code used in the image:

+ +
ModalForm.builder()
+    .title("Title")
+    .content("Content")
+    .button1("Button 1")
+    .button2("Button 2")
+
+ +

SimpleForm

+ +

While this one is less easy than ModalForm is, it also has more customizability.
+It’s still limited to a title, content and buttons, but these buttons can also have images and do not have a minimum and maximum of two.

+ +

Example of a SimpleForm

+ +

Code used in the image:

+
SimpleForm.builder()
+    .title("Title")
+    .content("Content")
+    .button("Button without an image")
+    .button("Button with URL image", FormImage.Type.URL, "https://github.com/GeyserMC.png?size=200")
+    .button("Button with path image", FormImage.Type.PATH, "textures/i/glyph_world_template.png")
+
+ +

CustomForm

+ +

While the CustomForm is the last one on our list (and thus the least easy one), it also has the greatest customizability.
+This form exists of a title, content and a list of different components e.g. label, slider and input.
+See Components for more information about every component you can use and in which form type.

+ +

Example of a CustomForm

+ +

Code used in the image:

+ +
CustomForm.builder()
+    .title("Title")
+    .dropdown("Text", "Option 1", "Option 2")
+    .input("Input", "placeholder")
+    .toggle("Toggle")
+    .slider("Text", 0, 10, 1, 5)
+
+ +

Sending a form

+ +

After you decided which form type you want to use and finished filling in the actual content, it’s time to send the Form to the Bedrock player.
+You can do that by calling the API and send a form to the player’s UUID and the form:

+
FloodgateApi.getInstance().sendForm(uuid, form); // or #sendForm(uuid, formBuilder)
+
+

Or you can do it by using the Player’s FloodgatePlayer instance:

+
FloodgatePlayer player = FloodgateApi.getInstance().getPlayer(uuid);
+player.sendForm(form); // or #sendForm(formBuilder)
+
+

So you can make and send forms in a pretty compact way by doing something like this:

+
FloodgatePlayer player = FloodgateApi.getInstance().getPlayer(uuid);
+...
+player.sendForm(
+    CustomForm.builder()
+        .title("My cool title")
+        .label("10/10 content")
+);
+
+ +

Receiving a response from the client

+ +

It’s nice and all that we can send forms to a client, but we also want to be able to get a response from a client and being able to handle them.
+We can do that using one (or multiple) result handers. The most used result handlers are: validResultHandler(BiConsumer<Form, ValidFormResponseResult> | Consumer<ValidFormResponseResult>), invalidResultHandler, closedResultHandler and closedOrInvalidResultHandler.
+Here follows an example that uses result handlers:

+
CustomForm.builder()
+    .title("geyser.auth.login.form.details.title")
+    .label("geyser.auth.login.form.details.desc")
+    .input("geyser.auth.login.form.details.email", "account@geysermc.org", "")
+    .input("geyser.auth.login.form.details.pass", "123456", "")
+    .closedOrInvalidResultHandler(() -> buildAndShowLoginDetailsWindow(session))
+    .validResultHandler(response -> session.authenticate(response.next(), response.next())));
+
+ +

Advanced stuff

+ +

The FormBuilder also has support for translating the data used in the builder.
+To add a translator, you can use the translator(BiFunction<String, String, String>) or the translator(BiFunction<String, String, String>, String) method:

+
ModalForm form = ModalForm.builder()
+    .translator(this::translate, userLanguage)
+    .title("Title")
+    .content("Content")
+    .button1("translate.button1")
+    .button2("translate.button2")
+    .build();
+
+public String translate(String key, String locale) {
+    // this method will be called for every string, in this case, 4 times:
+    // Title, Content, translate.button1, translate.button2
+    // your own translate logic here
+    // return the value that replaces the key
+}
+
+

Or you can have the translate method directly in the FormBuilder instead of a separate method:

+
ModalForm form = ModalForm.builder()
+    .translator((key, unused) -> {
+        // this method will be called for every string, in this case, 4 times:
+        // Title, Content, translate.button1, translate.button2
+        // since this isn't a separate method, you don't need the locale argument, so it's unused.
+        // your own translate logic here
+        // return the value that replaces the key
+    })
+    .title("Title")
+    .content("Content")
+    .button1("translate.button1")
+    .button2("translate.button2")
+    .build();
+
+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/getting-started-with-the-api/index.html b/_site/geyser/getting-started-with-the-api/index.html new file mode 100644 index 0000000..e66f841 --- /dev/null +++ b/_site/geyser/getting-started-with-the-api/index.html @@ -0,0 +1,509 @@ + + + + + + + + GeyserMC Wiki: Getting Started with the API + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

To start, add the Open Collaboration repository to your project:

+ +

Maven

+
<repository>
+    <id>opencollab-snapshot</id>
+    <url>https://repo.opencollab.dev/main/</url>
+</repository>
+
+

The “main” repository contains both release and snapshot versions.

+ +

Gradle

+
repositories {
+    maven {
+        url = uri("https://repo.opencollab.dev/main/")
+    }
+}
+
+ +

Using Geyser

+ +

Add Geyser’s API codebase as a dependency:

+ +

Maven

+
<dependency>
+    <groupId>org.geysermc.geyser</groupId>
+    <artifactId>api</artifactId>
+    <version>2.2.0-SNAPSHOT</version>
+    <scope>provided</scope>
+</dependency>
+
+ +

Gradle

+
dependencies {
+    compileOnly('org.geysermc.geyser:api:2.2.0-SNAPSHOT')
+}
+
+ +

To get a Geyser player, or check if a player is from Bedrock:

+ +
GeyserConnection connection = GeyserApi.api().connectionByUuid(uuid);
+
+ +

connection can be null if such a player does not exist on Geyser.

+ +

GeyserApi.api() may be null until after the Geyser plugin enables.

+ +

For more information on the Geyser API, see here.

+ +

Using Floodgate

+

This page has a very simple primer for the Floodgate API. For a full breakdown, see here.

+ +

Add Floodgate’s API as a dependency:

+ +

Maven

+
<dependency>
+    <groupId>org.geysermc.floodgate</groupId>
+    <artifactId>api</artifactId>
+    <version>2.2.2-SNAPSHOT</version>
+    <scope>provided</scope>
+</dependency>
+
+ +

Gradle

+
dependencies {
+    compileOnly('org.geysermc.floodgate:api:2.2.2-SNAPSHOT')
+}
+
+ +

Get the Floodgate API using:

+
FloodgateApi api = FloodgateApi.getInstance();
+api.isFloodgatePlayer(uuid);
+
+ +

For more information on the Floodgate API, see here.

+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/geyser-command-line-arguments-and-system-properties/index.html b/_site/geyser/geyser-command-line-arguments-and-system-properties/index.html new file mode 100644 index 0000000..adab37a --- /dev/null +++ b/_site/geyser/geyser-command-line-arguments-and-system-properties/index.html @@ -0,0 +1,534 @@ + + + + + + + + GeyserMC Wiki: Geyser Command Line Arguments and System Properties + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Geyser Command Line Arguments and System Properties

+

Geyser offers a few command line arguments/system properties to allow you to configure Geyser without editing the config files. +Additionally, you can suppress some warnings that may be printed to the console.

+ +

Configuration system properties

+

You can set Geyser to automatically bind to a specific address and port by using the following command line arguments.
+This is primarily aimed at server hosting providers to automatically configure servers for users.

+ + + +
    +
  • -DgeyserUdpPort=server or -DpluginUdpPort=server +
      +
    • -1 means UDP is not supported and will forcibly stop Geyser.
    • +
    • server means to match the port of the TCP server.
    • +
    • any other number means to use that specific port
    • +
    +
  • +
  • -DgeyserUdpAddress=server or -DpluginUdpAddress=server +
      +
    • server means to match the bind address of the TCP server
    • +
    • any other string will be used as-is for the bind address.
    • +
    +
  • +
+ +

Disabling warnings and advanced configuration

+

You may disable some warnings that may be printed to the console by using the following command line arguments:

+ + + +
    +
  • -DGeyser.PrintSecureChatInformation=true +
      +
    • Allows you to disable the warning about secure chat being disabled. +Since the warning is sent when the server sends the warning, this option does not do much anymore.
    • +
    +
  • +
  • -DGeyser.ShowScoreboardLogs=true +
      +
    • Allows you to disable warnings related to scoreboards, such as “Tried to update score without the existence of its requested objective”.
    • +
    +
  • +
  • -DGeyser.ShowResourcePackLengthWarning=true +
      +
    • Allows you to disable the warning about a resource pack having too long paths. Disabling this warning will not fix the underlying issue! +Console players might not be able to join your server at all if you have a resource pack with paths exceeding the 80 character limit.
    • +
    +
  • +
  • -DGeyser.PrintPingsInDebugMode=true +
      +
    • Controls if pings are being logged in debug mode.
    • +
    +
  • +
  • -DGeyser.UseDirectAdapters=true +
      +
    • Allows you to disable the usage of NMS adapters. Disabling will result in a performance penalty and should only be used for debugging. +This is Spigot-only and will not work on other platforms.
    • +
    +
  • +
  • -DGeyser.BedrockNetworkThreads=8 +
      +
    • Allows you to set the number of threads used for the Bedrock networking. This is not set to a specific number by default, but is instead calculated based on the available resources.
    • +
    +
  • +
  • -DGeyser.AddTeamSuggestions=true +
      +
    • Allows you to turn off suggestions for teams in the scoreboard command. This is enabled by default, disabling this can help with performance if there are a lot of teams defined. +Setting “command-suggestions” to false in the config will also disable this.
    • +
    +
  • +
+ +

Geyser-Standalone specific options:

+ +

--config [file]

+
    +
  • Alias: -c
  • +
  • Points to an alternative config file to use.
  • +
+ +

--gui / --nogui

+
    +
  • Alias: gui / nogui:
  • +
  • Forces GUI or non-GUI usage, depending on context.
  • +
+ +

Overriding specific config values

+

Overriding a standard config option (e.g. command-suggestions):

+ +

--command-suggestions=false

+ +

Overriding a nested config option(e.g. the remote section with address):

+ +

--remote.address=test.geysermc.org

+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/global-api/index.html b/_site/geyser/global-api/index.html new file mode 100644 index 0000000..ab7fcef --- /dev/null +++ b/_site/geyser/global-api/index.html @@ -0,0 +1,460 @@ + + + + + + + + GeyserMC Wiki: Global API + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Geyser Global API

+

The Global API is available for every server. It currently includes: Global Linking, skin uploading, getting a xuid by gamertag, and getting a gamertag by xuid. +We don’t store anything else than you can access by the Global API, except for some non-identifiable metrics. The source code of the Global API is available here and the source code of the Global Linking server is available here.

+ +

As a user of the API, you can get various info about Geyser (or specifically, Floodgate players) that joined any Geyser + Floodgate server before. This includes:

+
    +
  • Conversion methods from a Bedrock gamertag to Bedrock xuid, and vice-versa. Only provides info for players who are in Geyser’s cache.
    +If you need them for all players, you can use a third-party API, e.g. https://mcprofile.io/endpoints, which also provides info from the Geyser Global API.
  • +
  • Skin info: Whenever a Bedrock player joins via Floodgate, their skin gets converted & uploaded to mineskin. If you want to grab that converted skin, use the xuid of the Bedrock player in this endpoint to get a texture id, or a base64 encoded “value”, which you could use directly in e.g. player heads.
  • +
+ +

See the Global API docs for more info, and detailed usage.

+ +

Examples

+

Here are a few examples of how you could use the Global API.

+ +

GeyserDiscordBot

+
    +
  • GeyserMC’s discord bot has a /uuid command to get a floodgate uuid from a bedrock username.
  • +
+ +

CustomPlayerHeads

+
    +
  • A fabric mod that uses the Global API to get a Bedrock player’s skin, and then uses that to create a player head.
  • +
+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/index.html b/_site/geyser/index.html new file mode 100644 index 0000000..20769f3 --- /dev/null +++ b/_site/geyser/index.html @@ -0,0 +1,440 @@ + + + + + + + + GeyserMC Wiki: Geyser + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Geyser

+

License: MIT +Build Status +Discord

+ +

A bridge between Minecraft: Bedrock Edition and Minecraft: Java Edition.

+ +

Currently, supporting Minecraft Bedrock 1.20.0-1.20.40 and Minecraft Java 1.20.2

+ +

The goal of Geyser is to bridge the Minecraft: Bedrock Edition and Minecraft: Java Edition by allowing Bedrock clients to join Java Edition servers. This project is still in development and not complete yet, so expect bugs.

+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/playit-gg/index.html b/_site/geyser/playit-gg/index.html new file mode 100644 index 0000000..282aeb6 --- /dev/null +++ b/_site/geyser/playit-gg/index.html @@ -0,0 +1,469 @@ + + + + + + + + GeyserMC Wiki: playit.gg Setup + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Prerequisites

+ + + +
    +
  • If you already have playit.gg running & set up (for e.g. Minecraft Java edition), skip steps 1 and 2 and proceed with step 3.
  • +
+ +

Setup

+
    +
  1. Head over to playit.gg’s website - download the program & run it. It will open the login site in the browser - create an account & sign in. Or, use a guest account.
  2. +
  3. Once logged in, make sure to connect the program + site, until step 4 is reached. This should happen automatically, if it does not, follow the instructions on the website and the playit.gg program console. +img
  4. +
  5. Click “Create Tunnel” if you see the screen above, or, select the “Tunnels” tab when logged in to your account. There, select “Minecraft Bedrock”, leave “Enable Tunnel” ticked, and click “Add tunnel”. +img
  6. +
  7. Once “Add tunnel” is clicked, it should create a new tunnel, and you are set! Scroll down until you see this: +img +If you have Geyser running on a port that is not 19132, update the port there. The “Local Address” does not need to be changed unless you are not running playit.gg and Geyser on the same device.
  8. +
  9. Connect to your server - use the IP and Port from the “Allocation” tab. In our example - “180.ip.ply.gg” as the IP, and “17019” as the port. Alternatively, use the Domain it gives you instead of the IP.
  10. +
  11. If you join successfully, then you are done! Make sure to leave the playit.gg program running as closing it will close the tunnel. You also may want to ratelimit individual connections - use the “Per Connection Rate Limit” option to do so. +(If you failed to join, check out the troubleshooting section of the page.)
  12. +
+ +

Troubleshooting

+ +

I can’t connect to my server!

+
    +
  • Are there errors in your minecraft server console?
  • +
  • Make sure to check here beforehand.
  • +
  • If you changed the port that Geyser would bind to, you’ll have to tell playit.gg to use that port instead! See step 5 here.
  • +
  • (Alternatively: You can try setting the bedrock port in the Geyser configuration to 19132.)
  • +
+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/port-forwarding/index.html b/_site/geyser/port-forwarding/index.html new file mode 100644 index 0000000..8a64da9 --- /dev/null +++ b/_site/geyser/port-forwarding/index.html @@ -0,0 +1,584 @@ + + + + + + + + GeyserMC Wiki: Port forwarding + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

Port forwarding

+

This page contains information on how to set up port forwarding required for Geyser to work when self-hosting. +There are also guides for specific configurations, such as Docker/Pterodactyl, or on specific VPS/KVM providers, such as OVH or Oracle Cloud.

+ + + +

Port forwarding on Linux/Windows/macOS

+

To allow others to play on your server, you will need to set up port forwarding on the device hosting Geyser. +Additionally, you will need to port forward the port on your router/modem (in other words, allow and route traffic on that port to the proper machine) if you want the server to be accessible outside your own home network. +See here or here for helpful guides. +Do note: if you do not have a static IP address, your IP address may change over time.

+ + + +

Windows

+

To open a port on Windows, you will need to open the port through the Windows Firewall. There are multiple ways to do this:

+ +
    +
  • +

    Powershell (recommended)

    + +

    To open a port on UDP (in our example, port 19132), run the following command in an administrator Powershell:

    +
    New-NetFirewallRule -DisplayName "Geyser" -Direction Inbound -Protocol UDP -LocalPort 19132 -Action Allow
    +
    +

    Running this command creates a rule named “Geyser” that allows UDP traffic on port 19132.

    +
  • +
  • +

    Windows Defender Firewall with Advanced Security (GUI)

    +
      +
    1. Search for “Windows Defender Firewall with Advanced Security” in the start menu, and open it. (Image)
    2. +
    3. Click on “Inbound Rules” in the left sidebar. (Image)
    4. +
    5. Click on “New Rule…” in the right sidebar. (Image)
    6. +
    7. Select “Port” as the rule type and click “Next”. (Example)
    8. +
    9. Select “UDP” and “Specific local ports”, and enter the port you want to open (in our example, 19132). Click “Next”. (Example)
    10. +
    11. Select “Allow the connection” and click “Next”. (Example)
    12. +
    13. Select the profiles you want to apply the rule to (e.g. “Domain”, “Private”, “Public”), and click “Next”. (Example)
    14. +
    15. Enter a name for the rule (e.g. “Geyser”), and click “Finish”. (Image)
    16. +
    +
  • +
+ +

Linux

+

Different Linux distributions, even different VPS providers ship and configure different firewalls. In the following examples, we will use 19132 as the port to open, but you should replace this with the port you are using for Geyser.

+ +
    +
  • ufw is a simple firewall front-end for iptables that is commonly used on Ubuntu and Debian. To open a port on UDP, run the following command: +
    sudo ufw allow 19132/udp
    +
    +

    Then, reload the firewall with sudo ufw reload, and see all open rules with sudo ufw status.
    +Further helpful guides: DigitalOcean, Baeldung

    +
  • +
  • firewalld Add a port on UDP by running: +
    sudo firewall-cmd --zone=public --permanent --add-port=19132/udp
    +
    +

    Then, reload the firewall with sudo firewall-cmd --reload, and see all open rules with sudo firewall-cmd --list-all.
    +Further helpful guides: DigitalOcean

    +
  • +
  • iptables is a common firewall that is used on many Linux distributions. To open a port on UDP, run the following command: +
    sudo iptables -A INPUT -p udp --dport 19132 -j ACCEPT
    +
    +

    Then, save the firewall with sudo iptables-save, and see all open rules with sudo iptables -L.
    +Further helpful guides for iptables: DigitalOcean, Ubuntu

    +
  • +
+ +

macOS

+

You will need to disable Block all incoming connections in your Firewall settings, as that will block any connections and won’t allow you to make exceptions. +To allow incoming connections, click Allow when getting these prompts. +If you are still facing issues, see Apple’s official guide here to open a port on macOS.

+ +

Using Docker or Pterodactyl

+

In addition to port forwarding the port in your server’s firewall (and, if applicable, your router/modem), you will need to assign the port in Docker/Pterodactyl.

+ +

Pterodactyl

+

Make sure to allocate the port to the server in the Pterodactyl panel’s Network tab, additionally to port forwarding the port. +See here for more information.

+ +

Pterodactyl panel, Network section

+ +

There are also different Geyser eggs for Pterodactyl, which can be found here.

+ + + +

Docker

+

For Geyser to work under Docker (e.g. using Itzg’s Docker image), you will need to add the Geyser port on UDP to the docker-compose file. This is done by adding the following to the ports section:

+
ports:
+    - "25565:25565"
+    - "19132:19132/udp"
+
+

The additional /udp suffix is required so that the port is exposed on UDP. If you want to run the Java server and Geyser on the same port, the following would work:

+
ports:
+    - "25565:25565"
+    - "25565:25565/udp"
+
+

Alternatively, add another port with the -p 19132:19132/udp flag to the docker run command.

+ +

Issues with specific VPS/KVM providers

+

Some providers, such as OVH, Oracle Cloud, and SoYouStart, have a firewall that blocks UDP ports by default/in most cases.

+ +

OVH and SoYouStart

+

By default, OVHs firewall requires a TCP ping to the server before allowing UDP connections. This is not possible with Geyser, so you will need to disable the firewall.

+ + + +

To verify/temporary work around it:

+ +

Attempt to connect to your servers IP and port through a web browser - for example, http://test.geysermc.org:19132. Connecting won’t work, but then try connecting through Bedrock on that same device, and it should work. +Alternatively, try connecting to the server first on Java edition, then on Bedrock with the same device.

+ +

To resolve it:

+ +

OVH:

+
    +
  1. Navigate to Network interfaces
  2. +
  3. Click on the ... button on the table for your IP -> then ... and Configure the GAME firewall -> Add rule -> Other protocol (or minecraftPocketEdition if available)
  4. +
  5. Add your Geyser port into outgoing port.
  6. +
+ +

SoYouStart (subsidiary of OVH):

+
    +
  1. Click the IP tab.
  2. +
  3. Click the gear at the right of the public IP address; select “Game mitigation”.
  4. +
  5. Pick “Add a rule”.
  6. +
  7. Select “minecraftPocketEdition” in the dropdown list and enter the target UDP ports.
  8. +
  9. Save and wait a few seconds for the changes to come into effect.
  10. +
+ +

Oracle Cloud/OCI

+

You’ll need to allow port 19132 on UDP in both the security list and the firewall-cmd command.

+ +

Additional step for Ubuntu users:

+
    +
  1. Remove/comment out -A INPUT -j REJECT --reject-with icmp-host-prohibited in the /etc/iptables/rules.v4 file.
  2. +
  3. Then, run the following command to fix ufw: +
    sudo iptables-restore < /etc/iptables/rules.v4
    +
    +
  4. +
+ + + +
+ +
+
+ + + + + diff --git a/_site/geyser/secure-chat/index.html b/_site/geyser/secure-chat/index.html new file mode 100644 index 0000000..c921bf8 --- /dev/null +++ b/_site/geyser/secure-chat/index.html @@ -0,0 +1,457 @@ + + + + + + + + GeyserMC Wiki: Geyser and Secure Chat + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

In the 1.19 Java Edition updates, a mechanism for reporting player chat messages to Mojang was implemented. +Bedrock Edition does not support this reporting mechanism. +If your server or proxy settings require that every player joining supports this mechanism (which may be enabled by default), +Bedrock players will be unable to chat.

+ +

Server administrators can disable this setting, but please note that Java players can join with certain mods that make their messages unreportable.

+ +

For a technical explanation of Java’s chat signing system, see this article.

+ +

Disabling

+ +

Vanilla, Spigot/Paper/forks, Fabric

+ +

Set enforce-secure-profile: false in server.properties

+ +

BungeeCord and forks

+ +

Set enforce_secure_profile: false in config.yml

+ +

Velocity

+ +

Set force-key-authentication = false in velocity.toml

+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/setup/index.html b/_site/geyser/setup/index.html new file mode 100644 index 0000000..087e1e9 --- /dev/null +++ b/_site/geyser/setup/index.html @@ -0,0 +1,1355 @@ + + + + + + + + GeyserMC Wiki: Setup + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + + + +
+
+ +
+ +
+
+ + + + + + +
+
+ + +

Paper / Spigot setup with server hosting provider

+ + + +
    +
  1. Select your server hosting provider in the dropdown above.
  2. +
  3. Download the plugin from the download page.
  4. +
  5. Place the Geyser-Spigot.jar in the plugins folder, and restart the server.
  6. +
  7. +

    Open your Geyser config, located in /plugins/Geyser-Spigot/config.yml, and find the following:

    + +
     bedrock:
    +     # The IP address that will listen for connections. 
    +     # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server. 
    +     #address: 0.0.0.0 
    +
    +     # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server.
    +     port: 19132
    +
    +     # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock. 
    +     # This option makes the Bedrock port the same as the Java port every time you start the server. 
    +     # This option is for the plugin version only. 
    +     clone-remote-port: false
    +
    +

    The vital part is the port. This is the port that Bedrock players will use to connect to your server. + Follow the instructions in the provider selector - change the port, and if necessary, clone-remote-port & address. + If clone-remote-port is enabled, the bedrock port will be overwritten with the Java port!
    + Important: Other services/plugins that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser.

    +
  8. +
  9. Verify whether connections are possible by running geyser connectiontest <ip>:<port> in the console.
  10. +
+ + + +
+
+ + +

Fabric setup with server hosting provider

+ + + +
    +
  1. Select your server hosting provider in the dropdown above.
  2. +
  3. Download the mod from the download page.
  4. +
  5. Place the Geyser-Fabric.jar in the mods folder, and restart the server. You also need FabricAPI.
  6. +
  7. +

    Open your Geyser config, located in /config/Geyser-Fabric/config.yml, and find the following:

    + +
     bedrock:
    +     # The IP address that will listen for connections. 
    +     # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server. 
    +     #address: 0.0.0.0 
    +
    +     # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server.
    +     port: 19132
    +
    +     # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock. 
    +     # This option makes the Bedrock port the same as the Java port every time you start the server. 
    +     # This option is for the plugin version only. 
    +     clone-remote-port: false
    +
    +

    The vital part is the port. This is the port that Bedrock players will use to connect to your server. + Follow the instructions in the provider selector - change the port, and if necessary, clone-remote-port & address. + If clone-remote-port is enabled, the bedrock port will be overwritten with the Java port!
    + Important: Other services/mods that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser.

    +
  8. +
  9. Verify whether connections are possible by running geyser connectiontest <ip>:<port> in the console.
  10. +
+ + + +
+
+ + +

Proxy setup with server hosting provider

+ + + +
    +
  1. Select your server hosting provider in the dropdown above.
  2. +
  3. Download the plugin for your proxy software from the download page.
  4. +
  5. Place the Geyser jar in the plugins folder, and restart the server.
  6. +
  7. +

    Open your Geyser config, located in /plugins/Geyser-xyz/config.yml, and find the following:

    + +
     bedrock:
    +     # The IP address that will listen for connections. 
    +     # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server. 
    +     #address: 0.0.0.0
    +
    +     # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server.
    +     port: 19132
    +
    +     # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock. 
    +     # This option makes the Bedrock port the same as the Java port every time you start the server. 
    +     # This option is for the plugin version only. 
    +     clone-remote-port: false
    +
    +

    The vital part is the port. This is the port that Bedrock players will use to connect to your server. + Follow the instructions in the provider selector - change the port, and if necessary, clone-remote-port & address. + If clone-remote-port is enabled, the bedrock port will be overwritten with the Java port!
    + Important: Other services/plugins that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser.

    +
  8. +
  9. Verify whether connections are possible by running geyser connectiontest <ip>:<port> in the console.
  10. +
+ + + +
+ +
+
+ +
+ + +
+
+ + +

Paper / Spigot setup - self-hosting

+ + + +
    +
  1. Download the plugin from the download page.
  2. +
  3. Place the Geyser-Spigot.jar in the plugins folder, and restart the server.
  4. +
  5. +

    Open your Geyser config, located in /plugins/Geyser-Spigot/config.yml, and find the following:

    + +
     bedrock:
    +     # The IP address that will listen for connections. 
    +     # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server. 
    +     #address: 0.0.0.0 
    +
    +     # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server.
    +     port: 19132
    +
    +

    The vital part is the port. This is the port that Bedrock players will use to connect to your server! + If you enable clone-remote-port, the port will be overridden and the Java port is used. + Since you are self-hosting, you can choose the port freely - the default port is 19132.
    + Important: Other services/plugins that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser. +

    +
  6. +
  7. +

    Connecting to your server +

    + Connecting locally in the same network
    + On the same device as the server, you can connect using localhost, or 127.0.0.1 as the address. + Do note: When hosting and playing on the same Windows device, you will need the loopback fix. + Other devices in the same local network can use your local IPv4 to connect - it starts with 10. or 192.168.. +

    + Connecting from a different network
    + You will need to expose the port Geyser runs on to the Internet if you want players from outside your network to join. + To achieve that, you have two options:

    + +
      +
    • +

      Port forwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. +Our port forwarding guide explains how to do this in detail. +After doing this, players can connect with your public IPv4 + port to your server.

      +
    • +
    • +

      playit.gg: Instead of opening a port (which might not be an option/if you do not want to expose your home ip), you can use +the playit.gg service to create a tunnel for you to route the traffic through. See our playit.gg guide. +Ngrok will not work since it is TCP-only.

      +
    • +
    +
  8. +
  9. Verify whether connections from other networks are possible by running geyser connectiontest <ip>:<port> in the console.
  10. +
+ + + +
+
+ + +

Fabric setup - self-hosting

+ + + +
    +
  1. Download the mod from the download page.
  2. +
  3. Place the Geyser-Fabric.jar in the mods folder, and restart the server. You also need FabricAPI.
  4. +
  5. +

    Open your Geyser config, located in /config/Geyser-Fabric/config.yml, and find the following:

    + +
     bedrock:
    +   # The IP address that will listen for connections. 
    +   # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server. 
    +   #address: 0.0.0.0 
    +
    +   # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server.
    +   port: 19132
    +
    +

    The vital part is the port. This is the port that Bedrock players will use to connect to your server! +If you enable clone-remote-port, the port will be overridden and the Java port is used. +Since you are self-hosting, you can choose the port freely - the default port is 19132.
    +Important: Other services/mods that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser. +

    +
  6. +
  7. +

    Connecting to your server +

    +Connecting locally in the same network
    +On the same device as the server, you can connect using localhost, or 127.0.0.1 as the address. +Do note: When hosting and playing on the same Windows device, you will need the loopback fix. +Other devices in the same local network can use your local IPv4 to connect - it starts with 10. or 192.168.. +

    +Connecting from a different network
    +You will need to expose the port Geyser runs on to the Internet if you want players from outside your network to join. +To achieve that, you have two options:

    + +
      +
    • +

      Port forwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. +Our port forwarding guide explains how to do this in detail. +Then, players can connect with your public IPv4 + port to your server.

      +
    • +
    • +

      playit.gg: Instead of opening a port (which might not be an option/if you do not want to expose your home ip), you can use +the playit.gg service to create a tunnel for you to route the traffic through. See our playit.gg guide. +Ngrok will not work since it is TCP-only.

      +
    • +
    +
  8. +
  9. Verify whether connections from other networks are possible by running geyser connectiontest <ip>:<port> in the console.
  10. +
+ + + +
+
+ + +

Proxy setup - self-hosting

+ + + +
    +
  1. Download the plugin for your proxy software from the download page.
  2. +
  3. Place the Geyser jar in the plugins folder, and restart the server.
  4. +
  5. +

    Open your Geyser config, located in /plugins/Geyser-xyz/config.yml, and find the following:

    + +
     bedrock:
    +     # The IP address that will listen for connections. 
    +     # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server. 
    +     #address: 0.0.0.0 
    +
    +     # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server.
    +     port: 19132
    +
    +

    The vital part is the port. This is the port that Bedrock players will use to connect to your server! + If you enable clone-remote-port, the port will be overridden and the Java port is used. + Since you are self-hosting, you can choose the port freely - the default port is 19132.
    +Important: Other services/plugins that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser. +

    +
  6. +
  7. +

    Connecting to your server +

    + Connecting locally in the same network
    + On the same device as the server, you can connect using localhost, or 127.0.0.1 as the address. + Do note: When hosting and playing on the same Windows device, you will need the loopback fix. + Other devices in the same local network can use your local IPv4 to connect - it starts with 10. or 192.168.. +

    + Connecting from a different network
    + You will need to expose the port Geyser runs on to the Internet if you want players from outside your network to join. + To achieve that, you have two options:

    + +
      +
    • +

      Port forwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. +Our port forwarding guide explains how to do this in detail. +Then, players can connect with your public IPv4 + port to your server.

      +
    • +
    • +

      playit.gg: Instead of opening a port (which might not be an option/if you do not want to expose your home ip), you can use +the playit.gg service to create a tunnel for you to route the traffic through. See our playit.gg guide. +Ngrok will not work since it is TCP-only.

      +
    • +
    +
  8. +
  9. Verify whether connections from other networks are possible by running geyser connectiontest <ip>:<port> in the console.
  10. +
+ + + +
+ +
+ +

Geyser-Standalone Setup

+ + + + + +

General Setup & Configuration

+ +
    +
  1. Download Geyser Standalone from here.
  2. +
  3. Create a new folder for Geyser, and drop the jar in there.
  4. +
  5. Start Geyser Standalone: +
      +
    • GUI (Recommended):
      +Double-click the jar file and all the necessary files for Geyser will be created.
    • +
    • Or use the console setup:
      +Create a new bat or startup script, similar to the one you’d use for a Spigot/Paper server, and take a look at this page for what to put into it.
      +Run the startup script/bat, and all the necessary files for Geyser will be created.
    • +
    +
  6. +
  7. +

    Open your Geyser config (config.yml), and find the following:

    + +
    bedrock:
    +   # The IP address that will listen for connections. 
    +   # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server. 
    +   #address: 0.0.0.0 
    +
    +   # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server.
    +   port: 19132
    +
    +

    The port is the port Bedrock players will enter to connect to the server.
    +Uncommenting and changing address here is only needed if you need to limit connections to a specific IP address. +

    + +

    To configure which Java Edition server Geyser Standalone will send players to, find the remote section:

    +
    remote:
    +   # The IP address of the remote (Java Edition) server
    +   # If it is "auto", for standalone version the remote address will be set to 127.0.0.1.
    +   address: auto
    +
    +   # The port of the remote (Java Edition) server
    +   port: 25565
    +
    +   # Authentication type. Can be offline, online, or floodgate (see https://github.com/GeyserMC/Geyser/wiki/Floodgate).
    +   auth-type: online
    +
    +

    Here, change address to the Java server’s address, or to auto if the server is on the same machine as Geyser-Standalone. +Then, change port to the Java server’s port. If you have set up Floodgate on the remote Java server, you can set auth-type to “floodgate” - otherwise, +set it to either online for an online mode server, or offline for an offline mode server. To install and set up Floodgate with a Standalone server, see here.

    +
  8. +
  9. +

    Connecting to your server +

    +Connecting locally in the same network
    +On the same device as the server, you can connect using localhost, or 127.0.0.1 as the address. +Do note: When hosting and playing on the same Windows device, you will need the loopback fix. +Other devices in the same local network can use your local IPv4 to connect - it starts with 10. or 192.168.. +Alternatively, open Minecraft: Bedrock edition, and join the LAN-Server in the Friends tab. +

    +Connecting from a different network
    +You will need to expose the port Geyser runs on to the Internet if you want players from outside your network to join. +To achieve that, you have two options:

    + +
      +
    • +

      Port forwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. +After doing this, players can connect with your public IPv4 + port to your server. +See here for a helpful guide.

      +
    • +
    • +

      playit.gg: Instead of opening a port (which might not be an option/if you do not want to expose your home ip), you can use +the playit.gg service to create a tunnel for you to route the traffic through. See our playit.gg guide. +Ngrok will not work since it is TCP-only.

      +
    • +
    +
  10. +
  11. Verify whether connections from other networks are possible by running geyser connectiontest <ip>:<port> in the console.
  12. +
+ +

Running Geyser-Standalone on Android/iOS

+ + + +

Termux (Android)

+
    +
  1. Download and install Termux
  2. +
  3. Run pkg install openjdk-17
  4. +
  5. Run wget https://ci.opencollab.dev/job/GeyserMC/job/Geyser/job/master/lastSuccessfulBuild/artifact/bootstrap/standalone/build/libs/Geyser-Standalone.jar
  6. +
  7. Run java -jar Geyser-Standalone.jar
  8. +
+ +

OR

+ +

We have an automated setup script for clean Termux installs, which might not work for all users. If the manual guide above does not work, try this. +Run this to start the download/install:

+
curl https://gist.githubusercontent.com/rtm516/e3e07d6595ee41e05a38b03c0f4d7a80/raw/install.sh | bash
+
+ +

NewTerm 2 (iOS)

+

Note: A jailbreak is required. You can find what jailbreak to use for your device here.

+
    +
  1. Install Filza File Manager.
  2. +
  3. Install NewTerm 2.
  4. +
  5. Download PojavLauncher’s Java 16 JRE for iOS and install it using Filza here.
  6. +
  7. Download this package containing modified java commands, and install it using Filza here (Note: Not an official GeyserMC project, install at your own risk).
  8. +
  9. Open NewTerm 2 and run wget https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/standalone
  10. +
  11. Run java -jar Geyser-Standalone.jar.
  12. +
  13. Geyser should show up in the Friends tab inside Minecraft.
  14. +
+ +

Note: +Due to the iOS environment, if your device has low specs, iOS might end up killing NewTerm 2 while you’re playing, stopping the server. There is no fix for that because of how iOS works.

+ +
+ +
+
+
+ + + +

Further information:

+ + + +
+ +
+
+ + + + + diff --git a/_site/geyser/supported-hosting-providers/index.html b/_site/geyser/supported-hosting-providers/index.html new file mode 100644 index 0000000..dde133d --- /dev/null +++ b/_site/geyser/supported-hosting-providers/index.html @@ -0,0 +1,709 @@ + + + + + + + + GeyserMC Wiki: Supported Hosting Providers + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + + + + + + + + + +

Built-in Geyser

+ +
    +
  • +

    Aternos - Install Geyser in the Aternos plugin list and connect to your server with your Java IP and port. See Aternos’s article for more details. Do note: Aternos automatically installs the latest version of the plugin, but does not auto update it. To update Geyser on Aternos, simply reinstall the plugin (no need to uninstall the plugin/deleting the plugin files).

    +
  • +
  • +

    Apex Hosting - Full auto installation. Go to the Customizations tab in the panel and select ‘Enabled’ under the ‘Geyser Auto Installer’ option. Then, restart and connect to your server with your Java IP and port. See Apex’s article for more details.

    +
  • +
  • +

    Cloud Nord - Go to their Crossplay Server hosting section and order your server. Instructions on how to join are provided.

    +
  • +
  • +

    CreeperHost - Has a toggle within the control panel to automatically enable Geyser. May not be enabled by default, so you may need to toggle it and restart the server.

    +
  • +
  • +

    Cubes Hosting - Install Geyser using the plugin manager. Then restart the server and Geyser will run on an additional port - you can check it in the server console. Geyser-Standalone can be set up through a support ticket.

    +
  • +
  • +

    exaroton - Install Geyser in the exaroton plugin list and connect to your server with your Java IP and port. See exaroton’s article for more details.

    +
  • +
  • +

    GGServers - Can be installed to any server from their auto plugin setups. No further configuration needed.

    +
  • +
  • +

    MCProHosting - Click ‘Enable Bedrock Support’ on the server dashboard and follow the steps. For manual installation: Add ‘Destination Port’ 19132 with ‘Protocol UDP’ to the port forward mapping and connect to the given source port.

    +
  • +
  • +

    Minefort - On the server dashboard under ‘Connect Support’, make sure ‘Allow Bedrock’ is enabled. Then connect via play.minefort.com and join using /server <servername>, or connect via <servername>.minefort.com.

    +
  • +
  • +

    Minehut - Connect via bedrock.minehut.com and do /join <servername>, or connect directly via <servername>.bedrock.minehut.gg.

    +
  • +
  • +

    Physgun - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    OMGServ - Select Geyser in the Install Menu, it will be automatically installed. You can enable floodgate in the server properties on the dashboard.

    +
  • +
  • +

    PloudOS - Connect via geyser.ploudos.com and enter the with your Java IP and port. See PloudOS’s article for more details.

    +
  • +
  • +

    Pufferfish Host - Geyser is installed and configured on all servers by default.

    +
  • +
  • +

    Server.pro - Different instructions for different plans: On VPS, select Geyser in the Service Type Menu, Floodgate can be enabled on the dashboard configuration. For manual installation: Using a Premium or Free plan, use the same port as your Java server for the Bedrock port in the configuration file and connect that; for the Free plan, also enable the clone-remote-port option. If you are using a PRO or a VPS plan, you can use any port, which can be opened on the Firewall tab.

    +
  • +
  • +

    Snakecraft Hosting - Select ‘Paper + Geyser with Floodgate’ under the Jar Type at checkout to install the Geyser plugin. Players will Connect with the same IP and port as you would on Java.

    +
  • +
  • +

    SRKHOST - You can enable Geyser on the version changer page. Geyser will run on the given port by the host.

    +
  • +
  • +

    Virtual Gladiators - Find the plugin in the control panel under the ‘VG Recommended’ category and restart your server. IP and port are the same as Java.

    +
  • +
  • +

    WiseHosting - Both auto and manual installation available. Find the GeyserMC presets from the Properties tab in the Game Panel. There, click Install and restart your server. See Crossplay FAQ for additional details.

    +
  • +
  • +

    ZapHosting - Find the plugin in the control panel and restart your server. IP and port are the same as Java.

    +
  • +
  • +

    365Hosts - Go to their Minecraft: Crossplay hosting section and order your server. Instructions on how to join are provided.

    +
  • +
+ +

Support for Geyser

+ +
    +
  • +

    Akliz - Offers a working port forwarding option.

    +
  • +
  • +

    Aquatis - Need to open a support ticket to get a UDP port, then use that as the bedrock port.

    +
  • +
  • +

    BisectHosting - You must have a plan with a dedicated IP. In Geyser’s config, uncomment the bedrock address and set it to the public IP of your server (e.g. address: 51.79.129.18). Leave the port as 19132. Under the home tab, select ‘Enable UDP Network’ and restart the server. See Bisect’s article for full instructions.

    +
  • +
  • +

    Bloom.Host - Offers a working port forwarding option.

    +
  • +
  • +

    Clovux - Make sure your remote address is ‘auto’, uncomment bedrock address, and change 0.0.0.0 to your Java server’s IP.

    +
  • +
  • +

    Consulhosting - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    Craft-Hosting - Set the Bedrock port to the Java server’s port and connect with that port; note that this provider appears to only provide service in Russia.

    +
  • +
  • +

    DedicatedMC - Contact the support to open the default Bedrock port, which Geyser is configured to use by default.

    +
  • +
  • +

    ElfIDC - When placing an order, choose Paper/Spigot + Geyser, which will automatically install the Geyser plugin. Connect with the Java server’s IP and port. Note: This provider only provides service in China.

    +
  • +
  • +

    EnviroMC - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    ExtraVM - Make sure your remote address is ‘auto’, uncomment bedrock address, and change 0.0.0.0 to your Java server’s IP.

    +
  • +
  • +

    FadeHost - Set the Bedrock port to the Java server’s port and connect with that port. Alternatively, buy a dedicated IP address to support a different port.

    +
  • +
  • +

    FakaHeda - Set the bedrock port in the config to the Java server’s port or use one of the available ports allocated to your server, and connect with that port.

    +
  • +
  • +

    FalixNodes - Open a port yourself on the network page in the game panel, then use that port in the bedrock section of the Geyser config.

    +
  • +
  • +

    Ferox Hosting - Open a port yourself in their panel and check out the knowledgebase article for how to install and configure Geyser.

    +
  • +
  • +

    Fluctis Hosting - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    FREAKHOSTING - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    FreeMcServer.net - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    Fusion Hosting - Get Geyser as a plugin. Use the same port as your Java server for the Bedrock port in your config (either by setting it yourself, or enabling “clone-remote-port”) and connect with the same IP and port as you would on Java or create a port in the Network tab on the panel & use this for Geyser.

    +
  • +
  • +

    Futurehosting - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port. Make sure your bedrock address in your Geyser config is your server IP.

    +
  • +
  • +

    GameHosting.it - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    GPortal - You have to adjust the port according to your query port. Scheme: Query port: xxx65. The ports from xxx66 to xxx70 are available. For example, if your query port is 12365, then Geyser can only run under the port range 12366-12370. Furthermore, you have to change the ‘Bedrock’ ‘address’ in the Geyser config to your IP address. You can find it above your query port. Don’t forget to delete the # in front of `address’.

    +
  • +
  • +

    Heavynode - Open a port yourself in the networking section of the control panel. Port 19132 is only available with a dedicated IP (contact support), otherwise you will need to use a randomly assigned port. To resolve further connection issues for servers located in Canada and the UK, contact their support with the info found here.

    +
  • +
  • +

    Hicoria - Use one of the available ports allocated for your server for the Bedrock port in your config and connect with that port.

    +
  • +
  • +

    Hosterfy - Use the same port as your Java server for the Bedrock port in your config (either by setting it yourself, or enabling clone-remote-port) and connect with the same IP and port as you would on Java. You can also ask for a new port.

    +
  • +
  • +

    HostEZ - Geyser plugin supported with self-install or installed on request with its own port.

    +
  • +
  • +

    HumbleServers - Set the Bedrock port to the Java server’s port, or to one of the two extra ports, and connect with that port. If the subdomain doesn’t work, use your regular numbered IP address.

    +
  • +
  • +

    MC-HOST24.de - Enable clone-remote-port (or manually set bedrock port to the Java port), uncomment bedrock address, and change 0.0.0.0 to your Java server’s IP. Connect with the Java IP and port.

    +
  • +
  • +

    Meloncube - Contact the support for a UDP port to use for Geyser. Set that port as the bedrock port, and connect with it.

    +
  • +
  • +

    MineStrator - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    Minecraft-Hosting.pro - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    Netbela - Install Geyser with the dedicated Plugin installer. Use the same port as your Java server in your config. Connect with the same address and port as your Java server.

    +
  • +
  • +

    NFOservers - Uncomment and set bedrock address to the server IP in the Geyser config file. As an alternative, you can run Geyser standalone separately on an Unmanaged VDS.

    +
  • +
  • +

    Nitrado - Get Geyser as a plugin. Add 4 to the Port of the Java server. See here for specific instructions.

    +
  • +
  • +

    Nodecraft - Use the default server port and 0.0.0.0 or your server IP as the host address.

    +
  • +
  • +

    Pebblehost - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port. See this video for a PebbleHost-specific tutorial.

    +
  • +
  • +

    PlanetNode - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    PUBCS - Set the Bedrock port to the Java server’s port and connect with that port, or upgrade to a plan that includes dedicated IP address to support a different port.

    +
  • +
  • +

    RamShard - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    Redline Hosting - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    Revivenode - Set bedrock port to the Java server’s port (either by setting it yourself, or enabling clone-remote-port). You can also create a secondary port in the network tab and use that. To fix random Unable to Connect issues, see here.

    +
  • +
  • +

    ScalaCube - Enable clone-remote-port (or manually set bedrock port to the Java port), uncomment bedrock address, and change 0.0.0.0 to your Java server’s IP. Connect with the Java IP and port.

    +
  • +
  • +

    Shockbyte - Uncomment and set bedrock address to the Java server’s IP, and bedrock port to the Java server’ port. Connect with the same IP and port as on Java. For Geyser Standalone installation instructions, see here.

    +
  • +
  • +

    Skynode.pro - Go to ‘Server Details’, add a new port, and set the bedrock port in your config to that port. Connect with it and the Java server’s address.

    +
  • +
  • +

    Sparked Host - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    StellaNode - Open a support ticket on the billing panel to receive an additional UDP port for Geyser, then set that as the bedrock port.

    +
  • +
  • +

    STIPE - Set the Bedrock port to the Java server’s port and connect with that port; note that this provider only provides service in Australia.

    +
  • +
  • +

    SyntexHosting - Set the Bedrock port to the Java server’s port and connect with that port, or request a (free) additional port.

    +
  • +
  • +

    The Minecraft Hosting - Try using 19132 as the Bedrock port, if that does not work, use the same Java server’s port for the bedrock port in your config and connect with that port and the Java server’s IP.

    +
  • +
  • +

    TNAHosting - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    TurboHost - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    UltimateSRV - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    Volcano Hosting - Enable clone-remote-port (or manually set bedrock port to the Java port), and connect with the Java IP and port.

    +
  • +
  • +

    Vultam - Set the bedrock port to the Java server’s port, or request an additional port. The additional port can be 19132 if you buy a dedicated IP.

    +
  • +
  • +

    WinterNode - Set the Bedrock port to the Java server’s port and connect with that port. Alternatively, request an additional port, or buy a dedicated IP address.

    +
  • +
  • +

    WitherHosting - Either use the Java server’s port, or create a port in the ports manager on the panel and use that for Bedrock. Refer to the hosts support article for further info.

    +
  • +
+ +

Does not support Geyser

+ +
    +
  • +

    MCPEhost

    +
  • +
  • +

    MyArena - Does seem to be working, but the Java version is too old in order for Geyser to run properly.

    +
  • +
  • +

    NiCraft - Does not provide Bedrock support, and are affected by a firewall configuration issue, which prohibits most players from joining.

    +
  • +
  • +

    Feather - Their proxy network does not support UDP. Therefore, Geyser is not supported. As an alternative, set up a paper server with e.g. playit.gg instead of port forwarding.

    +
  • +
+ + + +
+ +
+
+ + + + + diff --git a/_site/geyser/understanding-the-config/index.html b/_site/geyser/understanding-the-config/index.html new file mode 100644 index 0000000..c4aacbb --- /dev/null +++ b/_site/geyser/understanding-the-config/index.html @@ -0,0 +1,575 @@ + + + + + + + + GeyserMC Wiki: Understanding the Config + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

This page covers basic information about the Geyser config and what each option does. Though they are explained in the configuration itself, this explains what each option does in more detail.

+ +

Bedrock Section

+

The options for Geyser on the Bedrock-facing end. Mostly contains options for how Bedrock edition will see the server.

+ +

address: The address of Geyser on the Bedrock end. In most all scenarios, this should not need to be changed, unless you want to limit what IPs can connect to your server. Leave it at 0.0.0.0 (default), unless otherwise instructed in the setup guide.

+ +

port: The port Geyser will run on. By default, it is 19132 in Bedrock. If you are using a server hosting provider, you may not have this port available to you - in which case, read the setup guide to proceed.

+ +

clone-remote-port: Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock/UDP connections. This option makes the Bedrock port the same as the Java port every time you start the server. This option does not do anything on the Standalone version of Geyser.

+ +

motd1: The first line of the MOTD for Geyser.

+ +

motd2: The second line of the MOTD for Geyser. Please keep in mind, this option will only work if Geyser is shown in the Friends tab!

+ +

server-name: The world name that is shown in the top-right area of the pause menu and the settings menu.

+ +

compression-level: An number value that represents how much to compress outgoing traffic. Can be any number from -1 to 9; any other value will be replaced with the nearest acceptable value. The higher the number, the more CPU processing that is used but with less bandwidth used. Default is 6.

+ +

enable-proxy-protocol: Whether to enable PROXY protocol or not for clients. You DO NOT WANT this feature unless you run UDP reverse proxy in front of your Geyser instance. You do NOT need this for BungeeCord (and forks), Velocity, or Waterfall.

+ +

proxy-protocol-whitelisted-ips: Disabled by default, and only enable this if you use “enable-proxy-protocol”. A list of allowed PROXY protocol speaking proxy IP addresses/subnets. Should really only be used when you are not able to use a proper firewall (usually true with shared hosting providers etc.). Keeping this list empty means there is no IP address whitelist. Both IP addresses and subnets are supported.

+ +

Remote Section

+

Options for the remote (Java) server.

+ +

address: The address of the Minecraft: Java Edition server you want to join. By default, this value is auto. By keeping it as auto, the address, port, and Floodgate support will be automatically configured. In standalone, keeping this as auto sets the remote address to 127.0.0.1.

+ +

port: The port of the Minecraft: Java Edition server you specified in the address section. For plugin versions, if address has been set to “auto”, the port will also follow the server’s listening port.

+ +

auth-type: The authentication type of the Minecraft: Java Edition server. Valid options are online, offline, and floodgate.

+ +

Please keep in mind, what you specify in the Geyser auth-type option MUST be the same as what the remote server has (with the exception of Geyser being in online mode and remote being in offline mode). You simply cannot join an online mode server without a genuine account. If you want to allow Minecraft: Bedrock Edition accounts to join without a Minecraft: Java Edition account, see the Floodgate wiki page.

+ +

use-proxy-protocol: Whether to enable PROXY/HAProxy protocol or not while connecting to the server. This is useful only when:

+
    +
  • Your server supports PROXY protocol (it probably doesn’t)
  • +
  • You run Velocity or BungeeCord with its respective option enabled.
  • +
  • IF YOU DON’T KNOW WHAT THIS IS, DON’T TOUCH IT!
  • +
+ +

forward-hostname: Forwards the hostname/IP address that the Bedrock client used to connect over to the Java server. This is designed to be used for forced hosts on proxies.

+ +

General Options

+

General Geyser options that are mostly specific to Geyser itself.

+ +

floodgate-key-file: Floodgate uses encryption to ensure use from authorised sources. This should point to the public key generated by Floodgate (BungeeCord, Spigot or Velocity). You can ignore this when not using Floodgate. If you’re using a plugin version of Floodgate on the same server, the key will automatically be picked up from Floodgate.The key file path for Floodgate. Requires that you have Floodgate installed and the auth-type set to floodgate.

+ +

saved-user-logins: For online mode authentication type only. +Stores a list of Bedrock players that should have their Java Edition account saved after login. +This saves a token that can be reused to authenticate the player later. This does not save emails or passwords, +but you should still be cautious when adding to this list and giving others access to this Geyser instance’s files. +Removing a name from this list will delete its cached login information on the next Geyser startup. +The file that tokens will be saved in is in the same folder as this config, named saved-refresh-tokens.json.

+ +

Format:

+ +
saved-user-logins:
+  - jeb_
+  - Dinnerbone
+
+ +

command-suggestions: Bedrock clients freeze or crash when opening up the command prompt for the first time with a large amount of command suggestions. This config option disables command suggestions being sent to prevent any freezing. Since 1.16.100: command freezing and crashing has been largely reduced; you may no longer need this option disabled.

+ +

passthrough-motd: If the MOTD should be relayed from the remote server. Causes the motd1 and motd2 options in the bedrock section to no longer have a use.

+ +

passthrough-protocol-name: Relay the protocol name (e.g. BungeeCord [X.X], Paper 1.X) - this is only really useful when using a custom protocol name! This will also show up on sites like MCSrvStatus.

+ +

passthrough-player-count: If the current and max player counts should be relayed from the remote server.

+ +

legacy-ping-passthrough: If enabled, manually pings the server by impersonating a Minecraft client instead of using the server’s API. This option should only be enabled if your MOTD or player count is not accurate, as it can cause errors especially on BungeeCord. This option does nothing on Geyser Standalone.

+ +

ping-passthrough-interval: How often the fake Minecraft client should attempt to ping the remote server to update information, in seconds (a setting of 1 will ping the server every second; a setting of 3 will ping the server every three seconds). Only relevant for standalone and legacy ping passthrough. Increase the number if you’re getting timeout or BrokenPipe exceptions.

+ +

forward-player-ping: Whether to forward player ping to the server. While enabling this will allow Bedrock players to have more accurate ping, it may also cause players to time out more easily.

+ +

max-players: The maximum amount of players shown when pinging the server. This does not actually cap how many players can join the Geyser instance at this time. The number will visually increase when pinging if the amount of players is greater, as Bedrock clients will not even attempt to join a full server.

+ +

debug-mode: If debug messages should be printed in console. Useful if you run into an error and need more context. Yes, this will cause more messages, warnings or even errors in console - some packets aren’t translated.

+ +

allow-third-party-capes: If third party (Optifine, 5zig, LabyMod, etc.) capes should be displayed to the bedrock player.

+ +

allow-third-party-ears: If third party Deadmau5-style ears should be enabled. Currently only supports MinecraftCapes.

+ +

show-cooldown: Bedrock Edition currently does not have Java Edition 1.9+ combat mechanics. In order to get around this, Geyser sends a fake cooldown by sending a title message. This cooldown should not show if 1.8 combat mechanics are in use. The options available for this setting are false (no cooldown is sent), title/true (a cooldown indication is shown in the title), or actionbar (a cooldown indication is shown in the action bar). All other options default to false.

+ +

show-coordinates: Bedrock Edition has an option to show coordinates in the top-left part of your screen. This setting enables or disables this.

+ +

disable-bedrock-scaffolding: Whether Bedrock players are blocked from performing their scaffolding-style bridging.

+ +

emote-offhand-workaround: Since Java Edition 1.9, clients have had the ability to switch the item in their mainhand and offhand with a keybind. Bedrock Edition does not have this ability, so this config option makes up for it, If set, when a Bedrock player performs any emote, it will swap the offhand and mainhand items, just like the Java Edition keybind. There are three options this can be set to:

+
    +
  • disabled - the default/fallback, which doesn’t apply this workaround
  • +
  • no-emotes - emotes will NOT be sent to other Bedrock clients and offhand will be swapped. This effectively disables all emotes from being seen.
  • +
  • emotes-and-offhand - emotes will be sent to Bedrock clients and offhand will be swapped
  • +
+ +

default-locale: The default locale to send to players if their locale could not be found. Check this page to find the code corresponding to your language. This option is disabled by default - to enable it, remove the “#” in front of the option.

+ +

cache-images: Specify how many days images will be cached to disk to save downloading them from the internet. A value of 0 is disabled. (Default: 0)

+ +

allow-custom-skulls: Allows custom skulls to be displayed when placed. Keeping them enabled may cause a performance decrease on older/weaker devices.

+ +

max-visible-custom-skulls: The maximum number of custom skulls to be displayed per player. Increasing this may decrease performance on weaker devices. Setting this to -1 will cause all custom skulls to be displayed regardless of distance or number.

+ +

custom-skull-render-distance: A number value specifying the radius in blocks around the player in which custom skulls are displayed. 32 by default.

+ +

add-non-bedrock-items: Whether to add (at this time, only) the furnace minecart as a separate item in the game, which normally does not exist in Bedrock Edition. This should only need to be disabled if using a proxy that does not use the “transfer packet” style of server switching. If this is disabled, furnace minecart items will be mapped to hopper minecart items. This option requires a restart of Geyser in order to change its setting.

+ +

above-bedrock-nether-building: Bedrock prevents building and displaying blocks above Y127 in the Nether - enabling this config option works around that by changing the Nether dimension ID to the End ID. The main downside to this is that the sky will resemble that of the End sky in the Nether, but ultimately it’s the only way for this feature to work.

+ +

force-resource-packs: Force clients to load all resource packs if there are any. If set to false, it allows the user to disconnect from the server if they don’t want to download the resource packs.

+ +

xbox-achievements-enabled: Allows Xbox achievements to be unlocked. This disables certain commands so the Bedrock client can’t “cheat” to get them; this cannot be worked around if you want to enable this. Commands such as /gamemode and /give will not work from Bedrock with this enabled.

+ +

log-player-ip-addresses: Whether player IP addresses will be logged by the server.

+ +

notify-on-new-bedrock-update: Whether to alert the console and operators that a new Geyser version is available that supports a Bedrock version that this Geyser version does not support. It’s recommended to keep this option enabled, as many Bedrock platforms auto-update.

+ +

unusable-space-block: Which item to use to mark unavailable slots in a Bedrock player inventory. Examples of this are the 2x2 crafting grid while in creative, or custom inventory menus with sizes different from the usual 3x9. A barrier block is the default item (minecraft:barrier is therefore the default value). Takes any Minecraft Bedrock identifier, e.g. minecraft:apple. To set this to a custom item, you will need to add the geyser_custom: namespace.

+ +

Metrics

+ +

bStats is a stat tracker that is entirely anonymous and tracks only basic information about Geyser, such as how many people are online, how many servers are using Geyser, what OS is being used, etc. You can learn more about bStats here. To see Geyser Stats, see here.

+ +

enabled: If metrics are enabled

+ +

uuid: UUID of the server, don’t change this!

+ +

Advanced Options

+ +

scoreboard-packet-threshold: Geyser updates the Scoreboard after every Scoreboard packet, but when Geyser tries to handle a lot of scoreboard packets per second can cause serious lag. This option allows you to specify after how many Scoreboard packets per seconds the Scoreboard updates will be then limited to four updates per second.

+ +

enable-proxy-connections: Allow connections from ProxyPass and Waterdog. See https://www.spigotmc.org/wiki/firewall-guide/ for assistance - use UDP instead of TCP. This option does not need to be enabled in instances like BungeeCord or Velocity.

+ +

mtu: https://en.wikipedia.org/wiki/Maximum_transmission_unit - The internet supports a maximum MTU of 1492 but could cause issues with packet fragmentation. 1400 is the default.

+ +

use-direct-connection: Whether to connect directly into the Java server without creating a TCP connection. This should only be disabled if a plugin that interfaces with packets or the network does not work correctly with Geyser. If enabled on plugin versions, the remote address and port sections are ignored. If disabled on plugin versions, expect performance decrease and latency increase.

+ +

Default Geyser Config: config.yml

+ + +
+ +
+
+ + + + + diff --git a/_site/geyser/using-geyser-with-consoles/index.html b/_site/geyser/using-geyser-with-consoles/index.html new file mode 100644 index 0000000..6bff6a1 --- /dev/null +++ b/_site/geyser/using-geyser-with-consoles/index.html @@ -0,0 +1,488 @@ + + + + + + + + GeyserMC Wiki: Using Geyser with Consoles + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+ + +

All consoles can join third-party servers - including Geyser servers - with workarounds. Xbox One, Nintendo Switch, and PS4 systems can join third-party servers using a third-party program called BedrockConnect. For technical information about the program, including how to run your own setup, see their GitHub repository (This program is not affiliated with GeyserMC). Other methods are also available for use.

+ +

There is also a tool anyone can set up that allows you to connect to the server via adding a user to your friends list - FriendConnect, and MCXboxBroadcast. The latter one can even be set up as a Geyser Extension.

+ +

NOTE: The main IP used for BedrockConnect is often blocked on consoles, if you run into issues with internet connection or joining servers after changing your DNS, consider using either one of the other BedrockConnect servers on the BedrockConnect Github Page, or the Public GeyserConnect which allows connecting to both Java and Bedrock servers.

+ +

Xbox One

+ +

(Video linked below)

+ +

Xbox One BedrockConnect

+ +

Nintendo Switch

+ +

(Video linked below)

+ +

Nintendo Switch BedrockConnect

+ +

PlayStation 4

+
    +
  1. Go to your PS4 Home screen.
  2. +
  3. Go to Settings.
  4. +
  5. Go to Network.
  6. +
  7. Select Set Up Internet connection.
  8. +
  9. If you are using wired internet, select “Use LAN Cable”, otherwise choose “Use Wi-Fi”.
  10. +
  11. Select the Custom network creation mode.
  12. +
  13. Select Automatic IP Address.
  14. +
  15. For DHCP Host Name, make sure you select Do Not Specify.
  16. +
  17. Under DNS Settings, select Manual.
  18. +
  19. Enter the BedrockConnect IP for the preferred Primary DNS (Multiple options depending on region can be found on the BedrockConnect Github Page) and something like Google or Cloudfare’s IP for the Secondary DNS (8.8.8.8 or 1.1.1.1).
  20. +
+ +

Alternative Methods

+

If you’d rather try emulating a LAN game on your network on another device, here’s how you’d do that.

+ +

Note that this method will not work with the Nintendo Switch.

+ +

Using a PC

+

If you have a PC, you can use Phantom.

+ +

Using an Android Device

+

If you have an Android device, you have several options:

+ + +

Using an iOS device

+

If you have an iOS 14+ device, you can use BedrockTogether.

+ + +
+ +
+
+ + + + + diff --git a/img/icons/fabric.png b/_site/img/icons/fabric.png similarity index 100% rename from img/icons/fabric.png rename to _site/img/icons/fabric.png diff --git a/img/icons/geyser.png b/_site/img/icons/geyser.png similarity index 100% rename from img/icons/geyser.png rename to _site/img/icons/geyser.png diff --git a/img/icons/paper.png b/_site/img/icons/paper.png similarity index 100% rename from img/icons/paper.png rename to _site/img/icons/paper.png diff --git a/img/icons/sponge.png b/_site/img/icons/sponge.png similarity index 100% rename from img/icons/sponge.png rename to _site/img/icons/sponge.png diff --git a/img/icons/velocity.svg b/_site/img/icons/velocity.svg similarity index 100% rename from img/icons/velocity.svg rename to _site/img/icons/velocity.svg diff --git a/img/wiki/discord-bot/logs.png b/_site/img/wiki/discord-bot/logs.png similarity index 100% rename from img/wiki/discord-bot/logs.png rename to _site/img/wiki/discord-bot/logs.png diff --git a/img/wiki/discord-bot/ocr.png b/_site/img/wiki/discord-bot/ocr.png similarity index 100% rename from img/wiki/discord-bot/ocr.png rename to _site/img/wiki/discord-bot/ocr.png diff --git a/img/wiki/discord-bot/ping.png b/_site/img/wiki/discord-bot/ping.png similarity index 100% rename from img/wiki/discord-bot/ping.png rename to _site/img/wiki/discord-bot/ping.png diff --git a/img/wiki/discord-bot/provider.png b/_site/img/wiki/discord-bot/provider.png similarity index 100% rename from img/wiki/discord-bot/provider.png rename to _site/img/wiki/discord-bot/provider.png diff --git a/img/wiki/edit_server_form.png b/_site/img/wiki/edit_server_form.png similarity index 100% rename from img/wiki/edit_server_form.png rename to _site/img/wiki/edit_server_form.png diff --git a/img/wiki/playit-gg/add_tunnel.png b/_site/img/wiki/playit-gg/add_tunnel.png similarity index 100% rename from img/wiki/playit-gg/add_tunnel.png rename to _site/img/wiki/playit-gg/add_tunnel.png diff --git a/img/wiki/playit-gg/added_tunnel.png b/_site/img/wiki/playit-gg/added_tunnel.png similarity index 100% rename from img/wiki/playit-gg/added_tunnel.png rename to _site/img/wiki/playit-gg/added_tunnel.png diff --git a/img/wiki/playit-gg/running.png b/_site/img/wiki/playit-gg/running.png similarity index 100% rename from img/wiki/playit-gg/running.png rename to _site/img/wiki/playit-gg/running.png diff --git a/img/wiki/port-forwarding/macos_warning.png b/_site/img/wiki/port-forwarding/macos_warning.png similarity index 100% rename from img/wiki/port-forwarding/macos_warning.png rename to _site/img/wiki/port-forwarding/macos_warning.png diff --git a/img/wiki/port-forwarding/pterodactyl-1.png b/_site/img/wiki/port-forwarding/pterodactyl-1.png similarity index 100% rename from img/wiki/port-forwarding/pterodactyl-1.png rename to _site/img/wiki/port-forwarding/pterodactyl-1.png diff --git a/img/wiki/port-forwarding/windows-1.png b/_site/img/wiki/port-forwarding/windows-1.png similarity index 100% rename from img/wiki/port-forwarding/windows-1.png rename to _site/img/wiki/port-forwarding/windows-1.png diff --git a/img/wiki/port-forwarding/windows-2.png b/_site/img/wiki/port-forwarding/windows-2.png similarity index 100% rename from img/wiki/port-forwarding/windows-2.png rename to _site/img/wiki/port-forwarding/windows-2.png diff --git a/img/wiki/port-forwarding/windows-3.png b/_site/img/wiki/port-forwarding/windows-3.png similarity index 100% rename from img/wiki/port-forwarding/windows-3.png rename to _site/img/wiki/port-forwarding/windows-3.png diff --git a/img/wiki/port-forwarding/windows-4.png b/_site/img/wiki/port-forwarding/windows-4.png similarity index 100% rename from img/wiki/port-forwarding/windows-4.png rename to _site/img/wiki/port-forwarding/windows-4.png diff --git a/img/wiki/port-forwarding/windows-5.png b/_site/img/wiki/port-forwarding/windows-5.png similarity index 100% rename from img/wiki/port-forwarding/windows-5.png rename to _site/img/wiki/port-forwarding/windows-5.png diff --git a/img/wiki/port-forwarding/windows-6.png b/_site/img/wiki/port-forwarding/windows-6.png similarity index 100% rename from img/wiki/port-forwarding/windows-6.png rename to _site/img/wiki/port-forwarding/windows-6.png diff --git a/img/wiki/port-forwarding/windows-7.png b/_site/img/wiki/port-forwarding/windows-7.png similarity index 100% rename from img/wiki/port-forwarding/windows-7.png rename to _site/img/wiki/port-forwarding/windows-7.png diff --git a/img/wiki/skin_upload_example.png b/_site/img/wiki/skin_upload_example.png similarity index 100% rename from img/wiki/skin_upload_example.png rename to _site/img/wiki/skin_upload_example.png diff --git a/_site/index.html b/_site/index.html new file mode 100644 index 0000000..ded3f87 --- /dev/null +++ b/_site/index.html @@ -0,0 +1,425 @@ + + + + + + + + GeyserMC Wiki + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+
+
+ +
+
+
+
+ geyser logo +
+


+ +

GeyserMC Wiki

+ +

Here you will find setup guides, FAQs and other information about GeyserMC projects including but not limited to Geyser and Floodgate. You can access the various pages from the sidebar on the left.

+ +
+ +
+
+ + + + + diff --git a/_site/js/page-nav.js b/_site/js/page-nav.js new file mode 100644 index 0000000..0bb9b2c --- /dev/null +++ b/_site/js/page-nav.js @@ -0,0 +1,26 @@ +(function () { + const toc = document.querySelector('#page-nav') + + // Select each header + const sections = document.querySelectorAll('main h1') + sections.forEach((section, id) => { + // Create the header link + toc.innerHTML += '' + + // Create the sub links container + const children = document.createElement('nav') + children.className = 'md-nav' + children.innerHTML = '' + + // Select all the sub headers and add them to the sub links container + let contenders = section.nextElementSibling + while (contenders && contenders.tagName !== 'H1') { + if (contenders.tagName === 'H2' || contenders.tagName === 'H3') { + const content = '
  • ' + contenders.textContent + '
  • ' + children.firstElementChild.innerHTML += content + } + contenders = contenders.nextElementSibling + } + document.querySelector('#link_' + section.id).appendChild(children) + }) +})() diff --git a/_site/js/search.js b/_site/js/search.js new file mode 100644 index 0000000..6c6a759 --- /dev/null +++ b/_site/js/search.js @@ -0,0 +1,102 @@ +(function () { + function getQueryVariable (variable) { + const query = window.location.search.substring(1) + const vars = query.split('&') + + for (let i = 0; i < vars.length; i++) { + const pair = vars[i].split('=') + + if (pair[0] === variable) { + return decodeURIComponent(pair[1].replace(/\+/g, '%20')).trim() + } + } + } + + function getPreview (query, content, previewLength) { + previewLength = previewLength || (content.length * 2) + + const parts = query.split(' ') + let match = content.toLowerCase().indexOf(query.toLowerCase()) + let matchLength = query.length + let preview + + // Find a relevant location in content + for (let i = 0; i < parts.length; i++) { + if (match >= 0) { + break + } + + match = content.toLowerCase().indexOf(parts[i].toLowerCase()) + matchLength = parts[i].length + } + + // Create preview + if (match >= 0) { + const start = match - (previewLength / 2) + const end = start > 0 ? match + matchLength + (previewLength / 2) : previewLength + + preview = content.substring(start, end).trim() + + if (start > 0) { + preview = '...' + preview + } + + if (end < content.length) { + preview = preview + '...' + } + + // Highlight query parts + preview = preview.replace(new RegExp('(' + parts.join('|') + ')', 'gi'), '$1') + } else { + // Use start of content if no match found + preview = content.substring(0, previewLength).trim() + (content.length > previewLength ? '...' : '') + } + + return preview + } + + function displaySearchResults (results, query) { + const searchResultsEl = document.getElementById('search-results') + const searchProcessEl = document.getElementById('search-process') + + if (results.length) { + let resultsHTML = '' + results.forEach(function (result) { + const item = window.data[result.ref] + if (item.title) { + const contentPreview = getPreview(query, item.content, 170) + const titlePreview = getPreview(query, item.title) + resultsHTML += "
  • " + titlePreview + '

    ' + contentPreview + '

  • ' + } + }) + + searchResultsEl.innerHTML = resultsHTML + searchProcessEl.innerText = 'Showing' + } else { + searchResultsEl.style.display = 'none' + searchProcessEl.innerText = 'No' + } + } + + window.index = lunr(function () { + this.field('id') + this.field('title', { boost: 10 }) + this.field('url') + this.field('content') + }) + + const query = decodeURIComponent((getQueryVariable('q') || '').replace(/\+/g, '%20')) + const searchQueryContainerEl = document.getElementById('search-query-container') + const searchQueryEl = document.getElementById('search-query') + + searchQueryEl.innerText = query + if (query !== '') { + searchQueryContainerEl.style.display = 'inline' + } + + for (const key in window.data) { + window.index.add(window.data[key]) + } + + displaySearchResults(window.index.search(query), query) // Hand the results off to be displayed +})() diff --git a/_site/other/community-geyser-projects/index.html b/_site/other/community-geyser-projects/index.html new file mode 100644 index 0000000..c39a699 --- /dev/null +++ b/_site/other/community-geyser-projects/index.html @@ -0,0 +1,568 @@ + + + + + + + + GeyserMC Wiki: Community Geyser Projects + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    +
    +
    +
    +
    + +
    +
    +
    + + +

    Below is a list of community-compiled plugins, extensions and tools that work with Geyser.

    + +

    Please note that, as these are unofficial, the main Geyser Discord will likely be unable to help with any bugs or issues you run into. Please check the linked pages for their support systems.

    + +

    If you wish to add your own plugin to this list, please reach out in the #development channel of Geyser first!

    + +

    BedrockFormShop

    + +

    A Spigot shop plugin that uses Bedrock forms.

    + + + +

    Creator: KejonaMC

    + +

    Bedrock Player Manager for Floodgate

    +

    A Spigot plugin that is able to run certain commands when a Bedrock player joins, or have Bedrock players able to bypass the anticheat, etc.

    + + + +

    Creator: ofunny

    + +

    BedrockSkinUtility

    +

    This is a Fabric mod that allows you to view Bedrock capes from Java.

    + + + +

    Creator: Camotoy

    + +

    CreeperNation Skin API

    + +

    An SkinAPI that displays Java or Bedrock skins based on the UUID or username.

    + + + +

    Creators: creeperz653, BlueTree242

    + +

    CrossplatForms

    +

    A Spigot, BungeeCord, and Velocity plugin to create custom Bedrock Edition forms and inventory menus through configurations.

    + + +

    Creators: Konicai, Jens

    + +

    CustomCommandPrefix

    +

    A Spigot plugin that allows users to enter commands starting with ., to work around Xbox achievements being disabled.

    + + + +

    Creator: Chew

    + +

    FloodgatePlaceholders

    +

    Placeholders support for Floodgate.

    + + + +

    Creator: rtm516

    + +

    Floodgate-Skript

    +

    Floodgate support for Skript.

    + + + +

    Creator: Camotoy

    + +

    GeyserBlockJavaPlayers

    +

    Plugin that blocks Java players from joining your Geyser server, so you can have a Bedrock only server that can use Spigot plugins.

    + + + +

    Creator: Camotoy

    + +

    GeyserPreventServerSwitch

    +

    Prevent Bedrock players from joining specific sub-servers on a proxy

    + + + +

    Creator: Camotoy

    + +

    GeyserSkinManager

    +

    Spigot and Bungee plugin to make Bedrock skins work; requires Geyser to be installed on the server.

    + + +

    Creator: Camotoy

    + +

    GeyserUpdater

    +

    This is a Spigot/BungeeCord/Velocity plugin that can be used to automatically update Geyser.

    + + + +

    Creators: Jens, YHDiamond, Konicai

    + +

    SleepingServerStarter

    +

    Small application that waits for a player to connect before launching actual minecraft server.

    + + +

    Creator: Vincss

    + +

    TydiumCraft Skin API

    +

    An API makes it easier for your Bedrock skin to be rendered and outputted!

    + + +

    Creators: Tydium

    + + +
    + +
    +
    + + + + + diff --git a/_site/other/developer-guide/index.html b/_site/other/developer-guide/index.html new file mode 100644 index 0000000..366e618 --- /dev/null +++ b/_site/other/developer-guide/index.html @@ -0,0 +1,493 @@ + + + + + + + + GeyserMC Wiki: Developer Guide + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    +
    +
    +
    +
    + +
    +
    +
    + + +

    Compiling

    +
      +
    1. Clone the repo to your computer (EG: git clone https://github.com/GeyserMC/Geyser.git)
    2. +
    3. Install Maven
    4. +
    5. Navigate to the Geyser root directory and run git submodule update --init --recursive. This downloads all the needed submodules for Geyser and is a crucial step in this process.
    6. +
    7. Run mvn clean install and locate to the bootstrap, then your desired Geyser version, then target folder.
    8. +
    + +

    Project layout

    +
      +
    • bootstrap is where we hold the specific platform code. So if you’re porting Geyser to a new platform, or working with platform-specific code, you likely want to be in here.
    • +
    • core is where connections are handled and the data conversion is done. The majority of Geyser work is held here.
    • +
    + +

    Compiler Tools

    + +

    Lombok

    + +

    Note that the latest version of IntelliJ IDEA does not require additional setup in order to develop with Geyser.

    + +

    If you’re using an IDE for editing any of the GeyserMC projects you will most likely need to install the Project Lombok plugin as it is used to generate a bunch of handy functions. You can edit without it but you may get missing functions and or other issues displayed in your IDE. Please see the IDE section on their site for the supported plugins and install methods https://projectlombok.org/setup/overview.

    + +

    Protocol Information

    + +

    GopherTunnel

    +

    GopherTunnel is a library for Bedrock Edition written in Go. The source code is an excellent documentation for the Bedrock protocol.

    + +

    wiki.vg

    +

    For a full rundown of the Java Edition protocol, see here.

    + +

    wiki.vg (Bedrock)

    +

    The Bedrock Edition protocol is documented here, but it’s currently incomplete so only use it as a reference.

    + +

    Programs

    + +

    debuginfo-be

    +

    debuginfo-be is a Spigot plugin that displays an overlay to Geyser clients with useful debug information, similar to the F3 screen in Java Edition.

    + +

    pakkit

    +

    pakkit is a GUI-based tool for intercepting packets between a server and client developed by Geyser contributor circuit10/Heath123 built using Electron. It works for both Java Edition (using node-minecraft-protocol) and Bedrock (as a GUI wrapper for ProxyPass adding extra features). It supports features such as viewing packet data in JSON format, Edit and Resend and a hex view for raw packet data. You can download it from here. It’s currently WIP, so expect bugs.

    + +

    Gadget

    +

    Gadget is a fabric client mod to inspect & log, amongst other things, packets sent between a java server and a java client. It can be useful to determine java behavior. +You can download it from here.

    + +

    ProxyPass

    +

    ProxyPass is a tool for intercepting packets between a Bedrock server and client developed by the Cloudburst team. It can be found here and the vanilla Bedrock server can be found here.

    + +

    MCC Toolchest

    +

    MCC Toolchest is a tool for viewing and editing NBT data for Bedrock edition, this allows you to see data as it is stored in Bedrock. You can download it from here.

    + +

    NBTExplorer

    +

    NBTExplorer is a tool for viewing and editing NBT data for Java edition, this allows you to see data as it is stored in Java edition. You can download it from here.

    + +

    Windows 10 Multi-Version Launcher

    +

    The Windows 10 Multi-Version launcher allows you to switch between release and beta versions of Minecraft Bedrock. Its GitHub repository can be viewed here. +Alternatively, use FoxyNoTail’s Version Switcher, found here. +Note: To apply the loopback fix for Minecraft Preview, use the following loopback restriction lifting command with the different app ID: CheckNetIsolation LoopbackExempt -a -n="Microsoft.MinecraftWindowsBeta_8wekyb3d8bbwe"

    + + +
    + +
    +
    + + + + + diff --git a/_site/other/discord-bot-usage/index.html b/_site/other/discord-bot-usage/index.html new file mode 100644 index 0000000..adbc094 --- /dev/null +++ b/_site/other/discord-bot-usage/index.html @@ -0,0 +1,481 @@ + + + + + + + + GeyserMC Wiki: Discord Bot Usage + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    +
    +
    +
    +
    + +
    +
    +
    + + +

    Our discord bot provides some very useful toos to debug/issue track your server. We will go in-depth on how to use the bot commands and its tools.

    + +

    Server Logs

    + +

    If you are having console errors or Geyser isn’t functioning/starting up, server logs are very useful to find the root cause of why Geyser is not running. You can safely share your server logs with mclogs as it will remove all IP addresses and other sensitive information from the logs.

    + +

    If you paste the logs URL into our Discord, our bot will analyze the error and will give a fix if there is one present like seen below. You can also paste the latest.log file into Discord.

    + +

    Example of an error

    + +

    OCR

    + +

    OCR or Optical Character Recognition is something that our discord bot can process, which means if you upload a picture/image into our discord that contains an error like seen below the bot might be able to help you out with our issue.

    + +

    Example of an error

    + +

    Ping Server

    + +

    If you are not sure if your server is reachable from the outside you can use our ping tool. Using the ping command in #bot-spam; /ping “serverip” as seen below, The bot will check if your server is online/reachable. When you are not running your server on default port: java 25565 and bedrock 19132 you will need to specify the port like /ping “serverip:serverport”.

    + +

    If the bot returns Unable to find Java/Bedrock server at the requested address, your server either is not running/setup properly or your firewall is blocking the connection. More info on how to setup Geyser can be found on the Geyser Setup page.

    + +

    Example of the ping command

    + +

    Provider List

    + +

    Some hosting providers have unique setup methods for Geyser. If you do not know how to setup Geyser on your provider you can either checkout the Geyser Host Provider List manually, or use our bot command /provider "providername" as seen below.

    + +

    Example of the provider command

    + +

    Download Command

    + +

    Sends the download link of the chosen program/plugin. /download "Geyser" or /download "ViaVersion" and so on.

    + +

    Leaderboard Command

    + +

    Provides a link to the Geyser Bot XP leaderboards.

    + +

    Rank Command

    + +

    You can give yourself two types of roles on our discord, “GeyserNews” and “Testers”. You can use the command /rank "chosen rank" to give one to yourself.

    + +

    Queue Command

    + +

    Displays Current global api skin queue upload times.

    + + + +
    + +
    +
    + + + + + diff --git a/_site/other/geyserconnect/index.html b/_site/other/geyserconnect/index.html new file mode 100644 index 0000000..02b2e78 --- /dev/null +++ b/_site/other/geyserconnect/index.html @@ -0,0 +1,453 @@ + + + + + + + + GeyserMC Wiki: GeyserConnect + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    +
    +
    +
    +
    + +
    +
    +
    + + +

    GeyserConnect is a extension for Geyser that allows you to join multiple servers using a single GeyserMC proxy.

    + +

    Setup

    +

    (For GeyserConnect to work you need an open UDP port, by default it’s 19132.)

    +
      +
    1. Download the latest Geyser build from the downloads page
    2. +
    3. Download the latest build from Github Actions
    4. +
    5. Extract the downloaded ZIP file, and put the extracted JAR file into the extensions folder in your GeyserMC standalone installation.
    6. +
    7. Start Geyser standalone as you do with a normal Geyser install. EG: java -Xms1024M -jar Geyser.jar (More info on Creating a Startup Script)
    8. +
    9. Shutdown the standalone Geyser instance, and make you’re desired changes to the GeyserConnect configuration in GeyserConnect in the extensions folder.
    10. +
    11. Connect to it to make sure its all working.
    12. +
    + +

    DNS

    +

    There are DNS (using bind9) configs in the repo if you would like to use them.

    + +

    Config

    +

    See here.

    + + +
    + +
    +
    + + + + + diff --git a/_site/other/geyseroptionalpack/index.html b/_site/other/geyseroptionalpack/index.html new file mode 100644 index 0000000..c175a6e --- /dev/null +++ b/_site/other/geyseroptionalpack/index.html @@ -0,0 +1,453 @@ + + + + + + + + GeyserMC Wiki: GeyserOptionalPack + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    +
    +
    +
    +
    + +
    +
    +
    + + +

    Download here

    + +

    GeyserOptionalPack is a Bedrock resource pack that adds more features to Geyser to bring Bedrock Edition in line with Java Edition. A resource pack allows various features and bug fixes to be implemented in Bedrock, including:

    + +
      +
    • Armor stand poses and arm/baseplate visibility
    • +
    • Illusioner texture
    • +
    • Missing particles, like sweep attack
    • +
    • Spectral arrow entity texture
    • +
    + +

    A more complete list can be found on the optional pack’s README. Implementation details for those interested in how features are added can be found here.

    + +

    While recommended, it is not required to install the resource pack on the server - clients can install it themselves. Additionally, if you use a proxy like WaterdogPE, you can install the pack on the server without impacting gameplay on other Bedrock servers.

    + +

    Resource pack conflicts

    + +

    If your current server resource pack contains any entity definitions that overlap with the optional pack, you will need to merge the definitions for these entities for the optional pack and your own pack to work correctly. Otherwise, the prevailing entity definition will be based on pack application order. This process is best performed manually due to the complexity of entity definition files, though it can also be scripted.

    + + +
    + +
    +
    + + + + + diff --git a/_site/other/hurricane/index.html b/_site/other/hurricane/index.html new file mode 100644 index 0000000..4d4a29d --- /dev/null +++ b/_site/other/hurricane/index.html @@ -0,0 +1,464 @@ + + + + + + + + GeyserMC Wiki: Hurricane + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    +
    +
    +
    +
    + +
    +
    +
    + + +

    Hurricane

    + +

    Hurricane is a Paper/Spigot plugin, and Fabric mod (unofficial port), that fixes some bugs that otherwise cannot be fixed without server modification.

    + +

    Fixes

    +

    Issues with each workaround are listed in the plugin’s config. Please take your time to read them as the workarounds in this plugin can be used for exploitative purposes.

    + +
      +
    • Bamboo and dripstone collision (by setting them to no server-side collision)
    • +
    • https://github.com/GeyserMC/Geyser/issues/638 by implementing the control server-side.
    • +
    + +

    Supported Versions:

    +
      +
    • 1.14.x - 1.20.x
    • +
    • 1.17.x & above for pig riding
    • +
    + +

    Download

    + + +

    Source

    + + + +
    + +
    +
    + + + + + diff --git a/_site/other/index.html b/_site/other/index.html new file mode 100644 index 0000000..d635672 --- /dev/null +++ b/_site/other/index.html @@ -0,0 +1,431 @@ + + + + + + + + GeyserMC Wiki: Other + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    +
    +
    +
    +
    + +
    +
    +
    + + +

    Other

    + + +
    + +
    +
    + + + + + diff --git a/_site/other/test-server/index.html b/_site/other/test-server/index.html new file mode 100644 index 0000000..00246bf --- /dev/null +++ b/_site/other/test-server/index.html @@ -0,0 +1,480 @@ + + + + + + + + GeyserMC Wiki: Test Server + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    +
    +
    +
    +
    + +
    +
    +
    + + +

    Details

    +
      +
    • IP: test.geysermc.org (default ports on both Bedrock and Java)
    • +
    • World size: 20k x 20k
    • +
    + +

    Infomation

    +

    Geyser has a test server for those who want to test how Java <-> Bedrock crossplay works on their device, and to see the limitations and restrictions. You can join from either Bedrock or Java, and the server has Floodgate installed so you don’t need a Java account to join from Bedrock.

    + +

    If you can’t build/destroy/interact with the world in the test server, run /rtp to get away from the protected spawn area.

    + +

    If you have any questions or problems be sure to join our Discord!

    + +

    Commands:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    CommandDesc
    /rtpTeleport to a random location
    /llLandLord base command for managing land claims
    /spawnTeleport to spawn
    /homeSet/go-to a home
    /linkaccountLink your Java and Bedrock accounts
    + + +
    + +
    +
    + + + + + diff --git a/safari-pinned-tab.svg b/_site/safari-pinned-tab.svg similarity index 100% rename from safari-pinned-tab.svg rename to _site/safari-pinned-tab.svg diff --git a/_site/search/index.html b/_site/search/index.html new file mode 100644 index 0000000..be42b3a --- /dev/null +++ b/_site/search/index.html @@ -0,0 +1,956 @@ + + + + + + + + GeyserMC Wiki: Search + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    +
    +
    +
    +
    + +
    +
    +
    + + + + +
    + +

    Loading results

    + +
      + + + + + + +
      + +
      +
      + + + + + diff --git a/babel.config.js b/babel.config.js new file mode 100644 index 0000000..e00595d --- /dev/null +++ b/babel.config.js @@ -0,0 +1,3 @@ +module.exports = { + presets: [require.resolve('@docusaurus/core/lib/babel/preset')], +}; diff --git a/css/style.css b/css/style.css index 4e3f1b9..9acf72e 100644 --- a/css/style.css +++ b/css/style.css @@ -92,3 +92,7 @@ main img { width: 1.5em; height: 1.5em; } + +table { + margin-bottom: 1rem; +} diff --git a/debug.log b/debug.log new file mode 100644 index 0000000..7c8d383 --- /dev/null +++ b/debug.log @@ -0,0 +1 @@ +# Logfile created on 2022-02-20 17:51:46 -0600 by logger.rb/v1.4.3 diff --git a/_docs/floodgate/api.md b/docs/floodgate/api.md similarity index 71% rename from _docs/floodgate/api.md rename to docs/floodgate/api.md index f33754d..0fbc465 100644 --- a/_docs/floodgate/api.md +++ b/docs/floodgate/api.md @@ -4,7 +4,7 @@ title: Floodgate API ### Floodgate has an API to extend what is possible and allow servers to get information about the Bedrock client. It also allows other plugins access to [Cumulus](/geyser/forms/) -This page will contain information about class FloodgateApi.
      +This page will contain information about class FloodgateApi. See the sidebar for more information about other parts of the API. ### Accessing the Floodgate API @@ -13,37 +13,39 @@ See [here](/geyser/getting-started-with-the-api) for how to include the Floodgat The Floodgate API has changed in Floodgate 2.0. The most important change is that the API methods are no longer static and instead instance-based, as shown below. --- -The class FloodgateApi is the base class of the API and you need to use it to access any part of the API.
      +The class FloodgateApi is the base class of the API and you need to use it to access any part of the API. To access it, you simply type: ```java FloodgateApi.getInstance(); ``` -After you got the instance, you have access to all the methods.
      +After you got the instance, you have access to all the methods. Use the documentation in the API module to see (and get info about) every single method available. Most [API methods have a simple explanation](https://github.com/GeyserMC/Floodgate/tree/master/api/src/main/java/org/geysermc/floodgate/api). - +:::note + +To see full, detailed documentation, see the [javadocs](https://repo.opencollab.dev/javadoc/maven-snapshots/org/geysermc/floodgate/api/2.2.2-SNAPSHOT). + +::: #### We'll highlight a few to get you started quickly: -`FloodgateApi#isFloodgatePlayer(UUID)`
      +`FloodgateApi#isFloodgatePlayer(UUID)` Used to check if the given UUID of an **online** player is a Bedrock player. -`FloodgateApi#getPlayer(UUID)`
      -Used to get the FloodgatePlayer instance of an **online** player.
      +`FloodgateApi#getPlayer(UUID)` +Used to get the FloodgatePlayer instance of an **online** player. Click [here](/floodgate/player/) to get more information about the FloodgatePlayer class. -**Note**: You don't need to wait until the Bedrock player is online to use the getPlayer and isFloodgatePlayer methods.
      +**Note**: You don't need to wait until the Bedrock player is online to use the getPlayer and isFloodgatePlayer methods. You can even use them in the pre-login events. -`FloodgateApi#getPlayerLink()`
      -Used to get the PlayerLink instance used by Floodgate to check for linked accounts.
      +`FloodgateApi#getPlayerLink()` +Used to get the PlayerLink instance used by Floodgate to check for linked accounts. Click [here](/floodgate/linking/) to get more information about the PlayerLink class -`FloodgateApi#sendForm(UUID, Form(Builder))`
      -Used to send a form to the Bedrock player with the given UUID.
      +`FloodgateApi#sendForm(UUID, Form(Builder))` +Used to send a form to the Bedrock player with the given UUID. Click [here](/geyser/forms/) to get more information about Forms. ### Using the API on backend servers diff --git a/_docs/floodgate/commands.md b/docs/floodgate/commands.md similarity index 100% rename from _docs/floodgate/commands.md rename to docs/floodgate/commands.md diff --git a/_docs/floodgate/faq.md b/docs/floodgate/faq.md similarity index 100% rename from _docs/floodgate/faq.md rename to docs/floodgate/faq.md diff --git a/_docs/floodgate/features.md b/docs/floodgate/features.md similarity index 93% rename from _docs/floodgate/features.md rename to docs/floodgate/features.md index f0e3f21..7309b9c 100644 --- a/_docs/floodgate/features.md +++ b/docs/floodgate/features.md @@ -20,4 +20,4 @@ Skin uploading is also a part of the [Global Api](/geyser/global-api). It is res We're using MineSkin internally. MineSkin is running on accounts donated by the community. So if you want to support MineSkin and make the upload times faster, feel free to look at [this page](https://mineskin.org/account) for more info. -![Example skin upload]({{ '/img/wiki/skin_upload_example.png' | relative_url }}) +![Example skin upload](/img/wiki/skin_upload_example.png) diff --git a/_docs/floodgate/issues.md b/docs/floodgate/issues.md similarity index 100% rename from _docs/floodgate/issues.md rename to docs/floodgate/issues.md diff --git a/_docs/floodgate/linking.md b/docs/floodgate/linking.md similarity index 99% rename from _docs/floodgate/linking.md rename to docs/floodgate/linking.md index d59a447..6d08133 100644 --- a/_docs/floodgate/linking.md +++ b/docs/floodgate/linking.md @@ -3,9 +3,10 @@ title: Linking --- ## What is Global Linking? + Instructions and information about how to link can also be found here: [https://link.geysermc.org/](https://link.geysermc.org/) -Before we introduced Global Linking, you always had to link your Java and Bedrock account on every individual server you visited (that has Floodgate). Global Linking is here to fix that problem. Link once, join everywhere.
      +Before we introduced Global Linking, you always had to link your Java and Bedrock account on every individual server you visited (that has Floodgate). Global Linking is here to fix that problem. Link once, join everywhere. Keep in mind: While having your accounts linked, you will use the Java account's location, inventory data, and achievements etc. regardless of which platform you sign in from (therefore, "synchronising" the player data). The player data from the Bedrock account will not be accessible until you unlink again. As a result, you should transfer everything (ender chest contents, items, armor) to the Java account before linking to not "lose" your Bedrock progress. If you forgot to do this, you can unlink, transfer everything over, and link again. diff --git a/_docs/floodgate/player.md b/docs/floodgate/player.md similarity index 93% rename from _docs/floodgate/player.md rename to docs/floodgate/player.md index e6bbb12..7be730c 100644 --- a/_docs/floodgate/player.md +++ b/docs/floodgate/player.md @@ -2,7 +2,7 @@ title: FloodgatePlayer --- -FloodgatePlayer is something that every player who's connect through Floodgate has.
      +FloodgatePlayer is something that every player who's connect through Floodgate has. It contains information about the Bedrock client which can be useful in various situations. You can get a FloodgatePlayer by using the `FloodgateApi#getPlayer(uuid)` method (where uuid is the unique id of the connected player) diff --git a/_docs/floodgate/root.md b/docs/floodgate/root.md similarity index 100% rename from _docs/floodgate/root.md rename to docs/floodgate/root.md diff --git a/docs/floodgate/setup.md b/docs/floodgate/setup.md new file mode 100644 index 0000000..ebee66d --- /dev/null +++ b/docs/floodgate/setup.md @@ -0,0 +1,82 @@ +--- +title: Floodgate Setup +page_sidebar: false +--- + +# Floodgate Setup + + + +[//]: # () +[//]: # () + +[//]: # () +[//]: # (
      ) + +[//]: # (
      ) + +[//]: # ( {% capture my_include %}{% include setup/instructions/floodgate/spigot.md %}{% endcapture %}) + +[//]: # ( {{ my_include | markdownify }}) + +[//]: # (
      ) + +[//]: # (
      ) + +[//]: # ( {% capture my_include %}{% include setup/instructions/floodgate/fabric.md %}{% endcapture %}) + +[//]: # ( {{ my_include | markdownify }}) + +[//]: # (
      ) + +[//]: # (
      ) + +[//]: # ( {% capture my_include %}{% include setup/instructions/floodgate/proxy.md %}{% endcapture %}) + +[//]: # ( {{ my_include | markdownify }}) + +[//]: # (
      ) + +[//]: # (
      ) + +[//]: # ( {% capture my_include %}{% include setup/instructions/floodgate/standalone.md %}{% endcapture %}) + +[//]: # ( {{ my_include | markdownify }}) + +[//]: # (
      ) + +[//]: # (
      ) + +

      Further information:

      + diff --git a/docs/geyser/anticheat-compatibility.md b/docs/geyser/anticheat-compatibility.md new file mode 100644 index 0000000..4ff7273 --- /dev/null +++ b/docs/geyser/anticheat-compatibility.md @@ -0,0 +1,41 @@ +--- +title: Anticheat Compatibility +--- + +:::caution + +The AntiCheats listed below have been categorized based on their compatibility with Geyser. +This is a community-compiled list and does not indicate any endorsement from GeyserMC. Use them at your own risk! + +::: + +### AntiCheat compatibility reports + +Full Compatibility (Checks Bedrock Players Accurately) + +- [AntiAura](https://www.spigotmc.org/resources/1368/) (Paid) - Last Updated on 19th August 2021 +- [Themis](https://www.spigotmc.org/resources/90766/) - Last Updated on 15th Jun 2022 +- [Negativity V2](https://www.spigotmc.org/resources/86874/) (Paid) - Last Updated on 21st March 2022 +- [SoaromaSAC](https://www.spigotmc.org/resources/87702/) - Last Updated on 27th March 2022 +- [Spartan: Bedrock Edition](https://builtbybit.com/resources/12832/) (Paid) - Last Updated on 22nd May 2023 + +Partially Compatible (Does not Check/Ignores Bedrock Players) + +- [AAC](https://www.spigotmc.org/resources/6442/) (Paid) - Last Updated on 19th August 2021 +- [Flappy Anticheat](https://www.spigotmc.org/resources/92180/) - Last Updated on 14th September 2021 +- [GrimAC](https://github.com/MWHunter/Grim) - Last Updated on 24th March 2022 +- [Intave](https://intave.ac) (Paid) Requires [GeyserMC addon](https://github.com/intave/bedrock) - Last Updated on 24th October 2022 +- [Matrix](https://matrix.rip/) (Paid) - Last updated on 2nd September 2021 +- [Spartan: Java Edition](https://www.spigotmc.org/resources/25638/) (Paid) - Last Updated on 22nd May 2023 +- [Vulcan](https://www.spigotmc.org/resources/83626/) (Paid) - Last Updated on 19th August 2021 +- [Verus](https://verus.ac) (Paid) - Last Updated on 13th July 2022 + +Incompatible (False Positives on Bedrock Players, no Compatibility at All) + +- [AntiCheatReloaded](https://www.spigotmc.org/resources/23799/) - Last Updated on 19th August 2021 +- [Negativity V1](https://www.spigotmc.org/resources/48399/) - Last Updated on 21st March 2022 +- [NoCheatPlus](https://ci.codemc.io/job/Updated-NoCheatPlus/job/Updated-NoCheatPlus/) ([Compat NCP](https://github.com/Updated-NoCheatPlus/CompatNoCheatPlus/) is an addon that enables Partial Compatibility) - Last Updated on 19th August 2021 +- [GodsEye](https://www.spigotmc.org/resources/69595/) ([GodsEyeGeyserMC](https://github.com/TheDejavu/GodsEyeGeyserMC/releases) is an addon that enables Partial Compatibility) (Paid) - Last Updated on 21st March 2022 +- [Kauri](https://www.spigotmc.org/resources/53721/) (Paid) - Last Updated on 21st March 2022 +- [Reflex](https://www.spigotmc.org/resources/21122/) (Paid) - Last Updated on 19th August 2021 +- [Wraith](https://www.spigotmc.org/resources/66887/) (Paid) - Last Updated on 19th August 2021 diff --git a/_docs/geyser/api.md b/docs/geyser/api.md similarity index 93% rename from _docs/geyser/api.md rename to docs/geyser/api.md index 95ce5d9..21ab342 100644 --- a/_docs/geyser/api.md +++ b/docs/geyser/api.md @@ -19,7 +19,7 @@ The Geyser API offers events to subscribe to, or information on whether a player (soon, blocks and entities too). It can be used easily in Geyser Extensions, see [here](/geyser/extensions) for details on those. -**Quick overview:**
      +**Quick overview:** @@ -28,36 +28,36 @@ It can be used easily in Geyser Extensions, see [here](/geyser/extensions) for d The GeyserApi interface serves as a central access point to various functionalities provided by the Geyser API, providing methods to e.g. interact with player connections. It extends the [Base API](https://github.com/GeyserMC/api/blob/master/base/src/main/java/org/geysermc/api/GeyserApiBase.java) interface, which provides basic information about individual players. -The class GeyserApi is the base class of the API and you need to use it to access any part of the API.
      +The class GeyserApi is the base class of the API and you need to use it to access any part of the API. To access it, you simply type: ```java GeyserApi.api(); ``` -After you got the instance, you have access to all the methods.
      +After you got the instance, you have access to all the methods. Use the documentation in the API module to see (and get info about) every single method available. Most [API methods have a simple explanation](https://github.com/GeyserMC/Geyser/blob/master/api/src/main/java/org/geysermc/geyser/api/GeyserApi.java). Since the Geyser API extends the Base API that is shared across Floodgate and Geyser, you can also use the [methods from the Base API](https://github.com/GeyserMC/api/blob/master/base/src/main/java/org/geysermc/api/GeyserApiBase.java). #### We'll highlight a few to get you started quickly: -`GeyserApi#isBedrockPlayer(UUID)`
      +`GeyserApi#isBedrockPlayer(UUID)` Used to check if the given UUID of an **online** player is a Bedrock player. -`GeyserApi#connectionByUuid(UUID)`
      -Used to get the [Connection](https://github.com/GeyserMC/api/blob/master/base/src/main/java/org/geysermc/api/connection/Connection.java) of an **online** player.
      +`GeyserApi#connectionByUuid(UUID)` +Used to get the [Connection](https://github.com/GeyserMC/api/blob/master/base/src/main/java/org/geysermc/api/connection/Connection.java) of an **online** player. This method will return null if the player is not a Bedrock player. -`GeyserApi#sendForm(UUID, Form(Builder))`
      -Used to send a form to the Bedrock player with the given UUID.
      +`GeyserApi#sendForm(UUID, Form(Builder))` +Used to send a form to the Bedrock player with the given UUID. Click [here](/geyser/forms/) to get more information about Forms. -`GeyserApi#onlineConnectionsCount()`
      +`GeyserApi#onlineConnectionsCount()` Used to get the amount of online Bedrock players. ### Short Overview of the Geyser API diff --git a/docs/geyser/commands.md b/docs/geyser/commands.md new file mode 100644 index 0000000..a2fcd17 --- /dev/null +++ b/docs/geyser/commands.md @@ -0,0 +1,51 @@ +--- + +# Commands and Permissions + +Geyser features many built-in commands that can be used by players or server owners. + + + +## Geyser commands & their permissions
      +::: + +## Geyser commands & their permissions + +| Command | Permission | Description | +| :--- | :--- | :--- | +| `geyser help`
      `geyser ?` | `geyser.command.help` | Shows help for all registered commands. | +| `geyser help` `geyser ?` | `geyser.command.help` | Shows help for all registered commands. | +| `geyser advancements` | `geyser.command.advancements` | Open the Java advancements menu. | +| `geyser dump` | `geyser.command.dump` | Dumps Geyser debug information for bug reports. | +| `geyser list` | `geyser.command.list` | List all players connected through Geyser. | +| `geyser offhand` | `geyser.command.offhand` | Puts an item in your offhand. | +| `geyser reload` | `geyser.command.reload` | Reloads the Geyser configurations. Kicks all players when used! | +| `geyser settings` | `geyser.command.settings` | Opens a settings menu allowing you to modify aspects of the world. | +| `geyser shutdown`
      `geyser stop` | `geyser.command.shutdown` | Shuts down Geyser.
      *This command only works on Standalone.* | +| `geyser shutdown` `geyser stop` | `geyser.command.shutdown` | Shuts down Geyser. *This command only works on Standalone.* | +| `geyser statistics` | `geyser.command.statistics` | Open the Java statistics menu. | +| `geyser version` | `geyser.command.version` | Shows the current Geyser version and checks for updates. | +| `geyser tooltips` | `geyser.command.tooltips`| Toggle showing Advanced Tooltips (F3 + H on Java) | + +
      +## Other Permissions
      +## Other Permissions + +Besides commands, there are other permissions that are used to guard specific Geyser features. + +| Permission | Description | +| `geyser.settings.server` | Allow players to use the [game settings menu](/img/wiki/game_menu.png). (Also requires player to have op.) | +|---|---| +| `geyser.settings.server` | Allow players to use the [game settings menu](/static/img/wiki/game_menu.png). (Also requires player to have op.) | + +
      +## Floodgate commands and permissions
      +## Floodgate commands and permissions + +For Floodgate commands, see [here](/floodgate/commands/). diff --git a/_docs/geyser/common-issues.md b/docs/geyser/common-issues.md similarity index 97% rename from _docs/geyser/common-issues.md rename to docs/geyser/common-issues.md index a8f9994..9962571 100644 --- a/_docs/geyser/common-issues.md +++ b/docs/geyser/common-issues.md @@ -64,7 +64,7 @@ This message can occur with a Floodgate setup. Usually, it means that a misconfi If you have your configuration set up like this, put simply, it won't work. If authentication for the Java server is set to online, it is expected Geyser is configured the same way. The server requires a valid Minecraft: Java Edition account, and if you aren't logging into one with Geyser, then you will be unable to join the server. If your configuration is set up properly and you're still getting this issue, it could be that your credentials are invalid. -### Connection Refused: +### Connection Refused: \ Connection Refused usually means that a Java server could not be found on that port, or the server denied access to the connection on a network level. The latter can happen with anti-DDOS plugins such as TCPShield, but otherwise ensure that the server you're trying to connect to is spelled correctly in the config, is up and is port forwarded correctly. @@ -83,7 +83,7 @@ This is unfortunately something we have no control over, and is most likely the # "Invalid IP address!" from Bedrock This can happen if the domain you are entering resolves to a SRV record, which Bedrock does not support. Try using the IPv4 address instead. -Additionally, this can happen when trying to specify both the ip and port in the ip tab - in which case, see [here]({{ '/img/wiki/edit_server_form.png' | relative_url }}) for how to properly connect to "test.geysermc.org:19132". +Additionally, this can happen when trying to specify both the ip and port in the ip tab - in which case, see [here](/img/wiki/edit_server_form.png) for how to properly connect to "test.geysermc.org:19132". # Bedrock clients freeze when opening up commands for the first time Disable `command-suggestions` in your Geyser config. This will stop the freezing at the expense of removing command suggestions from Bedrock clients. diff --git a/_docs/geyser/creating-a-startup-script.md b/docs/geyser/creating-a-startup-script.md similarity index 100% rename from _docs/geyser/creating-a-startup-script.md rename to docs/geyser/creating-a-startup-script.md diff --git a/_docs/geyser/current-limitations.md b/docs/geyser/current-limitations.md similarity index 100% rename from _docs/geyser/current-limitations.md rename to docs/geyser/current-limitations.md diff --git a/_docs/geyser/custom-blocks.md b/docs/geyser/custom-blocks.md similarity index 100% rename from _docs/geyser/custom-blocks.md rename to docs/geyser/custom-blocks.md diff --git a/_docs/geyser/custom-items.md b/docs/geyser/custom-items.md similarity index 100% rename from _docs/geyser/custom-items.md rename to docs/geyser/custom-items.md diff --git a/_docs/geyser/custom-skulls.md b/docs/geyser/custom-skulls.md similarity index 100% rename from _docs/geyser/custom-skulls.md rename to docs/geyser/custom-skulls.md diff --git a/_docs/geyser/events.md b/docs/geyser/events.md similarity index 100% rename from _docs/geyser/events.md rename to docs/geyser/events.md diff --git a/_docs/geyser/extensions.md b/docs/geyser/extensions.md similarity index 99% rename from _docs/geyser/extensions.md rename to docs/geyser/extensions.md index 56ed2f0..aa94ce2 100644 --- a/_docs/geyser/extensions.md +++ b/docs/geyser/extensions.md @@ -47,7 +47,7 @@ Explanations for the individual fields: ### Creating the main class The main class, the entrypoint for the extension, needs to [implement the 'Extension' interface provided by Geyser](https://github.com/GeyserMC/GeyserExampleExtension/blob/master/src/main/java/org/geyser/extension/exampleid/ExampleExtension.java#L12). -That way, Geyser recognizes the extension, and gives you access to important methods - such as 'logger()', to get your extensions logger.
      +That way, Geyser recognizes the extension, and gives you access to important methods - such as 'logger()', to get your extensions logger. To see all the methods provided by that interface, see [here](https://github.com/GeyserMC/Geyser/blob/master/api/src/main/java/org/geysermc/geyser/api/extension/Extension.java). Unlike plugins, extensions do not have a 'onEnable' or 'onDisable' method. Instead, most actions are done in events at different stages during Geyser's lifecycle using events. diff --git a/docs/geyser/faq.md b/docs/geyser/faq.md new file mode 100644 index 0000000..49f4a08 --- /dev/null +++ b/docs/geyser/faq.md @@ -0,0 +1,46 @@ +--- +title: FAQ +--- + +[//]: # () +[//]: # ({% for section in site.data.faq %}) + +[//]: # (

      {{ section.title }}

      ) + +[//]: # ( {% if section.desc != nil %}

      {{ section.desc | markdownify }}

      {% endif %}) + +[//]: # (
      ) + +[//]: # ( {% for question in section.items %}) + +[//]: # ( {% assign id = question.title | slugify %}) + +[//]: # (
      ) + +[//]: # (

      ) + +[//]: # ( ) + +[//]: # (

      ) + +[//]: # (
      ) + +[//]: # (
      ) + +[//]: # ( {{ question.content | markdownify }}) + +[//]: # (
      ) + +[//]: # (
      ) + +[//]: # (
      ) + +[//]: # ( {% endfor %}) + +[//]: # (
      ) + +[//]: # ({% endfor %}) diff --git a/_docs/geyser/fixing-unable-to-connect-to-world.md b/docs/geyser/fixing-unable-to-connect-to-world.md similarity index 100% rename from _docs/geyser/fixing-unable-to-connect-to-world.md rename to docs/geyser/fixing-unable-to-connect-to-world.md diff --git a/_docs/geyser/forms.md b/docs/geyser/forms.md similarity index 91% rename from _docs/geyser/forms.md rename to docs/geyser/forms.md index eea3afc..62ba37b 100644 --- a/_docs/geyser/forms.md +++ b/docs/geyser/forms.md @@ -4,8 +4,8 @@ title: Forms and Cumulus # What is Cumulus? -Bedrock Edition has a cool exclusive feature called Forms.
      -Cumulus is the Forms API that we use in Geyser and Floodgate.
      +Bedrock Edition has a cool exclusive feature called Forms. +Cumulus is the Forms API that we use in Geyser and Floodgate. The source code is available [here](https://github.com/GeyserMC/Cumulus). You can access the Cumulus API through the [Floodgate API](/floodgate/api/), or the [Geyser API](/geyser/api). Bedrock knows three types of Forms: @@ -13,13 +13,13 @@ Bedrock knows three types of Forms: * SimpleForm * CustomForm -We'll discuss them one by one starting with the easiest and ending with the least easy form type.
      -After that, you get an overview of every single component.
      -Then we'll talk about sending the form, receiving a response and doing advanced stuff.
      +We'll discuss them one by one starting with the easiest and ending with the least easy form type. +After that, you get an overview of every single component. +Then we'll talk about sending the form, receiving a response and doing advanced stuff. ## ModalForm -While this is the easiest form type it's also the least customisable.
      +While this is the easiest form type it's also the least customisable. You have a title, description (content) and two buttons. ![Example of a ModalForm](https://i.imgur.com/kMpMgOh.png) @@ -36,7 +36,7 @@ ModalForm.builder() ## SimpleForm -While this one is less easy than ModalForm is, it also has more customizability.
      +While this one is less easy than ModalForm is, it also has more customizability. It's still limited to a title, content and buttons, but these buttons can also have images and do not have a minimum and maximum of two. ![Example of a SimpleForm](https://i.imgur.com/3rj2OQ2.png) @@ -53,8 +53,8 @@ SimpleForm.builder() ## CustomForm -While the CustomForm is the last one on our list (and thus the least easy one), it also has the greatest customizability.
      -This form exists of a title, content and a list of different components e.g. label, slider and input.
      +While the CustomForm is the last one on our list (and thus the least easy one), it also has the greatest customizability. +This form exists of a title, content and a list of different components e.g. label, slider and input. See [Components](https://github.com/GeyserMC/Cumulus/tree/master/src/main/java/org/geysermc/cumulus/component) for more information about every component you can use and in which form type. ![Example of a CustomForm](https://i.imgur.com/zHgxELm.png) @@ -72,7 +72,7 @@ CustomForm.builder() ## Sending a form -After you decided which form type you want to use and finished filling in the actual content, it's time to send the Form to the Bedrock player.
      +After you decided which form type you want to use and finished filling in the actual content, it's time to send the Form to the Bedrock player. You can do that by calling the API and send a form to the player's UUID and the form: ```java FloodgateApi.getInstance().sendForm(uuid, form); // or #sendForm(uuid, formBuilder) @@ -95,8 +95,8 @@ player.sendForm( ## Receiving a response from the client -It's nice and all that we can send forms to a client, but we also want to be able to get a response from a client and being able to handle them.
      -We can do that using one (or multiple) result handers. The most used result handlers are: `validResultHandler(BiConsumer | Consumer)`, `invalidResultHandler`, `closedResultHandler` and `closedOrInvalidResultHandler`.
      +It's nice and all that we can send forms to a client, but we also want to be able to get a response from a client and being able to handle them. +We can do that using one (or multiple) result handers. The most used result handlers are: `validResultHandler(BiConsumer | Consumer)`, `invalidResultHandler`, `closedResultHandler` and `closedOrInvalidResultHandler`. Here follows an example that uses result handlers: ```java CustomForm.builder() @@ -110,7 +110,7 @@ CustomForm.builder() ## Advanced stuff -The FormBuilder also has support for translating the data used in the builder.
      +The FormBuilder also has support for translating the data used in the builder. To add a translator, you can use the `translator(BiFunction)` or the `translator(BiFunction, String)` method: ```java ModalForm form = ModalForm.builder() diff --git a/_docs/geyser/getting-started-with-the-api.md b/docs/geyser/getting-started-with-the-api.md similarity index 100% rename from _docs/geyser/getting-started-with-the-api.md rename to docs/geyser/getting-started-with-the-api.md diff --git a/_docs/geyser/geyser-command-line-arguments-and-system-properties.md b/docs/geyser/geyser-command-line-arguments-and-system-properties.md similarity index 98% rename from _docs/geyser/geyser-command-line-arguments-and-system-properties.md rename to docs/geyser/geyser-command-line-arguments-and-system-properties.md index 1b18a9b..391135d 100644 --- a/_docs/geyser/geyser-command-line-arguments-and-system-properties.md +++ b/docs/geyser/geyser-command-line-arguments-and-system-properties.md @@ -7,7 +7,7 @@ Geyser offers a few command line arguments/system properties to allow you to con Additionally, you can suppress some warnings that may be printed to the console. ### Configuration system properties -You can set Geyser to automatically bind to a specific address and port by using the following command line arguments.
      +You can set Geyser to automatically bind to a specific address and port by using the following command line arguments. This is primarily aimed at server hosting providers to automatically configure servers for users.