Legendary Tooltips [Neo/Forge]

配置文件包含了如何设置tooltip的说明，你可以根据自己的喜好进行设置，请先阅读配置说明！支持多达十六种自定义边框，每种边框都可以设置为按物品名称、模组、标签、原版稀有度、物品名称颜色、显示名称、tooltip文本或NBT标签应用于物品。默认情况下，该模组包含上述的自定义边框，并且通过资源包可以轻松添加更多。想要查看添加了十个自定义框架的示例资源包，可以看看 “折衷宝库（Eclectic Trove）”！

以下内容仅适用于1.2及更高版本！

如果你有兴趣在自己正在编写的模组中为物品添加自定义边框，通过将 “传奇工具提示（Legendary Tooltips）” 作为依赖项即可实现。（可使用cursemaven.com来完成此操作。）

使用 LegendaryTooltipsConfig.addFrameDefinition() 方法为给定的资源位置 / 框架索引指定选择器列表（如果你不明白这是什么意思，请参阅配置文件文档）。此方法支持度不高，所以如果它不起作用，请尝试使用下面推荐的数据驱动方法。

边框可以通过资源包进行自定义。资源包能够用多达16种自定义边框替换模组中包含的默认边框，供模组使用。有关示例，请参阅 “折衷宝库（Eclectic Trove）”——我建议在设计自己的边框时以此为起点。还有一个模板图像可供使用，以便于绘制，可在 此处找到（这是一个Photoshop项目，所以你需要Photoshop或像Gimp这样能读取Photoshop文件的图像编辑器）。

以下内容仅适用于1.2及更高版本！

从1.2版本起，资源包和模组也可以使用包含在资源包 / 模组本身中的.json文件资源来定义自定义边框。这个文件的加载方式与普通资源不同，因为它们不会相互替换——在所有活动的自定义边框资源文件中找到的所有边框定义都将被加载并应用。这些文件允许你使用 任何 格式正确的图像资源，并可以指定所有要匹配的颜色。描述文件格式的示例文件可以在 此处找到。请先阅读此文件，因为它包含了很多信息。你还可以在 “折衷宝库（Eclectic Trove）” 的 noconfig 变体中找到一个示例，该示例包含许多原版物品的定义，在此处。

The configuration file includes instructions for setting up tooltips however you feel fit, please read the configuration instructions first!  Supports up to sixteen custom borders, each of which can be set to apply to items by name, mod, tag, vanilla rarity, item name color, display name, tooltip text, or NBT tag.  By default, the mod includes the custom border seen above, and more can easily be added with a resource pack.  For an example resource pack that adds ten custom frames, check out Eclectic Trove!

The following only applies to version 1.2 and later!

If you are interested in adding custom borders to items in a mod you are coding, it is possible by adding Legendary Tooltips as a dependency.  (Use cursemaven.com for this.)

Use the LegendaryTooltipsConfig.addFrameDefinition() method to specify a list of selectors for a given ResourceLocation / frame index (see configuration file documentation if you don't understand what this means).  This method is not widely supported, so if it isn't working, please try the preferred data-driven method below instead.

Borders can be customized via resource packs.  The resource pack is capable of replacing the default border included in the mod with up to 16 custom borders that can be used by the mod.  Please see Eclectic Trove for an example--I recommend using this as a starting point when designing your own borders.  There is also a template image available to make drawing easier, which can be found here (this is a Photoshop project, so you will need Photoshop or an image editor that can read Photoshop files like Gimp).

The following only applies to version 1.2 and later!

As of version 1.2, it is also possible for resource packs and mods to define custom borders using a .json file resource included in the pack/mod itself.  This file is loaded differently than normal resources, as they do not replace each other--all border definitions found in all active custom border resource files will be loaded and applied.  These files allow you to use any properly-formatted image resource and can specify all colors to match.  An example file that describes the file format can be found here.  Please read this file first, as it contains a lot of information.  You can also find an example in the noconfig variant of Eclectic Trove, which contains definitions for many vanilla items, here.