Server documentation

Restock & Roam

Active

Hytale • Version 1.0.0

Instalación, kits, redes de cofres, recuperación de trip, BetterClaim, comandos, config y permisos.

Setup de servidor de Restock & Roam: carpetas de datos, pestañas de la GUI, recuperación de trip, BetterClaim, comandos y config.json.

Resumen

Restock & Roam es un plugin server-side para Hytale 0.6.0+. Los jugadores guardan kits personales, vinculan una red de cofres, activan un kit para esa base y luego se agachan y abren un cofre vinculado para preparar la trip o para guardar loot y reponer al volver.

Abrir el cofre de pie es vanilla. El plugin solo transfiere ítems tras un interact agachado en un cofre vinculado, con un kit ya activo en esa network. Cada jugador es dueño de como máximo una base. Los invitados mantienen sus propios kits y snapshots de trip en los cofres del anfitrión.

Los datos viven en mods/durkz_RestockAndRoam/. Si mods/durkz_ExpeditionPrep/ ya existe, el plugin sigue usando esa carpeta para no perder kits ni bases.

Instalación

Requiere Hytale 0.6.0+
Descarga RestockAndRoam-1.0.0.jar en la pestaña Files de CurseForge
Coloca el JAR en mods/ (global UserData/Mods o mods/ del save)
Arranca el mundo. Config en mods/durkz_RestockAndRoam/config.json
Ejecuta /eprep. Log de arranque: Restock & Roam loaded. Open /eprep to claim an Expedition Ledger.
(Opcional) Instala BetterClaim si los cofres vinculados también deben respetar las reglas de interact de cofre del claim

GUI

/eprep y la secondary action del Expedition Ledger abren la misma CustomUI. Pestañas:

Pestaña	Función
Overview	Elegir kit y una base que puedas usar, activar el kit, reclamar el Ledger
Kits	Guardar, editar y borrar hasta 12 kits
Base	Vincular o desvincular cofres, invitar o quitar invitados, borrar la network
Chest rules	Rol, prioridad y filtros por cofre
Trip status	Último informe de turnaround, loot pending, abandon o recovery de admin

Las acciones destructivas (reemplazar kit, borrar kit, borrar network, abandonar trip, reset de admin) piden un segundo clic. El primero solo pide confirmación y no mueve ítems.

El bucle de 13 pasos del jugador está en la página del mod.

Kits

Un kit es un snapshot de hotbar, armor, utility, tools, inventario y backpack, más entradas opcionales de supplies total (no atadas a un slot).

Regla	Detalle
Nombre	1-24 caracteres: letras, números, espacios, `-`, `_`
Cantidad	Hasta 12 kits por jugador por mundo
Save	Save full kit guarda el layout. Los ítems se quedan en el jugador
Replace	Mismo nombre: clic dos veces para confirmar
Excluidos	Expedition Ledger e ítems `EditorTool_*` nunca se guardan
Vacío	Un kit vacío no se puede guardar

Add held supplies toma el stack activo de la hotbar y guarda un objetivo de cantidad. El restock luego mete ese total en inventario o backpack, no en un slot concreto de equipo.

Base e invitados

Regla	Detalle
Primary	Link primary, el menú se cierra, abre el cofre en 30 segundos
Additional	Link additional, misma ventana de 30 segundos, a 16 bloques del primary (3D: `dx²+dy²+dz² ≤ 256`)
Tamaño	1 primary más extras, máximo 17 cofres
Dueño	Una network por jugador. Un cofre no puede pertenecer a dos networks
Invitados	El nombre debe resolver a un solo jugador conocido (entró al menos una vez). Máximo 128 invitados
Acceso	Dueño o invitado. Los invitados no editan cofres, reglas ni lista de invitados
Unlink extra	Selecciona un cofre que no sea el primary, Unlink selected
Delete	Delete network pide un segundo clic. Quita toda la base

/expedition cancel cancela un vínculo pendiente de 30 segundos.

Chest rules

Campo	Detalle
`SUPPLY`	Da ítems cuando se rellena el kit
`LOOT`	Recibe ítems ganados desde la partida
`BOTH`	Ambos. El primary empieza como `BOTH` con filtros vacíos (fallback)
Prioridad	`-1000` a `1000`. Mayor primero entre cofres filtrados
Filtros	Lista OR: `item:ID`, `category:ID`, `resource:ID`. Vacío = fallback

Orden: cofres filtrados antes del fallback, luego mayor prioridad, luego orden de link. El primary siempre queda primero en la lista. Move earlier / Move later solo intercambian cofres extra.

Turnaround

Agáchate e interactúa hasta que la ventana del cofre se abra de verdad. El plugin espera esa ventana antes de mover ítems.

Caso	Qué pasa
Primer agacharse (sin trip)	Rellena el kit desde `SUPPLY`/`BOTH`, escribe el snapshot de partida
Vuelta a la misma base	Deposita la cantidad ganada vs snapshot en `LOOT`/`BOTH`, luego rellena el kit
Interact de pie	Cofre vanilla. Sin transferencia
Otra base u otro mundo	Bloqueado hasta volver al origen o Abandon trip
Cambio de kit a mitad de trip	El snapshot se queda en el kit usado al salir
Cofre de loot lleno	El resto se queda en el jugador y aparece como pending en Trip status
Interrupción	La trip queda marcada para recovery. Inspecciona el inventario y luego abandon. Recovery nunca reejecuta transferencias

El loot sale de inventario, backpack, hotbar, utility, tools y luego armor, en ese orden. Solo las cantidades extra desde la partida cuentan como loot.

BetterClaim

Dependencia opcional durkz:BetterClaim. Cuando BetterClaim está presente y activo, cada cofre vinculado también necesita su permiso de interact de cofre. Si BetterClaim está instalado pero la consulta falla, el acceso se deniega. Sin BetterClaim, Restock & Roam no consulta claims.

Características

Kits personales con layout de slots y totales opcionales de suministros
Red de cofres, invitados y trips por jugador en una base compartida
Deposita solo lo ganado desde la partida; rellena desde SUPPLY/BOTH
El overflow se queda en el jugador; Trip status lista tipos pending
Expedition Ledger (animación de spellbook) o /eprep
Comprobación opcional de interact de cofre de BetterClaim
Avisos de update para operadores o expeditionprep.admin (checkForUpdates)

Comandos

Comando principal: /expedition (aliases: /eprep, /restock, /rr). Sin permiso para la GUI.

Comando	Acceso	Descripción
`/eprep`	Todos	Abrir Overview
`/expedition bind`	Todos	Armar un vínculo de cofre primary (o additional) de 30 segundos
`/expedition save <name>`	Todos	Guardar el equipo actual como kit sin abrir la GUI
`/expedition prepare <name>`	Todos	Activar un kit y armar un prepare de 30 segundos en el cofre vinculado
`/expedition cancel`	Todos	Cancelar una acción de cofre pendiente de 30 segundos

/eprep
/expedition bind
/expedition save Ranger
/expedition prepare Ranger
/expedition cancel

La GUI es el camino normal. Los atajos de chat no sustituyen Use this kit más agacharse en un cofre vinculado.

Permisos

Permiso	Descripción
`expeditionprep.admin`	Inspeccionar la trip de otro jugador, resetear tracking, recibir avisos de update

Los dueños de la base gestionan cofres e invitados sin nodo extra.

Ejemplo:

/perm user <player> expeditionprep.admin true

Los operadores del servidor heredan avisos de update por la misma comprobación de expeditionprep.admin.

Configuración

Archivo: mods/durkz_RestockAndRoam/config.json (o mods/durkz_ExpeditionPrep/config.json cuando esa carpeta ya existe).

Campo	Por defecto	Descripción
`checkForUpdates`	`true`	Al entrar, operadores o `expeditionprep.admin` reciben un aviso de chat una vez si el sitio lista un `RestockAndRoam-x.y.z.jar` más nuevo

{
  "checkForUpdates": true
}

No hay toggles de gameplay en la config. Tamaño de kit, número de cofres y filtros se aplican en el plugin.

Archivos de datos

Ruta	Función
`mods/durkz_RestockAndRoam/config.json`	Toggle de update-check
`mods/durkz_RestockAndRoam/profiles/<worldUuid>/<playerUuid>.json`	Kits por jugador
`mods/durkz_RestockAndRoam/worlds/<worldUuid>.json`	Networks, kits activos, trips

Sustituye el nombre de carpeta por durkz_ExpeditionPrep cuando ese directorio ya exista.

Cómo comprobarlo

Arranca el mundo. El log contiene Restock & Roam loaded. Open /eprep to claim an Expedition Ledger.
/eprep abre Overview. Reclama el Ledger. El inventario recibe Durkz_Expedition_Ledger si hay un slot libre.
Guarda un kit, vincula un cofre primary en 30 segundos, pulsa Use this kit.
Agáchate y abre ese cofre. El chat informa el refill del kit y empieza la trip.
Recoge un ítem nuevo, vuelve, agáchate otra vez. El chat informa loot depositado y kit supplied.
Trip status muestra el mismo resumen. Abandon trip (dos clics) limpia el tracking sin mover ítems.

Licencia

MIT License