Server documentation

Restock & Roam

Active

Hytale • Version 1.0.0

Instalação, kits, redes de baús, recuperação de trip, BetterClaim, comandos, config e permissões.

Setup de servidor do Restock & Roam: pastas de dados, abas da GUI, recuperação de trip, BetterClaim, comandos e config.json.

Visão geral

Restock & Roam é um plugin server-side para Hytale 0.6.0+. Jogadores salvam kits pessoais, vinculam uma rede de baús, ativam um kit para essa base e depois agacham e abrem um baú vinculado para preparar a trip ou para guardar loot e reabastecer na volta.

Abrir o baú em pé é vanilla. O plugin só transfere itens depois de um interact agachado num baú vinculado, com kit já ativo nessa network. Cada jogador é dono de no máximo uma base. Convidados mantêm os próprios kits e snapshots de trip nos baús do dono.

Os dados ficam em mods/durkz_RestockAndRoam/. Se mods/durkz_ExpeditionPrep/ já existir, o plugin continua nessa pasta para não perder kits e bases.

Instalação

Exige Hytale 0.6.0+
Baixe RestockAndRoam-1.0.0.jar na aba Files da CurseForge
Coloque o JAR em mods/ (UserData/Mods global ou mods/ do save)
Inicie o mundo. Config em mods/durkz_RestockAndRoam/config.json
Rode /eprep. Log de boot: Restock & Roam loaded. Open /eprep to claim an Expedition Ledger.
(Opcional) Instale BetterClaim se os baús vinculados também devem honrar as regras de interact de baú da claim

GUI

/eprep e a secondary action do Expedition Ledger abrem a mesma CustomUI. Abas:

Aba	Função
Overview	Escolher kit e uma base que você pode usar, ativar o kit, claim do Ledger
Kits	Salvar, editar e apagar até 12 kits
Base	Vincular ou desvincular baús, convidar ou remover convidados, apagar a network
Chest rules	Role, prioridade e filtros por baú
Trip status	Último relatório de turnaround, loot pending, abandon ou recovery de admin

Ações destrutivas (substituir kit, apagar kit, apagar network, abandonar trip, reset de admin) pedem um segundo clique. O primeiro só pede confirmação e não move itens.

O loop de 13 passos do jogador está na página do mod.

Kits

Um kit é um snapshot de hotbar, armor, utility, tools, inventário e backpack, mais entradas opcionais de supplies total (não presas a um slot).

Regra	Detalhe
Nome	1-24 caracteres: letras, números, espaços, `-`, `_`
Quantidade	Até 12 kits por jogador por mundo
Save	Save full kit guarda o layout. Itens ficam no jogador
Replace	Mesmo nome: clique duas vezes para confirmar
Excluídos	Expedition Ledger e itens `EditorTool_*` nunca são salvos
Vazio	Kit vazio não pode ser salvo

Add held supplies pega o stack ativo da hotbar e guarda um alvo de quantidade. O restock depois puxa esse total para inventário ou backpack, não para um slot específico de equipamento.

Base e convidados

Regra	Detalhe
Primary	Link primary, o menu fecha, abra o baú em 30 segundos
Additional	Link additional, mesma janela de 30 segundos, até 16 blocos do primary (3D: `dx²+dy²+dz² ≤ 256`)
Tamanho	1 primary mais extras, máximo 17 baús
Dono	Uma network por jogador. Um baú não pode pertencer a duas networks
Convidados	O nome tem de resolver para um único jogador conhecido (entrou pelo menos uma vez). Máximo 128 convidados
Acesso	Dono ou convidado. Convidados não editam baús, regras nem lista de convidados
Unlink extra	Selecione um baú que não seja o primary, Unlink selected
Delete	Delete network precisa de um segundo clique. Remove a base inteira

/expedition cancel cancela um link pendente de 30 segundos.

Chest rules

Campo	Detalhe
`SUPPLY`	Entrega itens quando o kit é reabastecido
`LOOT`	Recebe itens ganhos desde a partida
`BOTH`	Os dois. O primary começa como `BOTH` com filtros vazios (fallback)
Prioridade	`-1000` a `1000`. Maior primeiro entre baús filtrados
Filtros	Lista OR: `item:ID`, `category:ID`, `resource:ID`. Vazio = fallback

Ordem: baús filtrados antes do fallback, depois prioridade maior, depois ordem de link. O primary fica sempre primeiro na lista. Move earlier / Move later só trocam baús extras.

Turnaround

Agache e interaja até a janela do baú abrir de verdade. O plugin espera essa janela antes de mover itens.

Caso	O que acontece
Primeiro agachar (sem trip)	Reabastece o kit de `SUPPLY`/`BOTH`, grava o snapshot de partida
Volta à mesma base	Deposita a quantidade ganha vs snapshot em `LOOT`/`BOTH`, depois reabastece o kit
Interact em pé	Baú vanilla. Sem transferência
Outra base ou outro mundo	Bloqueado até voltar à origem ou Abandon trip
Troca de kit no meio da trip	O snapshot fica no kit usado na partida
Baú de loot cheio	O resto fica no jogador e aparece como pending em Trip status
Interrupção	A trip fica marcada para recovery. Inspecione o inventário e depois abandon. Recovery nunca reexecuta transferências

O loot sai de inventário, backpack, hotbar, utility, tools e depois armor, nessa ordem. Só as quantidades extras desde a partida contam como loot.

BetterClaim

Dependência opcional durkz:BetterClaim. Quando o BetterClaim está presente e ligado, cada baú vinculado também precisa da permissão de interact de baú. Se o BetterClaim estiver instalado mas a consulta falhar, o acesso é negado. Sem BetterClaim, o Restock & Roam não consulta claims.

Características

Kits pessoais com layout de slots e totais opcionais de suprimento
Rede de baús, convidados e trips por jogador numa base compartilhada
Deposita só o que ganhou desde a partida; reabastece de SUPPLY/BOTH
Overflow fica no jogador; Trip status lista tipos pending
Expedition Ledger (animação de spellbook) ou /eprep
Checagem opcional de interact de baú do BetterClaim
Avisos de update para operadores ou expeditionprep.admin (checkForUpdates)

Comandos

Comando principal: /expedition (aliases: /eprep, /restock, /rr). Sem permissão para a GUI.

Comando	Acesso	Descrição
`/eprep`	Todos	Abrir Overview
`/expedition bind`	Todos	Armar um link de baú primary (ou additional) de 30 segundos
`/expedition save <name>`	Todos	Salvar o equipamento atual como kit sem abrir a GUI
`/expedition prepare <name>`	Todos	Ativar um kit e armar um prepare de 30 segundos no baú vinculado
`/expedition cancel`	Todos	Cancelar uma ação de baú pendente de 30 segundos

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

A GUI é o caminho normal. Atalhos de chat não substituem Use this kit mais agachar num baú vinculado.

Permissões

Permissão	Descrição
`expeditionprep.admin`	Inspecionar a trip de outro jogador, resetar tracking, receber avisos de update

Donos da base gerenciam baús e convidados sem nó extra.

Exemplo:

/perm user <player> expeditionprep.admin true

Operadores do servidor herdam avisos de update pela mesma checagem de expeditionprep.admin.

Configuração

Arquivo: mods/durkz_RestockAndRoam/config.json (ou mods/durkz_ExpeditionPrep/config.json quando essa pasta já existir).

Campo	Padrão	Descrição
`checkForUpdates`	`true`	No join, operadores ou `expeditionprep.admin` recebem um aviso de chat uma vez se o site listar um `RestockAndRoam-x.y.z.jar` mais novo

{
  "checkForUpdates": true
}

Não há toggles de gameplay na config. Tamanho de kit, número de baús e filtros são enforced no plugin.

Arquivos de dados

Caminho	Função
`mods/durkz_RestockAndRoam/config.json`	Toggle de update-check
`mods/durkz_RestockAndRoam/profiles/<worldUuid>/<playerUuid>.json`	Kits por jogador
`mods/durkz_RestockAndRoam/worlds/<worldUuid>.json`	Networks, kits ativos, trips

Troque o nome da pasta por durkz_ExpeditionPrep quando esse diretório já existir.

Como verificar

Suba o mundo. O log contém Restock & Roam loaded. Open /eprep to claim an Expedition Ledger.
/eprep abre Overview. Claim o Ledger. O inventário recebe Durkz_Expedition_Ledger se houver slot livre.
Salve um kit, vincule um baú primary em 30 segundos, clique Use this kit.
Agache e abra esse baú. O chat reporta o refill do kit e a trip começa.
Pegue um item novo, volte, agache de novo. O chat reporta loot depositado e kit supplied.
Trip status mostra o mesmo resumo. Abandon trip (dois cliques) limpa o tracking sem mover itens.

Licença

MIT License