Réglages et stockage

Réglages générés

Capacité requise : settings.

Déclarez un schéma de réglages : NeoPiano génère leur page dans Réglages › Mods et dans la fiche du mod, enregistre les valeurs et vous prévient quand elles changent.

function on_mod_init()
  neo.settings.define({
    { id = "show_hud",   type = "toggle", label = "Afficher le HUD", default = true },
    { id = "note_names", type = "dropdown", label = "Noms des notes",
      options = { "C D E", "Do Ré Mi" }, default = "C D E" },
    { id = "accent",     type = "color", label = "Couleur d’accent", default = "#C8A2F5" },
  })
end

function on_setting(id, value)
  if id == "show_hud" then neo.ui.set("chord", "visible", value) end
end

Lisez une valeur à tout moment avec neo.settings.get(id).

Astuce

Les réglages générés sont le moyen le plus simple d’avoir une interface propre : aucun panneau à écrire.

Stockage clé-valeur

Capacité requise : storage.

local total = neo.storage.get("total_notes", 0)   -- valeur par défaut si absente

function on_note_on(note, velocity)
  total = total + 1
  neo.storage.set("total_notes", total)
end

-- neo.storage.delete("total_notes")

• Les valeurs sont des nombres, des chaînes, des booléens ou des tables simples.
• Chaque mod a son propre espace, limité à 256 Kio.
• Les données sont écrites par NeoPiano dans le dossier utilisateur, dans NeoPiano/Mods/<NomDuMod>.json, avec les réglages.