mc-wiki / minecraft-mod-heywiki

A Minecraft mod that allows you to press H (customizable) to open the Minecraft Wiki page of the block/item/entity you're aiming at.
https://minecraft.wiki/MCW:MOD
GNU Lesser General Public License v3.0
29 stars 5 forks source link


Hey Wiki

CurseForge Modrinth Crowdin

fabric neoforge crowdin

Hey Wiki is a client mod made by the Minecraft Wiki that allows you to press H (customizable) to open the wiki page of the block/item/entity you're aiming at, no matter it's from vanilla or a mod. Hey Wiki supports Fabric and NeoForge.

Features

I didn't know that this mod is kinda like Lexica Botania but it is.

https://github.com/mc-wiki/minecraft-mod-heywiki/assets/45287180/b0650362-1fe9-46ff-83a1-48219d5fcc05

How to use

  1. Install the mod. You can download it from CurseForge or Modrinth. Don't forget to install the dependencies.
  2. Point at a block/entity with your crosshair or hover over an item in your inventory with your pointer.
  3. Press the keybind (default: H).
  4. Either confirm the action or copy the link to your clipboard in the screen that pops up.

Configuration

Optionally, you can change these behaviors in the config menu:

[!TIP] You need to install Mod Menu to access the config menu on Fabric.

Commands

These commands are available:

Note that if you open a page with a command, the confirmation screen will not appear.

[[Wiki links]] in chat

Hey Wiki supports [[wiki links]] in chat. When you send a message with [[wiki link]] syntax, Hey Wiki will replace it with a clickable link. The page name can include a namespace.

This also supports interwiki links. For example:

Supported wikis

Currently, Hey Wiki supports the following wikis:

If you want to add support for other wikis, you can file an issue. In addition, you can also add support for other wikis by using a resource pack.

Resource pack

[!WARNING]
Please note that the JSON schema is not stable and is not semantically versioned yet. We very well might break it in minor versions.

Hey Wiki supports using resource pack to add support for other wikis. To do so, create a JSON file in the assets/<namespace>/wiki_family/ folder in your resource pack with the following format:

{
  // A unique identifier for the wiki family
  "id": "minecraft",
  // The namespaces that is bound to the wiki family
  "namespace": [
    "minecraft"
  ],
  // List of different language wikis
  "wikis": [
    {
      // The URL pattern for articles. %s will be replaced with the query
      "article_url": "https://minecraft.wiki/?search=%s",
      // (Optional) If the wiki is a MediaWiki wiki, the API URL
      "mw_api_url": "https://ja.minecraft.wiki/api.php",
      // (Optional) The page name for the random article
      "random_article": "Special:RandomRootPage/Main",
      // (Optional) How Hey Wiki should fetch excerpts from the wiki. Either "text_extracts" or "none".
      // "text_extracts" only works for MediaWiki sites with the TextExtracts extension installed. You can check this by visiting Special:Version on the wiki.
      "excerpt": "text_extracts",
      "language": {
        // The language code of the wiki
        "wiki_language": "en",
        // Whether this is the main language. If true, this language will be fallback if no other language matches
        "main": true,
        // The default in-game language that the wiki supports. This will be fallback if the in-game language is not supported by the wiki
        "default": "en_us",
        // If the regex matches the in-game language, this wiki will be used when config is auto
        "regex": "^en_.*",
        // (Optional) Ditto, but for exclusion
        "exclude": null,
        // (Optional) A custom language code that allows you to override translation keys to specific pages. A translation file should exist at assets/<namespace>/lang/<lang_override>.json
        "lang_override": "minecraft_en"
      }
    },
    {
      // Another language
      "article_url": "https://de.minecraft.wiki/?search=%s",
      "language": {
        "wiki_language": "de",
        "default": "de_de",
        "regex": "^de_.*",
        "exclude": null
      }
    }
  ]
}

Dependencies

For Fabric:

For NeoForge:

Version support

Hey Wiki supports multiple versions of Minecraft.

The current release and the master branches receive all new features and bug fixes. Pull requests should almost always go to master. If they're accepted, they should be cherry-picked to the current stable release branch.

When a new snapshot releases, master branch is updated to that snapshot. Snapshots might receive only one version or no version at all. Only Fabric is supported for snapshots.

Some select old MC versions receive LTS – they may or may not receive new bug fixes and new features, but they will receive critical bug fixes. Old snapshots are not supported.

The following table shows which versions are supported:

Git branch Minecraft version Supported? Is LTS? Modloader
master 1.21 Yes (latest release) TBD Fabric, Neoforge
mc/1.20.6 1.20.6 No No Fabric, Neoforge
mc/1.20.5 1.20.5 No No Fabric, Neoforge
mc/1.20.4 1.20.4 Yes (LTS) Yes Fabric, Neoforge
N/A Outdated snapshots EOL No Fabric