Public release notes

Changelog

Updates for reforgermods.net, the Reforger Mods API, mod browser, server tools, caching behavior, and documentation.

v2.3.0

Planning Tools Rebuilt

Latest

The Storage Planner, Dependency Blockers, and Hosting Calculator have been rebuilt on one shared interface, and the Storage Planner now answers the question people actually ask it.

Added

  • Storage Planner: two clearly separated lists, Currently installed and Wish to install, with the current total, additional storage needed, projected library, and free space remaining shown side by side as you edit.
  • Storage budget is now optional and off by default, with quick amounts and a "match my current install" option derived from your own resolved mod sizes. No invented per-platform storage limits are presented as device profiles.
  • Over-budget guidance: when a plan does not fit, the planner ranks deletion candidates by how safe they are to remove, with the space each frees, a running total, and the row that first clears the budget.
  • A mod that other mods in your plan require is listed with an explicit warning naming what would break, and its bytes are excluded from the running total, so a suggested cleanup never depends on breaking a dependency. Where dependency data could not be read, the mod is marked unverified rather than assumed safe.
  • Dependency Blockers can now analyse several mods at once. Removing a set is a different question from removing each mod on its own: a mod that only breaks because another mod in the same set requires it is not a blocker when both go together, so a framework and everything built on it can be cleared in one step.
  • Dependency Blockers: an optional "draw every mod in the pack" view that places your whole library in the graph, including mods with no relationship to the removal.
  • All three tools share one "Add mods" dialog covering live servers, your Mod Manager list, Workshop search, and config.json upload, with drag-and-drop, per-import removal chips, and lists that survive a page reload.
  • POST /v2/tools/storage-plan accepts mode (replace or add) and includeRemovalImpact, and returns a removal block with ranked deletion candidates and their dependency impact.
  • POST /v2/tools/dependency-analysis accepts targetIds for a whole removal set and includeAll for the full-pack graph, and returns targets, missingTargets, and coveredBySelection.
  • The dependency and hosting endpoints now echo a mods array with the size resolved for each requested mod.

Changed

  • The Storage Planner now treats your wish list as mods to install on top of what you have, not as a replacement for it. Previously it reported everything outside the wish list as removable and could project a library smaller than the one you already had.
  • Long result lists across all three tools now show the rows that answer the question and open into a fixed-height scrolling box, instead of running down the page.
  • The dependency graph is collapsed by default behind "See it visually" and is only drawn once opened. The blocker and orphan lists above it carry the same information as text.
  • Hosting Calculator inputs are split into "Server shape" and "Modpack" tabs, and each resource figure's component breakdown is now its own collapsible card.
  • Mod sizes are resolved once server-side and folded back into your lists, instead of one browser lookup per mod. Unknown sizes are shown as unknown rather than counted as zero.

Fixed

  • The three /v2/tools/ endpoints and their pages are live again after being taken down for this rework.
  • A mod resolved without dependency data could be reused from cache to answer a dependency question, turning "we never looked" into "it requires nothing". Dependency callers now always resolve dependencies.
  • The Storage Planner's budget field was labelled GB while sending GiB; the budget is now sent as exact bytes.
  • Detail cards no longer render in a narrow column on wide screens.

Existing V1 and V2 response contracts are unchanged, and targetId still works for single-mod dependency analysis. The new request and response fields are additions. Hosting estimates remain planning figures built on provisional constants, not vendor specifications.

v2.2.3

Server Browser Data Corrections

Fixed

  • Offline servers now show 0 players, 0 queue, and 0 FPS instead of stale live values in the server browser and public server data.
  • Server browser and detail pages now use clearer online/offline labels and more consistent status handling.
  • Offline server state is now represented more accurately across server list, server detail, and V2 server data.

Public V1 and V2 response schemas are unchanged.

v2.2.1

Planning Tools API and UI Refresh

Added

  • Published the three planning calculators as a free public API: POST /v2/tools/hosting-estimate, POST /v2/tools/storage-plan, and POST /v2/tools/dependency-analysis. No API key required. Documented in the API reference.
  • Mod basket: search clears automatically after a mod or server is added, and tabs compact once a modpack is loaded, which reducess clutter across all three planning tools.

Changed

  • Storage Planner layout changed to a sequential step flow (stacked baskets, available-storage field moves to the analyze row) for a clearer input order.
  • Dependency Blockers: the raw Workshop-ID paste field is now hidden by default behind a toggle link, keeping the mod-select dropdown as the primary target.
  • Hosting Calculator: modpack card description shortened; mod-count slider hides when a real modpack is loaded.
  • Live player roster temporarily removed while the data source is being reworked. Server online/offline status and mod lists are unaffected.

Fixed

  • Server count query now uses index-covered reads so an unavailable table page cannot block the status check.
  • Breakdown tables in the Hosting Calculator no longer overflow horizontally on narrow columns; column widths are now fixed percentages.
  • Storage Planner now accepts a current-only modpack (no desired set) to show a breakdown of what is already installed.

API contracts for existing V1 and V2 endpoints are unchanged. The three new /v2/tools/ endpoints are additions.

v2.2.0

Live Server Browser and Public Server API

Added

  • Added the live Arma Reforger server browser with search, platform filters, ping-region filters, online/offline filtering, player counts, queues, scenario artwork, player history, and exact reported server mod versions.
  • Added public V2 server endpoints for server snapshots, server details, reported server mods, activity history, mod history, and ping-site metadata.
  • Added crawlable server detail pages so individual servers can have canonical URLs, metadata, activity summaries, reported mods, and API-backed hydration.
  • Added the ReforgerMods Discord support server for support, contact, reports, feature requests, API questions, and release feedback.

Changed

  • Repositioned the homepage and server-browser metadata around live Arma Reforger online server discovery, exact server mod lists, Workshop metadata, and the public API powering the site.
  • Updated structured data and footer links so support and contact routes are clearer across the public website.

This release expands V2 with server-list data while keeping existing V1 and V2 mod API response contracts compatible.

v2.1.5

Guide Expansion and API Usage

Added

  • Added a scenarios and scenario IDs guide covering the {GUID}Missions/....conf format, base-game versus modded scenarios, discovering IDs with -listScenarios and mod pages, and setting game.scenarioId.
  • Added a "Built with the Reforger Mods API" section to the landing page that credits real community projects using the public API, starting with Old Guard Revival and the 55th MEU. It is data-driven, so verified integrations can be added without markup changes.

Changed

  • Expanded the mod dependencies guide with how the server resolves the full mod set, transitive dependencies, download-size impact, version considerations, and troubleshooting for missing dependencies.
  • Added contextual internal links between the config, dependencies, mods, and scenarios guides so the guides read as a connected knowledge base.

This is a documentation and website release. Public V1 and V2 API schemas are unchanged. Guides link out only to official Bohemia Interactive resources.

v2.1.4

Crawlable Mod Detail Pages and Sitemap

Changed

  • Mod detail pages now render the real mod name, author, version, download size, last-updated date, dependencies, and scenarios directly in the HTML, so the page has a unique title, meta description, and heading before any JavaScript runs. Pages with no cached metadata yet fall back to the previous generic layout, which the browser then hydrates.
  • Dependencies listed on a mod page now link to their own detail pages on this site, and scenarios are listed with their gamemode, building an internal link graph across related Workshop mods.
  • The sitemap now includes every indexed mod detail page using the Workshop last-updated date as its lastmod signal, alongside the existing tool, guide, and reference pages.
  • Homepage, footer, and social metadata were rebalanced to position reforgermods.net as a broader platform spanning mods, server tools, Workshop data, guides, and the developer API, rather than an API alone.

This is a website and SEO release. Public V1 and V2 API schemas are unchanged.

v2.1.3

V2 Version Detail Error Handling

Fixed

  • Fixed an issue where GET /v2/mods/{id}/versions/{version} could return 503 UPSTREAM_UNAVAILABLE for a version that does not exist because the upstream Workshop API returns 500 for unknown historical versions.
  • V2 version-detail requests now validate the requested version against the authoritative parent mod versions list before calling the upstream version-detail endpoint.
  • Nonexistent versions now return 404 VERSION_NOT_FOUND, while confirmed existing versions still return 503 UPSTREAM_UNAVAILABLE if the Workshop version-detail endpoint is genuinely unavailable.

This is a backwards-compatible reliability fix. V1 version endpoints and successful V2 response schemas are unchanged.

v2.1.2

Mod Browser Performance and Reliability

Changed

  • Improved mod browser search responsiveness for faster typing, filtering, sorting, and pagination.
  • Reduced loading flicker by keeping current mod results visible while new searches load.
  • Improved mod detail page loading so the main mod information appears sooner.
  • Made mod browser pages more reliable when Workshop data is slow or temporarily unavailable.
  • Malformed Workshop mod ID lookups now fail faster with a clear 400 response.

This release does not change V1 or V2 public API response contracts.

v2.1.0

V2 Frontend Mod Browser

Changed

  • Moved the public mod browser list, search, pagination, tag filters, exact-ID lookup, and official Workshop links onto the V2 mod endpoints.
  • Updated mod browser result cards to use V2 fields such as imageUrl, sizeFormatted, numeric rating, subscriberCount, workshopUrl, and preview version.
  • Expanded the browser sort control to expose all public V2 sort values and aligned category buttons with V2 tag filtering.

Added

  • Added a V2-powered version browser to public mod detail pages, including version rows and on-demand version-detail/changelog loading from /v2/mods/{id}/versions/{version}.
  • Updated mod detail pages to load V2 dependencies, scenarios, versions, and license subresources directly.

This release updates the public website tooling. Existing V1 API endpoints remain supported.

v2.0.0

V2 Mod API

Added

  • Added the V2 public API surface under /v2, including mod list/search, detail, version history, health, rate-limit, and refresh-job routes.
  • Added plural V2 mod routes: GET /v2/mods, GET /v2/mods/{id}, GET /v2/mods/{id}/versions, GET /v2/mods/{id}/versions/{version}, GET /v2/mods/{id}/dependencies, GET /v2/mods/{id}/scenarios, and GET /v2/mods/{id}/license. List pages and search use query parameters on /v2/mods.
  • V2 mod fields use machine-native values: raw byte sizes, IEC sizeFormatted, numeric ratings, RFC3339 timestamps, flattened tags, and lower-camel links.
  • V2 detail responses include additional official Workshop metadata such as author ID, rating count, subscriber count, visibility flags, version ID, description, license, obsolete state, screenshots, version counts, dependency counts, scenario counts, and direct dependency size totals when available.
  • V2 version, dependency, scenario, and license subresources keep large collections, specific-version changelogs, and license text separate from the normal mod detail response.

Changed

  • V2 no longer exposes upstream blocked state. V1 response shapes remain unchanged.

Documented

  • Added separate V1 and V2 API reference pages, V1-to-V2 migration examples, and clarified that V1 remains supported without response-shape changes.

This is a backwards-compatible public API addition. Existing V1 and deprecated unversioned routes continue to work as before.

v1.5.0

Mod Version History

Added

  • Added GET /v1/mod/{id}/versions for Workshop mod version history in one response.
  • Version rows include the version ID, version string, game version, changelog text, publish and approval status, file size, timestamps, and dependencies when available.

Documented

  • Added examples and field documentation for the new version-history response.

This is a backwards-compatible public API addition. Existing /v1/mod/{id} responses are unchanged and do not include full version history by default.

v1.4.1

Search Query Aliases

Changed

  • Documented query as the preferred search parameter for /v1/search and mod list endpoints.
  • Added compatibility notes for q, search, and s search parameter aliases.

No response schemas changed, and existing search URLs remain supported.

v1.4.0

Daily Request Quotas

Added

  • Added daily request quotas alongside existing per-minute rate limits.
  • Added daily quota headers so clients can see their remaining daily allowance and reset time.
  • Added a dedicated DAILY_QUOTA_EXCEEDED response when a daily limit is exhausted.

Improved

  • Clarified rate-limit and daily-quota behavior for high-volume integrations.
  • Kept existing read endpoint response schemas unchanged.

No existing public API response schemas were changed.

v1.3.0

Subscription Billing and API Keys

Added

  • Developer and Pro monthly API plans are now available from the pricing page.
  • Paid plans include account API keys, higher rate limits, and access to key management.
  • Subscribers can create, name, rotate, and revoke API keys from the account area.
  • Billing, invoices, plan changes, and cancellations can be managed through Stripe.

Security

  • API keys are shown only once after creation.
  • Lost or exposed keys can be revoked and replaced from the account area.

No existing public API response schemas were changed.

v1.2.0

Server Admin Tools

Added

  • Public Arma Reforger mods browser, now available at /mods/, powered by the public API, with search, sorting, pagination, mod detail pages, copy-mod-ID and copy-JSON actions, and correct handling of 202 Accepted refreshes.
  • Config.json tools for server admins: a config validator with local, in-browser JSON and structure checks, a config generator with a form editor, live JSON preview, import/export, and a mod manager for the game.mods array with name resolution, reordering, duplicate detection, and dependency suggestions.
  • Shared working config across tools. Add to Config in the mod browser, the mod manager, and the config generator all edit the same browser-only draft.
  • API quickstart page and new guides for config.json, adding mods, troubleshooting, running server mods, API integration, and refresh jobs.
  • API documentation now includes client identity guidance, conditional request examples, and complete code examples in curl, JavaScript, and Go.
  • Inline Workshop mod search inside the config generator and mod manager.
  • JSON syntax highlighting in the config validator editor and generator live preview.

Changed

  • Homepage now presents both the API and the server-admin tools.
  • Site navigation includes the tools and guides sections.
  • Tool pages use a full-width desktop layout with refreshed colors and spacing.
  • Common mod lists, searches, and mod detail pages are more reliable when Workshop data is slow or temporarily unavailable.

No API endpoint, response-schema, or integration changes. The deprecated unversioned API aliases remain untouched.

v1.1.3

Workshop Link Fixes

Fixed

  • Fixed broken image, mod, dependency, and scenario links when Workshop data used a mix of relative and absolute URLs.
  • Improved handling for Workshop-hosted and CDN-hosted media links.

No API endpoint, response-schema, or integration changes are required.

v1.1.2

Scenario Metadata Fixes

Fixed

  • Fixed scenario entries that could be returned without scenario IDs.
  • Fixed scenario entries that could be returned without player counts.

No API endpoint, response-schema, or integration changes are required.

v1.1.1

Scenario Data Reliability

Fixed

  • Improved handling for unexpected Workshop scenario data.
  • Returned clearer errors when Workshop data is temporarily unavailable.

No API endpoint, response-schema, or integration changes are required.

v1.1.0

Resilient Refreshes

Improved reliability when Arma Reforger Workshop pages are slow or temporarily unavailable.

Changed

  • Cached API responses now return immediately where possible.
  • Stale cached data can be served while the API refreshes it in the background.
  • Uncached requests may return 202 Accepted while fresh Workshop data is being prepared.
  • Added refresh-job status URLs for integrations that want to show loading progress.
  • Added clearer cache, retry, and rate-limit response headers.

Integration Note

Clients should continue handling normal 200 OK responses as before. When an uncached resource returns 202 Accepted, wait for Retry-After and retry the original URL. Polling the Location job URL is optional.

Fixed

  • API requests respond more consistently when Workshop data is slow to update.
v1.0.0

Release

v1.0.0 marks the public return of reforgermods.net and the Reforger Mods API after a period offline.

Earlier iterations of the project are retired and are not compatible with this release. This version establishes the current API foundation and public documentation.

Included

  • Read-only versioned /v1 API routes for health checks, mod lists, search, and mod details.
  • Cached normalized Arma Reforger Workshop metadata.
  • Anonymous public rate limiting.
  • Stale-cache fallback for safe read endpoints when official Workshop data is slow or temporarily unavailable.
  • Controlled JSON error envelopes with request IDs for support and debugging.
  • Public documentation for API routes, caching behavior, limits, and supported usage.

Notes

  • This is an independent, unofficial project and is not affiliated with or endorsed by Bohemia Interactive.
  • Workshop data is cached and may not always reflect the latest official Workshop changes immediately.
  • New integrations should use the versioned /v1 routes.