ImportTtsPresets

From Wiki G1R-MP G1 Remake Multiplayer
Revision as of 22:48, 8 October 2026 by QCherry (talk | contribs) (Document upcoming 0.1.7: optional server TTS, 33 functions, 4 events, English voice/setup guides and NPC meleeSkillTier; not a release)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

importTtsPresets

PLANNED FOR UPDATE 0.1.7
This function is planned for G1R:MP 0.1.7. It is not included in the public 0.1.6 release.

Validates an exported profile document and atomically replaces this resource's voices/presets.

Syntax

bool importTtsPresets(table document)

Parameters

Name Type Required Description
document table yes Exactly the schema, voices and presets fields from exportTtsPresets.

Returns

true after a complete valid import, or false, reason; no partial application on invalid data.

Examples

local text = readResourceData("tts_profiles")
if type(text) == "string" then
    local data = fromJSON(text)
    local ok, why = importTtsPresets(data)
    if not ok then outputDebugString(tostring(why)) end
end

Notes

  • Server-side only. Coming in 0.1.7 — not released yet; not included in public 0.1.6.
  • See Server TTS, TTS configuration and TTS voices for installation, options, ownership, cache and examples.
  • Invalid requests return false, reason. Profiles, jobs and playback handles belong to the calling resource; do not use handles from another resource or a previous resource lifetime.
  • This replaces both collections rather than merging individual profiles. It never downloads samples or loads arbitrary model checkpoints.