> For the complete documentation index, see [llms.txt](https://changelog.matrixemulator.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changelog.matrixemulator.com/welcome/server/muserver/gameserver/data/custom.md).

# Custom

## GameServerInfo - Custom.dat

Global operational switches for custom server-side features. Most configurations here dictate the binary activation or basic parametrization of individual files located within the `Data\Custom\` directory, which contain their own structural data tables.

### Chaos Machine Global Announcements

| **Key**          | **What it is**                                                                                                                                                                                                                           |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AnnounceChaosMix | `0` = Disabled. `1` = Broadcasts success/failure notifications exclusively to characters within the physical proximity of the Chaos Machine interface. `2` = Globally broadcasts notifications across the entire active server instance. |
| AnnounceMixLevel | The baseline item refinement tier that triggers the announcement routine: `0` = From +10 onward (announces +10 to +15 achievements). `5` = Triggers exclusively for +15 refinement outcomes.                                             |

### Custom Arena

| **Key**                        | **What it is**                                                                                                        |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| CustomArenaSwitch              | `0`/`1` — Toggles the operational state of the custom arena script infrastructure (refer to `CustomArena.txt`).       |
| CustomArenaVictimScoreDecrease | Structural score value deducted from a character upon suffering a PvP death within the custom arena boundaries.       |
| CustomArenaKillerScoreIncrease | Structural score value awarded to an attacking character upon securing a PvP kill within the custom arena boundaries. |

### Custom Event Drops

| **Key**               | **What it is**                                                                                             |
| --------------------- | ---------------------------------------------------------------------------------------------------------- |
| CustomEventDropSwitch | `0`/`1` — Toggles the operational state of the custom event drops engine (refer to `CustomEventDrop.txt`). |

### Custom Store (Persistent Offline Personal Shops)

| **Key**                    | **What it is**                                                                                                                                                     |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| CustomStoreTime\_AL0 – AL3 | Maximum operational session longevity limits associated with custom trading storefront commands, sorted by account tier classification. `0` = Infinite duration.   |
| CustomStoreOfflineGPGain   | `1` = Prompts the server engine to continuously distribute Goblin Points to the character container even after the client socket disconnects (Offline Store mode). |

### Custom Attack (Server-Side Automated Combat)

An autonomous server-side combat engine that simulates active farming loops for the character directly inside the GameServer process. It sustains automated combat, buff rotation refreshes, automated reset processing, and point allocation workflows independently of the standard client-side MU Helper engine.

<table data-header-hidden data-search="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Key</strong></td><td><strong>What it is</strong></td></tr><tr><td>CustomAttackTime_AL0 – AL3</td><td>Hard session execution time limit for the automated engine, sorted by account classification tier. <code>0</code> = Unrestricted execution.</td></tr><tr><td>CustomAttackDelay</td><td>Mandatory timing buffer measured in milliseconds separating successive automated skill deployment packets.</td></tr><tr><td>CustomAttackAutoPotionDelay</td><td>Mandatory timing buffer measured in milliseconds separating successive automated potion usage packets.</td></tr><tr><td>CustomAttackAutoBuff_AL0 – AL3</td><td><code>1</code> = Enables automated support skill and buff refresh routine sequences, sorted by account tier classification.</td></tr><tr><td>CustomAttackAutoBuffDelay</td><td>Cooldown timing loop in milliseconds governing the systematic redeployment of automated character buffs.</td></tr><tr><td>CustomAttackAutoResume_AL0 – AL3</td><td><code>1</code> = Directs the server engine to instantly re-initialize the automated combat routine upon processing a client reconnection sequence, sorted by account classification.</td></tr><tr><td>CustomAttackCanBeSummoned_AL0 – AL3</td><td><code>1</code> = Permits characters operating under active server-side automation routines to be targeted and displaced by the Dark Lord <code>/call</code> summon skill, sorted by account classification.</td></tr></tbody></table>

### Custom Attack Offline

| **Key**                   | **What it is**                                                                                                                                          |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CustomAttackOfflineGPGain | `1` = Command sequences leveraging background offline execution formats will continuously accumulate systemic Goblin Point payloads while disconnected. |

### Custom Online Lottery

| **Key**                   | **What it is**                                                                                                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CustomOnlineLotterySwitch | `0`/`1` — Toggles the automated world lottery selection cycle (refer to `CustomOnlineLottery.txt`).                                                                       |
| CustomOnlineLotteryNoOff  | `1` = Instructs the selection filter to strip out characters operating under offline storefront or offline attack flags from the pool of valid lottery ticket candidates. |

### Custom Quest System

| **Key**                     | **What it is**                                                                                                                                                                                                    |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CustomQuestSwitch           | `0`/`1` — Toggles execution of the custom script-driven progression quest framework (refer to `CustomQuest.txt`).                                                                                                 |
| CustomQuestSaveLevelUpPoint | `1` = Directs the engine to store unallocated attribute point rewards safely inside unassigned free-point banks rather than forcing immediate direct injection into character attribute structures on completion. |

### Custom RankUser Interface

| **Key**                    | **What it is**                                                                                                                                                                                                                |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CustomRankUserSwitch       | `0`/`1` — Toggles the custom tier bracket tracking system overlay interface (refer to `CustomRankUser.txt`).                                                                                                                  |
| CustomRankUserType         | Structural sorting parameters mapping tier progressions: `0` = Sorts by Reset metrics. `1` = Sorts by Master Reset parameters. `2` = Sorts by an additive evaluation formula combining Standard Level + Master Level metrics. |
| CustomRankUserRewardSwitch | `1` = Automates token or currency distribution payloads to the player container immediately upon crossing into a new tier boundary (refer to `CustomRankUser.txt`).                                                           |
| CustomRankUserNoticeToAll  | `1` = Broadcasts an instance-wide system alert notice across the global server layer whenever a player advancements to a new rank tier.                                                                                       |
| CustomRankUserNoticeToUser | `1` = Restricts the confirmation alert notification directly to the specific player interface.                                                                                                                                |

### Custom Death Messages

| **Key**                  | **What it is**                                                                                                                        |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| CustomDeathMessageSwitch | `0`/`1` — Toggles custom localized text layout distributions for structural PvP/PvE death events (refer to `CustomDeathMessage.txt`). |

### Custom Quiz System

| **Key**          | **What it is**                                                                             |
| ---------------- | ------------------------------------------------------------------------------------------ |
| CustomQuizSwitch | `0`/`1` — Toggles the automated trivia quiz server loop cycle (refer to `CustomQuiz.txt`). |

### Custom NPC Item Collector

| **Key**                  | **What it is**                                                                                                                        |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| CustomNpcCollectorSwitch | `0`/`1` — Toggles item hand-in recycling interactions via specified environmental collector NPCs (refer to `CustomNpcCollector.txt`). |

### Custom In-Game Rankings Panel (F8)

| **Key**             | **What it is**                                                                                                                                    |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| CustomRankingSwitch | `0`/`1` — Grants client-side visualization access mapping live rank leaderboards bound to the F8 hotkey interface (refer to `CustomRanking.txt`). |

### Custom Event Timers Interface (F7)

| **Key**               | **What it is**                                                                                              |
| --------------------- | ----------------------------------------------------------------------------------------------------------- |
| CustomEventTimeSwitch | `0`/`1` — Toggles client visualization access mapping schedule countdowns bound to the F7 hotkey interface. |

### Custom Guild Warehouse Vaults

| **Key**              | **What it is**                                                                                                                                                                                                                                                                     |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GuildWarehouseEnable | `0`/`1` — Toggles the structural deployment of shared, cross-account storage vault containers for Guild groups.                                                                                                                                                                    |
| GuildWarehouseStatus | Minimum organizational authority rank validation required to open the shared vault: `0` = Open to all roster members. `32` = Restrained to Battle Masters and above. `64` = Restrained to Assistant Masters and above. `128` = Restricted exclusively to the supreme Guild Master. |

### Custom Store Purchase Confirmation Dialogs

| **Key**              | **What it is**                                                                                                                                                                                                                                                                             |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| CustomShopMessageBox | Restrains safety confirmation checks inside user storefront operations: `0` = Disabled. `1` = Generates a verification popup dialog exclusively for items requiring premium currency tokens (Cash Shop transactions). `2` = Enforces safety confirmation popups across all item purchases. |

### Custom NPC Quest Assignments

| **Key**                        | **What it is**                                                                                                                                                                |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CustomNpcQuestSwitch           | `0`/`1` — Toggles character interaction loops and script targets for bespoke NPC quest nodes (refer to `CustomNpcQuest.txt`).                                                 |
| CustomNpcQuestSaveLevelUpPoint | `1` = Instructs the quest rewards processor to parse attribute rewards directly into free unassigned point allocations, mirroring the logic of `CustomQuestSaveLevelUpPoint`. |

### MU Helper Offline Execution Profiles

<table data-header-hidden data-search="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Key</strong></td><td><strong>What it is</strong></td></tr><tr><td>MuHelperOffEnable</td><td><code>0</code>/<code>1</code> — Core systemic master switch enabling offline execution for the native client-side helper engine.</td></tr><tr><td>MuHelperOffEnable_FREE / VIP1 / VIP2 / VIP3</td><td>Grants offline bot loop validation permissions split across individual account access tiers.</td></tr><tr><td>MuHelperOffTime_FREE / VIP1 / VIP2 / VIP3</td><td>Maximum persistence window duration tracking background offline bot execution loops, sorted by account tier brackets. <code>0</code> = Infinite execution runtime.</td></tr><tr><td>MuHelperOffAutoPick_FREE / VIP1 / VIP2 / VIP3</td><td><code>1</code> = Retains operational access to ground coordinate item scan matrices and automated retrieval patterns while offline, sorted by account tiers.</td></tr><tr><td>MuHelperOffRequireLevel_FREE / VIP1 / VIP2 / VIP3</td><td>Minimum level validation criteria required before registering an offline helper session, split by account tiers.</td></tr><tr><td>MuHelperOffRequireReset_FREE / VIP1 / VIP2 / VIP3</td><td>Minimum reset validation criteria required before registering an offline helper session, split by account tiers.</td></tr><tr><td>MuHelperOffComboDelay_FREE / VIP1 / VIP2 / VIP3</td><td>Fixed delay offset in milliseconds tracking automated spell casting intervals, split by account classification tiers.</td></tr><tr><td>MuHelperOffCanBeSummoned_FREE / VIP1 / VIP2 / VIP3</td><td><code>1</code> = Validates coordinate displacement requests via Dark Lord <code>/call</code> skills targeting offline bot containers, split by account tiers.</td></tr></tbody></table>

### PvP Shield (SD) Damage Suppression

| **Key**             | **What it is**                                                                                                                                                                                                                   |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| DisableShieldDamage | `1` = Strips out absorption filters and calculation passes on the PvP Shield (SD) gauge, routing all prospective incoming damage payloads directly to the primary HP container (effectively deactivates SD utility server-wide). |

### Web Chat Integration (External API Mirroring)

<table data-header-hidden data-search="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Key</strong></td><td><strong>What it is</strong></td></tr><tr><td>ChatWebConnection</td><td><code>0</code>/<code>1</code> — Activates real-time packet mirroring, forwarding live in-game text chat streams to an external remote web server endpoint.</td></tr><tr><td>ChatWebPort</td><td>Target network connection destination port hosted on the external web service.</td></tr><tr><td>ChatWebHost</td><td>Explicit domain network address or destination IP matching the receiving web server API.</td></tr><tr><td>ChatWebPage</td><td>Target path mapping to the server script or endpoint handler configured to accept the incoming JSON/text chat payloads.</td></tr><tr><td>ChatWebKey</td><td>Cryptographic authentication token string or shared secret key validated by the receiving external API.</td></tr><tr><td>ChatWebFail</td><td>Consecutive network response timeout or failure cycles tolerated before the GameServer terminates integration attempt logic.</td></tr></tbody></table>

### Custom Character Starter Kits

| **Key**                    | **What it is**                                                                                                                                                |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CustomStartItem\_AL0 – AL3 | `0`/`1` — Toggles automated starter equipment initialization routines (`CustomStartItem.txt`) upon character creation, split by account classification tiers. |

### Custom Refinement Jewels

| **Key**                          | **What it is**                                                                                                                                                                                                                                                        |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| EnableExcellentJewelRandomOption | `1` = Directs successful custom jewel application loops (`CustomJewel.txt`) to process a random lottery index selection across eligible Excellent options lines, rather than strictly injecting the static default option index declared in the jewel template block. |

### Technical Notes

* Asymmetric Structural Dependency: The vast majority of variables contained inside this configuration file represent simple structural switches (`0` or `1`) pointing toward foundational sub-systems. Detailed attribute modification structures, rule frameworks, item indexes, and payload tables reside explicitly inside their corresponding `.txt` configuration scripts within `Data\Custom\`. Modifying execution behaviors requires data entry adjustments inside those data tables directly.
* Architecture Divergence (Custom Attack vs. MU Helper Offline): These two automation structures function on completely distinct codebases:
  * Custom Attack (`/attack` / `/offattack`): An entirely simulated server-side loop process. It forces character pathfinding, targeting vectors, and automation passes directly within GameServer memory matrices, independent of client-side architecture.
  * MU Helper Offline: The passive background persistence mode of the traditional client-driven helper tool. It takes the parameters established inside the player client interface prior to disconnection and handles the thread within a specialized background structure. They use distinct processing priorities, calculation tolerances, and cooldown timers.
* Web Integration Authentication Constraints: Properties such as `ChatWebKey` and `ChatWebPage` default to placeholder strings (`YOURSECRETKEY`, `yoursite.com`) inside basic delivery presets. These values require absolute synchronization and proper authorization parameters against a live receiving endpoint layout before setting `ChatWebConnection` to `1`. Failure to provide valid properties can trigger connection timeout sequences, causing thread locks within the chat engine if `ChatWebFail` margins are configured poorly.