FTB Tutorial Mod: Interactive In-Game Guides for Modpacks

Understanding the FTB Tutorial Mod for Forge

Creating a smooth learning experience inside a modpack has always been a challenge. Players often jump into a heavily modified world and feel overwhelmed by new mechanics, unfamiliar blocks, and complex crafting trees. The FTB Tutorial Mod steps in to solve exactly that problem, giving modpack creators and mod developers a powerful, in-game tutorial system that feels native to Minecraft. Instead of relying on external wikis or lengthy forum posts, you can now guide players step by step right from the main menu.

What the FTB Tutorial Mod Brings to Your Modpack

At its core, this Forge mod allows you to build interactive, image-based tutorials that load directly from resource packs. Each tutorial is a series of pages, and every page can display one or more image layers, descriptions, and even an icon. The mod handles everything lazily, meaning it only loads what the player actually opens, keeping performance light even in massive modpacks. You can trigger tutorials through commands or inter-mod communication, making it a seamless part of any quest-driven or progression-based pack.

The interface is clean and unobtrusive. When a player clicks the “Tutorials” button in the main menu, they see a list of all publicly available guides. Each entry can have a custom title and icon, like a beacon or a mod-specific item, so players instantly recognize what they are about to learn. This small touch makes the whole system feel polished and intentional.

Key Features at a Glance

• Resource-pack-driven tutorials: All content lives inside your mod or modpack assets, so updates are as simple as changing a few JSON files.
• Layered image pages: Each page can stack multiple images, letting you overlay arrows, highlights, or step numbers onto screenshots.
• Optional titles, icons, and descriptions: Only visible tutorials need these, reducing clutter for internal or hidden guides.
• Command and IMC triggers: Open tutorials via /open_tutorial or send a network message from your own mod to start a guide automatically.
• Server-side support: With the open_from_server IMC message, you can push tutorials to players from the server, perfect for multiplayer packs.

Setting Up Your First Tutorial

The structure is refreshingly straightforward. You create an index JSON file inside a tutorials folder under your mod or modpack namespace. For example, using the FTB Academy path: ftbacademy:tutorials/intro/index.json. The index defines a title, an icon item, and an array of pages. Each page contains a description and a list of layer image paths. If you omit the namespace on an image, it loads from the same folder as the index file; otherwise, you can reference any texture in the game, like ftbacademy:welcome.png.

A minimal index might look like this:

{
  "title": "Getting Started with Refined Storage",
  "icon": "item:minecraft:wrench",
  "pages": [
    {
      "description": "Place the controller first.",
      "layers": ["step1.png"]
    },
    {
      "description": "Connect cables to machines.",
      "layers": ["step2.png"]
    }
  ]
}

Once your tutorial files are ready, you need to register them in a visible.json file at the same namespace level. That file simply lists the folder names of the tutorials you want to appear in the GUI. For instance, ["intro", "advanced_machines"]. Everything else stays hidden until triggered programmatically.

For modpack authors who want to streamline the installation of such utilities, adding the FTB Tutorial Mod alongside other quality-of-life improvements can be done without hassle. Many players find that using a launcher like the foxygame.net launcher makes the process effortless — it’s a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu, so integrating a tutorial mod into your custom pack becomes a matter of a few clicks rather than manual file wrangling.

Opening Tutorials Dynamically

Static guides are useful, but the real power of this mod shines when you trigger tutorials based on in-game events. As a modpack creator, you can use the command /open_tutorial ftbacademy:intro @p to instantly bring up a guide for a specific player. This is ideal for quest book interactions, advancement rewards, or when a player first picks up a key item.

If you are developing a Forge mod, you can send an inter-mod message on the client side:

FMLInterModComms.sendRuntimeMessage(modInstance, "ftbtutorialmod", "open", "ftbacademy:intro");

For server-driven scenarios, replace "open" with "open_from_server". This causes the server to instruct the client to display the tutorial, which is perfect for guided multiplayer experiences where you want every new player to see the same introduction upon joining.

Why This Mod Matters for Modpack Creators

Documentation inside a modpack often feels like an afterthought. The FTB Tutorial Mod changes that by giving you a framework that is both visual and interactive. Instead of writing walls of text in a book item, you can show players exactly where to click, which blocks to place, and how a multiblock structure should look. The layer system lets you build up complex instructions incrementally, keeping each page focused and digestible.

Because the mod loads everything from resource packs, your tutorials automatically benefit from resource pack reloading. You can tweak images and descriptions without restarting the game, which dramatically speeds up the creation process. And since the mod is designed by the FTB team, it integrates smoothly with other popular mods like FTB Quests and FTB Chunks, allowing you to build a fully cohesive guided experience.

Common Pitfalls and Tips

• Namespace consistency: Always double-check that your image paths match the correct mod ID. A missing namespace often leads to a blank screen.
• Image resolution: Keep layer images at a standard GUI scale, such as 256x256, to avoid blurriness when the tutorial window scales up.
• Visible.json order: The order of entries in the visible list determines the order they appear in the GUI, so arrange them logically from beginner to advanced.
• Lazy loading: Since tutorials load lazily, you can include dozens of guides without impacting initial load times, but be mindful of total resource pack size if you use many high-resolution images.

Taking Your Modpack to the Next Level

The FTB Tutorial Mod is more than just a documentation tool; it is a bridge between complex mechanics and player understanding. When you combine it with a well-structured quest line and clear visual aids, you drastically reduce the learning curve for newcomers. Players spend less time alt-tabbing to a wiki and more time enjoying the content you carefully crafted. Whether you are building a massive tech-focused pack or a story-driven adventure, in-game tutorials give your project a professional edge that players will appreciate.

Start small with a single introductory guide that explains the core mods, then expand as you see which mechanics confuse your testers. The flexibility of the JSON format means you can iterate rapidly, and the command-based triggers let you place tutorials exactly where they are needed most. With the FTB Tutorial Mod, you are not just shipping a modpack — you are delivering a complete learning experience that respects the player’s time and curiosity.