I’m Swiss, and therefore I had to make (for my first mod) a wealth transfer terminal.

I’m preparing an extraction shooter / battle royale / looter shooter modpack with a multiple-choice story and several different endings (solo). I’m also planning a server with friendly competitions.

So, to allow people to leave with their winnings (special and unique items), I developed this mod.

Players on their solo map can also use it to bring (their gear, blocks, etc.) equipment over to another player’s solo map.

OK, this mod is also a way to bring corruption into a world.
Let’s say it will rather bring DEPTH to RP gameplay!!

I’m Swiss, I like money LOL
(By the way, I write in Helvetica!!!!!)

MineExpress adds a storage terminal with secure withdrawal tickets, JSON snapshots, admin logs, and an anti-duplication / anti-smuggling system.
Deposit your items, generate a ticket, withdraw later… or watch your expired contraband go to the item graveyard.

🚂 MineExpress — The terminal that forgets nothing (except your expired contraband)

MineExpress is a Forge 1.20.1 mod that turns a storage terminal into a secure deposit / withdrawal system using tickets.

How it works:

Fill the MineExpress Terminal.
Click “Generate Ticket”.
The mod creates a snapshot (JSON file) of the contents.
The terminal is emptied, and you receive a withdrawal ticket linked to your player.
Use your ticket on a MineExpress terminal to recover the stored contents (On another server or in a solo game, you need to send the JSON file to the server or to your friend so they can put it in their FedCraft folder. It’s my first mod and I’m not exactly a computer genius, that’s all!!!!).

✅ Main Features

Storage terminal (27 slots)
Secure withdrawal ticket
- linked to the owner (UUID)
- single use
- limited validity time
Anti-duplication
- ticket marked as redeemed
- snapshot deleted after withdrawal
- admin logs for every withdrawal
Admin logs
- player, ticket, source, withdrawal position, file deletion, etc.
Ticket restoration
- if a snapshot still exists in the folder, the mod can restore the ticket on login (useful after crashes / disconnects)
“Medieval customs checkpoint” vibe
- visual / sound effects on use
- “contraband” messages (yes, on purpose 😅)

⏱️ Timers (important)

Ticket valid for ~5 minutes
Terminal locked for ~6 minutes after issuing a ticket

Yes, the terminal rests for 6 minutes. Even machines need a coffee break.

Warnings (bugs, duplication, limitations)

⚠️ Mod is in “serious testing” mode

This mod interacts with:

inventories
snapshot files
ticket NBT data
logs / anti-duplication logic

👉 Back up your worlds/servers before using it in production.

Because “we’ll see what happens” is a speedrun strategy to disaster.

⚠️ Anti-duplication: what the mod does (and does not do)

The mod prevents normal gameplay duplication through:

player-bound tickets
single-use tickets
expired ticket = withdrawal denied
snapshot deleted after withdrawal
admin log trace

However (important):

the system is not designed to stop admin cheating / FTP access / manual JSON file editing
if someone copies or edits snapshots by hand, that is outside the normal gameplay scope of the mod

In short:
MineExpress fights in-game smuggling, not server gods with root access.

⚠️ Do not edit snapshot files manually

Snapshots are stored in:

/FedCraft/ (yes, the folder name is inherited… long story 😄)

These JSON files are used for withdrawal recovery.
👉 Do not rename / move / edit these files unless you want weird behavior.

The JSON is a witness. If you torture it, it will talk… badly.

⚠️ Expired ticket = contents destroyed (intended behavior)

If the ticket expires, withdrawal is denied and the contraband is destroyed.

It’s harsh. It’s unfair. It’s exactly the point.
The terminal is not a daycare.

⚠️ Compatibility / possible conflicts

Since the mod handles inventories and files, conflicts may happen with:

protection / claims mods
inventory-overhaul mods
rollback / restore systems
plugins that intercept block interactions

If something behaves strangely, test first with a clean instance (MineExpress + Forge only).

⚠️ Important (worth keeping on the mod page)

Avoid breaking the terminal while it still contains items unless you have generated a ticket / emptied it first.
For safety, treat the terminal as a transit station, not a permanent chest.

(The machine is not a Swiss bank. Well… not yet.)

Logs & Debug (for bug reports)

The mod writes admin traces to:

/config/admin.log

If you report a bug, please include:

mod version
Forge version
Minecraft version
latest.log
if possible, the related snapshot JSON (without sensitive data if it’s a public server)

The more precise the report, the less likely I need a necromancer to reproduce the bug.

Je suis Suisse et par conséquent je me devais de faire (pour mon premier mod) un terminal de transfert de richesse. Je prépare un Modpack extraction shooter, BattleRoyale, LooterShooter avec histoire à choix multiples et plusieurs fins différentes (Solo). Je prévois un serveur avec compétitions amicales. Donc, pour permettre aux gens de pouvoir repartir avec leurs gains (Items spéciaux et uniques), j'ai développer ce mod. Les joueurs jouant sur leur carte solo peuvent aussi s'en servir pour apporter (leur équipement ou blocs, etc) du matériel sur la carte solo d'un autre joueur. OK ce mod est aussi une possibilité d'apporter la corruption dans un monde. Disons que ça apportera plutôt de la PROFONDEUR au jeux RP!! Je suis Suisse, j'aime l'argent LOL (D'ailleurs, j'écris en Helvetica!!!!!)

MineExpress ajoute un terminal de stockage avec tickets de retrait sécurisés, snapshots JSON, logs admin, et un système anti-duplication / anti-contrebande.
Tu déposes, tu génères un ticket, tu retires plus tard… ou la contrebande finit au cimetière des items.

Le principe :

Tu remplis le Terminal MineExpress.
Tu cliques sur “Générer ticket”.
Le mod crée un snapshot (fichier JSON) du contenu.
Le terminal est vidé, et tu reçois un ticket de retrait lié à ton joueur.
Tu utilises ton ticket sur un terminal MineExpress pour récupérer le contenu (dans un autre serveur ou dans une partie solo, Il faut envoyer le fichier JSON au serveur ou à son ami pour qu'il le mette dans son dossier FedCraft. C'est mon premier mod et je suis pas un champion de l'informatique voilà!!!!).

✅ Fonctions principales

Terminal de stockage (27 slots)
Ticket de retrait sécurisé
- lié au propriétaire (UUID)
- usage unique
- durée de validité limitée
Anti-duplication
- ticket marqué comme utilisé (redeemed)
- suppression du snapshot après retrait
- logs admin de chaque retrait
Logs admin
- trace du joueur, ticket, source, position de retrait, suppression du fichier, etc.
Restauration de tickets
- si un snapshot existe encore dans le dossier, le mod peut restaurer le ticket au login (pratique après crash / déco sauvage)
Ambiance “douane médiévale”
- effets visuels / sonores à l’utilisation
- messages “contrebande” (oui, c’est volontaire 😅)

⏱️ Timers (important)

Ticket valide ~5 minutes
Terminal verrouillé ~6 minutes après émission d’un ticket

Oui, le terminal se repose 6 minutes. Même les machines ont besoin d’un café. (Je suis dans le tertiaire... La machine à café c'est toute ma vie :p )

Avertissements (bugs, duplications, limites)

⚠️ Mod en mode “test sérieux”

Ce mod touche à :

inventaires
fichiers snapshots
tickets NBT
logs / anti-duplication

👉 Faites des backups de vos mondes/serveurs avant usage en production.

Parce que “on verra bien” est une stratégie de speedrun vers le drame.

⚠️ Anti-duplication : ce que le mod fait (et ce qu’il ne fait pas)

Le mod bloque la duplication “gameplay” classique grâce à :

ticket lié au joueur
ticket à usage unique
ticket expiré = retrait refusé
snapshot supprimé après retrait
trace dans les logs admin

Mais (et c’est important) :

le système n’est pas conçu pour contrer la triche admin / accès FTP / manipulation manuelle des fichiers JSON
si quelqu’un copie/modifie les snapshots à la main, il sort du cadre normal du mod

En bref :
MineExpress combat la contrebande en jeu, pas les dieux du serveur avec accès root.

⚠️ Ne touchez pas aux fichiers snapshots à la main

Les snapshots sont stockés dans le dossier :

/FedCraft/ (oui, le nom est hérité… longue histoire 😄)

Ces fichiers JSON sont utilisés pour restaurer les retraits.
👉 Ne pas renommer / déplacer / éditer ces fichiers si vous voulez éviter les surprises.

Le JSON est un témoin. Si vous le torturez, il parlera… mal.

⚠️ Ticket expiré = contenu détruit (comportement voulu)

Si le ticket dépasse sa durée de validité, le retrait est refusé et la contrebande est détruite.

C’est dur. C’est injuste. C’est exactement le principe.
Le terminal n’est pas une garderie.

⚠️ Compatibilité / conflits possibles

Comme le mod manipule des inventaires et des fichiers, des conflits peuvent apparaître avec :

mods de protection / claims
mods d’inventaire modifié
systèmes de rollback / restore
plugins qui interceptent les interactions de bloc

Si vous avez un comportement bizarre, testez d’abord avec une instance propre (MineExpress + Forge uniquement).

⚠️ Important (à signaler si vous le gardez dans la page)

Évitez de casser le terminal avec du contenu dedans sans avoir généré de ticket / vidé le bloc au préalable.
Par sécurité, considérez le terminal comme un poste de transit, pas un coffre permanent.

(La machine n’est pas une banque suisse. Enfin… pas encore.)

Logs & debug (utile pour les reports)

Le mod écrit des traces admin dans :

/config/admin.log

En cas de bug, merci de fournir :

version du mod
version Forge
version Minecraft
log (latest.log)
si possible, le snapshot JSON concerné (sans données sensibles si serveur public)

Plus le report est précis, moins je dois invoquer un nécromancien pour reproduire le bug.