# TMwU pack

This resource pack is designed to customize the appearance of inventory-based menus.
It does NOT create custom menus or provide any functionality by itself.

# IMPORTANT

For the best experience, it is highly recommended to use this template together with plugins, mods, or datapacks that support custom inventory menus (GUI systems).

This resource pack only changes the visual appearance of menus.

The included template is intended to make creating custom menu textures as simple as possible while remaining easy to integrate into existing projects.

==================================================
FEATURES
========

• Easy-to-use template for custom inventory menu textures.
• Supports both 27-slot and 54-slot container menus.
• Simple Unicode-based texture registration.
• Fully customizable textures.
• Compatible with Minecraft 1.21.4 and newer.

==================================================
PREVIEWING MENU TEXTURES
========================

27-Slot Chest

Run the following command in chat:

/give @p minecraft:chest[minecraft:custom_name={"text":"\uE200\uE201","color":"white","italic":false}]

This gives you a chest using the default 27-slot menu texture.

---

54-Slot Double Chest

Run the following command in chat:

/give @p minecraft:chest[minecraft:custom_name={"text":"\uE100\uE000","color":"white","italic":false}] 2

Place two chests next to each other so they combine into a double chest.

==================================================
ADDING YOUR OWN MENU TEXTURES
=============================

1. Create your texture inside:

minecraft/textures/tmwu/menu

2. Give the texture an English file name.

Recommendations:

* Use only letters and numbers.
* Do not use spaces.
* Avoid underscores whenever possible.

3. Open the following file:

minecraft/font/default.json

You can edit it with any code editor.
Visual Studio Code (VSCode) is recommended.

==================================================
BASIC EXAMPLE
=============

{
"providers": [
{
"type": "space",
"advances": {
"\uE100": -48
}
},
{
"type": "bitmap",
"file": "minecraft:tmwu/menu/template.png",
"ascent": 46,
"height": 256,
"chars": [
"\uE000"
]
}
]
}

Explanation:

* "advances" controls the horizontal offset.
* "ascent" controls the vertical position.
* "height" controls the rendered size.
* "file" specifies which texture is used.
* "chars" assigns the Unicode character to that texture.

==================================================
CREATING A NEW UNICODE CHARACTER
================================

Copy the bitmap section above.

Change the Unicode value.

Example:

From:
"\uE000"

To:
"\uE523"

# IMPORTANT

Every Unicode value must be unique.
Never reuse a Unicode character that has already been assigned to another texture.

After changing the Unicode value, duplicate the bitmap entry and edit the file path to point to your new texture.

Example:

{
"type": "bitmap",
"file": "minecraft:tmwu/menu/my_menu.png",
"ascent": 46,
"height": 256,
"chars": [
"\uE523"
]
}

==================================================
USING YOUR NEW TEXTURE
======================

If you use the included spacing characters, your command will look like this:

/give @p minecraft:chest[minecraft:custom_name={"text":"\uE100\uE523","color":"white","italic":false}] 2

In this command:

\uE100 = horizontal spacing character.

\uE523 = your custom texture.

==================================================
SUPPORT
=======

If you have questions, find bugs, or need help, please join the template author's Discord server.

Ask your question in the "questions-about-tmwu" channel.

The author will do their best to help whenever possible.

Please avoid repeatedly messaging the author or requesting excessive personal support.
The author also has work and personal responsibilities outside of this project.

==================================================
SUPPORTED MINECRAFT VERSIONS
============================

Minecraft 1.21.4+

==================================================
LICENSE
=======

This project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).

https://creativecommons.org/licenses/by-nc-sa/4.0/

==================================================

Thank you for using this template.

— CryngelDust
