Editor web

/exylialib editor sube lo que se puede editar en este servidor y responde con un enlace. El admin edita en el navegador, y un segundo comando, tecleado en el juego, trae el resultado. El servidor nunca abre un puerto y nada le llega salvo que alguien con permiso lo pida.

Para dueños de servidor

Los tres comandos necesitan exylialib.editor (de op por defecto). Un plugin puede restringir un archivo con un permiso propio; un archivo que no puedes editar queda fuera de la sesión y se rechaza al aplicar.

Qué se ofrece

Los archivos de cada plugin de Exylia activo, encontrados sin que el plugin haga nada:

• Ajustes — cada archivo de config que declaró el plugin.
• Mensajes — los archivos del idioma activo bajo lang/<código>/ (y lang/custom/).
• Menús — comprobados con el propio compilador de menús del plugin antes de escribirse; un menú que no compilaría se rechaza.
• Archivos — cualquier otro .yml que el plugin instaló en su carpeta.

Fuera quedan: los menús de administración que el plugin reescribe en cada arranque, las carpetas de otros idiomas, las carpetas llamadas data, players, playerdata, logs, backups, cache, storage, database, exports o schematics, las carpetas ocultas, los archivos de más de 1 MB, los que no se pueden leer y los que el plugin nunca instaló. Los plugins también pueden registrar pantallas más ricas — un editor de hologramas con vista previa, minas o kits guardados en una base de datos — que sustituyen al formulario simple para esos archivos.

Qué necesita confirm

• Un cambio bajo una ruta que el plugin marcó como sensible, como los comandos al hacer clic de un holograma.
• Cualquier línea cambiada que ejecute un comando de consola (console:, [CONSOLE], op:…).
• Borrar una entrada guardada, como una mina o un kit.
• Un archivo que cambió en el servidor después de que el navegador lo cargara.

Un valor del tipo equivocado se rechaza igual que en el archivo YAML, y el resto del cambio se aplica.

Seguridad

• El enlace no es la llave. Solo lleva un código público. El secreto que lee un cambio de vuelta se queda en la memoria del servidor, así que un enlace filtrado deja mirar y proponer, nunca aplicar.
• Un navegador es dueño de la sesión. El primero que abre el enlace edita; otro navegador, o el mismo enlace desde otra dirección, es de solo lectura y muestra un reto corto. /exylialib editor trust <código> <reto> en el juego lo convierte en editor.
• La confianza es por servidor. Un navegador de confianza lo sigue siendo en las siguientes sesiones de este servidor. El servidor se reconoce por plugins/ExyliaLib/editor-key.txt, una clave generada una vez y nunca mostrada a un navegador. Borra ese archivo para retirar la confianza a todos los navegadores.
• Las sesiones duran poco. Una sesión dura 24 horas, hay como mucho 32 abiertas a la vez, y un reinicio las olvida todas.
• No se sube nada de los jugadores salvo el nombre del admin que abrió la sesión.

web-editor:
  enabled: true                   # false: /exylialib editor se niega
  url: https://utils.exylia.net   # solo cámbialo para usar tu propia copia

Para desarrolladores de plugins

Un plugin no necesita código para que sus archivos sean editables. Registra un sujeto cuando el descubrimiento no puede saber lo que necesitas: una pantalla más rica, un permiso más estrecho, rutas sensibles, un comprobador, o entradas guardadas fuera de un archivo de config.

WebEditor.of(this)
        .subject("holograms", hologramsFile, "displays/hologram")
        .title("Holograms")
        .permission("exyliadisplays.holograms")
        .sensitive("holograms.*.click")
        .onApplied(this::reloadHolograms);

Todo sujeto acepta title, permission, sensitive(rutas…) (rutas con puntos, * para cualquier clave, comparadas como prefijo) y onApplied(runnable). Un sujeto YAML acepta además check(yaml -> problemas): cualquier línea que devuelva rechaza el cambio entero.

WebEditor.of(this).yaml("tags", "cosmetics/tags", "chatcosmetics/catalog")
        .check(yaml -> catalog.problems(yaml))
        .onApplied(catalog::reload);

Un EntryStore<R> responde entries() desde memoria y escribe con futuros:

public final class MineStore implements EntryStore<MineEdit> {
    public Map<String, MineEdit> entries() { return manager.asEdits(); }
    public List<String> check(String id, MineEdit mine, boolean created) { return manager.problems(id, mine); }
    public CompletableFuture<Void> save(String id, MineEdit mine, boolean created) { return manager.save(id, mine); }
    public CompletableFuture<Void> delete(String id) { return manager.delete(id); }
}

Cada entrada pasa por el binder de config antes de que la vea el almacén, y un problema en una sola entrada rechaza el sujeto entero, así que el almacén nunca recibe medio cambio. Todo borrado necesita confirm.

WebEditor.open(sender, plugin) abre una sesión desde el comando propio de un plugin, y WebEditor.available(plugin) dice si abriría algo. Los registros se olvidan cuando el plugin se desactiva.