Arcadia SpriteConfig Compatibility Patch [B42]
Изображение 1 из 2. Материалы автора из Steam Workshop.
О материале
«Arcadia SpriteConfig Compatibility Patch [B42]» — материал мастерской Project Zomboid. Карты, транспорт, оружие и моды для выживания. Данные Steam, описание автора и ссылка для установки через подписку. Совместимость редакцией не проверена.
Описание автора
Arcadia SpriteConfig Compatibility Patch [B42]
What Problem Does This Fix?
Long-running Build 42 worlds can collect player-built objects whose saved appearance no longer matches the definition the game expects. Version 1.8.8: retains only a capped invalid-repair queue and removes the legacy all-build coordinate ledger on upgrade. This prevents persistent Global ModData growth during normal construction without increasing scan, repair, streaming or Java-object work.
The server may repeatedly report:
Invalid SpriteConfig object!
Affected objects may include:
-
Wooden walls, windows and frames
-
Player-built floors
-
Doors, gates and fences
-
Crates
-
Crafted or placed furniture
-
Gravel and sand flooring
One bad object can produce the same warning repeatedly whenever players load its area. A server may therefore display thousands of warnings without having thousands of different broken objects.
Driving does not appear to create the problem. Driving exposes it because many chunks and player-built areas are loaded quickly. Large groups of mismatched objects may contribute to delayed chunks, black areas, high ping, vehicle desynchronization and localized server strain.
What Does This Mod Do?
The mod gradually finds affected objects as their areas load naturally.
When it finds a mismatch, it checks the object's saved appearance against the appearance registered by the game. It repairs the object only when the correct result can be proven.
The repair changes only the incorrect sprite connection. The original world object remains in place.
Once repaired, that object should stop producing its former mismatch warning when the area is loaded again.
Repairing the accumulated backlog of a large world is like trying to extinguish the sun with a garden hose. The important discovery is that the hose works.
How the targeted repair works
The targeted repair is driven by normal player exploration, but has hard global limits so it does not scale Java stream work with player count.
-
Player movement schedules one small 5x5 vicinity zone. Only one already-loaded square is inspected globally every two seconds.
-
A newly built or placed object can be checked when the game adds it.
-
A recorded invalid object is reconsidered only when its exact X/Y/Z square is already loaded by normal play.
-
A moving player cannot reset unfinished work; the current zone finishes before one newest requested zone is considered.
-
Each inspected square is capped at 32 object slots. Exact duplicate evidence is treated as ambiguous and left untouched.
-
Automatic repair remains limited to verified construction evidence. Structural and customized appearances stay protected.
-
Repairs waiting during a burst remain bounded, and all mutation paths share a maximum rate of one repair per second.
-
The mod never forces unloaded chunks to open, performs a global scan, or retains Java world objects between worker steps.
There is no forced streaming, global cursor, safehouse sweep, driving scanner, client scanner, or unbounded Java-object cache.
Server-Side Repair Record
The current version records every successful repair in the server log.
Each record includes:
-
The object's X, Y and Z coordinates
-
The object and construction type
-
The appearance found
-
The corrected appearance
-
Whether the repair succeeded or was safely refused
This allows server owners to investigate reports of missing walls or turned furniture and see exactly what the mod changed.
Unclear furniture directions are logged and left untouched. Failed changes are rolled back instead of being sent to players.
Measured Results
The following results come from retained logs on a large active multiplayer server.
Beta 1.6:
-
68.49 logged server hours
-
389,788 repeated SpriteConfig warnings
-
Approximately 5,692 warnings per hour
-
496 successful repairs
-
Approximately 7 repairs per hour
Current Beta 1.7 beta.5:
-
43.53 logged server hours
-
123,307 repeated SpriteConfig warnings
-
Approximately 2,833 warnings per hour
-
11,216 successful repairs
-
Approximately 258 repairs per hour
-
Zero sprite transmission failures
Compared with Beta 1.6:
-
The average warning rate fell by approximately 50%.
-
The successful repair rate became approximately 36 times faster.
-
Beta 1.6 averaged one repair per 786 warning appearances.
-
Beta 1.7 beta.5 averages one repair per approximately 11 warning appearances.
Three repair attempts were safely rejected and rolled back. All three records involved the same unsupported Lifestyle disco-ball object returning after separate restarts. The object was not deleted, moved or replaced.
These figures are real server-log results, not a controlled laboratory test. Player count, driving, explored areas and server activity changed between sessions. Warning totals are repeated messages, not unique broken objects.
Data Safety
-
Does not delete, replace, move or rebuild world objects.
-
Does not remove walls, stairs, floors, furniture or containers.
-
Does not remove items from crates, backpacks, vehicles or player inventories.
-
Does not change object coordinates or move structures between floors.
-
Does not directly rewrite map, database or save files.
-
Preserves container contents, ownership, health and unrelated saved information.
-
Stores the original sprite before applying a correction.
-
Verifies the result and rolls back a failed change.
Appearance Protection
Player customization is protected.
The mod leaves an object unchanged when its appearance may represent:
-
Carpet or alternate flooring
-
Plaster
-
Paint
-
Wallpaper
-
Interior finishes
-
Burnt or damaged appearances
-
Modded tile families
-
Furniture with an uncertain direction
-
An incomplete or unsafe multi-piece object
The mod does not guess. If the correct appearance cannot be proven, the object remains untouched.
What Does It Not Fix?
This mod does not repair:
-
Missing or corrupted map chunks
-
Objects already lost during a rollback or failed save
-
Stuck or duplicated inventory items
-
Container ID problems
-
Missing item or object mods
-
Structural damage caused by gameplay
-
Objects without a usable game definition
Cleanup is gradual. An affected area must load naturally before its objects can be checked.
Installation
Add the Workshop ID and Mod ID to the server:
WorkshopItems=3782457233
Mods=ArcadiaSpriteConfigCompat_B42
Existing servers can add the mod without wiping the world. Backing up an important multiplayer save before changing any server mod list is always recommended.
Support Midgar's Project Zomboid Workshop
If this mod has improved your game, server or community, optional support helps fund Build 42 testing, compatibility updates, server infrastructure, artwork and continued maintenance. Public fixes remain free and are never paywalled.
Join the Arcadia Rising Community
Get update news, support, bug-report help and access to our active long-term Project Zomboid RP/PVE community.
Server: 50.5.46.175:16261
Workshop ID: 3782457233 Mod ID: ArcadiaSpriteConfigCompat_B42
Как установить и запустить
Откройте оригинальную страницу в Steam Workshop, проверьте версию игры, зависимости и порядок загрузки в описании автора. Нажмите «Подписаться» и дождитесь загрузки Steam. Включите материал в меню модификаций или контента игры, если это требуется. Совместимость и запуск редакцией не проверены.