# Taitools common configuration settings

This file describes configuration settings for Taitools that are common to
all games.

Keyboard binding settings use
[Virtual-Key Codes](https://docs.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes).

For Raw Input, you're on your own for now.

## `[clock]`

Controls hooks for Windows time-of-day APIs.

### `timezone`

Default: `1`

Make the system time zone appear to be JST. SEGA games malfunction in strange
ways if the system time zone is not JST. There should not be any reason to
disable this hook other than possible implementation bugs, but the option is
provided if you need it.

### `timewarp`

Default: `0`

Experimental time-of-day warping hook that skips over the hardcoded server
maintenance period. Causes an incorrect in-game time-of-day to be reported.
Better solutions for this problem exist and this feature will probably be
removed soon.

### `writeable`

Default: `0`

Allow game to adjust system clock and time zone settings. This should normally
be left at `0`, but the option is provided if you need it.

## `[dns]`

Controls redirection of network server hostname lookups

### `default`

Default: `localhost`

Controls hostname of all of the common network services servers, unless
overriden by a specific setting below. Most users will only need to change this
setting. Also, loopback addresses are specifically checked for and rejected by
the games themselves; this needs to be a LAN or WAN IP (or a hostname that
resolves to one).

### `router`

Default: Empty string (i.e. use value from `default` setting)

Overrides the target of the `tenporouter.loc` and `bbrouter.loc` hostname
lookups.

## `[jvs]`

Configure emulation of the iDMAC JVS port (usually the reader, NOT IO! For IO, see the FastIO section)

### `enable`

Default `1`

Enable JVS port emulation. Disable to use the JVS port on a real iDMAC card.

## `[fastio]`

Configure emulation of the iDMAC FastIO ports

### `enable`

Default `1`

Enable FastIO port emulation. Disable to use the JVS port on a real iDMAC card.

## `[netenv]`

Configure network environment virtualization. This module helps bypass various
restrictions placed upon the game's LAN environment.

### `enable`

Default `1`

Enable network environment virtualization. You may need to disable this if
you want to do any head-to-head play on your LAN.

Note: The virtualized LAN IP range is taken from the emulated keychip's
`subnet` setting.

### `addrSuffix`

Default: `11`

The final octet of the local host's IP address on the virtualized subnet (so,
if the keychip subnet is `192.168.32.0` and this value is set to `11`, then the
local host's virtualized LAN IP is `192.168.32.11`).

### `routerSuffix`

Default: `1`

The final octet of the default gateway's IP address on the virtualized subnet.

### `macAddr`

Default: `01:02:03:04:05:06`

The MAC address of the virtualized Ethernet adapter. Used in nesica auth.

## `[vfs]`

Configure Windows path redirection hooks.

### `enable`

Default: `1`

Enable path redirection.

### `amfs`

Default: Empty string (causes a startup error)

Configure the location of the SEGA AMFS volume. Stored on the `E` partition on
real hardware.

### `appdata`

Default: Empty string (causes a startup error)

Configure the location of the SEGA "APPDATA" volume (nothing to do with the
Windows user's `%APPDATA%` directory). Stored on the `Y` partition on real
hardware.

### `option`

Default: Empty string

Configure the location of the "Option" data mount point. This mount point is
optional (hence the name, probably) and contains directories which contain
minor over-the-air content updates.

## `[idmac]`
### `dipsw_override`

Default: 0

Weather the value of `dipsw` will override the dipswitch value set by the DLL. 
Only useful for debugging. Leave disabled.

### `dipsw`

Default: 0

Controls the value of the 4-switch dipswitch on the DMAC's daughter board. Each
bit is one of the switches, with LSB being switch 1. Ignored if `dipsw_override` 
is 0.

### `hook_dll`

Default: 0

If 1, hook the iDmacDrvxx.dll functions, otherwise create a fake device. Set to
1 if you're using the stub included with this hook as a substitute for the real
DLL. Both hooking methods lead to the same place, so it doesn't matter too much
what you use.

## `[cert]`
### `enable`

Default: 1

If 1, hooks functions related to server and client certificate processing.

### `path`

Default: ``

Path to a certificate file in either PEM or P12/PFX format that contains the client cert 
to be used for mTLS. Leave this blank to disable mTLS, if the server you're connecting 
to supports it.