QuickStash

Mod de cliente para Valheim 1.0. Hace ocho cosas:

1. Un botón en el inventario que manda de golpe a los cofres cercanos los objetos que esos cofres ya contienen.
2. Favoritos: marcás ítems o casillas con Alt+clic y el botón nunca los guarda.
3. Craftear desde cofres: estando en la forja o en una mesa de crafteo, las recetas usan el material de los cofres de alrededor sin que lo tengas que sacar a mano.
4. Construir desde cofres: con el martillo, las piezas usan el material de los cofres cercanos.
5. Cuánto tenés y cuánto pide: en las recetas y en el menú de construcción, el número del material pasa a ser 100/3 — tenés 100 usables, pide 3.
6. Un botón para traer el material de la receta al inventario, incluso si no alcanza para craftear.
7. Hornos automáticos: un cofre al lado de una fundición o un horno de carbón lo carga solo con combustible y mineral.
8. Animales que comen del cofre: los domesticados sacan comida de un cofre cercano cuando tienen hambre.

Está pensado para un servidor con mucha gente: no agrega tráfico de red propio, no toca el servidor y nunca escribe en un cofre que otro jugador tenga abierto.

Instalación

Es solo cliente: lo instala cada jugador que lo quiera usar, y no hace falta ponerlo en el servidor. Se puede jugar con gente que no lo tenga.

1. Tener BepInExPack_Valheim (5.4.2350 o superior).
2. Copiar QuickStash.dll a BepInEx\plugins\.

Uso

Guardar rápido

Abrí el inventario y apretá el botón Guardar (arriba a la derecha del panel).

• Solo manda cosas a los cofres que ya tienen ese tipo de objeto. Un cofre vacío no se llena solo, igual que el botón de apilar del juego.
• La primera fila del inventario (la barra rápida) queda protegida por defecto.
• Lo que tengas equipado nunca se guarda.
• Si hay un cofre abierto, se usa primero.
• También se puede guardar con la tecla N, sin abrir el inventario. No se dispara mientras estás escribiendo en el chat, la consola o un cartel. Se cambia en Atajo.

Favoritos

• Alt + clic izquierdo sobre un ítem → protege ese tipo de ítem. Toda tu madera queda protegida, esté en la casilla que esté. Borde amarillo.
• Alt + clic izquierdo sobre una casilla vacía → protege esa casilla, que no se va a usar para nada. Borde celeste.
• Alt + Shift + clic sobre un ítem → protege la casilla en vez del tipo.
• Volvé a hacer el mismo clic para desmarcar.

Los favoritos se guardan por personaje, en BepInEx\config\QuickStash\favorites.<personaje>.json.

Construir desde cofres

Con el martillo en la mano, las piezas cuentan también el material de los cofres cercanos (30 m por defecto). El material sale del cofre recién cuando colocás la pieza, no antes.

Hornos automáticos

Poné un cofre a menos de 15 m de una fundición, horno de carbón, alto horno, molino, rueca o refinería de eitr y se carga solo con lo que corresponda: carbón y mineral para la fundición, madera para el horno de carbón, y así.

Cuidado con el horno de carbón. Acepta varios tipos de madera y todos le dan carbón por igual, así que un cofre con madera fina a 10 m se te puede convertir solo. Es irreversible. Si guardás madera valiosa a menos de 15 m de un horno de carbón, ponela en ItemsExcluidos (por ejemplo FineWood,RoundLog,ElderBark) o alejá el cofre.

Otras dos cosas que conviene saber:

• Solo usa cofres que ya son tuyos. En una base compartida, si otro jugador es dueño del cofre (Valheim le asigna la propiedad al que llegó primero y sigue cerca), el horno no lo va a tocar hasta que la propiedad pase a vos. Es a propósito: evita cualquier riesgo de duplicar objetos en un ciclo que corre solo.
• Solo actúa el jugador más cercano al horno, así que aunque los 14 tengan el mod, un horno lo alimenta un solo cliente.

Animales que comen del cofre

Poné un cofre a menos de 10 m de tus jabalíes, lobos o lo que tengas domesticado. Cuando les da hambre y no hay comida en el piso, sacan una unidad del cofre y se la comen.

• Solo agarran lo que ese animal come normalmente. El filtro es la lista del propio juego (m_consumeItems), no una lista nuestra: un jabalí no va a comerse tu carne de lobo.
• La comida cae al lado del animal, no del cofre, así que el cofre puede estar del otro lado del cerco sin problema.
• Todo lo demás lo hace el juego: la animación, el hambre, y el progreso de domesticación o de cría. Para el juego es exactamente como si se la hubieras tirado vos.
• Con que uno solo de ustedes tenga el mod, alcanza. El mod deja la comida en el piso y después come el animal por su cuenta, con código del juego base: los animales se alimentan aunque el dueño del corral no tenga QuickStash instalado.
• Sobre la cría: al mantenerlos saciados se van a reproducir, pero el juego ya lo limita solo a 4 criaturas en 10 m, así que el corral se llena hasta ese tope y ahí se queda. (Corrijo lo que decía antes: no es ilimitado.)
• Si no querés que coman algo puntual aunque su especie lo acepte, ponelo en Animales > ItemsExcluidos. Es una lista aparte de la global, así que podés proteger las salchichas de los jabalíes sin sacarlas del guardado rápido.

Craftear desde cofres

Parado en una estación (forja, mesa de trabajo, etc.), las recetas cuentan también lo que hay en los cofres cercanos. El número del requisito se pinta en celeste cuando alcanza gracias a los cofres, y el material se trae solo al momento de craftear.

Fuera de una estación el mod no interviene: craftear a mano y construir con el martillo funcionan exactamente como en el juego base.

Cuánto tenés y cuánto pide

El juego base solo te muestra cuánto pide la receta. Ahora el número es disponible/necesario:

Madera   100/3        tenés 100 usables, pide 3
Cuero      1/5        te faltan 4

• Vale igual en el panel de crafteo y en el menú de construcción con el martillo.
• El disponible incluye los cofres cercanos cuando el crafteo o la construcción desde cofres están activados; si no, es solo lo que tenés encima.
• Es lo que podés usar de verdad: si no te queda espacio en el inventario para sacarlo del cofre, no se cuenta. Por eso el número puede bajar con el inventario lleno.
• En celeste cuando alcanza gracias a los cofres, en rojo intermitente cuando no alcanza (igual que el juego base).

Se apaga con MostrarDisponibles y vuelve a mostrar solo la cantidad que pide.

Traer el material al inventario

En el panel de crafteo, debajo del botón de craftear, aparece un botón Traer: pone en tu inventario el material de la receta seleccionada que haya en los cofres cercanos.

• Funciona aunque no alcance. Si la receta pide 20 de hierro y entre los cofres hay 12, te trae los 12. Sirve para juntar a medias o para ver cuánto falta de verdad.
• Aparece solo cuando hay algo que traer, así que no estorba cuando ya tenés todo.
• Trae lo que falta, no de más: si ya tenés 15 de 20, te trae 5.
• En las recetas de un solo ingrediente (las que aceptan varios materiales distintos) trae solo uno: el que más cerca queda de completar la receta. Si no, te vaciaría los cofres de todas las alternativas.
• Respeta las mismas reglas que el resto del mod: cofres privados, wards, cofres que otro jugador tenga abierto, y la lista de ItemsExcluidos.
• Si el inventario se llena en el medio, avisa y deja lo que sí entró.

Todo lo que trae queda anotado en el log con la etiqueta SACADO <-, igual que el material que se trae al craftear.

Para construir con el martillo no hace falta: ahí el material sale del cofre solo, en el momento de colocar la pieza.

Configuración

El archivo es BepInEx\config\com.valheimcrew.quickstash.cfg. Aparece recién después de entrar al juego una vez con el mod instalado.

Hay dos formas de tocarlo:

• A mano, con un editor de texto, con el juego cerrado. BepInEx no vigila el archivo, así que hay que reiniciar el juego para que tome los cambios.
• In-game con F1, que es más cómodo y aplica al instante. Para eso hace falta instalar aparte el mod Official BepInEx ConfigurationManager — no viene incluido en BepInEx. Es solo cliente: lo instala quien lo quiera.

Lo que probablemente quieras tocar:

Multijugador

• Un cofre que otro jugador tiene abierto se salta, no se toca. Vas a ver el aviso "cofre en uso".
• Para escribir en un cofre ajeno se usa el mismo pedido de permiso que el botón de apilar del juego: el dueño del cofre valida y recién ahí cede el control.
• Se respetan los cofres privados y los wards, con las mismas reglas que el juego.

Limitaciones conocidas

• Si el inventario está lleno, craftear desde cofres puede fallar con el mensaje de "sin espacio" del juego: el material se trae al inventario antes de consumirse y necesita un hueco. No se pierde nada.
• La posición por defecto de los botones puede no ser perfecta según la resolución o si usás otros mods de interfaz. Se ajustan con PosicionX / PosicionY el de guardado y con PosicionTraerX / PosicionTraerY el de traer.
• No conviene usarlo junto a QuickStackStore ni a CraftFromContainers: hacen lo mismo y se pisan. El mod avisa en el log si detecta alguno.

Registro de movimientos

Por defecto el mod anota en BepInEx/LogOutput.log todo lo que mueve, una línea por cofre:

[Info   :   QuickStash] GUARDADO -> Cofre (1243, 31, -678) | 21:15:03 | Madera x40, Piedra x12
[Info   :   QuickStash] SACADO <- Cofre de hierro (1250, 31, -670) | 21:16:44 | Hierro x10

Sirve para investigar si alguna vez falta algo: buscás el nombre del objeto en el log y ves cuándo se movió, cuánto y a qué cofre (la posición está para poder ir a buscarlo al mundo). Se apaga con LogDeMovimientos = false, pero conviene dejarlo: es el único rastro que queda.

Las cargas automáticas de horno no se anotan por defecto: son un goteo continuo que taparía todo lo demás. Si las querés, activá Hornos > LogDeCarga y aparecen con la etiqueta HORNO <-, para poder separarlas con un buscador.

Changelog

1.0.0

• Primera version.
• Boton de guardado rapido en el inventario, hacia los cofres cercanos.
• Favoritos por tipo de item y por casilla (Alt+clic), que nunca se guardan.
• Crafteo y mejoras en estaciones usando material de los cofres cercanos.

1.0.1

Correcciones de la auditoria previa al reparto. Nada de esto se probo in-game todavia.

• Se arreglo la reentrada del guardado rapido: cuando el cofre ya era propio, el RPC se resolvia en la misma pila y el resumen salia una vez por cofre.
• Nunca se escribe en un cofre sin ser dueno del ZDO. Sin propiedad el movimiento era local y el siguiente sync lo revertia, con los items ya descontados del inventario.
• Las unidades movidas se cuentan a mano en vez de con el delta de CountItems, que filtra por nivel de mundo: con nivel > 0 se podian perder items viejos.
• Las respuestas de apilado propias nunca caen al handler vanilla, que ignora los favoritos.
• El crafteo de recetas de un solo ingrediente ya no puede tirar NullReferenceException dentro del juego cuando el material no alcanza a llegar del cofre.
• Se piden permisos solo a los cofres que van a recibir algo (antes eran hasta 32 por pulsacion).
• Un solo guardado por cofre tambien al sacar material para craftear.
• Los parches de interfaz que corren por frame ya no pueden romper el inventario del jugador.
• Los favoritos se escriben de forma atomica y se reintentan si falla el disco.
• Se parchea por feature: si un parche del juego renombra un metodo, se apaga esa parte y no el mod entero.
• Cooldown de medio segundo por accion. Topes de configuracion mas conservadores.

1.0.2

• La tecla N guarda por defecto, sin abrir el inventario. No se dispara mientras escribis en el chat, la consola, un cartel o el comercio.
• El rango de guardado pasa de 10 a 30 metros.
• Nuevo LogDeMovimientos, activado por defecto: anota en el log cada objeto movido, con cantidad, cofre, posicion y hora. Es el rastro para investigar si alguna vez falta algo.
• Se corrigio la documentacion: ConfigurationManager (F1) es un mod aparte, no viene con BepInEx, y editar el .cfg a mano requiere reiniciar el juego.

1.0.3

• El rango de crafteo desde cofres tambien pasa a 30 metros, igual que el de guardado.

1.1.0

• Arreglado: cofres que a veces no se tomaban. No era la distancia. Se recortaba a los 32 cofres mas cercanos ANTES de mirar cuales tenian el objeto, asi que con muchos cofres juntos los que quedaban fuera de ese tope no se usaban nunca. Ahora se filtra primero y el tope se aplica solo a los cofres a los que se les escribe. Leer un cofre no cuesta red.
• Nuevo: construir desde cofres. Con el martillo, las piezas usan el material de los cofres cercanos (30 m por defecto). El material se trae recien al colocar la pieza.
• Nuevo: hornos automaticos. Un cofre a menos de 10 m de una fundicion, horno de carbon, alto horno, molino, rueca o refineria de eitr la carga sola con combustible y mineral. Solo usa cofres que ya son tuyos, y solo actua el jugador mas cercano al horno.
• Con LogDeRendimiento activo, el resumen del guardado ahora dice cuantos cofres habia en rango, cuantos eran utilizables y cuantos tenian el objeto: si algo no se guarda, el log lo explica.
• Opcion nueva MaxCofresEscaneados (128) para el tope de lectura, separado de MaxCofresPorAccion (32) que sigue siendo el de escritura.
• Los hornos respetan ItemsExcluidos, tienen tope global por segundo, y sus cargas no llenan el log salvo que actives Hornos > LogDeCarga.

1.2.0 (experimental — rama feature/animales-comen-de-cofres)

• Los animales domesticados comen de un cofre cercano cuando tienen hambre y no hay nada en el piso. Solo agarran lo que ese animal come normalmente: el filtro es la lista del propio juego.
• La comida se tira al lado del animal, no del cofre, asi que el cofre puede estar fuera del cerco.
• Solo actua el cliente dueno del animal y solo usa cofres propios, igual que los hornos.

1.2.1 (experimental)

• Diagnostico para los animales: con LogDeRendimiento activo, el log explica por que un animal hambriento no comio (no hay cofre, el cofre es de otro jugador, o la comida no le gusta) y vuelca una vez por especie la lista real de lo que come.

1.3.0

• Arreglado: los animales no comian en el servidor. El enganche anterior colgaba de la IA del animal, que Valheim solo ejecuta en el cliente dueno de su ZDO. Con varios jugadores, el que esta parado al lado del corral tipicamente NO es el dueno, asi que el codigo no corria nunca.
• Rediseno: ya no hace falta ser dueno del animal. El mod solo deja la comida en el piso y el cliente que si es dueno se la come con codigo vanilla. Efecto lateral: alcanza con que UNO de los jugadores tenga el mod para que se alimenten los animales de toda la base.
• Coordinacion entre clientes: solo actua el jugador mas cercano al animal, y no se tira comida si ya hay en el piso.
• Opciones nuevas: Animales > IntervaloSegundos y Animales > MaxPorCiclo.

1.3.1

Correcciones de la auditoria de seguridad sobre master.

• Critico: los animales podian vaciar un cofre sin freno. La unica defensa contra tirar comida en cada ciclo era un barrido de fisica acotado a 32 objetos. En un corral con basura tirada —tipico despues de un raid, y dentro de una base lo tirado no despawnea— ese barrido se truncaba, no veia la comida que ya estaba en el piso, y seguia sacando del cofre indefinidamente. Ahora el buffer es de 256 y, si aun asi se satura, se asume que hay comida en vez de lo contrario.
• Cooldown de 10 s por animal tras darle de comer, para que el freno no dependa de un solo chequeo.
• La eleccion de que jugador alimenta ya no depende solo de la distancia: con posiciones replicadas y con lag, dos jugadores casi equidistantes podian creerse ambos el mas cercano.
• No se le tira comida a un animal muerto.
• LogDeComida pasa a estar activado por defecto: es la funcion que mas necesita dejar rastro.
• Lista de exclusion propia para animales, separada de la global.
• Los ciclos de animales corren aislados: una excepcion ahi ya no mata el atajo de guardado.
• El diagnostico deja de repetir "no hay animales" cada 5 segundos.

1.3.2

• El rango de los hornos pasa de 10 a 15 metros.

1.3.3

• El rango del guardado rapido baja de 30 a 15 metros.

1.3.4

• Diagnostico para los hornos: con LogDeRendimiento activo, el log explica por que un horno no se carga (no es tuyo, el cofre no es tuyo, el cofre esta marcado en uso, o no hay material). Corre tambien cuando el horno no es tuyo, que es justo el caso que antes quedaba mudo.

1.4.0

• El numero del material ahora es "disponible/necesario" (por ejemplo 100/3) en las recetas y en el menu de construccion. El vanilla solo muestra cuanto pide. El disponible incluye los cofres cercanos cuando la feature correspondiente esta activada, y descuenta lo que no se podria sacar por falta de espacio en el inventario. Se apaga con MostrarDisponibles.
• Boton "Traer" debajo del boton de craftear: pone en el inventario el material de la receta seleccionada que haya en los cofres, aunque no alcance para craftear. Trae solo lo que falta, aparece solo cuando hay algo que traer, y en recetas de un solo ingrediente trae uno solo —el que mas cerca queda de completarla— en vez de vaciar los cofres de todas las alternativas. Se mueve con PosicionTraerX/Y y se apaga con MostrarBotonTraer.
• La cuenta que decide si el boton aparece y la que mueve el material son el mismo codigo, una en seco: no pueden desincronizarse y mostrar un boton que no hace nada.
• El clon del boton de craftear pierde el binding de UIGamePad, asi que craftear con el mando no dispara tambien el boton de traer.
• MostrarTotales (en Crafteo) pasa a ser solo el color celeste; el numero lo controla MostrarDisponibles.