⚒️ Guide to the CustomOreGen Plugin for Minecraft

On almost any Minecraft server, players seek out ores to craft better gear, earn in-game money, and more. Depending on the type of gameplay, this can be a long or difficult process. For example, Skyblock servers don’t have natural caves for players to collect materials. Solving this particular scenario involves using Spigot plugins, and one of them is CustomOreGen.

Using this on your server allows players to create cobblestone generators but with unique ores or blocks instead of stone. There can be many different versions, as you have the ability to fully customize its settings. Whether you want an overpowered generator that produces diamond blocks or just iron ore, this plugin can do it. We’ve created this tutorial from PixelHost to guide you through the installation and configuration of CustomOreGen on your Minecraft server.

🛠️ Installation

1. Go to CustomOreGen on Spigot and then click the Download button.

2. On the next page, click the plugin’s .jar file and save it somewhere easily accessible.

3. Go to your PixelHost server panel, then click on FTP File Access near the top left.

   Important: Make sure you are using the correct server profile for this installation.

4. Log in with your password and enter the plugins directory.

5. Near the top left, click on "Upload" and drag the .jar file to the appropriate area.

6. Wait for it to reach 100%, then return to the main panel and Restart the server.

7. Join your server and use the command /plugins to confirm if it’s working.

   Note: If "CustomOreGen" appears in green, it has been installed correctly.

   
   

🔧 Getting Started

Before setting up your custom generators, you’ll want to familiarize yourself with their design.

Essentially, having water flow into lava creates a cobblestone block. Setting this up can be done by reviewing our resource here, but there are several designs to try.

Once the water transforms the lava into stone, you might find other blocks if they’re configured in the plugin. This can also happen naturally, depending on your server’s gameplay. We’ll cover a basic generator and how to edit it to your liking in the following sections.

🛠️ Beginner Generator

The first generator most players will see is the Beginner Generator, which only allows stone, iron ore, and sandstone to spawn. This doesn’t require any prior setup or permissions configuration, as it’s enabled by default. However, server operators will automatically have access to the VIP generator, which spawns almost all iron ore. If you want to customize the possible blocks, you’ll need to edit the plugin’s configuration file. Although the default generators might be useful on your server, adding others is the next step.

➕ Creating New Generators

As briefly mentioned earlier, customizing your generators is necessary to add new blocks into the mix. These can be anything you want, like diamond ore, end stone, or even ancient debris. Make sure your generators are appropriate for your server, as having an overly powerful one can be problematic. A common issue is excessively flooding the game’s economy because diamonds are easily obtainable. Regardless of what you implement, you’ll need to access the plugin’s file to make these changes.

1. Go to your FTP File Access area and log in, then enter the plugins directory.

2. Locate and continue to the CustomOreGen folder.

3. Next, click on "Edit" to the right of the config.yml file.

4. Make the necessary changes and click "Save" at the top.

5. Go to the main panel and Restart the server to apply the edits.

⚙️ Configuration Breakdown

There aren’t too many settings, but we’ll go over them so you can get started. However, keep in mind that the "blocks" options require item IDs from here to work in the file.

Setting	Description
label	Name of the generator, also used for placeholders.
blocks	Category of blocks that spawn in a generator, with their probability next to each material.
permission	Sets the permission node required for players to use the generator.
unlock_islandLevel	Unlocks the generator at a specific island level but requires a SkyBlock plugin.
enable-stone-generator	Enables or disables if vertical cobblestone generators become custom generators.
enable-particle-effect	Enables or disables the smoke particle effect when a block is generated.
enable-sound-effect	Enables or disables the hissing sound effect when a block is generated.
disabled-worlds	Specifies worlds where the plugin won’t function.

🔧 Example Generator

The following settings are popular among server owners, which you can use or test.

yaml
generator3: label: "Example" blocks: - STONE:50.0 - SANDSTONE:30.0 - IRON_ORE:10.0 - GOLD_ORE:5.0 - EMERALD_ORE:3.0 - DIAMOND_ORE:2.0 permission: 'oregen.example' unlock_islandLevel: 0

🔑 Assigning Permissions

Once you have custom generators, you’ll want to make sure the permission node is assigned to players or their ranks. This can be done through LuckPerms, a group management plugin that sets abilities for users.

For example, using the oregen.example permission for your generator will allow others to use it, even if it’s in a rank or someone’s account. Otherwise, not having a node in the configuration will allow everyone to use it.

📜 Plugin Commands

There aren’t too many commands, but these can help admins or moderators manage the plugin.

🏝️ SkyBlock Compatibility

CustomOreGen is fully compatible with SkyBlock, as this is an extremely popular game mode. The best way to set this up is by using our preconfigured server and the plugin together, which saves you a lot of time. Otherwise, install one of the SkyBlock plugins mentioned below to see if they’ll work.

Either way, combining these offers your players a new way to obtain materials.

❗ Common Issues

Generators Aren’t Working

In cases where no generators are working, try enabling the enable-stone-generator setting in the configuration file. This allows all generators to be used in the CustomOreGen plugin. Additionally, make sure your world isn’t disabled in the same file, as that would cause issues. Alternatively, check if you have the correct permissions for what you want. Remember, LuckPerms or another management plugin is needed for these abilities. Otherwise, becoming a server operator might also work.

The Plugin Isn’t Working

After installing CustomOreGen on your Spigot server and it isn’t working, ensure you’ve used the correct server profile. However, the root of the problem might be related to an incompatible game type. For example, standalone Forge servers cannot support plugins and should only be on those based on Bukkit. Confirming this and your profile will likely make it work. Although, it could be a simple issue of loading CustomOreGen into the FTP panel. Make sure the file reaches 100%, then Restart the server to apply the plugin.

Best Regards,

João @PixelHost