mirror of
https://github.com/chylex/Minecraft-Window-Title.git
synced 2024-10-17 01:42:46 +02:00
72 lines
3.2 KiB
Markdown
72 lines
3.2 KiB
Markdown
# For Users
|
|
|
|
## Installation
|
|
|
|
The mod supports [NeoForge](https://neoforged.net/) and [Fabric](https://fabricmc.net/) (*) mod loaders. Follow either mod loader's installation guide, then download the mod file for your Minecraft version from [CurseForge](https://www.curseforge.com/minecraft/mc-mods/custom-window-title/files) or [Modrinth](https://modrinth.com/mod/custom-window-title/versions), and install it into the `.minecraft/mods` folder.
|
|
|
|
(*) Fabric API is **not** required.
|
|
|
|
## Configuration
|
|
|
|
Run the game once to create the configuration file. By default, the window title will be set to **Minecraft _<version>_**. Unlike in vanilla 1.15.2 onwards, the title will not change when you enter a world/server.
|
|
|
|
To change the title or icon, navigate to the `.minecraft/config` folder, and open `customwindowtitle-client.toml` in a text editor. You will see the following entries:
|
|
|
|
```toml
|
|
title = 'Minecraft {mcversion}'
|
|
icon16 = ''
|
|
icon32 = ''
|
|
```
|
|
|
|
Only edit text inside quotes or apostrophes.
|
|
|
|
### Changing the Title
|
|
|
|
You can use the following special tokens in the _title_ configuration entry:
|
|
|
|
* `{mcversion}` - current Minecraft version
|
|
* `{modversion:<mod_id>}` - version of installed mod with the identifier `<mod_id>`
|
|
* `{username}` - current username
|
|
|
|
If any of the tokens aren't working, search the game log for **CustomWindowTitle** and you should see the reason, otherwise please file an issue on the [issue tracker](https://github.com/chylex/Minecraft-Window-Title/issues) with as many details as possible.
|
|
|
|
### Changing the Icon
|
|
|
|
**This feature is currently not supported in Minecraft 1.20+.**
|
|
|
|
You must create two PNG images with sizes 16x16 and 32x32 pixels. The images **must be saved with transparency** even if they don't use it, **otherwise the icons will appear corrupted**. In Krita for example, you must check _Store alpha channel (transparency)_ when saving the image.
|
|
|
|
The _icon16_ and _icon32_ configuration entries point to the PNG files relative to the `.minecraft/config` folder. For example, if you place the two icons in a folder named _customwindowtitle_ as follows:
|
|
|
|
* `.minecraft/config/customwindowtitle-client.toml`
|
|
* `.minecraft/config/customwindowtitle/icon16.png`
|
|
* `.minecraft/config/customwindowtitle/icon32.png`
|
|
|
|
Then, the two icon entries should look like this:
|
|
|
|
```toml
|
|
icon16 = 'customwindowtitle/icon16.png'
|
|
icon32 = 'customwindowtitle/icon32.png'
|
|
```
|
|
|
|
## Screenshots
|
|
|
|
These screenshots were taken using the following example configuration:
|
|
|
|
```toml
|
|
title = "Minecraft {mcversion} - Custom Window Title {modversion:customwindowtitle}"
|
|
```
|
|
|
|
![](https://github.com/chylex/Minecraft-Window-Title/blob/master/.github/README/screenshot.png)
|
|
|
|
# For Developers
|
|
|
|
The mod sources are organized into 3 projects:
|
|
- `src/` contains common source files and mixins
|
|
- `Fabric/src/` contains source files specific for Fabric
|
|
- `NeoForge/src/` contains source files specific for NeoForge
|
|
|
|
The `assemble` Gradle task creates a single `.jar` file for both mod loaders in the `build/dist` folder.
|
|
|
|
When building against a Minecraft version that is only supported by one mod loader, open `gradle.properties` and comment or remove either `neoForgeVersion` or `fabricVersion` to disable them.
|