Sword of Moonlight Extension Library/adjust extensions

blackened_tint

Introduced around 1.1.1.5, this extension replaces the colour of the black tint that is a backdrop for text and menus. The default value is 80000000, or half black. Note that there is a second black tint the is applied over the first black tine. Refer to #blackened_tint2. Values are limited to hexadecimal colour codes.

blackened_tint2

Introduced around 1.1.1.5, this extension replaces the colour of the second layer of black tint. Refer to #blackened_tint. The default value is 64000000, or 100/255 (about a third) black. Note that this is the tint that is used by #do_pause when the game is paused. Values are limited to hexadecimal colour codes.

blue_flash_tint

Introduced around 1.1.1.5, this extension replaces the colour of the blue flash that is triggered by in game events. The default value is ff0000ff, or pure blue. Note that the flash begins fully opaque and then tails off. The blending mode is not based on the alpha component, but the colour is divided by the alpha component as a courtesy, and if the colour is fully transparent, the flash will not appear. Values are limited to hexadecimal colour codes.

bob_distance_multiplier

Introduced around 1.0.0.1, this extension multiplies the walking effect(s) experienced by the player. Values are limited to real numbers.

A multiplier of -1 is generally recommended in order to invert the bob effect. Does not apply to #do_bob. In reality when people walk the eye level does not gain any height, and a negative effect ensures the player will not be able to see anything that they shouldn't by bobbing up over visual obstacles.

Sword of Moonlight's bob effect is quite eccentric. 0.075 meters, just shy of 3 inches. Not so implausible for a mad dash, but you will probably want to tone this down in your game. Consider #do_sway and #sway_distance_multiplier while you are at it.

draw_distance_multiplier

Introduced around 1.0.0.1, this extension multiplies the draw distance uniformly across maps. Values are limited to positive real numbers.

fog_pullback_factor

Introduced around 1.0.0.1, this extension pulls the fog to the player as the value approaches 1. It is then averaged with #fog_pushback_factor to determine where fog will begin. Values are limited to real numbers.

fog_pushback_factor

Introduced around 1.0.0.1, this extension pushes the fog away from the player arriving at the draw distance when the value reaches 1. It is then averaged with #fog_pullback_factor to determine where fog will begin. Values are limited to positive real numbers.

fog_saturate_multiplier

Introduced around 1.0.0.1, this extension multiplies the distance at which fog becomes fully saturated. Values are limited to positive real numbers.

fov_frustum_multiplier

Introduced around 1.1.1.5, this extension multiplies the horizontal angle of what is visible to Sword of Moonlight in game. It can be game dependent, but you may need to increase this (from 1) to create gutters along the sides of the field of vision if you notice map tiles disappearing (along the sides) especially when moving quickly with analog controls. Generally the higher the turn speed the more you might need to lean on this. Note that this is not a fix for problems of this nature in widescreen mode. See #do_fix_fov_in_memory (or #do_fix_any_trivial) in that case. Values are limited to real numbers.

This can also be a means to work with map tiles that have "eaves" far outside of 2x2 meters (the natural size of a single tile) however generally speaking this is not recommended in terms of best practices.

green_flash_tint

Introduced around 1.1.1.5, this extension replaces the colour of the green flash that is triggered by in game events. The default value is ff00ff00, or pure green. Note that the flash begins fully opaque and then tails off. The blending mode is not based on the alpha component, but the colour is divided by the alpha component as a courtesy, and if the colour is fully transparent, the flash will not appear. Values are limited to hexadecimal colour codes.

pov_baseline_in_meters

Introduced around 1.0.0.1, this extension adds to the player's eye level -- as of 1.0.0.1 arms are not yet adjusted accordingly. This is fixed in 1.1.1.5. Note that this extension does not change the height of the player in terms of passing beneath obstacles for example.. Values are limited to real numbers.

pov_baseline_in_meters was originally setup for Trismegistus (which does away with combat elements) and therefore the arm thing funnily enough was not a problem. Nevertheless the arms are an oversight. Arms work in 1.1.1.5.

red_flash_tint

Introduced around 1.1.1.5, this extension replaces the colour of the red flash that is triggered by in game events. The default value is ffff0000, or pure red. Note that the flash begins fully opaque and then tails off. The blending mode is not based on the alpha component but the colour is divided by the alpha component as a courtesy, and if the colour is fully transparent, the flash will not appear. Values are limited to hexadecimal colour codes.

Sword of Moonlight displays this flash if the player character receives damage in order to elicit a sensation of pain from the player. If interested in modulating this effect, refer first to #do_red.

sky_ambience_factor

Absent as of 1.1.1.5. Will be back.

Introduced around 1.0.0.1, this extension colorizes the sky to match the global ambient light at 1. Values are limited to real numbers.

sky_emissive_factor

Absent as of 1.1.1.5. Will be back.

This extension is planned but not yet implemented. It will brighten the sky above 1 and darkens it below 1. It's meant to balance out the colours produced by #sky_ambience_factor.

sky_distance_multiplier

Introduced around 1.0.0.1, this extension works like #draw_distance_multiplier, however it only applies to maps with skies. It supersedes draw_distance_multiplier. Values are limited to positive real numbers.

sky_fadeline_multiplier

Introduced around 1.0.0.1, this extension determines a point between the fog saturation distance at 0 and the sky distance at 1 and smoothly blends things beyond that point into the sky. As if the sky is a second layer of fog beyond the first. Values are limited to real numbers between 0 and 1.

Note, the utility is to have your game's skyline blend into the "skybox". The effect itself is quite natural and complements well the way Sword of Moonlight fades NPCs and items into and out of view. It is recommended to use this instead of deploying over ambitious tricks to hide the horizon or resorting to draw distances that are all encompassing.

start_blackout_factor

Introduced around 1.1.1.5, this extension changes the way the title screen options are masked. As the value approaches 1 the transparency effect is replaced by a darkening effect. This is especially useful if the title screen is not a flat colour behind the text. Note that as of 1.1.1.5 the title screen elements, pushstart.bmp etc., have black pixels knocked out like every other texture. Values are limited to real numbers.

If you are considering your options. It is recommended that you first see if #do_start is implemented or not (it is not as of 1.1.1.5) and use that if so. It simply uses text in place of images. Text is much less work for translators to deal with. It is not clear how or if start_blackout_factor will interplay with do_start.

sway_distance_multiplier

Introduced around 1.1.1.5, this extension multiplies the horizontal sway walking effect supplied by #do_sway. Note that the "sway" itself is initially equal in magnitude to the vertical "bob" effect. Refer to #bob_distance_multiplier. Values are limited to real numbers.

An author or player may want to tweak this if they decide that it is more realistic to move more (or less) horizontally (side to side) than vertically when walking.