OpenDisks: Add Custom Disks to OpenComputers via Config

What is OpenDisks?

If you have ever put together a custom Minecraft modpack, you know the pain of bundling a pre-built world just to deliver a few custom loot disks for OpenComputers. OpenDisks wipes away that frustration. It is a lightweight OpenComputers addon designed specifically for modpack creators who want to add new loot disks without shipping an entire world save. With a simple configuration file and a folder of Lua scripts, you can inject fresh, themed disks directly into the game, and players can access them using the standard scrench cycling mechanic.

The Core Purpose of OpenDisks

Simplifying Loot Disk Creation for Modpacks

Traditional OpenComputers loot disks require a world to be generated with the correct loot tables or manual insertion. OpenDisks changes that by hooking into the existing loot disk system and letting you define disks purely through file structure. You drop your Lua files into a designated folder, tweak a tiny configuration file, and the mod handles the rest. This means no more shipping massive world files alongside your modpack, and players can enjoy your custom content immediately upon starting a new game.

Understanding the disk.cfg Configuration

Every custom disk you create needs a disk.cfg file placed inside its directory. The format is straightforward and uses a key-value pair system. All fields are optional, so you can keep things minimal or fine-tune behavior as needed.

Key Configuration Fields

• color: An integer from 0 to 15 that matches Minecraft's dye color scheme. This determines the visual tint of the loot disk item. If omitted, it defaults to 0 (white).
• name: A string that overrides the directory name for the in-game disk label. By default, the disk takes the folder name, but you can set a cleaner display name here.
• isReadOnly: A boolean (true or false) that controls whether the disk can be written to. When set to true (the default), the disk acts like a read-only floppy, preventing accidental overwrites.
• isCraftable: A boolean that decides if the disk appears in the scrench cycling loop. The default is true. Setting this to false hides the disk from the standard cycling mechanic, which is perfect when you want to introduce the disk through custom crafting recipes from other mods.

For example, a simple disk.cfg might look like this:

color=14
name=merpis
isReadOnly=true
isCraftable=true

How Loot Disks and the Scrench Work

The Crafting Grid Cycling Mechanic

OpenComputers uses a clever system: any loot disk combined with a scrench in a crafting grid lets you cycle through all available loot disks. OpenDisks plugs directly into this loop. As long as your disk has isCraftable set to true, players can scroll through the disks you have added just like they would with vanilla OpenComputers loot disks. No chests, no world data required.

Making Disks Non-Craftable for Custom Recipes

When you want to gate a disk behind a specific mod interaction, set isCraftable to false. The disk will not appear in the scrench cycle, so players cannot obtain it that way. Instead, you can use CraftTweaker, ModTweaker, or another recipe modification tool to create a unique crafting recipe that outputs your custom disk. This gives you full control over progression and integration with other mods.

Organizing Your Disk Contents

Directory Structure and In-Game Files

Everything placed inside the disk's root directory becomes part of the in-game disk file system. If you have a path like /mods/opendisks/lua/merp/dir1/somefile.lua, the resulting loot disk will be named "merp" (or whatever the name field specifies) and will contain a directory called dir1 with the file somefile.lua inside it. You can nest folders and add as many scripts as you like, making it easy to bundle entire programs or libraries. While setting up these custom disks, you might find yourself juggling multiple mods and configurations. For a smoother workflow, many players rely on the foxygame.net launcher, a modern and flexible Minecraft launcher that allows you to install mods like OpenDisks directly from its built-in menu, eliminating manual downloads and keeping your OpenComputers addons neatly organized.

Practical Use Cases for Modpack Creators

OpenDisks shines in themed modpacks where you want to deliver custom operating systems, utility scripts, or narrative-driven programs. You can create a disk that holds a bootable OS with a unique color, make it read-only to prevent tampering, and either let players find it through cycling or lock it behind a quest reward. The addon also works perfectly for tutorial disks that guide new players through complex mod interactions without cluttering the world with books or signs.

Conclusion: Unleashing Creativity with OpenDisks

OpenDisks removes the last barrier to distributing rich, custom OpenComputers content inside modpacks. Its no-fuss configuration, seamless integration with the existing loot disk system, and optional craftability toggle give you the flexibility to shape exactly how players discover and use your creations. Whether you are building an adventure map, a tech-heavy progression pack, or just want to share your favorite Lua scripts, this addon makes the process clean and efficient. Dive in, structure your disks, and watch your modpack come alive with personalized computing experiences.