Loadout API docs

Choose an endpoint for your bot, chat command, or script.

All endpoints below accept GET requests and return JSON. No API key, request body, or query parameters are needed. Successful requests return HTTP 200 with Content-Type: application/json.

Random loadout routes roll on every request. Repeated results are possible. Saved browser settings do not affect the API, and query parameters cannot override these presets.

For OBS browser sources, use the separate overlay endpoint guide.

Random weapons

GET /api/random-loadout

Roll two weapon slots with ammo selections for a standard hunter.

Uses a weapon size budget of 5 with quartermaster set to false. Special ammo and dual wield are allowed; scarce weapons are excluded. Does not include utilities or traits.

Request

                  curl --fail --silent --show-error https://melledorks.com/api/random-loadout

Response fields

Random weapons response fields
Field	Type	Meaning
`weapons`	array	Two weapon slots, each with name, dual, specialAmmo, specialAmmoShell, and specialAmmo2.
`budget`	number	Combined weapon size limit, not a Hunt Dollar budget.
`totalSize`	number	Combined size of the selected weapons, including dual wield.
`quartermaster`	boolean	Whether this roll uses Quartermaster capacity.
`message`	string	A complete description of the roll, ready for a chat reply.

Weapon slot and ammo fields

Each weapon slot has a name string or null for an empty slot, and a dual boolean for dual wield. Ammo fields contain a selected ammo name or null when no special ammo is selected.

specialAmmo is the main selection, specialAmmoShell is the shell selection for split-ammo weapons, and specialAmmo2 is the second selection for weapons with two ammo choices.

Random weapons with Quartermaster

GET /api/random-loadout-quartermaster

Roll weapons and ammo for a hunter who already has Quartermaster.

Uses a weapon size budget of 6 with quartermaster set to true. Special ammo and dual wield are allowed; scarce weapons are excluded. Does not include utilities or traits.

Request

                  curl --fail --silent --show-error https://melledorks.com/api/random-loadout-quartermaster

Response fields

Random weapons with Quartermaster response fields
Field	Type	Meaning
`weapons`	array	Two weapon slots, each with name, dual, specialAmmo, specialAmmoShell, and specialAmmo2.
`budget`	number	Combined weapon size limit, not a Hunt Dollar budget.
`totalSize`	number	Combined size of the selected weapons, including dual wield.
`quartermaster`	boolean	Whether this roll uses Quartermaster capacity.
`message`	string	A complete description of the roll, ready for a chat reply.

Weapon slot and ammo fields

Each weapon slot has a name string or null for an empty slot, and a dual boolean for dual wield. Ammo fields contain a selected ammo name or null when no special ammo is selected.

specialAmmo is the main selection, specialAmmoShell is the shell selection for split-ammo weapons, and specialAmmo2 is the second selection for weapons with two ammo choices.

Random weapons for prestiging

GET /api/random-loadout-prestiging

Roll weapons and ammo using base weapons only, excluding entries with a parent variant.

Uses a weapon size budget of 5 with quartermaster set to false. Special ammo and dual wield are allowed; scarce weapons are excluded. Does not accept a bloodline rank or filter special ammo by unlock rank. Does not include utilities or traits.

Request

                  curl --fail --silent --show-error https://melledorks.com/api/random-loadout-prestiging

Response fields

Random weapons for prestiging response fields
Field	Type	Meaning
`weapons`	array	Two weapon slots, each with name, dual, specialAmmo, specialAmmoShell, and specialAmmo2.
`budget`	number	Combined weapon size limit, not a Hunt Dollar budget.
`totalSize`	number	Combined size of the selected weapons, including dual wield.
`quartermaster`	boolean	Whether this roll uses Quartermaster capacity.
`message`	string	A complete description of the roll, ready for a chat reply.

Weapon slot and ammo fields

Each weapon slot has a name string or null for an empty slot, and a dual boolean for dual wield. Ammo fields contain a selected ammo name or null when no special ammo is selected.

specialAmmo is the main selection, specialAmmoShell is the shell selection for split-ammo weapons, and specialAmmo2 is the second selection for weapons with two ammo choices.

Prestiging weapons with Quartermaster

GET /api/random-loadout-prestiging-quartermaster

Roll base weapons and ammo for a prestiging hunter who has Quartermaster.

Uses a weapon size budget of 6 with quartermaster set to true. Excludes weapons with a parent variant and scarce weapons. Special ammo and dual wield are allowed. Does not accept a bloodline rank or filter special ammo by unlock rank. Does not include utilities or traits.

Request

                  curl --fail --silent --show-error https://melledorks.com/api/random-loadout-prestiging-quartermaster

Response fields

Prestiging weapons with Quartermaster response fields
Field	Type	Meaning
`weapons`	array	Two weapon slots, each with name, dual, specialAmmo, specialAmmoShell, and specialAmmo2.
`budget`	number	Combined weapon size limit, not a Hunt Dollar budget.
`totalSize`	number	Combined size of the selected weapons, including dual wield.
`quartermaster`	boolean	Whether this roll uses Quartermaster capacity.
`message`	string	A complete description of the roll, ready for a chat reply.

Weapon slot and ammo fields

Each weapon slot has a name string or null for an empty slot, and a dual boolean for dual wield. Ammo fields contain a selected ammo name or null when no special ammo is selected.

specialAmmo is the main selection, specialAmmoShell is the shell selection for split-ammo weapons, and specialAmmo2 is the second selection for weapons with two ammo choices.

Full loadout

GET /api/random-full-loadout

Roll weapons, ammo, tools, and consumables without traits.

Allows special ammo and dual wield, excludes scarce equipment, and uses bloodline rank 100. Includes a First Aid Kit and one melee tool, then fills the remaining utility slots. Tools and consumables share eight slots. Weapon capacity is 5, quartermaster is false, and traits is an empty array. The message describes all equipment.

Request

                  curl --fail --silent --show-error https://melledorks.com/api/random-full-loadout

Response fields

Full loadout response fields
Field	Type	Meaning
`weapons`	array	Two weapon slots, each with name, dual, specialAmmo, specialAmmoShell, and specialAmmo2.
`budget`	number	Combined weapon size limit, not a Hunt Dollar budget.
`totalSize`	number	Combined size of the selected weapons, including dual wield.
`quartermaster`	boolean	Whether this roll uses Quartermaster capacity.
`message`	string	A complete description of the roll, ready for a chat reply.
`utilities`	array	Eight utility slots containing item names or null.
`tools`	string[]	Selected tool names. Tools are unique within the loadout.
`consumables`	string[]	Selected consumable names. Names may repeat, with at most four items per category.
`traits`	string[]	Selected trait names, or an empty array for the endpoint without perks.

Weapon slot and ammo fields

Each weapon slot has a name string or null for an empty slot, and a dual boolean for dual wield. Ammo fields contain a selected ammo name or null when no special ammo is selected.

specialAmmo is the main selection, specialAmmoShell is the shell selection for split-ammo weapons, and specialAmmo2 is the second selection for weapons with two ammo choices.

Full loadout with perks

GET /api/random-full-loadout-with-perks

Pick random perks, called traits in the response, before rolling weapons, ammo, tools, and consumables.

Allows special ammo and dual wield, excludes scarce equipment, and uses bloodline rank 100. Includes a First Aid Kit and one melee tool, then fills the remaining utility slots. Tools and consumables share eight slots. Picks up to 15 unique, non-scarce traits within a 10-point budget, continuing until no more fit. Quartermaster raises weapon capacity from 5 to 6 when selected and is not changed after the trait roll. It affects weapons, not utility slots. The message describes equipment and traits.

Request

                  curl --fail --silent --show-error https://melledorks.com/api/random-full-loadout-with-perks

Response fields

Full loadout with perks response fields
Field	Type	Meaning
`weapons`	array	Two weapon slots, each with name, dual, specialAmmo, specialAmmoShell, and specialAmmo2.
`budget`	number	Combined weapon size limit, not a Hunt Dollar budget.
`totalSize`	number	Combined size of the selected weapons, including dual wield.
`quartermaster`	boolean	Whether this roll uses Quartermaster capacity.
`message`	string	A complete description of the roll, ready for a chat reply.
`utilities`	array	Eight utility slots containing item names or null.
`tools`	string[]	Selected tool names. Tools are unique within the loadout.
`consumables`	string[]	Selected consumable names. Names may repeat, with at most four items per category.
`traits`	string[]	Selected trait names, or an empty array for the endpoint without perks.

Weapon slot and ammo fields

Each weapon slot has a name string or null for an empty slot, and a dual boolean for dual wield. Ammo fields contain a selected ammo name or null when no special ammo is selected.

specialAmmo is the main selection, specialAmmoShell is the shell selection for split-ammo weapons, and specialAmmo2 is the second selection for weapons with two ammo choices.

Using the API in automation

For any random loadout endpoint, read message and send it as your chat reply. If your tool accepts a JSON field name or path, use message or $.message as appropriate.

With jq installed, this prints the full loadout message:

curl --fail --silent --show-error https://melledorks.com/api/random-full-loadout-with-perks | jq -r '.message'

JavaScript

async function getLoadoutMessage() {
  const response = await fetch('https://melledorks.com/api/random-loadout')
  if (!response.ok) {
    throw new Error(`Loadout request failed: ${response.status}`)
  }
  const loadout = await response.json()
  return loadout.message
}

console.log(await getLoadoutMessage())

Run this in a server-side bot or a Node.js script with fetch support. Replace the URL with your chosen endpoint. The API does not set cross-origin access headers for browser requests from other sites. Check the HTTP status before reading JSON, and handle network failures in your automation.