> For the complete documentation index, see [llms.txt](https://docs.ohalee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ohalee.com/products/playerdatahistory/configuration.md).

# Configuration

```yaml
#  Remote databases
#   - MariaDB
#
#  Don't require any extra configuration
#   - H2
storage-method: h2

entry:
  flush-interval: 30 # (in seconds)
  flush-min-size: 0
  console-log: false

# A list of commands that should be ignored by the plugin.
ignored-commands:
  - "register"
  - "login"
  - "setblock"
  - "minecraft:setblock"
  - "fill"
  - "minecraft:fill"

# ONLY FOR SPIGOT, PAPER, BUKKIT
server-name: 'survival-1'

# The following block defines the settings for remote database storage methods.
data:
  address: localhost
  database: minecraft
  username: root
  password: ''

  pool-settings:
    maximum-pool-size: 5
    minimum-idle: 5
    maximum-lifetime: 1800000 # 30 minutes
    keepalive-time: 0
    connection-timeout: 5000 # 5 seconds
    properties:
      useUnicode: true
      characterEncoding: utf8

  table-prefix: 'datahistory_'
```

## Key reference

<table><thead><tr><th width="230">Key</th><th>Description</th></tr></thead><tbody><tr><td>storage-method</td><td><code>h2</code> (embedded, no setup) or <code>mariadb</code> (remote)</td></tr><tr><td>entry.flush-interval</td><td>How often buffered actions are written to the database, in seconds</td></tr><tr><td>entry.flush-min-size</td><td>Minimum number of buffered actions before a flush occurs</td></tr><tr><td>entry.console-log</td><td>Whether to also log actions to the server console</td></tr><tr><td>ignored-commands</td><td>Commands that are never logged (useful for hiding <code>/login</code>, <code>/register</code>, etc.)</td></tr><tr><td>server-name</td><td>The name reported for this server in server-switch logs. <strong>Bukkit/Spigot/Paper only</strong></td></tr><tr><td>data.*</td><td>Address, database, credentials and connection-pool settings used by MariaDB</td></tr><tr><td>data.table-prefix</td><td>Prefix applied to every database table</td></tr></tbody></table>

{% hint style="warning" %}
`storage-method`, the `data.*` connection settings, `data.table-prefix` and `entry.flush-interval` are **not** reloadable — changes to them only apply after a full server restart.
{% endhint %}