kv3t

kv3t is a command line utility that converts KeyValues3 files to and from any format or encoding. The utility can also convert KeyValues1 files into KeyValues3. It is available for Windows and Linux.

Supported formats:

• generic

Supported encodings:

• text
• binary
• binary_bc (block-compressed binary)

Supported input files:

• Any KV3 file
• text KeyValues1

Help Text

------------------------------------------------------------------
KV3T - A tool for dealing with KeyValues3 files
KeyValues3 - Copyright (c) Valve Corporation, All rights reserved.
Tool developed by the Strata Source Team
------------------------------------------------------------------
SYNOPSIS
kv3t <input> [options] [-o output]

DESCRIPTION
        Read and convert KeyValues3 ("KV3") files from and to any format. If no output is specified, print to stdout as text.
        KV3 input formats and encoding will be automatically detected.

COMMAND-LINE OPTIONS
        -inh | --input-no-header
                Specify that your input file doesn't have a header. Interpret as 'generic' and 'text', which is not guaranteed to work.
        -ikv1 | --input-is-kv1
                Specify that the input file is in the original KeyValues format ("KV1") and try to convert it.
                Doesn't support advanced conversion rules for now.
        -ikv1es | --input-kv1-escape-sequences
                Enable escape sequence support for KV1 input files.
        --kv1-multiroot
                Enable support for multiple root keys. Needed for sound scripts, VMF, etc.
        -of <FORMAT> | --output-format <FORMAT>
                Request a special KV3 output format. Only 'generic' (default) is supported for now.
        -oe <ENCODING> | --output-encoding <ENCODING>
                Request a special KV3 output encoding when writing to a file. Supports 'text' for plain text (default),
                'binary' for simple binary encoding and 'binary_bc' for block-compressed binary encoding

Usage Examples

Example 1: Convert binary KeyValues3 to text

kv3t myfile.kv3 -oe text myfile_text.kv3

Example 2: Convert text KeyValues3 to binary compressed

kv3t myfile_text.kv3 -oe binary_bc myfile.kv3