Wallpapers

Wallpapers are cosmetics that can be applied to the boxes within the PC's Pokémon Storage System. They can be found via the four-squares icon next to the filter, then the grid icon in the top right of the interface.

By default, players will have access to 11 basic wallpapers, with 5 unlockable wallpapers available for a total of 16 wallpapers.

Wallpapers may also have an alternative style which can be accessed via holding shift whilst viewing the wallpaper selection list in the PC interface.

List of Wallpapers

Name	Image	Alt.	Unlock Requirement(s)
Basic (Red)		N/A	Unlocked by default
Basic (Orange)		N/A	Unlocked by default
Basic (Yellow)		N/A	Unlocked by default
Basic (Green)		N/A	Unlocked by default
Basic (Cyan)		N/A	Unlocked by default
Basic (Blue)		N/A	Unlocked by default
Basic (Purple)		N/A	Unlocked by default
Basic (Pink)		N/A	Unlocked by default
Basic (White)		N/A	Unlocked by default
Basic (Gray)		N/A	Unlocked by default
Basic (Dark Gray)		N/A	Unlocked by default
Cave			Visit a Cave.
Forest			Visit a Forest biome.
The Nether			Visit The Nether.
Ocean			Visit an Ocean biome.
The End			Visit The End.

Custom Wallpapers

Custom wallpapers may be added by players. These custom wallpapers may be added client-side or server-side.

Client-Side

Client-sided wallpapers may be added by placing the texture PNG file in the assets/cobblemon/textures/gui/pc/wallpaper/ directory. The emmissive screen glow is also optionally able to be added, via the assets/cobblemon/textures/gui/pc/wallpaper/*/glow directory, using the same file name as the wallpaper.

An alternative style may also be provided, which can be found in-game the same way as the base Cobblemon wallpapers. These alternative styles must be placed in the assets/cobblemon/textures/gui/pc/wallpaper/*/alt directory, using the same file name as the main wallpaper.

Server-Side

A datapack folder exists called unlockable_pc_box_wallpapers. This contains JSONs of a simplistic format. For example, you could create a JSON file called some_texture.json with the following contents:

{
   "enabled": true,
   "displayName": "Something",
   "texture": "cobblemon:textures/gui/pc/wallpaper/some_texture.png"
}

The purpose of having a datapacked JSON for wallpapers is for when the wallpaper should not be immediately available. Any wallpaper that is in the client's resources but is not in the server's datapack will be available in the GUI immediately and will not be validated against when the client asks to use that wallpaper. But if the wallpaper is in the server's datapack, the client will only see the wallpaper if they have specifically unlocked it.

The enabled field is used when you want to actively prevent a specific texture from being used. For example, if there is a wallpaper supplied by Cobblemon that you want to remove, setting this to false will prevent its use despite existing in the client's resources.

The displayName field is used to provide a name in the toast when the wallpaper is unlocked. It can be a lang key or text. If it is left out or null, the toast will instead insert '???' in place of the name.

For enabled, datapacked wallpapers, the server will build a list of which of these have been unlocked by the player. Unlocking can be done from MoLang scripts using q.player.pc.unlock_wallpaper(id, [shouldNotify]), from /unlockpcboxwallpaper <player> <wallpaper>, and from code unlocks.

For MoLang and command unlocks, references to the wallpaper use the JSON's file ID, not the texture. For example, in the above example, unlocking from the command would be /unlockpcboxwallpaper <player> cobblemon:some_texture.

Similarly, using the MoLang script would be q.player.pc.unlock_wallpaper("cobblemon:some_texture", true). The second parameter is a boolean that determines if the player should be notified of this new texture using a toast.

A datapacked wallpaper results in a validation check when the client asks the service to apply a texture. If the texture is mentioned by a datapacked wallpaper, and the player has not unlocked that ID, the client will be told that it is not a usable wallpaper, and it will not be displayed until it is unlocked.