How to create a Hytale server store

A Hytale server store has five parts: products the game's policy allows, a store platform, a payment provider, a plugin on the server that receives purchases, and the command each product runs. This guide sets them up in order, with Gamecart as the worked example. Other platforms follow the same path with different menu names.

Menu names below match the Gamecart docs.

1. Decide what to sell within the policy

Hytale has its own monetization rules, the Server Operator Policies. The full breakdown is in how to monetize a Hytale server. For your catalog, four points matter most:

• Cosmetics, subscriptions, paid access and donations are allowed, as long as price and terms are clear before payment.
• Gameplay-affecting items can be sold on Teen and Mature servers, tagged as such.
• Paid random items (crates, loot boxes) are banned on All Ages servers. Elsewhere they need numeric odds, expected cost disclosures and 12 months of records, so leave them for later if you are just starting.
• Your refund policy and key purchase terms have to be visible before checkout.

Every product description should say what the player gets, for how long, and whether it affects gameplay. A 30-day rank with a chat tag, a building kit and access to a decorative area is an easy first product to explain.

2. Pick where the store runs

You can build your own site with a checkout and a server integration, or use a hosted platform that already handles checkout, payments and delivery.

At least two hosted platforms have a dedicated Hytale plugin: Gamecart, and Tebex, which documents its Hytale integration. The biggest difference between them is how the money moves; Gamecart vs Tebex compares them with sources for each side. If this is your first store, how to create a store for your server covers the decisions that come before the technical setup.

Gamecart takes no commission on sales, and payments go to your own account with each provider. The Free plan allows up to 3 categories, 20 products and 3 servers, on a gamecart.gg subdomain.

3. Create the store

1. Go to dash.gamecart.gg, click Sign up and confirm your email with the 6-digit code.
2. In the store setup, pick Hytale under Game. The game decides the delivery methods and can't be changed later.
3. Enter the store name (3 to 32 characters), the currency and the subdomain, such as myserver.gamecart.gg.
4. Click Create Store.

4. Add categories and products

Every product belongs to a category, so start there.

1. Open Your store > Products, click Add and select Category. Name it, for example Ranks.
2. Click Add again and select Product.
3. Fill in the name, category, description and price.
4. For a 30-day rank, enter 30 in Duration. Leave it empty for a permanent product.
5. Click Create product.

For donations, Buyer chooses the price turns the price into a minimum, suggested amount, and the buyer can pay more.

5. Set up payments

1. Open Settings > Gateways and click Add gateway.
2. Find the provider and click Add.
3. Paste the credentials from your provider account and click Save Configuration.
4. Turn on the row's switch. New gateways start disabled, and Gamecart checks the credentials before enabling one.

Stripe (cards and wallets) and PayPal work in any store currency. The list order is the order buyers see at checkout, so put the method most of your players use first.

6. Connect your Hytale server

First, create the connection in the dashboard:

1. Open Integrations > Servers and click Create Server.
2. Under Delivery method, choose Plugin, the only delivery method for Hytale.
3. Name it, for example Survival, and click Create server.
4. Click Copy token on the server's row.

Then install the plugin. The Hytale executor page lists the Java version and Hytale server release it needs; check them before you install.

1. Download gamecart-hytale.jar from the link in the docs and copy it into the server's mods/ folder.
2. Start the server once to generate mods/Gamecart_Gamecart/config.properties.
3. Open that file and paste the token into serverToken.
4. Restart the server or run gamecart reload from the console.

serverToken=
apiUrl=https://api.gamecart.gg
pollIntervalSeconds=15
debug=false

Run gamecart status in the console to check it. The command shows the plugin version, connector state and last poll.

7. Configure delivery commands

A command is what your server runs when a purchase is approved. Gamecart uses {identifier} in place of the player, filled with the name the buyer entered at checkout.

1. Open the product in Your store > Products and scroll to Commands.
2. Click New command and choose when it runs: On Purchase, On Expiration or On Dispute.
3. Select the server that receives it.
4. Type the console command, without a leading slash.
5. Click Save.

The exact syntax depends on how your server handles groups and permissions. The reliable way to get it right: run the command in the console with your own player name, confirm it works, then replace your name with {identifier}.

For the 30-day rank, that becomes two commands: one on On Purchase that adds the player to the rank group, and one on On Expiration that removes them when the time runs out. A third on On Dispute takes the rank away if the payment is disputed, refunded or cancelled.

The gear icon on each row has two options. Offline delivery lets the command run while the player is offline. Ignore quantity runs it once even if the buyer orders more than one unit.

8. Run a test purchase

Test before you announce the store. The Manual gateway lets you do it without real money:

1. In Settings > Gateways, add Manual, write any instructions and turn it on.
2. Create a test product with the same command as your rank.
3. Buy it from your storefront with your own player name and the Manual gateway.
4. Open the order in Sales > Orders and click Approve. Delivery starts after approval.
5. Watch Integrations > Commands, then check in game that the rank was applied.

Turn the Manual gateway off afterwards, or buyers will see it at checkout too. To test the full money path, make a small purchase through your real gateway.

9. When a delivery doesn't arrive

Integrations > Commands shows the state of every command:

Common problems and where to look first:

10. List the server in Discovery

Discovery is Hytale's official in-game server browser. You submit your server from Server Profiles in your Hytale account, and each listing goes through moderation, according to Hypixel's announcement.

To be listed, the policy asks for public links to your website or store, privacy policy, refund policy and support contact. Once the store is live you have the first link. Write the other three before you submit.