Click here to view the Chinese version

Overview

This mod displays tooltips on Minecraft loading screens.

Gallery

User Guide

Configuration

You can access the configuration screen via ModMenu.

Position

This category controls where tips appear on the screen.

Option	Effect	Default
Screen Side	Which side to align to — LEFT or RIGHT	LEFT
Bottom Margin (px)	Distance from the bottom of the screen (in pixels)	10
Side Margin (px)	Distance from the selected side (in pixels)	10

The (px) suffix indicates that the values are in pixels, not percentages or grid units.

On the configuration screen, number fields can be adjusted using the increment/decrement buttons, the mouse scroll wheel, or by clicking the field and typing directly with the keyboard.

Visibility

This category controls whether tips are shown on each of the three loading screens.

Option	Corresponding Screen	Default
Level Loading Screen	The screen shown during chunk generation (entering a world or dimension transfer) or downloading (multiplayer)	On
Connect Screen	The screen shown while connecting to a remote server	On
Generic Message Screen	The placeholder screen shown during local loading (a screen that displays a dialog at the center of the viewport)	On

Disabling any of these options will hide tips on the corresponding screen.

Tip Rotation

Option	Effect	Default	Range
Switch Interval	Number of seconds each tip is displayed before switching to the next	8	1–60, step 1

After completing one full rotation (global), the order is randomly reshuffled before the next round begins. Tips do not repeat across multiple page switches.

If you do not see a log entry like parsed tips.json from pack '<your pack name>', it means the resource pack was not recognized — check whether it has been disabled in the Resource Packs screen, and ensure the JSON file has no syntax errors (parse errors are logged as failed to read tips.json from pack '...').

模组概述

本项目提供了在 minecraft 加载页面显示小提示的功能。

图集

用法指导

配置

可以通过 ModMenu 进入 Mod 配置页面。

Position（位置）

该类目控制 tip 在屏幕上的位置。

选项	作用	默认
Screen Side	贴哪一边 —— LEFT（左）或 RIGHT（右）	LEFT
Bottom Margin （px）	距屏幕底部的距离（像素）	10
Side Margin （px）	距所选边的距离（像素）	10

「px」是后缀，提示这是像素单位，不是百分比也不是格子。

在配置页面中，数字控件可以通过点击增减按钮、使用鼠标滚轮或者点击控件以触发键盘输入。

Visibility（可见性）

该类目分别控制三个加载屏是否显示 tip。

选项	对应界面	默认
Level Loading Screen	区块生成（进入存档和维度传送）或下载（多人游戏）时的加载屏	开
Connect Screen	连接远程服务器时的加载屏	开
Generic Message Screen	本地加载的占位屏（在在视口几何中心显示一个 dialog 的屏幕）	开

关掉某个，对应界面就不再显示 tip。

Tip Rotation（轮换）

选项	作用	默认	范围
Switch Interval	每条 tip 显示几秒后切到下一条	8	1 – 60，步进 1

一轮（全局）放完后，会重新随机生成一个轮播顺序再开始下一轮，多页面切换时不会重复。

资源包

让资源包给你的游戏添加自定义小贴士，或者重写/翻译模组自带的文字。

格式

包目录结构:

my-uknow-pack/
├── pack.mcmeta
└── assets/
    ├── mypack/                    ← 任意命名空间，存放 tip 列表
    │   └── tips.json
    └── uknow/                     ← 必须是 "uknow"，多语言文件
        └── lang/
            ├── en_us.json
            └── ja_jp.json

Tip列表

assets/mypack/tips.json（把要显示的 tip id 列在 tips 数组里）:

{
  "tips": [
    "tip_welcome",
    "tip_food",
    "tip_torch",
    "tip_sleep",
    "tip_pickaxe",
    "tip_craft"
  ]
}

多语言

将⌈语言ID⌋.json放在assets/uknow/

示例：assets/uknow/lang/en_us.json:

{
  "uknow.tips.tip_pickaxe": "A wooden pickaxe can mine coal ore.",
  "uknow.tips.tip_craft":   "Craft a furnace to smelt your first ingots."
}

• 多语言键为 uknow.tips.⌈TipID⌋，⌈TipID⌋为assets/mypack/tips.json内的TipID

Q&A

• 只放 tips.json 不放 lang 会怎样？

屏幕会显示裸 id 字符串（比如 tip_pickaxe），而不是漏出 uknow.tips.tip_pickaxe 这种带前缀的 key。也就是说:配置写得不全，不会显示异常文字，只会显示 id 本身。

• Tips只显示"No tips! Check resource."的原因是什么？

当前Tips列表内不存在任何Tips！请按照上述方法补充。

• 如何检查Tips列表是否被加载

装好资源包进入游戏后，看 .minecraft/logs/latest.log:

[uknow] parsed tips.json from pack 'mypack' (+2 new id(s))
[uknow] tip pool loaded: 6 tip(s) from resource packs [tip_welcome, tip_food, tip_torch, tip_sleep, tip_pickaxe, tip_craft]

如果看不到 parsed tips.json from pack '<你的包名>'，说明资源包没被识别 —— 检查是否在 Resource Packs 屏幕里禁用了它，以及 JSON 文件没有语法错误（解析错误会以 failed to read tips.json from pack '...' 行记录在日志里）。