Към съдържанието
PN Scripts

Инструменти за разработка на игри

Stashwright by PN Scripts

Старите записи не се чупят неусетно: пазите истински записи от всяко издание като образци и всяка версия трябва да ги отваря точно както е записано. Плюс слотове с версии, атомарен запис, контролни суми, копия, миграции и AES. Unity не е пускан; ядрото е тествано с .NET.

  • C#
  • .NET Standard 2.1
  • Newtonsoft.Json
  • Unity Package Manager
  • xUnit
  • Очаквайте скоро

Очаквайте скоро

Още не е публикуван в магазина, затова няма връзка за покупка или изтегляне. PN Scripts не приема плащане за него тук.

Три карти на слотове с резервните им файлове и размери до JSON съдържанието на slot1.save

Какъв проблем решава

Празнината

Простият код за записи пише направо върху единственото копие на прогреса на играча, не различава повреден файл от здрав и чупи старите записи, щом класовете с данни се променят.

Какво представлява

Stashwright пази истински записи от всяко издание като образци с очаквания резултат и спира версията, когато стар запис се счупи, зареди се различно, има пропуск в миграциите или няма образец, върху атомарен запис, контролни суми, копия и миграции.

Как се използва

Научавате преди издаването, а не от играчите, че обновление е счупило стар запис, и можете да променяте данните си без да гадаете.

Компактен слой за записи с включен код за Unity разработчици, които искат записи, устойчиви на сривове и с версии, без голяма рамка за данни.

За кого е

Използвайте го когато

  • Доказване в CI, че обновление, дори променящо формата на записа, още отваря всеки запис, който играчите вече имат
  • Слотове за записи в RPG, приключенски и управленски игри
  • Откриване на редактирани или повредени записи на PC и мобилни устройства

Направено за

  • Unity разработчици, които днес пишат собствен код за записи
  • Малки екипи, които обновяват игри с дълготраен прогрес

Какво има вътре

Проверка на старите записи

Пазете в папка истински запис от всяка пусната версия, заедно с файл, който казва как трябва да се зареди. Един тест зарежда всички с текущия ви код и настройки и пада с четлив отчет, когато стар запис вече не се зарежда, зарежда се различно (например wallet.gold: 50 -> 0 след счупена миграция), няма образец за пусната версия или няма стъпка на миграция към следващата. Образците се проверяват без резервни копия, никога не се заменят тихо, а умишлена промяна трябва да бъде приета изрично.

Слотове, формат на файла и запис, устойчив на сривове

Всеки слот е един JSON файл с маркер на формата, име на слота, версия на записа, UTC време, пореден номер, вашите метаданни (място, ниво, изиграно време), SHA-256 контролна сума и съдържанието. ListSlotsAsync чете само тези заглавия, най-новите първи, така че менюто за зареждане показва всички слотове, без да зарежда или декриптира данните. SaveAsync пише в slot.save.tmp, изпраща го на физическия диск и го преименува върху слота. Преди това текущият файл се копира в slot.save.bak1, а по-старите копия се отместват до зададения брой. Запис, прекъснат преди преименуването, оставя стария запис на място, а CleanUpInterruptedWrites маха останалия временен файл.

Откриване на повреди и възстановяване

При зареждане се проверяват пликът, името на слота, контролната сума и при криптирани записи HMAC. Отхвърленият файл се отчита с причина, използва се най-новото здраво копие и се записва обратно като слот, а резултатът е RecoveredFromBackup. Ако всички копия са лоши, резултатът е Corrupt и нищо не се презаписва.

Миграции и криптиране

Вдигнете версията на записа, когато данните се променят, и регистрирайте по една миграция за стъпка; всяка получава суровия JSON и връща надградения, а резултатът показва пътя, например 1, 2, 3. Криптирането е по избор: AES-256-CBC с нови сол и IV при всеки запис, HMAC-SHA256 върху шифъра и ключове от паролата чрез PBKDF2-SHA256. То спира лесното редактиране; ключ в билд на играта може да бъде извлечен.

Спецификации

Наличност
Очаквайте скоро
Разработчик
PN Scripts
Вид
Пакет
Ценообразуване
Еднократно плащане Цената ще бъде обявена.
Лиценз
Собственически лиценз
Внедряване
Изтегляне (UPM tarball и ZIP с C# код)
Зрялост
v1.1.0

Съвместимост

Платформа или среда Поддържани версии Тествано до
.NET (основна библиотека) netstandard2.1 или по-нова .NET 8.0
Unity 2021.3 или по-нова компилирано срещу 6000.5.4, не е стартирано

Стек

  • C#
  • .NET Standard 2.1
  • Newtonsoft.Json
  • Unity Package Manager
  • xUnit

Stashwright by PN Scripts предстои

Продуктът е завършен и тестван. Още не се продава; тази страница ще посочи откъде да го вземете, когато започне.

Очаквайте скоро

Още не е публикуван в магазина, затова няма връзка за покупка или изтегляне. PN Scripts не приема плащане за него тук.

Въпроси

Система за записи за Unity: слотове с версии в JSON с миграции, атомарен запис, контролни суми, резервни копия с възстановяване, криптиране с AES по избор и асинхронен API, с целия C# код. Другите системи за записи за Unity също слагат версии и правят миграции; Stashwright добавя частта, която доказва, че всичко работи: набор от истински стари записи със записан резултат, проверка, която пускате в тестовете или CI, и отчет, който посочва точно коя стойност се е променила. Практиката да се пазят стари записи като тестови файлове е добре позната; Stashwright носи готовите средства за нея.

Пакетът изисква Unity 2021.3 или по-нов и официалния пакет Newtonsoft JSON. Ядрото е за netstandard2.1 и е тествано на .NET 8 под Linux. Редакторът на Unity не е пускан за тази версия: скриптовете за Unity са компилирани срещу асемблитата на Unity 6000.5.4, но нищо не е пускано в Unity.

Няма записи в облака или платформено хранилище (Steam, конзоли, iCloud), няма двоичен сериализатор, няма отделно хранилище за WebGL и няма визуален преглед на записите освен менюто в редактора. Настройките за IL2CPP stripping не са тествани.

Написано е на C# с Newtonsoft.Json и криптографските API-та на .NET. Създадено с помощта на AI; ядрото е проверено от PN Scripts с 54 теста с xUnit на .NET 8 и със сценарий върху истински файлове, от който са и изображенията.

Още не се продава. Когато започне, тази страница ще води към магазина; PN Scripts не приема плащания на този сайт.