Papyrus Ini Manipulator

"Papyrus Ini Manipulator" is a SFSE plugin that adds some Papyrus functions to read and write ini files with correct structure - unique sections within a file, unique keys within a section and so on. Regular ini files in sum. This means other authors are able to save, load and edit their configs outside of ESX plugins using the most simple format ever.

key = value

Brief Overview - Papyrus

-- General --

String Function GetVersion() > returns "1-3-0-0" string.

String Function GetTranslation(String sKey) > returns translation of given sKey, like "$CancelTradeInProgress" > "Cancel trade in progress?"

-- Basic --

Bool Function IniDataExists(Int iLevel, ...) > level-dependent function.

• []iLevel is 0 > returns if file exists on given sPath.[/]

  []iLevel is 1 > returns if section exists on given sPath and sSection.[/]

  []iLevel is 2 > returns if key exists on given sPath and sSection and sKey.[/]

Bool Function ClearIniData(Int iLevel, ...) > level-dependent function. Returns boolean true on success and boolean false on fail.

• []iLevel is 0 > clears file on given sPath making it empty with no sections and keys and values.[/]

  []iLevel is 1 > clears section on given sPath and sSection making it empty with no keys and values.[/]

  []iLevel is 2 > clears key on given sPath and sSection and sKey making it empty with no value.[/]

Bool Function DestroyIniData(Int iLevel, ...) > level-dependent function. Returns boolean true on success and boolean false on fail.

• []iLevel is 0 > removes file on given sPath with all its content.[/]

  []iLevel is 1 > removes section on given sPath and sSection with all its content.[/]

  []iLevel is 2 > removes key on given sPath and sSection and sKey with all its content.[/]

String[] Function GetIniData(Int iLevel, ...) > level-dependent function.

• []iLevel is 0 > returns array with all sections in file on given sPath.[/]

  []iLevel is 1 > returns array with all keys in section on given sPath and sSection.[/]

  []iLevel is 2 > returns array with all chars in value on given sPath and sSection and sKey.[/]

-- Pullers --

Bool Function PullBoolFromIni(...) > returns boolean value on given sPath and sSection and sKey. Returns bDefault value on fail.

Int Function PullIntFromIni(...) > returns integer value on given sPath and sSection and sKey. Returns iDefault value on fail.

Float Function PullFloatFromIni(...) > returns float value on given sPath and sSection and sKey. Returns fDefault value on fail.

String Function PullStringFromIni(...) > returns string value on given sPath and sSection and sKey. Returns sDefault value on fail. <