Skip to content

Latest commit

 

History

History
317 lines (260 loc) · 13.3 KB

optionflags.md

File metadata and controls

317 lines (260 loc) · 13.3 KB
Raw

Enemizer Options File Format

{
 "RandomizeEnemies": true,
 "RandomizeEnemiesType": 3,
 "RandomizeBushEnemyChance": true,
 "RandomizeEnemyHealthRange": true,
 "RandomizeEnemyHealthType": 1,
 "OHKO": false,
 "RandomizeEnemyDamage": true,
 "AllowEnemyZeroDamage": true,
 "ShuffleEnemyDamageGroups": false,
 "EnemyDamageChaosMode": false,
 "EasyModeEscape": false,
 "EnemiesAbsorbable": false,
 "AbsorbableSpawnRate": 10,
 "AbsorbableTypes": {
   "FullMagic": true,
   "SmallMagic": true,
   "Bomb_1": true,
   "BlueRupee": true,
   "Heart": true,
   "BigKey": true,
   "Key": true,
   "Fairy": true,
   "Arrow_10": true,
   "Arrow_5": true,
   "Bomb_8": true,
   "Bomb_4": true,
   "GreenRupee": true,
   "RedRupee": true
 },
 "BossMadness": false,
 "RandomizeBosses": true,
 "RandomizeBossesType": 0,
 "RandomizeBossHealth": false,
 "RandomizeBossHealthMinAmount": 0,
 "RandomizeBossHealthMaxAmount": 300,
 "RandomizeBossDamage": false,
 "RandomizeBossDamageMinAmount": 0,
 "RandomizeBossDamageMaxAmount": 200,
 "RandomizeBossBehavior": false,
 "RandomizeDungeonPalettes": true,
 "SetBlackoutMode": false,
 "RandomizeOverworldPalettes": true,
 "RandomizeSpritePalettes": true,
 "SetAdvancedSpritePalettes": false,
 "PukeMode": false,
 "NegativeMode": false,
 "GrayscaleMode": false,
 "GenerateSpoilers": true,
 "RandomizeLinkSpritePalette": false,
 "RandomizePots": true,
 "ShuffleMusic": false,
 "BootlegMagic": true,
 "CustomBosses": false,
 "HeartBeepSpeed": 2,
 "AlternateGfx": false,
 "ShieldGraphics": "shield_gfx\normal.gfx",
 "SwordGraphics": "sword_gfx\normal.gfx",
 "BeeMizer": false,
 "BeesLevel": 3,
 "RandomizeTileTrapPattern": true,
 "RandomizeTileTrapFloorTile": false,
 "AllowKillableThief": true,
 "RandomizeSpriteOnHit": true,
 "DebugMode": false,
 "DebugForceEnemy": true,
 "DebugForceEnemyId": 196,
 "DebugForceBoss": false,
 "DebugForceBossId": 4,
 "DebugOpenShutterDoors": false,
 "DebugForceEnemyDamageZero": true,
 "DebugShowRoomIdInRupeeCounter": true
}

RandomizeEnemies (boolean)

Enable enemy randomization.

RandomizeEnemiesType (enum/number)

Requires: RandomizeEnemies
Enemy randomization mode. Must be set to 3 (Chaos) because nothing else is implemented. Possible values:

  • Basic (0)
  • Normal (1)
  • Hard (2)
  • Chaos (3)
  • Insanity (4)

RandomizeBushEnemyChance (boolean)

Requires: RandomizeEnemies
Randomize bush/grass enemy to be one of the possible enemies for a given area. If disabled this will default to guards, but the graphics may be wrong.

RandomizeEnemyHealthRange (boolean)

Enable randomization of enemy health range.

RandomizeEnemyHealthType (enum/number)

Requires: RandomizeEnemyHealthRange
Type of enemy health randomization. Possible values:

  • Easy (1-4 hp)
  • Medium (2-15 hp)
  • Hard (2-30 hp)
  • Patty (4-50 hp)

OHKO (boolean)

Enables OHKO mode with no timer. This was added because OHKO wasn't available in ER for some new mode, but this seems to have been added, so this is probably no longer needed. Note that this should disable RandomizeEnemyDamage and its children.

RandomizeEnemyDamage (boolean)

Enable randomization of enemy damage. Groups stay the same.

AllowEnemyZeroDamage (boolean)

Requires: RandomizeEnemyDamage
Allow enemies to do zero damage (this can cause a softlock with fake flippers).

ShuffleEnemyDamageGroups (boolean)

Requires: RandomizeEnemyDamage
Shuffles the enemy damage groups. Groups cannot be shuffled without also being randomized.

EnemyDamageChaosMode (boolean)

Requires: ShuffleEnemyDamageGroups
Scrambles damage groups and mail upgrade damage reduction. Green mail could be stronger than red mail against certain enemies with this mode enabled. (FYI this is rather broken because it hasn't been tuned and usually makes most mobs OHKO)

EasyModeEscape (boolean)

Currently not implemented.

EnemiesAbsorbable (boolean)

Allow absorbables (from selected types) to spawn in place of enemies.

AbsorbableSpawnRate (number)

Requires: EnemiesAbsorbable
The spawn rate for absorbables instead of enemies (%).

AbsorbableTypes (collection)

Requires: EnemiesAbsorbable
Possible absorbable types. Self-explanitory.

{
    "Heart": true,
    "GreenRupee": true,
    "BlueRupee": true,
    "RedRupee": true,
    "Bomb_1": true,
    "Bomb_4": true,
    "Bomb_8": true,
    "SmallMagic": true,
    "FullMagic": true,
    "Arrow_5": true,
    "Arrow_10": true,
    "Fairy": true,
    "Key": true,
    "BigKey": true
}

BossMadness (boolean)

Unused, depreciated.

RandomizeBosses (boolean)

Enable boss randomization. Pool of possible bosses is created based on the RandomizeBossesType set.

RandomizeBossesType (enum/number)

Requires: RandomizeBosses
Possible values:

  • Basic (0) - Vanilla bosses
  • Normal (1) - GT bosses are randomized in pool
  • Chaos (2) - Boss pool is completely random

RandomizeBossHealth (boolean)

Currently not implemented.

RandomizeBossHealthMinAmount (number)

currently not implemented.

RandomizeBossHealthMaxAmount (number)

Currently not implemented.

RandomizeBossDamage (boolean)

Currently not implemented.

RandomizeBossDamageMinAmount (number)

Currently not implemented.

RandomizeBossDamageMaxAmount (number)

Currently not implemented.

RandomizeBossBehavior (boolean)

Currently not implemented.

RandomizeDungeonPalettes (boolean)

Randomizes palettes used in dungeons.

SetBlackoutMode (boolean)

Requires: RandomizeDungeonPalettes
Sets palettes to completely black in dungeons. Torches, chests, and pots are not blacked out.

RandomizeOverworldPalettes (boolean)

Randomizes palettes used in the overworld.

RandomizeSpritePalettes (boolean)

Randomizes palettes used by sprites (shuffles existing palettes).

SetAdvancedSpritePalettes (boolean)

Requires: RandomizeSpritePalettes
Randomizes palettes used by sprites (randomizes the colors in the palettes).

PukeMode (boolean)

Random palettes... the name says it all.

NegativeMode (boolean)

Inverted palette mode.

GrayscaleMode (boolean)

Grayscale palette mode.

GenerateSpoilers (boolean)

Generate spoilers. Should always be turned on for web.

RandomizeLinkSpritePalette (boolean)

Randomizes Links sprite palette.

RandomizePots (boolean)

Shuffles the contents of pots in a given super room.

ShuffleMusic (boolean)

Shuffles music (can cause hard locks).

BootlegMagic (boolean)

Bootleg Chinese inspired magic (currently just gives Moldorm random number of eyes). This should always be on...just because.

CustomBosses (boolean)

Currently not implemented

HeartBeepSpeed (enum/number)

Heart beep speed. This will override randomizer setting, so make sure they are the same. Possible values:

  • Default (0)
  • Half (1)
  • Quarter (2)
  • Off (3)

AlternateGfx (boolean)

Swaps boss graphics with alternatives (currently only one set is implemented).

ShieldGraphics (string)

Relative string path to the shield graphics file. Should be set to "shield_gfx\\normal.gfx" for race roms.

SwordGraphics (string)

Relative string path to the sword graphics file. Should be set to "sword_gfx\\normal.gfx" for race roms.

BeeMizer (boolean)

Enable Beeeeeeeeeeeees!

BeesLevel (enum/number)

Requires: BeesLevel
Possible values:

  • Bees?? (0) - Replaces Arrows, Bombs, Rupees, Compass, Maps, Arrow Upgrade, and Bomb Upgrades with bee traps
  • Bees! (1) - Same as 0, but also introduces single bees and increases chance of trap.
  • Beeeeees!? (2) - Randomly replaces items not needed to beat the game with bee trap (including: bug net, boomerangs, heart container and heart pieces, magic, shield and armor upgrades).
  • Beeeeeeeeeeeeeeeeeeeees (3) - Always replaces items not needed to beat the game with bee trap (including: bug net, boomerangs, heart container and heart pieces, magic, shield and armor upgrades).

RandomizeTileTrapPattern (boolean)

Enables random tile trap pattern. Pattens are stored in the tiles directory.

RandomizeTileTrapFloorTile (boolean)

Enables "random" tile trap floor replacement tile. Currently this picks from a pool of 1 value (spike floor).

AllowKillableThief (boolean)

Lets you kill those bastards.

RandomizeSpriteOnHit (boolean)

Sets sprite randomization on hit mode on. This requires at least 32 sprite files in the sprites directory.

DebugMode (boolean)

Enables debug options.

DebugForceEnemy (boolean)

Requires: DebugMode
Enable forced enemy debug flag (requires DebugMode to be set).

DebugForceEnemyId (number)

Requires: DebugMode
SpriteId. See enemizer source code, or z3 compendium for list of possible sprites. Do not allow overlord sprites to be selected.

DebugForceBoss (boolean)

Requires: DebugMode
Enable forced boss debug flag (requires DebugMode to be set).

DebugForceBossId (enum/number)

Requires: DebugMode
Possible values:

  • Kholdstare (0)
  • Moldorm (1)
  • Mothula (2)
  • Vitreous (3)
  • Helmasaur (4)
  • Armos (5)
  • Lanmola (6)
  • Blind (7)
  • Arrghus (8)
  • Trinexx (9)

DebugOpenShutterDoors (boolean)

Requires: DebugMode
Causes all shutter doors to be open (requires DebugMode to be set).

DebugForceEnemyDamageZero (boolean)

Requires: DebugMode
Set all enemy damage to zero (requires DebugMode to be set).

DebugShowRoomIdInRupeeCounter (boolean)

Requires: DebugMode
Shows the current roomId in the rupee counter (requires DebugMode to be set).