LK: Shop and Market

A player-driven marketplace inspired by Albion Online featuring global buy/sell orders and villager-linked server shops.
Back to Files

LKShopMarket-1.20.1-1.1.0.jar

File nameLKShopMarket-1.20.1-1.1.0.jar
Uploaded
Nov 17, 2026
Downloads
12
Size
1.7 MB
Mod Loaders
Forge
File ID
9659457
Type
R
Release
Supported game versions
  • 1.20.1

Curse Maven Snippet

Forge

implementation fg.deobf("curse.maven:lk-shop-market-1650513:9659457")

Learn more about Curse Maven

What's new

LK Shop&Market 1.1.0

Minecraft 1.20.1 · Forge 47.3.30+ (built and verified on Forge 47.4.28)

This is the biggest update since 1.0: physical cash, a wallet and an ATM, a wealth ranking, a custom currency, a much better search and quantity selector, and a safer way to save your server's money and items.

⚠️ Update the server and all players at the same time. The network protocol jumps from 10 to 11, so a 1.0.x client cannot join a 1.1.0 server, or the other way around. Your worlds, balances and orders are kept. The save format moves to version 3 and a .dat.bak backup is made before anything is converted.

⚠️ No downgrade while banknotes are in circulation. An older version does not know the banknotes and loses them when it loads a chest, an inventory or a mailbox that holds them. To go back, set cashSystemMode = "DEPOSIT_ONLY", wait until everyone has deposited their notes, check that /market admin cash info shows 0, make a copy of the world, and only then install the older version.


English

💵 New Features: Physical Cash

  • Six banknotes: 5, 10, 50, 100, 1K and 10K. They are real items you can carry, drop, store in chests and give in /trade.
  • Serial numbers and an issue ledger. Every note has a unique serial number that the server checks in its own ledger. The ledger only pays what it issued: a note copied by another mod, creative mode, /give or a region copy is worth nothing. A note with no serial reads "No record · no value".
  • Merge notes. Drop a note on another of the same value to stack them (up to 64). If any of them is not backed by the ledger, the merge is refused and nothing changes.
  • LK Wallet with 9 slots. Craft it (5 leather + 1 string), right-click to open it and keep your notes in one place. You can also put notes in and out with the bundle gestures in any inventory. The open wallet cannot be moved, dropped or swapped by accident.
  • Quick ATM. Open it with /bank, /market bank, or by clicking your balance plate.
    • Withdraw in multiples of 5. It hands out the highest notes first and only charges you if they all fit.
    • Deposit and Deposit all read the notes in your inventory and your wallets.
    • Fake or unregistered notes are confiscated at the ATM and logged.
  • Cash is not sold. Banknotes cannot be bought or sold in the market or in server shops, not even inside shulker boxes or bags. They are still handed over normally in /trade.
  • Three cash modes you can change live: ENABLED, DEPOSIT_ONLY (no new notes are issued) and FROZEN. A fresh server starts in DEPOSIT_ONLY: set cashSystemMode = "ENABLED" to let players withdraw notes. Taking a stack out of a wallet always works.
  • Built-in bank shop. The mod ships it ready to use. In an existing config, point defaultBankShop to "bank".

🏆 New Features: Economy & Stats

  • Wealth ranking. The Stats tab ranks players by their real balance, not by net profit. Players who have been away for a long time still appear. Each row shows their fortune and number of operations.
  • Configurable currency. Set currencyName, currencySymbol and currencySymbolAfter. Every screen, tooltip, dialog and chat message uses your currency ("1234 Coins", "$1,234", "1234 Créditos"). Negative amounts now always read -$500, in every language.
  • Custom interface colors. Retheme the whole UI with a resource pack: assets/lkshopmarket/theme/palette.json. The jar includes palette.example.json with every color slot and its default value. Reload it in game with F3 + T. Delete a line, the file or the pack and that color goes back to normal without restarting. Several packs combine by priority.
  • Server shop stock at a glance. Shops with a stock cap show "Stock: 12/64", and the Sell button turns off when the line is full instead of bouncing.

🔎 UI & Quality of Life

  • Visual quantity selector. The buy and sell dialog is now a box you can type in. Number keys work, Backspace deletes, the arrow keys go up and down (Shift for steps of 10), and "All" jumps to the maximum. It starts at 1, so a stray Enter cannot buy your whole order.
  • Real totals in server shops. The dialog total follows the shop's price curve exactly as it will be charged, and the confirmation threshold uses that total.
  • Search filters. @mod finds items by mod and #tag finds them by item tag (for example #forge:ingots). Combine them with text and with each other: @create gear. A small "×" clears the box, and Escape clears it before closing.
  • "Max" button in /trade. Offer your whole balance in one click.
  • Mouse wheel on the amount in /trade: 1 by 1, or 10 by 10 with Shift, never above your balance.
  • See what the other player changed. In /trade, the slots and the amount the other side just changed light up in orange with a soft bell, and a message tells you who changed the offer.
  • Clearer empty trade columns: "Drag here what you offer" and "Not offering anything yet".
  • The market remembers your last tab. Server shops always open on their catalog.

🛠️ New Features: Admin & Commands

  • /market admin cash info | prune <days> | validate. See how much cash is in circulation, clear very old unredeemed notes, and re-validate held notes. prune cannot be undone and validate issues new money, so both are written to the audit log.
  • Money supply in market status and market report: balances plus notes not yet deposited, with the cash part shown separately.
  • New audit entries for cash withdrawals, deposits, fake notes, purges and validations.
  • Backups include the cash ledger. Backups from 1.0.x are still accepted and leave the ledger empty. The preview tells you so.
  • /market admin entry populate <shop> <item_tag> <buy> <sell> [stock]. Adds every item of a tag to a shop in one command. The order is stable, so two servers with the same modpack get the same ids, and repeating the command picks up where it left off. At most 256 additions per run and 2048 lines per catalog.
  • entry remove and entry stock now use the entry id, not its position. Copying an old command can no longer hit the wrong line.
  • /bank yields to other economy mods. If another mod already owns that command, LK keeps /market bank.

🔐 Stability, Security & Compatibility

  • Automatic escrow in /trade. What you put in a trade is copied to your player data the moment it changes. If the server goes down mid-trade, the items return to your inventory on your next login (the rest go to your mailbox), exactly once.
  • Atomic, transactional saves with a recovery journal. Every few seconds, balances, orders, shops, mailboxes, the cash ledger and the player files are written together as one transaction. A crash in the middle of a save leaves the world exactly as it was before, or finishes the save on the next start. A crash can no longer mix two different moments and duplicate items or lose money. The save is also much faster than before.
  • Balance caps enforced everywhere. A payment that does not fit in the receiver's balance is rejected before anything is charged: in /trade, when filling market orders (seller and buyer), when selling to a server shop, when cancelling or expiring a buy order, and at the ATM. Before, the surplus was silently lost.
  • DEPOSIT_ONLY for migrations. Players can still deposit notes while no new ones are issued, so you can safely retire physical cash before going back to an older version.
  • Dead and spectator protection. Dead or spectating players cannot move items or coins through the mod's packets. Dying closes the mod's screens before your inventory is dropped. Items for someone who is dead or logging out go to their mailbox instead of their hand.
  • No more lost paid goods. A huge purchase of more than 4096 stacks is now rejected up front instead of being charged and delivered cut short. Trades are also removed from the active list before items are handed over, so nothing can be intercepted along the way.
  • API for other mods.
    • New MarketEvent.DirectTradeCompleted fires when a /trade ends: both players, what each side gave, what each side paid, the session id and isOnlyCoins(). The lists are read-only copies.
    • New MarketEvent.BalanceChanged reports the old and new balance and a reason (market trade, server shop, ATM withdrawal or deposit, /trade, income, admin and more).
    • New LKShopMarketAPI.formatMoney(long), getCurrencySymbol() and getCurrencyName(), plus an all-or-nothing EconomyData.transfer(...).
  • Network protocol 10 → 11. Client and server must match.
  • Requires Forge 47.3.30 or newer. Built and verified on Forge 47.4.28. Deprecated Forge calls were replaced, so the build has no warnings.

🐞 Fixes

  • Catalog rows in server shops are now identified by id. Before, if a new catalog arrived at the wrong moment, buying, editing or deleting could act on the item next to the one you clicked.
  • Added missing texts: creative_trading_blocked, order_owner_frozen, item_too_large and four notices that used to show as a raw key.
  • Chat and command messages no longer say a fixed "coins". They use your server's currency.
  • A @ at the start of a word is kept in the search index, so "@create" no longer matches things that are only named "create".

Español

Es la mayor actualización desde la 1.0: efectivo físico, cartera y cajero, ranking por fortuna, moneda propia, un buscador y un selector de cantidad mucho mejores, y una forma más segura de guardar el dinero y los objetos de tu servidor.

💵 Novedades: Efectivo físico

  • Seis billetes: 5, 10, 50, 100, 1K y 10K. Son objetos reales: se llevan, se tiran, se guardan en cofres y se dan en /trade.
  • Número de serie y libro de emisión. Cada billete tiene un número de serie único que el servidor comprueba en su propio libro. El libro solo paga lo que emitió: un billete copiado por otro mod, el creativo, /give o una copia de región no vale nada. Un billete sin serie dice «Sin registro · sin valor».
  • Juntar billetes. Suelta un billete sobre otro del mismo valor para apilarlos (hasta 64). Si alguno no tiene respaldo en el libro, la unión se rechaza y no cambia nada.
  • Cartera LK de 9 espacios. Se fabrica (5 de cuero + 1 de cuerda), se abre con clic derecho y guarda tus billetes en un solo sitio. También puedes meter y sacar billetes con los gestos de bundle en cualquier inventario. La cartera abierta no se puede mover, tirar ni intercambiar sin querer.
  • Cajero rápido. Se abre con /bank, /market bank o con un clic en la placa de tu saldo.
    • Retirar va en múltiplos de 5. Reparte primero los billetes más altos y solo te cobra si caben todos.
    • Ingresar e Ingresar todo leen los billetes de tu inventario y de tus carteras.
    • Los billetes falsos o sin registro se confiscan en el cajero y quedan anotados.
  • El efectivo no se vende. Los billetes no se compran ni se venden en el mercado ni en las tiendas del servidor, ni siquiera dentro de shulkers o bolsas. En /trade se entregan con normalidad.
  • Tres modos de efectivo, que se cambian en caliente: ENABLED, DEPOSIT_ONLY (no se emiten billetes nuevos) y FROZEN. Un servidor nuevo arranca en DEPOSIT_ONLY: pon cashSystemMode = "ENABLED" para que los jugadores puedan retirar billetes. Sacar una pila de una cartera siempre funciona.
  • Tienda bank incluida. El mod la trae lista para usar. En una configuración que ya exista, pon defaultBankShop a "bank".

🏆 Novedades: Economía y estadísticas

  • Ranking por fortuna. La pestaña Stats ordena por saldo real, no por beneficio neto. Los jugadores que llevan mucho tiempo fuera siguen apareciendo. Cada fila muestra su fortuna y su número de operaciones.
  • Moneda configurable. Ajusta currencyName, currencySymbol y currencySymbolAfter. Todas las pantallas, tooltips, diálogos y mensajes de chat usan tu moneda («1234 Coins», «$1.234», «1234 Créditos»). Los importes negativos se leen siempre -$500, en cualquier idioma.
  • Colores de interfaz personalizables. Cambia el aspecto de toda la interfaz con un paquete de recursos: assets/lkshopmarket/theme/palette.json. El jar incluye palette.example.json con todas las ranuras y sus valores de fábrica. Recárgalo en el juego con F3 + T. Si borras una línea, el fichero o el paquete, ese color vuelve a la normalidad sin reiniciar. Varios paquetes se combinan por prioridad.
  • Existencias a la vista en las tiendas. Las tiendas con tope de existencias muestran «Stock: 12/64», y el botón Vender se apaga cuando la línea está llena en vez de rebotar.

🔎 Interfaz y Calidad de Vida

  • Selector visual de cantidad. El diálogo de compra y venta es ahora una caja donde se escribe. Valen las teclas numéricas, Retroceso borra, las flechas suben y bajan (Shift de 10 en 10) y «Todo» salta al máximo. Empieza en 1, así que un Enter despistado no compra la orden entera.
  • Totales reales en las tiendas del servidor. El total del diálogo sigue la curva de precios de la tienda tal como se cobrará, y el umbral de confirmación usa ese total.
  • Filtros de búsqueda. @mod busca por mod y #etiqueta busca por etiqueta de objeto (por ejemplo #forge:ingots). Se combinan con texto y entre sí: @create gear. Una pequeña «×» vacía la caja, y Escape la vacía antes de cerrar.
  • Botón «Max» en /trade. Ofrece todo tu saldo con un clic.
  • Rueda del ratón sobre el importe en /trade: de 1 en 1, o de 10 en 10 con Shift, sin pasar nunca de tu saldo.
  • Mira lo que cambia el otro jugador. En /trade, las ranuras y el importe que el otro acaba de cambiar se resaltan en naranja con una campana suave, y un mensaje te dice quién cambió la oferta.
  • Columnas vacías más claras: «Arrastra aquí lo que ofreces» y «Todavía no ofrece nada».
  • El mercado recuerda tu última pestaña. Las tiendas del servidor abren siempre en su catálogo.

🛠️ Novedades: Administración y comandos

  • /market admin cash info | prune <días> | validate. Consulta cuánto efectivo hay en circulación, limpia billetes muy antiguos sin ingresar y revalida los billetes en mano. prune no se puede deshacer y validate emite dinero nuevo, así que los dos quedan en la auditoría.
  • Masa monetaria en market status y market report: saldos más billetes sin ingresar, con la parte en billetes aparte.
  • Auditoría nueva para retiros, depósitos, billetes falsos, purgas y validaciones de efectivo.
  • Las copias de seguridad incluyen el libro de emisión. Las de la 1.0.x se siguen aceptando y dejan el libro vacío. La vista previa lo avisa.
  • /market admin entry populate <tienda> <etiqueta> <compra> <venta> [stock]. Da de alta todos los objetos de una etiqueta en una sola orden. El orden es estable: dos servidores con el mismo modpack obtienen los mismos ids, y repetir el comando retoma donde lo dejó. Como mucho 256 altas por ejecución y 2048 líneas por catálogo.
  • entry remove y entry stock usan ahora el id de la línea, no su posición. Copiar un comando antiguo ya no puede tocar la línea equivocada.
  • /bank cede el paso a otros mods de economía. Si otro mod ya tiene ese comando, LK conserva /market bank.

🔐 Estabilidad, Seguridad y Compatibilidad

  • Custodia automática en /trade. Lo que pones en un trato se copia a los datos de tu jugador en el mismo instante en que cambia. Si el servidor cae a mitad del trato, los objetos vuelven a tu inventario al volver a entrar (lo que no quepa va al buzón), una sola vez.
  • Volcado atómico y transaccional con diario de recuperación. Cada pocos segundos, los saldos, las órdenes, las tiendas, los buzones, el libro de efectivo y las fichas de los jugadores se escriben juntos como una transacción. Una caída a mitad del guardado deja el mundo exactamente como estaba, o termina el guardado en el siguiente arranque. Una caída ya no puede mezclar dos momentos distintos, duplicar objetos ni perder dinero. El guardado es además mucho más rápido que antes.
  • Topes de saldo en todas partes. Un pago que no cabe en el saldo de quien cobra se rechaza antes de cobrar nada: en /trade, al cumplir órdenes del mercado (vendedor y comprador), al vender a una tienda del servidor, al cancelar o caducar una orden de compra y en el cajero. Antes el sobrante se perdía en silencio.
  • DEPOSIT_ONLY para migraciones. Los jugadores pueden seguir ingresando billetes sin que se emitan nuevos, así que puedes retirar el efectivo físico con seguridad antes de volver a una versión anterior.
  • Protección de jugadores muertos y espectadores. Un jugador muerto o espectador no puede mover objetos ni monedas con los paquetes del mod. Morir cierra las pantallas del mod antes de que se reparta tu inventario. Lo destinado a alguien muerto o que se desconecta va a su buzón, no a su mano.
  • Sin mercancía pagada perdida. Una compra enorme de más de 4096 stacks se rechaza de antemano, en vez de cobrarse y entregarse recortada. Además, los tratos se retiran de la lista activa antes de entregar, así que nada puede interceptarse por el camino.
  • API para otros mods.
    • El nuevo MarketEvent.DirectTradeCompleted se lanza al terminar un /trade: los dos jugadores, lo que dio cada lado, lo que pagó cada lado, el id de sesión e isOnlyCoins(). Las listas son copias de solo lectura.
    • El nuevo MarketEvent.BalanceChanged informa del saldo anterior y el nuevo, con un motivo (compraventa, tienda del servidor, retiro o ingreso en el cajero, /trade, nómina, admin y más).
    • Nuevos LKShopMarketAPI.formatMoney(long), getCurrencySymbol() y getCurrencyName(), y un EconomyData.transfer(...) de todo o nada.
  • Protocolo de red 10 → 11. Cliente y servidor deben coincidir.
  • Requiere Forge 47.3.30 o superior. Compilado y verificado en Forge 47.4.28. Se sustituyeron las llamadas obsoletas de Forge, así que la compilación no da avisos.

🐞 Correcciones

  • Las filas del catálogo de las tiendas se identifican ahora por id. Antes, si llegaba un catálogo nuevo en mal momento, comprar, editar o borrar podía actuar sobre el objeto de al lado.
  • Añadidos textos que faltaban: creative_trading_blocked, order_owner_frozen, item_too_large y cuatro avisos que salían como una clave en crudo.
  • Los mensajes de chat y de comandos ya no dicen «coins» fijo: usan la moneda de tu servidor.
  • El @ al inicio de una palabra se conserva en el índice de búsqueda, así que «@create» ya no encuentra lo que solo se llama «create».

This mod has no additional files