VOOZH about

URL: https://minecraft.wiki/w/Minecraft_Wiki:Hey_Wiki

⇱ Minecraft Wiki:Hey Wiki – Minecraft Wiki


Minecraft Wiki:Hey Wiki

From Minecraft Wiki
Jump to navigation Jump to search
Shortcut
The contents of this page are not supported by Mojang Studios.
 
This mod is exclusive to Java Edition.
 
Hey Wiki
Author(s) Minecraft Wiki

Main contributors

Platform(s)
Written in Java
Latest version 1.9.0
Release date June 1, 2024
Size ~228 KiB
License LGPL-3.0
Source available Yes (GitHub)
{
 "title": "Hey Wiki",
 "rows": [
 {
 "field": "(link to MCW:About article, displayed as Minecraft Wiki)\n\n'''Main contributors'''\n* <span class=\"plainlinks\">[https://minecraft.wiki/w/User:Dianliang233 Dianliang233]</span>",
 "label": "Author(s)"
 },
 {
 "field": "\n* [https://fabricmc.net/ Fabric]\n* [https://neoforged.net/ NeoForge]",
 "label": "Platform(s)"
 },
 {
 "field": "(link to wikipedia:Java (programming language) article, displayed as Java)",
 "label": "Written in"
 },
 {
 "field": "1.9.0",
 "label": "Latest version"
 },
 {
 "field": "June 1, 2024",
 "label": "Release date"
 },
 {
 "field": "~228 KiB",
 "label": "Size"
 },
 {
 "field": "[https://www.gnu.org/licenses/lgpl-3.0.en.html LGPL-3.0]",
 "label": "License"
 },
 {
 "field": "Yes ([https://github.com/mc-wiki/minecraft-mod-heywiki GitHub])",
 "label": "<span style=\"white-space:normal\">Source available</span>"
 }
 ],
 "invimages": [],
 "images": [
 "Hey Wiki logo.png"
 ]
}

Hey Wiki is a client mod for Java Edition made by the Minecraft Wiki community. It allows players to quickly open the wiki page of the block, item, or entity that the camera is aimed at, whether it is from the vanilla game or another mod.

Download on Modrinth Download on CurseForge

Features

[edit source]
  • Press (customizable) to open the wiki (Minecraft Wiki or the respective mod wiki) page of the block/item/entity the crosshair/pointer is over.
  • Press β€―+β€― or β€―+β€― to open the wiki page of the item in the main hand.
  • Press to open the wiki search screen. The search bar can be used to search for wiki pages.
  • Adds several commands.
  • Link to a wiki page in chat using [[wiki link]] syntax.

How to use

[edit source]
  1. Install the mod from GitHub or Modrinth. Don't forget to also install the dependencies!
  2. Point at a block/entity with your crosshair or hover over an item in your inventory with your cursor.
  3. Press the keybind (default is ).
  4. Either confirm the action or copy the link to your clipboard in the screen that pops up.

It is also supported to use MCBrowser and MCEF for in-game browsing.

Optionally, the following behaviors in the config menu can be changed:

Mod Menu or Menulogue must be installed to access the config menu on Fabric.
  • If confirmation is required to open the wiki page: default is true
  • Preferred wiki language, default is the current game language unless overridden
  • Toggle between Simplified and Traditional Chinese, default is the current game language unless overridden
  • The keybind to open a wiki page, default is
  • Reach distance, default is 5.2 blocks (same as creative mode reach)
  • Whether fluid blocks can be targeted, default is false

Commands

[edit source]

These commands are available:

  • /imfeelinglucky [<namespace>] – Opens a random Minecraft Wiki page in the designated namespace.
  • /wiki <pageName> – Opens the Minecraft Wiki page of the specified page name.
  • /whatbiome – Opens the Minecraft Wiki page of the biome the player is currently in.
  • /whatstructure – Opens the Minecraft Wiki page of the structure the player is currently in.
  • /whatcommand <command> – Opens the Minecraft Wiki page of the specified command.
  • /whatisthis – Opens the Minecraft Wiki page of the block/item/entity that the player is aiming at.
  • /whatisthisitem – Opens the Minecraft Wiki page of the item being held in the main hand.
    • /whatisthisitem offhand – Same, but for the offhand.

Opening a page with a command does not cause the confirmation screen to appear.

Wiki links in chat

[edit source]

Hey Wiki supports [[wiki links]] in chat. When a message is sent with [[wiki link]] syntax, it will automatically be replaced with a clickable link.

Interwiki links and other namespaces are supported. For example:

  • [[aether:The Aether]] will link to the Aether Wiki page of "The Aether" (interwiki)
  • [[en:enderman]] will link to the English Minecraft Wiki page of "enderman" (interlanguage)
  • [[minecraft:en:enderman]] will link to the English Minecraft Wiki page of "enderman" (interwiki and interlanguage)

Supported wikis

[edit source]

The latest version of Hey Wiki supports the following wikis:

Resource packs can be used to add support for other wikis. An issue can be filed in case a wiki should be added to the default list.

Hey Wiki provides several ways mod, mod pack, data pack, and custom server developers can leverage to support their creation.

Resource pack

[edit source]
This API is stable since v1.6.0.

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:

  • [NBT Compound / JSON Object] The root tag
    • [NBT List / JSON Array] namespace: Namespaces bound to the wiki family.
    • [NBT List / JSON Array] wikis: List of different language wikis.
      • [NBT Compound / JSON Object]: The root tag
        • [String] article_url: The URL pattern for articles. to an article. %s will be replaced with the query.
        • [String] mw_api_url: (Optional) URL to the MediaWiki API, if it exists.
        • [String] search_url: (Optional) The URL pattern for searching. %s will be replaced with the query.
        • [String] random_article: (Optional) The name of the random article page.
        • [String] excerpt: (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.
        • [String] search_provider: (Optional) Which provider to use for autocompleted search. Either mediawiki or algolia.
        • [NBT Compound / JSON Object] algolia: (Optional) Required if Algolia is used as search provider.
          • [String] api_url: URL to the API of Algolia instance.
          • [String] index_name: Name of the Algolia search index.
          • [String] api_key: An Algolia API key. You MUST give the API key read-only permission with (optional) rate limit. Please see Algolia documentation for detail.
          • [String] app_id: Algolia application ID.
        • [NBT Compound / JSON Object] language: Information on the language of the wiki.
          • [String] wiki_language: The language code of the wiki.
          • [Boolean] main: Whether this is the main language. If true, this language will be fallback if no other language matches.
          • [String] default: The default in-game language that the wiki supports. This will be fallback if the in-game language is not supported by the wiki.
          • [String] regex: A regular expression. If the regex matches the in-game language, this wiki will be used when config is auto
          • [String] exclude: (Optional) A regular expression. Ditto, but for exclusion.
          • [String] lang_override: (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.

You also want to include a translation file in assets/<namespace>/lang/ folder with the following format:

assets/example/lang/en_us.json
{
// Assuming the definition is located at `assets/example/wiki_family/minecraft.json`
"wiki_family.example.minecraft":"Minecraft Wiki"
}

Custom item via data component or NBT

[edit source]
This API is an experimental feature and might change at any time.

Data pack and custom server authors can use heywiki:identifier, heywiki:translation_key and heywiki:fallback_title in custom_data data component to provide custom namespace and name for an item. However, this only accounts for custom items. For 1.20.4, you can populate these fields directly in NBT.

You need to use the method above to register a new wiki with a custom namespace using resource pack. If it is not feasible to ask your players to download a resource pack, we can also ship it with the mod itself.

  • [NBT Compound / JSON Object] components: Parent tag.
    • [NBT Compound / JSON Object] minecraft:custom_data
      • [String] heywiki:identifier A custom identifier for the item. It should be in the format of <namespace>:<id>.
      • [String] heywiki:fallback_title (Optional) A custom fallback title for the item. If this is missing, the path (id) of the identifier is used instead.
      • [String] heywiki:translation_key (Optional) A custom translation key for the item. If this is missing or the translation key is not defined, the fallback title is used instead.
  • [NBT Compound / JSON Object] tag: Parent tag.
    • [String] heywiki:identifier A custom identifier for the item. It should be in the format of <namespace>:<id>.
    • [String] heywiki:translation_key A custom translation key for the item.

For example, on "niceserver", to have a bone item to resolve to the "Drill" page, you will first need to register the "niceserver" namespace per above. Then you can give the player this item:

/give@sminecraft:bone[minecraft:custom_data={"heywiki:identifier": "niceserver:drill", "heywiki:fallback_title": "Drill", "heywiki:translation_key": "item.niceserver.drill"}]
/give@sminecraft:bone{"heywiki:identifier": "niceserver:drill", "heywiki:translation_key": "item.niceserver.drill"}

Dependencies

[edit source]

For Fabric:

For NeoForge:

Versioning

[edit source]

Hey Wiki

[edit source]

Hey Wiki uses Semantic Versioning in the format <major>.<minor>.<patch>[-<prerelease>]. The version number is incremented based on the following rules:

  • Major: Incremented when breaking changes are made to stable, public API.
  • Minor: Incremented when new features to stable, public API are added in a backwards-compatible manner.
  • Patch: Incremented when bug fixes are made.

Changelogs for Hey Wiki can be seen at MCW:Hey Wiki/Releases.

Minecraft

[edit source]

Hey Wiki supports multiple versions of Minecraft.

Every Minecraft version is assigned a support status:

  • Active: This version receives new features and bug fixes. Features will be backported as much as reasonably possible.
  • Maintenance: This version receives only bug fixes and security patches. Features are generally not backported.
  • End of Life (EOL): No further updates should be expected.

The current Minecraft release and the master branches are always Active. Pull requests should almost always go to master. If they're accepted, they should be cherry-picked to other Active branches.

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.

Old Minecraft versions are provided with Long Term Support (LTS) based on their popularity and the community's interest. LTS versions receive Active support at first. After some time, they will be downgraded to Maintenance. Old snapshots are not supported.

The following table shows which versions are supported:

Git branch Minecraft version Support LTS Modloader
master 26.1.2 Active (latest release) ? Fabric, Neoforge
mc/1.21.11 1.21.11 Maintenance (LTS) Yes Fabric, Neoforge
mc/1.21.8 1.21.8 EOL No Fabric, Neoforge
mc/1.21.4 1.21.4 EOL No Fabric, Neoforge
mc/1.21.3 1.21.2, 1.21.3 EOL No Fabric, Neoforge
mc/1.21.1 1.21, 1.21.1 Maintenance (LTS) Yes Fabric, Neoforge
mc/1.20.6 1.20.6 EOL No Fabric, Neoforge
mc/1.20.5 1.20.5 EOL No Fabric, Neoforge
mc/1.20.4 1.20.4 Maintenance (LTS) Yes Fabric, Neoforge
N/A Outdated snapshots EOL No Fabric

Language support

[edit source]

Hey Wiki is available in multiple languages.

It is translated by the community on Crowdin. It currently supports the following languages:

  • German - Germany (de_de)
  • English - US (en_us)
  • Spanish - Spain (es_es)
  • Persian - Iran (fa_ir)
  • Finnish - Finland (fi_fi)
  • French - France (fr_fr)
  • Hebrew - Israel (he_il)
  • Italian - Italy (it_it)
  • Japanese - Japan (ja_jp)
  • Korean - South Korea (ko_kr)
  • Classical Chinese (lzh)
  • Dutch - Netherlands (nl_nl)
  • Portuguese - Brazil (pt_br)
  • Portuguese - Portugal (pt_pt)
  • Russian - Russia (ru_ru)
  • Thai - Thailand (th_th)
  • Ukrainian - Ukraine (uk_ua)
  • Chinese Simplified - Chinese Mainland (zh_cn)
  • Chinese Traditional - Hong Kong (zh_hk)
  • Chinese Traditional - Taiwan (zh_tw)

Navigation

[edit source]
Retrieved from "https://minecraft.wiki/w/Minecraft_Wiki:Hey_Wiki?oldid=3615588"

Navigation menu