Mystery Boxes

HM_Settings_Mystery_Boxes

ServerProfile\Hunter_Mods\HM_Mystery_Boxes\HM_Settings_Mystery_Boxes.json

General

webhookUrl

Default "https://discord.com/api/webhooks/YOUR_..."

Your Discord webhook link. A message is posted every time someone wins. Leave the YOUR_DISCORD placeholder (or empty) to turn Discord off.

showBlueWin

Default 0

Set to 1 to post to Discord when someone wins a Common (blue) item. Set to 0 to stay quiet for Common wins.

showGreenWin

Default 0

Set to 1 to post to Discord when someone wins an Uncommon (green) item. Set to 0 to stay quiet.

showRedWin

Default 1

Set to 1 to post to Discord when someone wins a Rare item. Set to 0 to stay quiet.

showPinkWin

Default 1

Set to 1 to post to Discord when someone wins an Epic item. Set to 0 to stay quiet.

showGoldWin

Default 1

Set to 1 to post to Discord when someone wins a Legendary item. Set to 0 to stay quiet.

showPlayerName

Default 1

Set to 1 to put the player's name in the Discord message. Set to 0 to keep it anonymous.

showBoxPosition

Default 1

Set to 1 to add the box's map coordinates to the Discord message. Set to 0 to hide where it happened.

showReward

Default 1

Set to 1 to name the won item in the Discord message. Set to 0 to hide what was won.

thumbnailUrl

Default "https://utfs.io/f/2s7q5UpamTQc59HVPkKV..."

Link to a small image shown in the corner of the Discord message. Leave empty for no image.

titleTemplate

Default "{player} opened a Mystery Box"

The top line of the Discord message. Placeholders: {player}, {reward}, {qty}, {rarity}.

descriptionTemplate

Default "Won **{reward}** x{qty} - {rarity}"

The body line of the Discord message. Placeholders: {player}, {reward}, {qty}, {rarity}.

lockTimeoutSec

Default 60

How many seconds a box stays reserved for one player after they interact with it, in case they never finish. After that, someone else can use it.

Rarities

The rarity ladder. Every reward is tagged with one of these.

rarity

Default "BLUE"

Internal name of the tier (BLUE, GREEN, RED, PINK, GOLD). The loot file points each item at one of these. Don't rename these.

displayName

Default "Common"

The label players see on the reveal card (Common, Uncommon, Rare, Epic, Legendary). Change the words freely.

weight

Default 60

How likely this tier is, compared to the others. Higher = more common. The five weights add up and each tier's share is its slice of the total (60/25/10/4/1 = 60% Common down to 1% Legendary).

color

Default "#3f8cff"

The tier's colour (hex), used for the bar under each reel tile, the reveal glow, and the Discord message colour.

HM_Loot_Mystery_Boxes

ServerProfile\Hunter_Mods\HM_Mystery_Boxes\HM_Loot_Mystery_Boxes.json

General

id

Default "REWARDS"

Internal name of the reward pool. Leave as is.

displayName

Default "Rewards"

A label for the pool.

Items

Every possible reward the box can give.

classname

Default "Derringer_Grey"

The item's classname (any item in the game or another mod).

rarity

Default "BLUE"

Which tier this item belongs to. Must match one of the rarity names in the settings file (BLUE, GREEN, RED, PINK, GOLD). Sets how rare it is to win and its colour.

quantity

Default 1

How many of this item the player gets. 0 means 1.

amount

Default 0

How full each item is: bullets for ammo and magazines, how many in a stack, or % for kits, food, drinks and batteries. Set to 0 for full.

attachments[]

Default []

Classnames that come attached to it: a magazine loaded in the gun, an optic on the rail, a suppressor, and so on. Anything that can't attach goes into the reward.

Economy files

types.xml13 lines
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<types>
    <type name="HM_Mystery_Box">
        <nominal>30</nominal>
        <lifetime>14400</lifetime>
        <restock>0</restock>
        <min>15</min>
        <quantmin>-1</quantmin>
        <quantmax>-1</quantmax>
        <cost>100</cost>
        <flags count_in_cargo="0" count_in_hoarder="0" count_in_map="1" count_in_player="0" crafted="0" deloot="0"/>
    </type>
</types>