Stuck on a sword upgrade, a song that will not play, a missing structure or a game that crashes during launch? Start with the exact Minecraft version, mod loader and Master Sword file you installed. Then follow the matching fix below instead of changing unrelated settings.
Progression & important items
Where do I get the Goddess Sword?
Find the Temple of Time and use its special sword-bearing shrine with an empty main hand. The shrine gives you the Goddess Sword and then becomes a normal reusable Sword Shrine.
Where do the three Sacred Flames come from?
Farore’s Flame comes from the Farore Maze, Nayru’s Flame comes from the Nayru Shrine, and Din’s Flame drops after defeating the Fire Golem in the Din Arena. Sacred Flame guide →
How do I get a Hookshot?
In the main mod, the Hookshot can appear as a tier-4 Goron merchant trade for one Purple Rupee. Goron stock rotates, so it may take more than one in-game day to appear. Hookshot guide →
How do I get the Fairy Bow?
Place a normal Bow in a Sword Shrine and use a bottled Healing Fairy to empower it. Fairy Bow guide →
How do I get the True Master Sword?
In the End, place a Nether Star in a Sword Shrine and survive the ritual to obtain a Blessed Nether Star. Then place a Golden Master Sword in a Sword Shrine and use the Blessed Nether Star on it. Full ritual guide →
Where do I find Fire Rods, Ice Rods, or Mysterious Scrap?
Fire Rods can appear in Bastion and Nether Fortress treasure. Ice Rods can appear in Igloos, snowy village houses, and Ancient City ice-box chests. Mysterious Scrap can be mined from Kakariko Ore in the Nether and also appears through several loot/drop sources. Acquisition Index →
For the full control list and player commands, see Controls & Commands.
Using the mod
How do I open the Ocarina song menu?
Hold a Fairy Ocarina or Ocarina of Time in your main hand and press O (the reviewed NeoForge default). The menu will not open over another screen such as chat or your inventory. In NeoForge 1.21.1 v2.5.0 and Forge 1.20.1 v2.5.0c, choose a song (not Free Play), hold right-click and enter its six-note melody using your configurable note keys to activate its effect. Ocarina controls, note keys & Free Play →
Do the swords disappear when they run out of durability?
No. The mod’s swords are designed not to vanish when they reach their minimum durability state. Repair the sword before continuing to use it normally.
Why can’t I find a custom structure?
Structures only generate when new chunks are created, must pass their biome and terrain rules, and can also be disabled in server configuration. If you are exploring an old world, travel into terrain that has never been generated before. Check structure biomes and placement →
Does this wiki apply to every Minecraft/mod version?
Some Forge and NeoForge releases use different keys or gameplay settings. Check the release comparison and your in-game controls before following an older tutorial.
Which version do I need for the playable Ocarina?
For Minecraft 1.21.1 / NeoForge, use the 2.5.0 release. For Minecraft 1.20.1 / Forge, the 2.5.0c beta includes the playable notes, radial song menu, Free Play and song HUD. A 2.3.x-era Forge installation can have different controls. If the song wheel doesn't appear, verify your installed JAR, loader and keybinds before troubleshooting the song itself.
Launch crashes and Ocarina input problems
The launcher crashes with “Duplicate key key_key.mastersword.ocarina_song_menu”. What can I do?
This exact Ocarina Song Menu error has been reported; the reason and fix for every released JAR are not yet confirmed by in-game regression testing. It is different from simply having two actions assigned to the same physical key.
- Confirm the Minecraft version, mod loader and the exact Master Sword JAR in your launcher. The release table distinguishes Forge 1.20.1 and NeoForge 1.21.1.
- Close Minecraft and make a backup of that instance's
options.txtbefore making changes. Check whether more than one line beginskey_key.mastersword.ocarina_song_menu:. If there are duplicates, keep one line and remove only the extras, then try launching once. The reviewed source contains a repair for duplicated settings lines, but this is not proof that the reported release crash comes from that cause. - If only one entry exists—or the error continues—stop editing keybind files. Test the same release in a separate, minimal profile with the required dependencies and retain the original
latest.log/ crash report for comparison. Do not delete a saved world to troubleshoot a startup key-registration crash.
Include the error's Caused by section when reporting the problem; see what to include. An updated mod build, not a wiki change, may be required if this is duplicate registration in the JAR itself.
The song wheel does not open, but Minecraft starts normally.
Hold a Fairy Ocarina or Ocarina of Time in your main hand, close chat/inventory, and use the configured Song Menu key (reviewed NeoForge default: O). Forge 1.20.1 2.5.0c beta includes the newer song menu; Forge 2.3.x belongs to the older control system. If the menu still does not open, check Options → Controls → Key Binds and the control checklist.
My Ocarina makes notes but the song does not activate.
Choose an unlocked song rather than Free Play, hold Use, follow the six notes shown by your own HUD and keep holding until the effect completes. Check the song's cooldown, required instrument, player unlock and any server-disabled song ability. Step-by-step Ocarina guide →
Updating & troubleshooting
I updated the mod and something is acting strangely. What should I try first?
Back up the world and the instance's configuration files. Confirm you actually launched the new matching loader/JAR and required dependencies. Compare changed settings before resetting them: the reviewed Forge 1.20.1 source has both a mastersword-common.toml config and a config/mastersword/ JSON directory; the reviewed NeoForge 1.21.1 configuration guide documents individual JSON files. An older release can differ. If a particular config is corrupted, rename and back up only that file, restart in a test profile, then restore any custom settings carefully. Do not delete your world or indiscriminately wipe the entire config directory. Version and launch checks → · Safe config editing →
My Hookshot will not attach to blocks on a server. Why?
The server may have limitHookshotTargets enabled. That option changes Hookshots from normal valid-block targeting to a configurable allowlist. Hookshot target rules →
A song, structure, or item behaves differently from this wiki.
Check your Minecraft/mod version and server configuration first. Older releases and customized servers can differ from the current maintenance baseline. If the difference is real and reproducible, it is worth documenting on the specific page instead of hiding it in the FAQ.
How to report a problem that we can reproduce
Before submitting a report, note the Minecraft version, Forge/NeoForge loader and version, exact Master Sword JAR filename, and whether this occurs in single-player or on a server. Include the shortest steps that trigger it, what you expected, and what happened. For crashes, attach the latest.log or relevant crash report from your instance's logs/crash-reports folder, including the first meaningful Caused by section. Remove private information before sharing logs publicly. Find the official community and corrections contact →
Other reports being investigated: Fairy Sight Night Vision refresh while holding the Fairy Lantern is a source-review concern, not a reproduced bug. If you encounter an expiring effect, include how long it lasted, which hand held the item, your magic level and the exact release. The wiki does not yet claim a confirmed fix.