Skip to content

UltraCosmetics/UltraCosmetics-gui-addon

Repository files navigation

Logo

Version Discord View on SpigotMC Downloads

UltraCosmetics GUI Addon

UltraCosmetics GUI Addon is an addon for UltraCosmetics that customizes the main and purchase menus with custom textures. Thanks to @dennishzg for creating the resource pack!

  • Aseprite source files are in /aseprite/.
  • Resource pack and GUI textures are in /resourcepack/.
  • Plugin files are in /src/.

🖼️ Preview

Main menu

Main menu

Buy menu (keys, cosmetics etc.)

Buy menu

🛠️ How to use

Add server resource pack

By default, once the plugin is installed, it will suggest to clients to install the resource pack. Alternatively, you can disable that in the config and distribute the resource pack yourself; it can be downloaded in the Releases tab.

Create menu

If you have a custom menu for UC, you can also use these textures there. Example menu using DeluxeMenus:

GUI texture

  • 🏠 = Main menu texture
  • 🪙 = Buy menu texture
size: 54
menu_title: "&f🎲🎲🎲🎲🎲🎲🎲🎲🏠"

Custom items

Example:

/minecraft:give @p minecraft:brick[minecraft:item_model="ucgui:uc_items/key"]
Image Item model Description
invisible ucgui:guis/invisibleitem Invisible items are necessary to make the buttons/icons in the GUI clickable.
Key ucgui:uc_items/key Treasure chest key

✅ Compatibility

UltraCosmetics GUI Addon officially supports both Spigot and Paper.

The resource pack is designed for clients 1.21.4 and up.

📥 Download

You can download the latest stable release of UltraCosmetics GUI Addon from our official links:

🐛 Report a Bug

Please use the Issues on GitHub to report a bug.

When creating an issue, please make sure you're using the bug report issue template!

❓ Support

For questions and support please visit our Discord. The Issues page of this repository is exclusively for bug reports and feature requests.

💻 Development

CI Status CodeQL Status

📄 License

GNU Affero General Public License v3.0

UltraCosmetics - Lightweight, Fun and Easy-to-Use Spigot Cosmetics plugin.
Copyright (C) 2025 Datatags

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.