Hytale Payment Plugin Guide
What a Hytale payment plugin actually does, how to install one, and a plain comparison of the main options. For server operators who want to stop guessing and start collecting real money.
Updated April 10, 2026 · ~8 minute read
Hytale does not ship a built-in monetization layer. If you want to charge players for supporter tiers, cosmetics, or server access, you need a server plugin that connects to a payment processor, listens for webhook events, and grants perks when a purchase succeeds. Installing that plugin is usually drop-in. Choosing the right one is where most Hytale server operators get stuck, because the ecosystem is new and most of the existing comparisons are written by the platforms themselves.
This post is the comparison. It starts with what a Hytale payment plugin is actually doing under the hood, walks through a real install, compares the main options (Arcalotl, Tebex, PayNow, Tip4serv, Buytale) on their architecture and feature set, and points out the compliance requirements that apply regardless of which tool you pick. If you want the broader context on what to monetize and the Hytale EULA rules that govern it, read the Hytale monetization pillar guide first. This post is the technical complement.
What a Hytale payment plugin actually does
Under the hood, every Hytale payment plugin does roughly the same five things:
1. Register in-game commands or UI. The plugin exposes commands (or a clickable store interface) that players use to browse tiers, check their subscription status, and manage their perks. Commands like /store, /subscribe, /cancel, and /whoami are standard.
2. Listen for payment webhooks. When a player completes a purchase, the payment processor (Stripe, Tebex's own processor, Adyen, PayPal, etc.) sends a webhook to the plugin's HTTPS endpoint. The plugin verifies the webhook signature, looks up which player triggered the purchase, and schedules the perk grant.
3. Grant and revoke perks. On successful payment, the plugin assigns the in-game role, grants cosmetic access, unlocks the private channel, or whatever other perk the tier promises. On cancellation or failed payment, it reverses those grants. Well-designed plugins do this idempotently so retries do not create duplicate roles.
4. Handle subscription lifecycle events. Recurring payment plugins process renewal, refund, chargeback, upgrade, downgrade, and cancellation events. Most “donation store” plugins only handle one-time purchases and skip this layer entirely. If you want recurring supporter tiers (which is the highest-margin monetization model for most Hytale servers), you need a plugin that implements the full subscription lifecycle, not just a one-time checkout.
5. Surface admin controls. The plugin needs a way for the server operator to see what is happening: who subscribed, who churned, what the current MRR is, which payments failed. The best plugins push this to a web dashboard. The worst ones dump it into a log file.
Notably absent from that list: handling card data. No legitimate Hytale payment plugin should touch raw card numbers. All card entry happens in the payment processor's PCI-compliant checkout environment (Stripe Checkout, Tebex's hosted web store, etc.). The plugin only sees the result.
Installing a Hytale payment plugin: the generic flow
Every Hytale payment plugin installs roughly the same way. The specific file names and commands differ, but the shape is:
Create an account with the payment platform
Sign up on the platform's website (tebex.io, paynow.gg, tip4serv.com, arcalotl.com). Verify your email. Most platforms ask for basic business information (country, payout currency) up front.
Connect a payment processor
This is where the platforms diverge. Arcalotl connects your Stripe account via Stripe Connect OAuth, so payouts flow directly to your Stripe account. Tebex routes payments through its own processor and pays out to you afterwards. The difference matters for merchant-of-record responsibility and payout timing (covered in more detail below).
Download and install the plugin
Copy the plugin jar (or equivalent) into your Hytale server's plugins directory. Restart the server. The plugin registers its commands and starts listening for webhook events. Installation is drop-in on every platform; this is the simplest step.
Pair the plugin to your account
Run a pairing command in-game (e.g., /arcalotl pair) or paste a server-specific token into a config file. This step associates the plugin instance with your dashboard so it can receive webhook events from the right account.
Define your tiers
In the dashboard, create your supporter tiers or one-time products. Set prices, perks, and any Section 4.3 disclosure flags for gameplay-affecting items. Best practice: start with 2-3 tiers at $4.99 / $9.99 / $19.99, measure conversion, then adjust.
Test with a live purchase
Run a test subscribe as a player. Verify the perk gets granted in-game. Verify the payout lands in your processor account. Verify the dashboard reflects the correct MRR. Every plugin has edge cases; test yours before you tell players to buy anything.
The whole setup typically takes 10-30 minutes depending on how familiar you are with the payment platform. Most of the time is spent on payment processor verification, not on the plugin itself.
Architecture comparison: where the plugins differ
The big architectural split among Hytale payment plugins is whether they treat your server as a satellite of an external web store or as the primary commerce surface. Everything else follows from this choice.
External web store model (Tebex, PayNow, Tip4serv, PixlPay, HyStore)
The plugin is a thin webhook receiver. The primary purchase interface is a web store on the platform's domain (e.g., yourserver.tebex.io) or a custom subdomain. Players leave Hytale, open a browser, navigate to the store, pick a package, check out, and return to the game. The plugin's only job in-game is to deliver the perk once the webhook fires. This is the simplest architecture and the one every existing Hytale payment tool uses. The downside is every single transaction requires a context switch out of the game, which compounds into real conversion loss. Tebex's plugin is open source at github.com/tebexio/Tebex-Hytale and currently sits on the 1.x series as a port of the mature Minecraft connector.
In-game store model (Arcalotl)
The plugin renders the full supporter store inside Hytale. Players browse tiers, pick one, and confirm without leaving the game. The browser gets involved exactly once: on the first purchase, Arcalotl opens a secure Stripe Checkout so the player enters their card once. After that, every subsequent action (renewals, upgrades, cancel saves, failed-payment retries, tier switches) stays in-game. This is a bigger engineering lift but it materially reduces friction and lets the plugin run automated retention flows (dunning, cancel saves, term optimization) without ever kicking the player back to a browser.
The two models have real trade-offs. External web stores are easier to customize visually and support more one-off product types (merch, gift cards, affiliated services). In-game stores win on subscription conversion, retention, and operational simplicity for community operators who are not running a full e-commerce catalog.
A second split: merchant-of-record (MoR) responsibility. Hytale's EULA, Section 7.7, states that the server operator “is the merchant of record and is solely responsible for pricing, fulfillment, customer service, refunds where required by applicable law, and compliance with consumer protection, advertising, tax, and payment laws.” With Arcalotl's Stripe Connect model, payouts go directly to your Stripe account and you literally are the merchant of record. With Tebex, Tebex acts as the MoR and handles chargebacks and tax compliance on your behalf (which can be convenient). Either model can comply with the EULA. The difference matters mainly for payout timing, fee transparency, and who absorbs fraud loss.
Feature checklist: what to look for
When evaluating a Hytale payment plugin, this is the short list of features that actually matter for revenue. The first four are table stakes; the last five are where the tools differentiate.
- Recurring subscription support. Not just one-time purchases. Monthly and annual billing, upgrade/downgrade flows, prorated billing changes.
- In-game perk automation. Role grants, cosmetic unlocks, private channel access, all handled automatically on payment events. No manual operator intervention.
- Webhook signature verification. The plugin validates that webhook events are actually coming from the payment processor, not a spoofed request. Non-negotiable for security.
- Compliance disclosure metadata. Gameplay-affecting tags, paid random item disclosure fields, refund policy surfacing. Hytale's Server Operator Policies require this for teen and mature servers.
- Automated dunning. Failed-payment recovery through DMs, in-game messages, or email sequences. Recovers 30-50% of involuntary churn on most communities. See the dunning glossary for the full breakdown.
- Cancel save flows. When a player cancels, the plugin presents a dynamic offer (discount, pause, downgrade) before the cancellation finalizes. Recovers 30-40% of attempted cancellations.
- Term optimization. Engaged monthly subscribers get an auto-prompt to upgrade to annual at a discount. Annual subscribers churn dramatically less than monthly ones.
- Analytics dashboard. MRR, churn rate, recovery rate, cancel save rate, average tier value. Not just “you made $500 last month” as a single number.
- Cross-platform subscriber management. If your community spans Hytale + Discord + other platforms, the plugin should manage subscriptions from one dashboard.
Of the Hytale payment plugins shipping in 2026, only Arcalotl covers all nine. Tebex covers the first four. PayNow, Tip4serv, and Buytale cover the first three with gaps. See the Tebex alternatives breakdown and the direct Tebex vs Arcalotl comparison for the specifics.
Compliance requirements that apply regardless of plugin
No payment plugin absolves you of compliance responsibility. Hytale's EULA, Section 7.7, states explicitly that the server operator is “the merchant of record and is solely responsible for pricing, fulfillment, customer service, refunds where required by applicable law, and compliance with consumer protection, advertising, tax, and payment laws.” A plugin can help you get compliant, but it cannot take the legal responsibility off you.
Whatever plugin you pick, you are still on the hook for:
- Truthful pricing and disclosures. Total price, renewal terms, material limitations, refund policy, all visible before checkout.
- Tagging gameplay-affecting purchases. Section 4.3 of the Policies requires teen/mature servers to disclose every gameplay-affecting purchase. Configure your tiers accordingly.
- Loot box disclosure (if applicable). Section 5 of the Policies requires numerical odds, expected spend, and a 12-month audit trail for any paid random items. For most community servers, this compliance load is higher than the revenue and not worth shipping.
- Prohibited categories. Section 4.1 bans NFTs, speculative crypto tokens, play-to-earn schemes, and real-money gambling on every server. Section 6 bans “double random” gacha chaining.
- Tax handling. Sales tax, VAT, GST where applicable. Most payment processors (Stripe Tax, Tebex's tax layer) can help with this, but you are responsible for filing.
- Age-gating. Section 7.9(c) of the EULA prohibits selling paid random items to identified minors. Arcalotl enforces this at the config level; other plugins require you to implement it yourself.
Read the full Hytale monetization pillar guide for the complete Policy breakdown with verbatim quotes. If you are running monetization without having read the Server Operator Policies end-to-end, stop and go read them first.
Frequently asked questions
Do I need a plugin to accept payments on my Hytale server?
Yes. Hytale does not ship a built-in monetization layer. Every payment tool on the market (Arcalotl, Tebex, PayNow, Tip4serv, Buytale) ships as a server plugin that runs alongside your Hytale server. The plugin listens for purchase webhooks from a payment processor (Stripe, Tebex's own processor, etc.), grants in-game perks or roles, and handles subscription lifecycle events. Without a plugin, there is no way to automate perk delivery.
Does a Hytale payment plugin touch my players' card data?
No. Every reputable payment plugin delegates card handling to a PCI-compliant payment processor (Stripe, Adyen, PayPal, or the platform's own processor). The plugin itself never sees raw card numbers. It only receives webhook events indicating that a payment succeeded, failed, or was refunded. If a plugin author claims their plugin handles card data directly, do not install it.
Are Hytale payment plugins open source?
Some are. Tebex publishes the Tebex-Hytale connector plugin under an open-source license on GitHub (github.com/tebexio/Tebex-Hytale). Tip4serv publishes an open-source donation plugin. Arcalotl's Hytale plugin is closed source but hosted and signed by Arcalotl. The payment processor itself (Stripe or equivalent) is never part of the plugin source and remains under the vendor's control.
Can I run more than one payment plugin at the same time?
Technically yes, operationally not recommended. Two plugins competing to grant the same in-game perks will race, create duplicate roles, and confuse players. The only legitimate reason to run two plugins in parallel is during a migration window while you move tiers from one platform to another. Run the old plugin as read-only (no new tier sales) and the new plugin as write-only for new tiers. Cut over when the old plugin has no active subscribers.
Do Hytale payment plugins handle failed-payment recovery?
Most do not. Tebex, PayNow, Tip4serv, and Buytale handle basic webhook events (purchase, refund) but none of them ship automated dunning, cancel saves, or term optimization. When a subscription payment fails, the plugin revokes access and the player quietly disappears. Arcalotl ships these flows as first-class features and runs them automatically. See the Hytale monetization pillar guide for the full revenue recovery breakdown.
What permissions does the Arcalotl Hytale plugin need?
Grant-role, revoke-role, send-private-message, register-commands, and webhook-receive. The plugin listens on an HTTPS endpoint for payment events from Arcalotl's backend, verifies the webhook signature, and dispatches perk grants. It does not need filesystem write access outside its own data directory, and it does not modify your Hytale server config files at runtime.
Will installing a payment plugin affect my server performance?
Measurably, no. A well-built payment plugin runs as a lightweight webhook handler with a few scheduled jobs. The player-facing in-game store UI is rendered on-demand when a player opens it, not continuously. Arcalotl's plugin architecture is designed to keep steady-state overhead low enough to be negligible on a mid-sized server, dominated by the HTTPS TLS cost of inbound webhooks rather than any continuous rendering loop.
Which Hytale payment plugin should I use?
Depends on what you are optimizing for. If you want lowest initial friction for one-time purchases, Tip4serv is fine. If you want the broadest payment method catalog and multi-game support, Tebex is the established incumbent. If you want recurring subscription revenue, in-game checkout, and automated revenue recovery (dunning, cancel saves, term optimization) as first-class features rather than add-ons, Arcalotl is the platform built for that use case. For most community servers that monetize through supporter tiers, the recovery layer compounds into meaningfully higher MRR over the 2-year 0% revenue share window.
The plugin is the easy part
Installing a Hytale payment plugin takes 10-30 minutes. Designing the supporter tiers that actually convert takes longer. Staying compliant with the Server Operator Policies takes longer still. And the 0% revenue share window closes on January 13, 2028. Roughly 640 days remain. Every day spent deliberating which plugin to install is a day that the window is not compounding for you.
The Arcalotl Hytale plugin is in active development and ships alongside Early Access. Early-access spots get priority onboarding and grandfathered pricing. The fastest way to reserve one is to add your server to the list on the Hytale page — everything else (setup, tiers, analytics, retention flows) is 15 minutes of work once the plugin is live.