Skip to main content
The Patreon Cosmetics addon lets players who have supported Dimensions on Patreon enjoy exclusive visual effects whenever they ignite, destroy, or step through a portal. Once a player links their Minecraft account to their Patreon account through the Dimensions website, their effects activate automatically on any server running this addon — no per-server configuration required for players.

How It Works for Players

Players link their Minecraft and Patreon accounts on the Dimensions website. After the link is confirmed, the addon detects their UUID at runtime and applies their chosen cosmetic effects. There is nothing else a player needs to do.

Configuration for Server Owners

As a server owner, you are not required to configure anything for the addon to work for your players. However, as a thank-you for supporting the plugin, you can apply cosmetic effects to your own account by adding the following block to your config.yml:
CosmeticsAddon:
    PlayerUUID: <your uuid>
    IgnitePortal: <cosmetic>
    DestroyPortal: <cosmetic>
    UsePortal: <cosmetic>
    PortalTick: <cosmetic>
Replace <your uuid> with your Minecraft player UUID and each <cosmetic> with one of the effect names listed below.

Available Cosmetic Effects

The table below lists every available effect and the portal events it supports. Use these names as the values in config.yml.
EffectSupported Events
NOTHINGDisables effects entirely
FINAL_SPARKuse, destroy, ignite
FILLING_THE_VOIDtick, use, destroy, ignite
HEART_SEEKERtick, use, destroy, ignite
HUNGRY_HOUNDStick, use, destroy, ignite
GLOWING_AURAtick
ANGRY_LLAMAtick
EXPLOSIONSdestroy, use
LIL_RINGtick

Event Descriptions

The event keywords in the table above correspond directly to the config keys:
  • use — triggers when a player teleports through the portal; set via UsePortal
  • ignite — triggers when a player lights the portal; set via IgnitePortal
  • destroy — triggers when a portal frame is broken; set via DestroyPortal
  • tick — triggers continuously while the portal is active; set via PortalTick
Only assign an effect to a config key if that effect lists the matching event in the table above. For example, GLOWING_AURA only supports tick, so placing it under IgnitePortal has no effect.