Documentation

What Magmaro Is

Magmaro is a marketplace for Minecraft and Hytale products and services. It combines public resource listings, jobs, creator profiles, version history, buyer libraries, direct messaging, reviews, discussions, creator promotions and commerce tooling in one platform. It is designed to be the complete operational environment for serious creators who want to build and sustain a product business without stitching together external tools.

It is not just a download page. Buyers can build a persistent library, track updates across all their purchased resources and communicate directly with creators from the same account. Creators can manage listings, campaigns, discounts, traffic slots and sales reporting from a single creator dashboard — no separate admin area, no third-party tool dependency required.

Accounts and Profiles

Every Magmaro account serves dual purpose: it is simultaneously a buyer account and a public-facing creator profile. There is no separate creator registration — any user can publish listings from within their existing account once their profile is set up and their Stripe Connect onboarding is complete for paid resources.

Public profiles can display profile posts, recent activity, owned resources, job listings and basic profile information depending on what you enable in account settings. Profile visibility is granular — you control whether your about section appears, which activity entries are listed, and how your public presence is presented.

You can customize your avatar, banner, biography, website, country, visibility toggles and notification behavior from the account settings page. Profile activity visible to others may include resource publications, submitted reviews, profile interactions, profile posts and other marketplace events where visibility has been explicitly enabled.

The Buyer Experience

A typical buyer journey on Magmaro: discover a listing through the catalog, category pages, featured slots or search; read the product page including the description, cover, compatibility metadata, version history and reviews; check the discussion thread for support context and buyer feedback; add the resource to your cart or acquire it directly; complete checkout through Stripe; and then access the purchase from your library.

From the library you can download the current approved package, track version history, receive notifications when new versions are published and contact the creator directly if you have questions or need support. The library is persistent — resources you have purchased remain available for re-download and update tracking for as long as the listing exists on the platform.

The Creator Experience

Creators on Magmaro manage their product businesses from a unified dashboard. You publish resource listings from your profile, submit packages for moderation review, set pricing, manage version updates, run promotional campaigns and track sales and license data — all from the same account you use as a buyer.

The Creator API (available with Magmaro+) extends this to automated workflows. You can automate release publishing from CI/CD pipelines, query transaction and license data programmatically, and manage campaigns without using the web interface. This is particularly useful for studios or active developers who ship frequent updates.

Platform Philosophy

Magmaro is built on the idea that creators should be able to run a serious software product business within their own community ecosystem. The platform prioritises commercial credibility — accurate listings, real purchase flows, proper licensing, version-controlled distribution — alongside community quality through moderation, reviews and direct creator-buyer communication.

Features are designed to work together. The watermarking system deters redistribution. The temporal token system lets plugins self-verify at runtime. The Discord integration keeps buyer roles in sync without manual management. These are not isolated features — they form a coherent system for creators who want their product to feel professional from download to runtime.

Resources and Product Pages

Resources are the primary commercial product type on Magmaro. A resource listing includes a Markdown-rendered description, cover image, screenshots, creator identity, category and game metadata, compatibility information, software support declarations, tags, dependency references, external links, version history with changelogs, buyer reviews, and a public discussion thread.

Creators can publish both free and paid resources. Paid resources can be sold at a fixed price, discounted via time-limited offers, promoted through ad placements, and included in coupon campaigns. Free resources can still be added to a buyer's library so that access and update tracking remain centralised, even without a purchase involved.

Each product page is a standalone public-facing document. New buyers read it without an account. The quality and completeness of the product page directly affects conversion — a thorough, honest description builds trust. An incomplete or inaccurate one creates support friction and risks disputes.

Browsing, Search and Discovery

Resources can be discovered through the main catalog, category filters, game and software filters, tag browsing, creator profile pages and search. The platform also has featured placement slots that creators can book through the ad system to give their resource elevated visibility on relevant surfaces.

Trending and top-rated resources surfaces are automatically maintained based on platform activity. These are not manually curated — they reflect real buyer engagement and rating signals. Featured ads are distinct from organic catalog positions and are clearly booked through the commercial system.

Library and Downloads

When you acquire a resource — through purchase for paid content, or direct acquisition for free content — it appears in your personal library. The library is the canonical record of what you own and have access to on Magmaro. It persists across sessions, devices and account logins.

From the library you can download the current approved package version, browse the version history for a resource, see when updates were published and access the creator's product page. For paid resources, access is tied to a completed purchase — if a payment is reversed, access may be revoked. For free resources, access remains as long as the listing is active and you have not had access removed for policy reasons.

Downloads are processed through Magmaro's delivery system, which applies attribution watermarking before the file is served. This is described in more detail in the Platform tab.

Version History and Updates

Each resource maintains a versioned release history. Creators submit new versions through the dashboard or Creator API. Each new version goes through a moderation review before going live. The currently approved live version remains visible to all buyers and library holders during this review — the listing does not go offline while a new version is pending.

When a creator publishes a new approved version of a resource already in your library, Magmaro can notify you through the notification system depending on your preferences. Notifications are configurable per category from account settings, and browser push delivery is available where you have granted permission.

Version changelogs are displayed on the product page and in your library. This gives buyers visibility into what changed between versions and when updates occurred, which is particularly important for infrastructure products where upgrade timing matters.

Dependencies and Compatibility

Creators can declare software compatibility, game version support and dependencies on their listings. This information is surfaced on the product page to help buyers evaluate fit before purchasing. Compatibility declarations are the creator's responsibility — if a resource is listed as supporting a software version that it actually does not support, that is a listing accuracy issue governed by the Creator Guidelines.

Dependencies between Magmaro resources can be declared explicitly where a product requires another resource from the platform to function. This creates a visible relationship between listings and helps buyers understand what they need to download for a complete working setup.

Cart and Checkout

Magmaro supports both direct single-resource checkout and cart-based checkout for buying multiple resources in one transaction. The cart lets you collect paid resources from any creator before proceeding to payment. At checkout, the full cart is reviewed with final prices, any applied coupon discount, and the total in both the listing currency and your preferred display currency if they differ.

Payments are processed through Stripe. The checkout experience is handled through Stripe's hosted payment flow, which supports card payments and other methods depending on your region. After a successful payment, your library is updated immediately and a purchase receipt is associated with your account.

Stripe Connect and Payouts

Magmaro uses Stripe Connect to route revenue directly to creators. When a buyer completes a purchase, the transaction is processed through Stripe and the creator's share is transferred to their connected Stripe account according to payout schedules. Magmaro does not hold creator funds as an intermediary — payouts flow through Stripe directly.

To receive revenue from paid listings, creators must complete Stripe Connect onboarding from the creator dashboard. Until Stripe Connect is ready, paid listing creation and release automation is disabled. You can check your Stripe Connect status at any time from the payout settings page in the dashboard.

Currency Display and Exchange

Creators set their listing prices in a chosen currency. Buyers may have a different preferred display currency set in their account. When these differ, Magmaro shows both the listing currency and your preferred currency equivalent at checkout, so you can see exactly what you are paying before confirming the transaction.

Currency conversion at checkout is handled by Stripe. The rate applied is determined at transaction time. Magmaro does not guarantee a specific exchange rate and is not responsible for differences between the displayed estimate and the actual conversion applied by your payment provider or bank.

Coupons

Coupons are code-based discounts applied at checkout. A buyer enters a coupon code in the cart or checkout flow and, if valid, the applicable discount is reflected in the order total before payment is confirmed. Coupons are created by creators or platform administrators.

Creator coupons apply only to that creator's resources. A coupon targeting a specific resource will not apply to other creators' products. Global coupons created by platform administrators may apply more broadly across the catalog. A coupon must be active and unexpired at the time of checkout to be applied — expired or inactive codes will be rejected at validation.

Coupon codes are case-insensitive. A code entered in any capitalisation will be matched correctly. Each coupon has a defined discount percentage and may have additional restrictions such as a minimum order value or a maximum number of redemptions, depending on how it was configured.

Offers and Time-Limited Pricing

Creators can run time-limited offers that reduce the effective price of a resource for a defined period. When an offer is active, the discounted price replaces the standard price on catalog cards, search results and the product page. Buyers who purchase during an active offer pay the discounted amount — the offer discount is not retroactively applied to purchases made before the offer started.

Offers are subject to cooldown and maximum duration rules to prevent continuous discounting that could undermine the perceived value of the listed price. These rules are enforced at creation time. Once an offer period has ended, the standard price is automatically restored without any action required from the creator.

Offers can be created through the creator dashboard or through the Creator API. They can also be cancelled early through the same tools if circumstances change. Platform rules around offer frequency and duration are described in the Creator Guidelines.

Refunds and Disputes

Refund requests can be submitted through Magmaro support. The platform reviews requests on a case-by-case basis, taking into account whether the listing was accurately described, whether the product was functional, the nature of the complaint and the history of the relevant accounts. Magmaro may issue full or partial refunds where appropriate.

Buyers who initiate chargebacks directly with their payment provider without first seeking resolution through Magmaro may have their buyer access restricted. Chargebacks bypass the platform's own dispute process and may result in enforcement action as described in the Terms of Service.

Reviews

Resource pages support buyer reviews. A review consists of a star rating and optional written feedback about the resource. Only users who have the resource in their library — through purchase or free acquisition — can submit a review. This ensures that reviews reflect real buyer experience rather than uninformed opinion.

Reviews support Markdown formatting. Creators can reply to individual reviews directly from the product page. Reply content is public and appears directly below the review, which allows creators to address feedback, clarify issues or thank buyers publicly. Review ratings contribute to the resource's displayed average and affect its position in quality-sorted surfaces.

Review manipulation — including coordinated fake reviews, incentivised ratings or negative campaign tactics — is a serious violation of platform rules and may result in removal of the affected reviews and enforcement action against the accounts involved.

Discussion Threads

Every resource page includes a public discussion thread. Discussion is intended for product-related conversation — support questions, compatibility clarifications, feature requests, setup guidance and general dialogue between buyers and the creator. It is not a general chat area, and off-topic or disruptive behavior in discussions is subject to moderation.

Discussion posts support Markdown. Threaded replies are supported, allowing conversations to branch from specific posts rather than running as a flat stream. Creators receive notifications for new discussion posts on their listings, enabling timely support responses. Buyers can reply to existing threads directly or open new posts.

Profile Posts

Profile posts let users publish short-form updates, announcements or comments on their own public profile, visible to profile visitors. Posts support Markdown and can include links and formatted text. Other users can post to your profile as well, creating a wall-style timeline of activity around a creator's public presence.

Profile posts are public by default and contribute to the visible activity on a creator's profile page. They are a lightweight way for creators to announce new releases, updates, plans or community interactions without the overhead of a full listing update. Profile post visibility can be configured in account settings.

Private Messages

Private messaging supports direct communication between any two users. It is the primary channel for buyer support, creator-buyer coordination, private commercial discussions and any communication that should not be public. Messages can be edited by their author after sending.

The inbox is accessible through the navbar dropdown and the full messages page. Message threads are per-user pair, not per-resource — a single conversation thread connects any two users regardless of how many resources are involved. If a buyer needs help with a specific product they typically start a conversation from the product page or the creator's profile.

Messages are stored privately and are not visible to other users. Magmaro may access message content internally where necessary for moderation, abuse investigation or enforcement purposes, as described in the Privacy Policy.

Notifications

Magmaro's notification system covers both commercial events and community interactions. Commercial notifications include sales alerts, new version publications for resources in your library, payout updates and promotional campaign activity. Community notifications include new private messages, review replies, profile posts, discussion replies on resources you are involved with and other profile-level interactions.

You can configure which notification categories you receive from the account settings page. Categories can be enabled or disabled independently. Browser-level push notifications may also be available where you have granted permission through your browser — these are managed separately from in-app notification preferences and can be revoked through browser settings at any time.

In-app notifications appear in the navbar notification dropdown and on the dedicated notifications page. Unread notification counts are displayed in real time as you use the platform. Notifications can be marked as read individually or in bulk.

Community Standards

Magmaro is a professional marketplace. All community features — reviews, discussions, profile posts and messages — are expected to be used in good faith. Harassment, discrimination, spam, impersonation, threats, malicious file distribution and any other conduct that harms other users or degrades the platform experience are prohibited and subject to enforcement.

Platform rules are detailed in the Terms of Service. The Creator Guidelines contain additional standards specific to creators. Both documents should be read by anyone participating in the community, not just those publishing commercial listings.

Creator Dashboard

The creator dashboard is where all commercial tooling lives. The overview provides a summary of recent revenue, transaction counts and product performance at a glance. Each section of the dashboard is dedicated to a specific aspect of creator operations:

• Transactions — full sales history with filtering by provider, currency and date range
• Licenses — list of all users holding a license for your resources, with manual grant capability
• Ads — calendar-based booking of promotional placement slots
• Offers — creation and management of time-limited price reductions
• Coupons — creation and management of discount codes for buyers
• Payout Settings — Stripe Connect onboarding and payout configuration

Creator operations are designed to sit alongside your listings and public profile rather than in a disconnected admin area. Everything needed to manage a commercial presence on Magmaro is accessible from a single dashboard, reachable from your profile navigation.

Publishing a Resource

To publish a resource on Magmaro, navigate to your profile and create a new listing. The listing form collects title, description, game, category, tags, compatibility metadata, pricing and any external links. Once the initial listing is submitted it enters moderation review before going publicly live.

After the listing is approved, you can upload and submit your first package version. Packages must be uploaded using the chunked upload system, both through the web interface and via the API. Once a version is submitted it enters its own review queue. Your listing remains visible during review with any previously approved version still accessible to buyers.

The review process is designed to preserve listing stability for buyers while giving creators the freedom to ship updates at their own pace. A pending update does not interrupt buyer access to the current live version.

Jobs

Job listings let service providers, freelancers and studios publish available work offerings or service descriptions. A job page communicates what services you offer, how you operate and how to reach you. Job listings appear on your public profile alongside your resources, contributing to a more complete portfolio for potential clients who discover you through the platform.

Jobs are distinct from resources — they do not have associated packages, version history or purchase flows. They are a marketing and discovery surface for service-based work. Contact is typically handled through private messages or external links provided in the listing.

Ad Bookings

The ad system lets creators reserve specific calendar dates for featured promotional placements on relevant catalog surfaces. You select a slot type — such as a featured homepage slot or a top catalog position — and choose the specific dates you want your resource promoted. Bookings are confirmed on a first-come, first-served basis per slot.

Booked dates that have already passed cannot be cancelled. Future dates can be cancelled before they begin. Ad placements are tied to a specific resource and slot combination. A resource promoted through an ad slot receives elevated visibility on that surface during the booked period, independent of organic ranking. Ad bookings can also be managed programmatically through the Creator API.

Magmaro+

Magmaro+ is a creator-tier subscription that unlocks advanced platform features. Current Magmaro+ benefits include:

• Creator API access — programmatic access to all creator endpoints for release automation and data integration
• Higher upload limits — package file size up to 500 MB per version (compared to 100 MB for standard accounts)
• Temporal token injection — personalized JAR downloads can include a signed read-only access token, enabling plugin-side runtime checks against the Magmaro API
• Additional features as they are added to the platform

Magmaro+ is billed as a recurring subscription and can be managed from account settings. The subscription must remain active to retain API access and temporal token injection. If the subscription lapses, API keys remain in your account but requests will return a 402 error until the subscription is renewed.

Creator API

The Creator API enables release automation, programmatic campaign management and data access without using the web interface. The most common use case is automating release publishing from a CI/CD pipeline — upload a package, create a version record, and the release enters the moderation review queue automatically.

The API is documented in full on the API Reference page. Key capabilities include resource and version management, chunked package uploads, transaction and license querying, and offer, coupon and ad booking management. All creator API endpoints require an active Magmaro+ subscription and a valid API key, which is generated from account settings.

Moderation and Review Workflow

New resource listings and version updates go through a platform review before going publicly live. The review process checks for content policy compliance, listing accuracy, file safety and metadata quality. It is not a functional software audit — Magmaro does not verify that your plugin works as described. The review is a platform-level content and safety check.

The currently approved live state of a listing remains visible to buyers and accessible to library holders while any pending edits or new versions are in review. This protects stability for buyers who depend on a listing being available while still allowing creators to iterate without having to take their product offline.

Moderation may also apply to coupons, promotional campaigns, profile content, reviews and user conduct. Platform-wide conduct moderation is handled according to the standards described in the Terms of Service.

Download Watermarking

Every download delivered through Magmaro carries attribution metadata tied to the specific downloader and the moment of download. The goal is pragmatic attribution and deterrence against casual redistribution — not hard DRM that prevents all access. A determined user with technical knowledge can still inspect a downloaded package, but redistribution of that package leaves a clear attribution trail.

The watermarking system uses different mechanisms depending on the file type:

JAR Placeholder Injection

For .jar downloads, Magmaro replaces supported placeholder strings directly inside text files and Java class constant strings within the archive at delivery time. Creators leave these placeholders in their source code — in string constants, metadata files or configuration files compiled into the JAR. Magmaro replaces them when generating the personalized download for a specific buyer.

• %%__MAGMARO__%%true for any JAR delivered through Magmaro
• %%__USER__%%The downloader's internal Magmaro user ID
• %%__USERNAME__%%The downloader's username
• %%__RESOURCE__%%The internal resource ID
• %%__RESOURCE_TITLE__%%The resource title as published
• %%__VERSION__%%The internal version record ID
• %%__VERSION_NUMBER__%%The human-readable version string, e.g. 1.2.0
• %%__TIMESTAMP__%%Unix timestamp of the download moment
• %%__NONCE__%%A unique per-download signed nonce for forensic attribution
• %%__MAGMARO_TEMPORAL_TOKEN__%%Signed read-only API token for this resource (Magmaro+ creators only)
• %%__MAGMARO_TEMPORAL_TOKEN_EXPIRES__%%Unix timestamp when the temporal token expires

Temporal tokens are only injected when the creator has an active Magmaro+ subscription. They grant read-only access limited to the same resource with a maximum lifetime of 60 days. They are intended for plugin-side update checks — for example, checking whether a newer version of the plugin is available. They cannot be used for creator write operations and should not be stored or logged outside the plugin.

ZIP Watermark File

For .zip downloads, Magmaro does not rewrite existing files inside the archive. Instead it inserts a hidden .mgmr watermark file into the deepest directory already present in the archive. This file records attribution metadata including the uploader identity, the download timestamp, the resource and version identifiers, and the downloader's user ID and username.

The .mgmr file is not invisible — someone carefully inspecting the archive can locate it. The purpose is to avoid making the watermark obvious at a glance while still leaving clear attribution material inside any redistributed copy. Think of it as a practical anti-leak signal rather than a guarantee of copy protection.

Discord Bot and Server Integration

The Magmaro Discord bot connects your Discord account to your Magmaro account and keeps Discord guild roles in sync with your platform state automatically. The linking flow is: start a link request from within Discord using the bot command, receive a confirmation prompt in Magmaro, confirm the link on the website, and then the bot handles the role synchronisation on the Discord side without further manual steps.

Creator servers connected through the creator dashboard can have buyer roles synced automatically for their customers. Magmaro evaluates which resource roles each guild member should have based on their purchase or ownership state relative to the creator's listings, and the bot applies or removes those roles in the connected guild accordingly. This eliminates the need for manual role management by creators or moderators.

On the official Magmaro server, the bot also handles welcome and farewell messages through configurable admin channels, delivered as embeds with profile-context information. These messages are sent when users join or leave the server and are configurable through the server's bot management settings.