Skip to main content

Introduction

Geyser supports sending Bedrock edition resource packs to connecting Bedrock clients. However, Geyser does not convert resource packs from the Java Edition format into the Bedrock edition format.

Resource packs offer a range of customization options. Just like on Java, they can be used for a wide variety of things:

  • Texture Modifications: Resource packs can change the look of blocks, items, and entities, providing a unique visual experience.
  • Sound Changes: Custom sound effects or music tracks can be added to create a more immersive atmosphere.
  • UI Enhancements: Resource packs can modify the user interface - a popular example would be providing a dark mode UI option. ... and much more!

Using resource packs

Sending local packs

The easiest way to send resource packs to Bedrock players is by putting the Bedrock edition resource pack, either as a .zip or .mcpack file, into Geyser's packs folder.

Location of the 'packs' folder:

  • Fabric/NeoForge: /config/Geyser-<platform>/packs/
  • Geyser Standalone: /packs/ at the root directory
  • Other platforms: /plugins/Geyser-<platform>/packs/

After restarting the server (or reloading Geyser), players that connect will receive all packs that are in that folder.

Remote pack urls (accessible using the Geyser API)

As an alternative to sending local packs, you can also send resource packs by sending Bedrock players a link to download the packs from. This works similarly to Java edition's pack downloading. However, there are a few key limitations:

  • The link must be a direct link to the resource pack download (it will follow redirects, but those must result in a file download)
  • The Content-Length header must specify the exact file size.
  • The Content-Type application header must be set to application/zip.

Geyser will download your configured remote resource packs once on boot, and warn you if any of these conditions are not met. It is unfortunately not possible to bypass these, as these are restrictions imposed by the Bedrock client.

To verify headers manually, curl the website and check the values. For example: curl -I -L https://download.geysermc.org/v2/projects/geyseroptionalpack/versions/1.0.10/builds/11/downloads/geyseroptionalpack returns the following:

  • -I: This option tells curl to fetch the HTTP response headers in the output.
  • -L: Ensures that curl follows redirects

The output for this shows the following:

HTTP/1.1 200 OK
Date: Wed, 03 Jul 2024 23:03:06 GMT
Content-Type: application/zip
Content-Length: 95400
Connection: keep-alive
access-control-allow-methods: GET
access-control-allow-origin: *
Cache-Control: public, s-maxage=1209600
content-disposition: attachment; filename="=?UTF-8?Q?GeyserOptionalPack.mcpack?="; filename*=UTF-8''GeyserOptionalPack.mcpack
etag: "0258409cde3a2906e1085490fa5b10b77"
last-modified: Wed, 03 Jul 2024 08:42:41 GMT
CF-Cache-Status: HIT
Age: 21500
Accept-Ranges: bytes
Report-To: {"endpoints":[{"url":"https:\/\/a.nel.cloudflare.com\/report\/v4?s=DUpNVi9R96y13%2BlJm%2BNTpDLvSt9bw9CFDUh8Qwhpb9SsqjJbuInBGtSM5hiM2dGbSGkUccP4KvSqqD%2FCKrrcQ9ur5at5G0u8FrfooVTKLP%2B4MwGoUl29DwlxeMVg6tX36RjjICmV97M4FlErCZEe%2F3gM%2FA%3D%3D"}],"group":"cf-nel","max_age":604800}
NEL: {"success_fraction":0,"report_to":"cf-nel","max_age":604800}
Server: cloudflare
CF-RAY: 89da81ca69c63735-FRA
alt-svc: h3=":443"; ma=86400

This shows that the content-length is indeed set correctly, and that the content type indeed is application/zip. Further, Geyser will attempt to read the ETag to see if the content has changed. To query that, you can use the following:

curl -I -L -v https://download.geysermc.org/v2/projects/geyseroptionalpack/versions/1.0.10/builds/11/downloads/geyseroptionalpack 2>&1 | grep ETag Alternatively, just using the -v header will turn on verbose mode that would also display the etag.

Common questions

  • Does Geyser support behavior packs/add-ons?
    No. These would require modifications on the Java server side, which isn't possible when Geyser is used on a proxy. However, many things that are possible with add-ons or behavior packs can be done with Geyser's API - such as custom items or custom blocks.

  • Does Geyser convert Java edition resource packs?
    Not currently. For now, you need to manually create a Bedrock edition resource pack equivalent.

  • Can I allow players to choose resource packs themselves?
    On most Bedrock platforms (except consoles), players are able to download and install resource packs on the client. There is also a Geyser extension, PickPack that uses the Geyser API to allow all Bedrock players to choose from a set of resource packs.

  • On proxy setups: Are per-backend-server resource packs possible?
    This unfortunately is not possible natively, as Bedrock edition only allows removing and adding packs when connecting initially to the server. However, with the usage of the transfer packet, it is possible to instruct the Bedrock client to re-connect to the server, and to apply changes then. For per-server-packs, you can use the unofficial GeyserPackSync plugin.

  • Does Geyser have an API to send resource packs?
    Yes! See the Geyser API docs for more info on that. There is a SessionLoadResourcePacksEvent to determine which packs are sent to each connecting player, or the more general GeyserDefineResourcePacksEvent that defines the packs all users receive.

  • Can I use subpacks or specify the load order of resource packs?
    You can! However, this feature requires you to use the Geyser API.