ChargeOnUse — Paid Portals for Minecraft

ChargeOnUse Dimensions Addon: Monetize Portal Travel on Your Minecraft Server

Running a Minecraft server with custom dimensions opens up endless possibilities for exploration and adventure. But what if you could turn those interdimensional journeys into a balanced in-game economy feature? The ChargeOnUse addon for the Dimensions plugin does exactly that — it lets you withdraw money from players every time they step through a portal. Whether you are managing a survival world, an RPG realm, or a network of interconnected custom dimensions, this small but powerful tool adds a layer of resource management that keeps gameplay engaging and fair.

What Is the ChargeOnUse Addon?

ChargeOnUse is a lightweight addon designed to work alongside the popular Dimensions plugin for Minecraft servers. Its sole purpose is to apply a configurable monetary cost whenever a player uses a portal to travel between dimensions. The addon hooks into Vault, the standard economy API for Bukkit, Spigot, and Paper servers, to deduct funds directly from a player’s balance. If a player lacks sufficient money, the portal simply refuses to activate, preventing free rides across your carefully crafted multiverse.

This addon is perfect for server owners who want to introduce travel fees, create money sinks, or encourage players to earn currency before accessing exclusive dimensions like a premium mining world, a boss arena, or a peaceful farming realm. It adds a subtle but effective layer of progression without requiring complex command blocks or custom scripts.

Key Features and Mechanics

• Seamless Vault Integration: The addon automatically detects your economy plugin through Vault, supporting any major economy system like EssentialsX, CMI, or iConomy.
• Per-Dimension Cost Configuration: Set different prices for each dimension or portal type, allowing you to make some travels free while others require a hefty fee.
• Instant Transaction Feedback: Players receive clear messages when money is deducted or when they cannot afford the trip, keeping the experience transparent.
• Lightweight and Efficient: The addon runs silently in the background, adding no noticeable lag to your server performance.
• Simple Setup: Just drop the JAR file into the correct folder, restart, and you are ready to configure costs.

Dependencies You Need

Before installing ChargeOnUse, ensure your server meets these requirements. The addon relies on two core components:

• Dimensions Plugin: The main plugin that creates and manages custom dimensions, portals, and world travel rules. ChargeOnUse is an addon for this plugin, so it will not function without it.
• Vault: The essential economy API that bridges your economy plugin with other plugins. Vault must be installed and working with a compatible economy plugin like EssentialsX, CMI, or any other Vault-supported economy manager.

Installation Guide

Setting up the addon is straightforward and takes only a few minutes. Follow these steps to get started:

1. Download the ChargeOnUse JAR file. Obtain the latest version from your trusted source. The file is typically named ChargeOnUse.jar.
2. Place the JAR in the correct folder. Navigate to your server’s ./plugins/Dimensions/Addons/ directory. If the Addons folder does not exist, create it manually. Drop the JAR file inside.
3. Install the dependency. Make sure both the Dimensions plugin and Vault (with a compatible economy plugin) are already installed and enabled on your server.
4. Restart your server. A full restart is recommended to ensure the addon loads correctly and registers with the Dimensions plugin.

After restarting, the addon will generate a default configuration file inside the Dimensions addon folder. You can then adjust the cost per dimension, customize messages, and even set up exemptions for certain player groups if your permissions plugin allows fine-tuning.

Configuring Portal Costs

Once installed, you will find a configuration file named ChargeOnUse.yml (or similar) in the addon directory. Open it with a text editor to set the price for each dimension. The structure is intuitive:

dimensions:
  world_nether: 50.0
  world_the_end: 100.0
  mining_dimension: 25.0
  creative_world: 0.0

In this example, traveling to the Nether costs 50 units of your server’s currency, the End costs 100, a custom mining world costs 25, and a creative world is free. You can also define a global default cost for any dimension not explicitly listed. The addon supports decimal values, so you can charge fractions of a dollar, diamond, or whatever currency your economy plugin uses.

How It Works in Gameplay

When a player steps into a portal, the addon checks the destination dimension against the configuration. If a cost is defined, it queries Vault to see if the player has enough funds. On success, the money is withdrawn and the player is teleported. A configurable message appears in chat, such as “You paid 50 coins to enter the Nether.” If the balance is insufficient, the teleport is cancelled and the player receives a warning message. This all happens in milliseconds, so there is no noticeable delay.

Server administrators can also set up permissions to bypass costs for certain ranks. For example, VIP players might travel for free, while regular players must pay. This adds another layer of monetization and incentive for players to support the server.

Practical Use Cases

ChargeOnUse fits naturally into many server types. Here are a few scenarios where it shines:

• Survival Economy Servers: Charge for access to resource-rich dimensions like a mining world or the End, encouraging players to engage with the server economy.
• RPG and Adventure Maps: Create a sense of progression by gating high-level zones behind a fee, making players earn their way into dangerous dungeons.
• Hub-Based Networks: If your server uses a central hub with portals to different game modes, you can charge for entry to premium modes while keeping basic ones free.
• Event Dimensions: Temporarily open a special event world and charge a small fee to participate, adding to the event’s exclusivity.

When you are building a modded or custom dimension experience, having the right tools to manage player access is crucial. Many server owners find that combining plugins like Dimensions with a reliable launcher on the client side makes the whole experience smoother. For players, using a modern launcher such as foxygame.net can simplify joining these custom servers, as it allows you to download and manage modpacks directly from its interface, ensuring you always have the right setup to connect to worlds with unique portal mechanics and economy systems.

Why Use ChargeOnUse Instead of Custom Scripts?

While it is possible to achieve similar functionality with command blocks or complex scripting, ChargeOnUse offers several advantages:

• Performance: The addon is optimized and runs natively within the Dimensions plugin, avoiding the overhead of command block chains.
• Reliability: It hooks directly into Vault, ensuring accurate transactions without delay or duplication glitches.
• Ease of Maintenance: Updating costs is as simple as editing a YAML file; no need to hunt down command blocks scattered across worlds.
• Compatibility: Works with any economy plugin supported by Vault, giving you flexibility in choosing your server’s financial backbone.

Common Troubleshooting Tips

If the addon does not seem to charge players, check the following:

• Ensure Vault and an economy plugin are installed and enabled. Without Vault, the addon cannot access player balances.
• Verify the JAR file is placed in the correct ./plugins/Dimensions/Addons/ folder, not the main plugins directory.
• After installation, perform a full server restart rather than a reload, as reloads can sometimes fail to register new addons properly.
• Check the configuration file for typos in dimension names. The names must match exactly those defined in the Dimensions plugin.
• Look at the server console for any error messages related to ChargeOnUse during startup.

Expanding Your Server’s Potential

ChargeOnUse is a small piece of a much larger puzzle. When combined with other Dimensions addons, you can create a fully automated dimension management system. Imagine a network where players pay to enter worlds, earn money by completing tasks inside, and then spend that currency to unlock even more exotic realms. The addon’s simplicity makes it a reliable building block for complex economic ecosystems.

Server owners who enjoy tinkering with configurations will appreciate how easily ChargeOnUse blends into existing setups. It does not overwrite any core Dimensions settings, so your carefully tuned portal rules remain intact. You can enable or disable the addon at any time by simply removing the JAR file and restarting.

Final Thoughts

The ChargeOnUse Dimensions addon fills a specific but valuable niche: monetizing portal travel in a clean, automated way. It respects player choice by providing clear feedback, integrates seamlessly with Vault, and requires minimal maintenance once configured. Whether you run a small community server or a large network, this addon helps you balance exploration with economy, making every journey feel meaningful. Install it today, tweak the costs to match your server’s vision, and watch as your players strategize their travels like never before.