Battery charging station + mobile network - production spec & tracker (collab with @Akita83)

[TheCodingDad-TisonK]

Short version

Akita built two new tablet features. We are finishing them together.

• Battery + charging: the tablet has a battery. It runs down while you use it. You charge it back up at a dock.
• Phone signal: the tablet shows signal bars. When there is no signal, online apps stop showing live numbers and show the last saved numbers instead.

This issue is our shared checklist, so we both know what "finished" means. It follows on from #93.

Two rules for everything here:

• It is all client-side. It must not break dedicated servers.
• The tablet is a per-player HUD. Battery and signal are local to each player. They never run on the server.

Who does what (agreed on Discord)

• Akita: the charging station, battery drain and charge timing, the network build, and tuning.
• Me (Tison): merge into the current tablet, all 26 languages, settings and console, saving, polish.

Where the code is now

All of it is in src/FarmTabletUI.lua.

Battery:

• setup :133-140
• drain :1312-1315
• empty screen :1085-1113
• charging :1116-1124 and :1294-1310

Network:

• setup :142-161
• provider screen :1019-1083
• signal :1170-1260
• toasts :1148-1168

What is still "test only" for now:

• Battery drops about 1% per real minute the tablet is open. It should use in-game time instead.
• Charging is just a button that fills up in about 5 real seconds. It should be a charging dock that takes 1 in-game hour.
• Nothing is saved yet, so it all resets on reload.

---

System 1: Battery + charging dock (do this first)

The idea

There is a charging dock. You walk up to it and press E. The tablet charges to full over 1 in-game hour. While it sits on the dock it is "put away": if you press the open key, you get a message instead of the tablet opening.

The dock

• Best option: a real in-world object (placeable or map asset) that looks like a stand with the tablet in it.
• Simpler option if the object is too much for now: a trigger zone at one fixed spot (for example by the farmhouse) that turns the interaction on.
• When you stand close, show an E prompt that says "Charge tablet". Use the normal action-prompt system so it shows in the help box and respects key rebinds. Do not poll the key directly.
• Press E when the battery is not full: start charging.
• Press E when it is already full: show "Tablet already charged" and change nothing.

How charging works

• Charge from the current level up to 100% over 1 in-game hour. Use game time, not real seconds.
• While charging, the tablet stays closed. If you try to open it (key or console), show "Tablet is charging on the dock".
• Nice to have: a small "charging" indicator in the world or on the HUD so you know it is docked.
• Messages: one when charging starts, one at 100% ("Tablet fully charged").
• If you walk away mid-charge: pick one behaviour and write it down. Suggested: charging pauses and carries on when you come back. It keeps whatever % it reached. Do not reset it to 0.

Drain rework

• Drain on in-game time, not real time. Put the rate in Constants.lua (suggest about X% per in-game hour while open). Decide if it also drains a tiny bit while closed, or not at all, and write down which.
• At 0%, the tablet only shows the empty screen and points you to the dock. No apps at 0%.
• Low-battery warning at a set level (for example 20%).

Saving

• Save the battery % (and the "on dock / charging" flag) so it survives reload. Write it in the save hook (FSCareerMissionInfo:saveToXMLFile), the same way settings are saved. If you only save on change, the save copy can wipe it.
• Load it back in loadMission00Finished.

Settings and console

• Settings toggle: battery system on/off. Off means the tablet never drains (the current default for players who do not want it).
• Settings: drain rate and charge time, or at least a few presets.
• Console commands for testing: TabletBatterySet <0-100>, TabletCharge, TabletBatterySystem on|off.

Edge cases to check

• Sleep or time skip while charging: the charge should still move forward correctly (it is on game time).
• Battery system turned off mid-save: the tablet should just open normally and ignore any stored empty state.
• Multiplayer: each player has their own battery. The dock is local only, no sync needed. Check a dedicated server shows no errors when the dock object loads.

---

System 2: Phone signal

The prototype already works well. The missing piece is meaning. Right now the signal is just for show. Let me make "no signal" actually do something so the system is worth having.

Provider

• Save the chosen provider so it is not asked again every time you open the tablet. The very first open still shows the picker.
• Let the player change provider later from Settings or a small network panel, not only on first launch.

Signal bars

• Keep the position-based bars (_calcLocalSignalBars, same bars at the same spot on the map). Good as is.
• Optional extra: weather lowers signal (storms or heavy rain drop a bar or two). Low priority.

Outages

• Keep random outages, but make how often and how long they happen configurable (in Constants plus a preset: Off / Rare / Normal / Frequent).
• Show a toast when an outage starts and when it ends. Mostly done already, just check the wording for each state.

What "no signal" actually does (the important part)

• Online apps (market, contracts, companion-mod data, anything pulling live numbers) show a "No connection - last synced HH:MM" banner and show the last saved values instead of live ones.
• Local apps (Notes, Settings, anything self-contained) keep working as normal with no signal.
• Give apps the signal state through self.system.signal (already there at :1250-1257) so each app can decide what to do. Add a small helper like self:hasSignal() so apps do not have to read the table by hand.

Settings and console

• Settings toggle: network system on/off. Off means always full signal and no outages.
• Settings: outage frequency preset, and provider.
• Console: TabletSignalSet <0-4>, TabletOutage on|off, TabletNetworkSystem on|off.

Saving

• Save the chosen provider. The outage state does not need to survive reload (it can reset to "ok" on load).

---

Shared work (mostly mine)

• Languages: the new ft_battery_* and ft_network_* keys, plus all new settings and console text, in all 26 languages. They are only in DE and EN right now.
• Settings UI: both on/off toggles and the presets added to the pause-menu settings, using the existing SettingsUI clone helpers.
• Save/load: wire battery and provider into SettingsManager and the save hook.
• No regressions: the existing 30+ apps keep working, and the new screens do not break the lock / home / app flow.
• Version + changelog: bump modDesc.xml, the README version line, and the in-tablet Updates list when this ships.

---

Two things for us to agree on

• How fast the battery drains. Starting idea: a full tablet, left open the whole time, runs flat in about 2 in-game days. That makes it a gentle background thing, not a nag. We tune it together.
• One dock or a buyable one. Start with one fixed dock. If it feels good, we can add a buyable placeable later.

Tagging @Akita83 so we share the checklist. I will tick off the language, settings, and saving rows as I go.

[github-actions]

Hey @TheCodingDad-TisonK, your support ticket has been logged. 📱

@TheCodingDad-TisonK has been notified and will boot up the debugging tools as soon as possible.

Before the dev team digs in, please confirm:

• You are running the latest version of Farm Tablet (visible in the mod manager)
• Your issue includes the relevant [FarmTablet] lines from log.txt
  • Log location: Documents/My Games/FarmingSimulator2025/log.txt
  • Search for [FarmTablet] and paste the relevant section here
• If this involves a specific app (Dashboard, Weather, Soil, Finance, etc.) — note which app and what it showed vs. what you expected
• You have searched existing issues for a similar report

Note: Issues without a log snippet are difficult to diagnose and may be closed. UI and app bugs especially need log data to identify the root cause.

[TheCodingDad-TisonK]

Localization is done on my side. I ported all 86 new keys (battery, network and the four companion-app integrations) from en/de into the other 24 languages, so every language file now carries the same 188 keys. Verified each file is well-formed XML with no missing or duplicate keys, and the %s/%d format slots match the English source per key.

Commits on development:

• d84c503: merge of your prototype (battery, network, AnimalAutoCare, AnimalVetSystem, FactoryWeekSchedule, RealisticDealer)
• 93a0490: the 24-language localization

Remaining shared items in this tracker (settings toggles, console commands, save persistence) are best done once the battery and network systems are reworked from the test build (in-game-time drain, the charging station, the 1 in-game hour charge). I will add the settings/console strings to all 26 languages in the same pass when those land. Over to you for the core build whenever you are ready @Akita83.

[TheCodingDad-TisonK]

@Akita83 Hier die deutsche Version, falls dir das leichter fällt. Inhalt ist genau das gleiche wie oben, nur auf Deutsch. Gute Besserung. 💙

---

Kurzfassung

Akita hat zwei neue Tablet-Funktionen gebaut. Wir bringen sie zusammen fertig.

• Akku + Laden: Das Tablet hat einen Akku. Er entlädt sich beim Benutzen. An einer Ladestation lädst du ihn wieder auf.
• Telefonsignal: Das Tablet zeigt Signalbalken. Wenn es kein Signal gibt, zeigen Online-Apps keine Live-Zahlen mehr, sondern die zuletzt gespeicherten Zahlen.

Dieses Issue ist unsere gemeinsame Checkliste, damit wir beide wissen, was "fertig" heißt. Es ist die Fortsetzung von #93.

Zwei Regeln für alles hier:

• Es läuft alles nur auf dem Client. Es darf Dedicated Server nicht kaputt machen.
• Das Tablet ist ein HUD pro Spieler. Akku und Signal sind bei jedem Spieler lokal. Sie laufen nie auf dem Server.

Wer macht was (auf Discord abgesprochen)

• Akita: die Ladestation, das Timing fürs Entladen und Laden, der Netzwerk-Aufbau und das Tuning.
• Ich (Tison): Einbau ins aktuelle Tablet, alle 26 Sprachen, Einstellungen und Konsole, Speichern, Feinschliff.

Wo der Code gerade liegt

Alles steckt in src/FarmTabletUI.lua.

Akku:

• Setup :133-140
• Entladen :1312-1315
• Leer-Screen :1085-1113
• Laden :1116-1124 und :1294-1310

Netzwerk:

• Setup :142-161
• Anbieter-Screen :1019-1083
• Signal :1170-1260
• Toasts :1148-1168

Was bisher nur "zum Testen" ist:

• Der Akku fällt um etwa 1 % pro echter Minute, in der das Tablet offen ist. Er sollte stattdessen Spielzeit nutzen.
• Laden ist nur ein Knopf, der in etwa 5 echten Sekunden voll lädt. Es sollte eine Ladestation sein, die 1 Spielstunde braucht.
• Es wird noch nichts gespeichert, also ist nach dem Neuladen alles zurückgesetzt.

---

System 1: Akku + Ladestation (zuerst machen)

Die Idee

Es gibt eine Ladestation. Du gehst hin und drückst E. Das Tablet lädt über 1 Spielstunde auf 100 %. Solange es an der Station steht, ist es "weggelegt": Wenn du die Öffnen-Taste drückst, kommt eine Meldung, statt dass das Tablet aufgeht.

Die Station

• Beste Lösung: ein echtes Objekt in der Welt (Placeable oder Map-Asset), das wie ein Ständer mit dem Tablet aussieht.
• Einfachere Lösung, falls das Objekt erstmal zu viel ist: eine Trigger-Zone an einem festen Punkt (zum Beispiel beim Bauernhaus), die die Interaktion anschaltet.
• Wenn du nah dran stehst, zeige eine E-Aufforderung mit dem Text "Tablet laden". Nutze das normale Aktions-Prompt-System, damit es in der Hilfebox steht und Tastenbelegungen respektiert. Frag die Taste nicht direkt ab (kein Key-Polling).
• E drücken, wenn der Akku nicht voll ist: Laden starten.
• E drücken, wenn er schon voll ist: "Tablet bereits geladen" anzeigen und nichts ändern.

Wie das Laden funktioniert

• Vom aktuellen Stand bis 100 % über 1 Spielstunde laden. Spielzeit nutzen, nicht echte Sekunden.
• Während des Ladens bleibt das Tablet geschlossen. Wenn man es öffnen will (Taste oder Konsole), "Tablet lädt an der Station" anzeigen.
• Schön zu haben: eine kleine "Lädt"-Anzeige in der Welt oder im HUD, damit man sieht, dass es an der Station ist.
• Meldungen: eine beim Start des Ladens, eine bei 100 % ("Tablet voll geladen").
• Wenn man mitten im Laden weggeht: ein Verhalten festlegen und aufschreiben. Vorschlag: Laden pausiert und geht weiter, wenn man zurückkommt. Es behält den erreichten Prozentwert. Nicht still auf 0 zurücksetzen.

Entlade-Überarbeitung

• Auf Spielzeit entladen, nicht echte Zeit. Die Rate in Constants.lua ablegen (Vorschlag: etwa X % pro Spielstunde, solange offen). Festlegen, ob es geschlossen auch ein kleines bisschen entlädt oder gar nicht, und aufschreiben, was gilt.
• Bei 0 % zeigt das Tablet nur den Leer-Screen und verweist auf die Station. Keine Apps bei 0 %.
• Akkuwarnung bei einem festen Stand (zum Beispiel 20 %).

Speichern

• Den Akkustand (und das "an der Station / lädt"-Flag) speichern, damit es ein Neuladen übersteht. Im Save-Hook schreiben (FSCareerMissionInfo:saveToXMLFile), genauso wie die Einstellungen gespeichert werden. Wenn man nur bei Änderungen speichert, kann die Save-Kopie es überschreiben.
• In loadMission00Finished wieder laden.

Einstellungen und Konsole

• Einstellung zum An/Aus: Akku-System an/aus. Aus heißt, das Tablet entlädt nie (das aktuelle Standardverhalten für Spieler, die das nicht wollen).
• Einstellungen: Entladerate und Ladezeit, oder zumindest ein paar Voreinstellungen.
• Konsolenbefehle zum Testen: TabletBatterySet <0-100>, TabletCharge, TabletBatterySystem on|off.

Sonderfälle zum Prüfen

• Schlafen oder Zeit überspringen während des Ladens: Das Laden sollte trotzdem korrekt weiterlaufen (es hängt an der Spielzeit).
• Akku-System mitten im Spielstand ausgeschaltet: Das Tablet sollte einfach normal aufgehen und einen gespeicherten Leer-Zustand ignorieren.
• Mehrspieler: Jeder Spieler hat seinen eigenen Akku. Die Station ist nur lokal, keine Synchronisierung nötig. Prüfen, dass ein Dedicated Server keine Fehler zeigt, wenn das Stations-Objekt lädt.

---

System 2: Telefonsignal

Der Prototyp funktioniert schon gut. Was fehlt, ist Sinn. Gerade ist das Signal nur Deko. Ich mache, dass "kein Signal" wirklich etwas bewirkt, damit das System seinen Platz verdient.

Anbieter

• Den gewählten Anbieter speichern, damit nicht bei jedem Öffnen erneut gefragt wird. Beim allerersten Öffnen kommt die Auswahl trotzdem.
• Den Spieler den Anbieter später wechseln lassen, über die Einstellungen oder ein kleines Netzwerk-Panel, nicht nur beim ersten Start.

Signalbalken

• Die positionsbasierten Balken behalten (_calcLocalSignalBars, gleiche Balken an der gleichen Stelle auf der Map). So gut wie es ist.
• Optionale Zugabe: Wetter senkt das Signal (Stürme oder starker Regen nehmen ein bis zwei Balken weg). Niedrige Priorität.

Ausfälle

• Zufällige Ausfälle behalten, aber wie oft und wie lange sie passieren einstellbar machen (in Constants plus eine Voreinstellung: Aus / Selten / Normal / Häufig).
• Einen Toast zeigen, wenn ein Ausfall beginnt und wenn er endet. Meistens schon da, nur den Wortlaut für jeden Zustand prüfen.

Was "kein Signal" wirklich macht (der wichtige Teil)

• Online-Apps (Markt, Aufträge, Daten von Begleit-Mods, alles mit Live-Zahlen) zeigen ein Banner "Keine Verbindung - zuletzt aktualisiert HH:MM" und zeigen die zuletzt gespeicherten Werte statt der Live-Werte.
• Lokale Apps (Notizen, Einstellungen, alles Eigenständige) laufen ohne Signal ganz normal weiter.
• Den Apps den Signalzustand über self.system.signal geben (schon da bei :1250-1257), damit jede App selbst entscheiden kann. Einen kleinen Helfer wie self:hasSignal() hinzufügen, damit Apps die Tabelle nicht von Hand lesen müssen.

Einstellungen und Konsole

• Einstellung zum An/Aus: Netzwerk-System an/aus. Aus heißt immer volles Signal und keine Ausfälle.
• Einstellungen: Voreinstellung für Ausfall-Häufigkeit und Anbieter.
• Konsole: TabletSignalSet <0-4>, TabletOutage on|off, TabletNetworkSystem on|off.

Speichern

• Den gewählten Anbieter speichern. Der Ausfall-Zustand muss kein Neuladen überstehen (er kann beim Laden auf "ok" zurückgesetzt werden).

---

Gemeinsame Arbeit (meist meine)

• Sprachen: die neuen ft_battery_*- und ft_network_*-Keys plus alle neuen Texte für Einstellungen und Konsole in allen 26 Sprachen. Gerade nur in DE und EN.
• Einstellungs-UI: beide An/Aus-Schalter und die Voreinstellungen ins Pause-Menü einbauen, mit den vorhandenen SettingsUI-Klon-Helfern.
• Speichern/Laden: Akku und Anbieter in SettingsManager und den Save-Hook einbinden.
• Keine Rückschritte: die vorhandenen 30+ Apps laufen weiter, und die neuen Screens brechen den Sperr-/Home-/App-Ablauf nicht.
• Version + Changelog: modDesc.xml, die Versionszeile in der README und die Updates-Liste im Tablet hochsetzen, wenn das rauskommt.

---

Zwei Dinge, die wir noch festlegen

• Wie schnell der Akku leer wird. Erste Idee: ein voller Akku, die ganze Zeit offen gelassen, ist nach etwa 2 Spieltagen leer. So ist es eine sanfte Sache im Hintergrund, kein Nerv. Wir tunen das zusammen.
• Eine Station oder eine kaufbare. Mit einer festen Station anfangen. Wenn es sich gut anfühlt, können wir später ein kaufbares Placeable ergänzen.

@Akita83 markiert, damit wir die Checkliste teilen. Ich hake die Zeilen für Sprachen, Einstellungen und Speichern ab, während ich vorankomme.