Valheim-ის modpack Thunderstore-ზე: შექმნა, გამოქვეყნება, განახლება

Thunderstore-ის modpack პატარა zip-ია, რომელშიც ოთხი ფაილია და არც ერთი მოდი: manifest.json, რომლის dependencies სიაში ჩამოთვლილია შენი სერვერის ყველა მოდი და ვერსია, 256-ზე-256 ზომის icon.png, README.md და სურვილისამებრ config საქაღალდე. მას ტვირთავ გუნდის სახელით და შემდეგ ყველა მოთამაშე r2modman-ში, Gale-ში ან Thunderstore Mod Manager-ში ერთი დაწკაპუნებით დააყენებს ზუსტად შენს ნაკრებს. დაჭერა სიტყვა "private"-შია: Thunderstore-ზე პირადი ან ჩამონათვალში არარსებული პაკეტები არ არსებობს, ამიტომ modpack ატვირთვისთანავე საჯაროა. თუ ეს მნიშვნელოვანია, ამის ნაცვლად გაუზიარე ექსპორტირებული პროფილის ფაილი. თუ არა, გამოქვეყნებული პაკეტი ყველაზე სუფთა გზაა, რომ ჯგუფი თვეების განმავლობაში ერთსა და იმავე ვერსიებზე დარჩეს, ოღონდ განაახლე გააზრებულად და არა ყოველ ჯერზე, როცა მოდის ავტორი რამეს გამოუშვებს.

Modpack, პროფილის კოდი თუ პროფილის ფაილი#

ჯგუფს ერთი და იგივე მოდების ნაკრები სამი გზით შეგიძლია გადასცე და თითოეული ოდნავ განსხვავებულ პრობლემას წყვეტს.

პროფილის კოდი ყველაზე სწრაფია და პირველი საღამოსთვის სწორი არჩევანია. ექსპორტირებული .r2z მუდმივია და config საქაღალდესაც მოიცავს, ამიტომ პირადი გამოყენებისთვის საუკეთესოა - ორივეზე წერია r2modman-ის პროფილები ჯგუფისთვის. modpack-ის დამატებითი შრომა გამართლებულია, თუ ქვემოთ ჩამოთვლილთაგან ერთი მაინც შეესაბამება შენს შემთხვევას:

• ჯგუფი იცვლება. ახალი მოთამაშეები კვირების შემდეგ ჩამოდიან და არ უნდა ეძებონ Discord-არხში მიმაგრებული ფაილი.
• გაქვს საჯარო ან ნახევრად საჯარო სერვერი და სერვერის აღწერაში გინდა ბმული, რომელიც ყოველთვის მიმდინარე ნაკრებზე მიუთითებს.
• გინდა ვერსიების ისტორია. ყოველი ატვირთვა დანომრილი ვერსიაა და მენეჯერი თითოეულ მოთამაშეს ეუბნება, როცა ახალი ვერსია გამოვა.
• მოთამაშეები სხვადასხვა მენეჯერს იყენებენ. Thunderstore-ის პაკეტები საერთო ფორმატია, რომელსაც ყველა მენეჯერი კითხულობს.

რა არ არის modpack: სხვის მოდებს გავრცელების საშუალება. პაკეტი მოდებზეა დამოკიდებული და მათ .dll ფაილებს არ შეიცავს. Thunderstore-ის წესები სხვისი ნამუშევრის ხელახლა ატვირთვას კრძალავს და ასლებიანი პაკეტი წაიშლება. dependency მექანიზმი სწორედ იმისთვის არსებობს, რომ ეს არ დაგჭირდეს.

zip-ის სტრუქტურა#

ატვირთვა ერთი zip არქივია და ფაილები მის ძირში უნდა იდოს და არა რომელიმე საქაღალდის შიგნით. ატვირთვის უარყოფის ყველაზე ხშირი მიზეზი ისაა, რომ დააარქივე საქაღალდე და არა მისი შიგთავსი.

LongshipCrew_Modpack-1.0.0.zip    manifest.json    icon.png    README.md    CHANGELOG.md        optional, shown on its own tab    config/             optional, mod settings for clients        com.example.somemod.cfg

zip-ის სახელს Thunderstore-ისთვის მნიშვნელობა არ აქვს, მაგრამ თუ პაკეტისა და ვერსიის სახელს დაარქმევ, შენს საქაღალდეში ორმოც ფაილშიც კი გაერკვევი.

მოთხოვნები, რომლებსაც Thunderstore ატვირთვისას ამოწმებს:

• `manifest.json` - ვალიდური JSON იმ ველებით, რომლებიც შემდეგ თავშია აღწერილი.
• `icon.png` - PNG ზუსტად 256-ზე-256 პიქსელი. არა 512 და არა გადარქმეული JPEG. უბრალო ფერადი კვადრატი სერვერის ინიციალებით საკმარისია, modpack-ებს სურათების გამო არავინ ათვალიერებს.
• `README.md` - პაკეტის გვერდად აისახება. შეიძლება მოკლე იყოს, მაგრამ უნდა არსებობდეს.

CHANGELOG.md სურვილისამებრია. თუ არის, პაკეტის გვერდზე Changelog ჩანართად გამოჩნდება და ეს ყველაზე სასარგებლოა მოთამაშეებისთვის, რომლებსაც აინტერესებთ, რატომ სთავაზობს მენეჯერი განახლებას.

manifest.json, ველი-ველი#

პატარა ჯგუფის პაკეტისთვის მთელი ფაილი ასეთია:

{  "name": "LongshipCrew_Modpack",  "version_number": "1.0.0",  "website_url": "",  "description": "Mods for the Longship Crew server. Install this, then join.",  "dependencies": [    "denikson-BepInExPack_Valheim-5.4.2202",    "ValheimModding-Jotunn-2.20.1",    "ValheimModding-HookGenPatcher-0.0.4",    "RandyKnapp-EpicLoot-0.10.3",    "Advize-PlantEverything-1.18.2"  ]}

ზემოთ მოცემული ვერსიის ნომრები ფორმატის მაგალითია და არა რეკომენდაცია - რეალური ნომრები დააკოპირე თითოეული პაკეტის გვერდიდან, როგორც ქვემოთ წერია.

name-ის შეზღუდვაზე ხშირად წყდებიან, რადგან დეფისი მიზეზით არის აკრძალული: dependency სტრიქონებში დეფისი გამყოფია. Longship-Crew ორაზროვანი იქნებოდა, Longship_Crew - არა.

Thunderstore-ს საიტზე Tools განყოფილებაში manifest-ის ვალიდატორიც აქვს. ფაილი zip-ამდე ჩასვი და გამოტოვებულ მძიმეს ატვირთვის ფორმამდე იპოვი.

Dependency სტრიქონები

თითოეული ჩანაწერი არის Namespace-PackageName-Version, სადაც namespace ატვირთული გუნდია და არა აუცილებლად ავტორის საჩვენებელი სახელი. არც ერთი ნაწილის გამოცნობა არ გჭირდება: Thunderstore-ის ყველა პაკეტის გვერდზე ნაჩვენებია იმ ვერსიის dependency სტრიქონი, რომელსაც უყურებ, დასაკოპირებლად მზა. თუ ძველი ვერსია გინდა, გვერდზე ვერსიების სიაში გადადი.

სამი რამ უნდა გაითვალისწინო:

1. ჩართე loader და ბიბლიოთეკები. denikson-ის BepInExPack_Valheim Valheim-ისთვის BepInEx-ის აწყობაა და ყველა პაკეტში უნდა იყოს. ბიბლიოთეკები, როგორიცაა Jotunn და HookGenPatcher, თავისით მოჰყვება მათზე დამოკიდებულ მოდებს, მაგრამ ცალკე ჩამოთვლა მათ ვერსიასაც ამაგრებს, რაც ბიბლიოთეკის განახლებას ნაკრების ჩუმად გაფუჭებას უშლის ხელს.
2. თითო ჩანაწერი თითო პაკეტზე. ერთი მოდის ორი ვერსია სიაში პრობლემას ელოდება და ზოგი მენეჯერი იმას დააყენებს, რომელსაც ბოლოს შეხვდება.
3. გამოტოვე ის, რასაც სერვერი კრძალავს. თუ სერვერი არ იყენებს კლიენტის მხარის მოდს, რომელიც წესებს ცვლის - ტვირთის წონის ან ერთ უჯრაში დაწყობის ზომის მოდიფიკატორს - პაკეტში არ ჩასვა. მოთამაშე, რომელსაც ის აქვს და სერვერზე შედის, სადაც არ არის, დანარჩენებთან შეუსაბამოა.

thunderstore.io-ზე გამოქვეყნება#

გჭირდება ანგარიში და გუნდი. შედი thunderstore.io-ზე (შესვლა შეიძლება Discord-ით, GitHub-ით ან Overwolf-ით), გახსენი პარამეტრები და შექმენი გუნდი. გუნდის სახელი namespace-ია, რომელიც ყველა dependency სტრიქონში შენს პაკეტს წინ უძღვის და პაკეტის სახელის მსგავსად პრაქტიკულად მუდმივია, ამიტომ აირჩიე ისეთი, რომლის გამოც წელიწადში არ შეგრცხვება - ჩვეულებრივ სერვერის სახელს იყენებენ.

შემდეგ:

1. საიტის მენიუდან გახსენი ატვირთვის გვერდი და აირჩიე zip.
2. აირჩიე Valheim-ის community. არასწორში ატვირთვა ადვილია, რადგან ფორმა ბოლო არჩევანს იმახსოვრებს.
3. აირჩიე Modpacks კატეგორია და სხვა, რომლებიც შიგთავსს პატიოსნად აღწერს.
4. NSFW უჯრა მხოლოდ საჭიროების შემთხვევაში მონიშნე და გააგზავნე.

თუ ფორმა ატვირთვას უარყოფს, შეტყობინება პრობლემას ასახელებს: icon-ის ზომა, manifest-ის ველი, უკვე არსებული ვერსია. გამოასწორე და ხელახლა ატვირთე. მიღების შემდეგ პაკეტი Valheim-ის ჩამონათვალში და ყველა მენეჯერის ძიებაში ჩვეულებრივ რამდენიმე წუთში ჩნდება.

ყოველი გამოქვეყნებული ვერსია მუდმივად ჩათვალე. ატვირთულ ვერსიას ჩუმად ვერ შეცვლი და წაშლას არ უნდა დაეყრდნო; გაფუჭებული რელიზის გამოსწორება უფრო მაღალი ნომრის ახალი ვერსიაა. ეს ამავე დროს უპირატესობაცაა და შეზღუდვაც: მოთამაშეს, რომელმაც მარტში 1.2.0 დააიმპორტა, ისევ შეუძლია ზუსტად ნახოს, რა იყო მასში.

ვინც ხშირად აქვეყნებს, Thunderstore-ს ბრძანების ხაზის ინსტრუმენტი tcli აქვს, რომელიც პროექტის საქაღალდიდან zip-ს აგებს და გუნდის პარამეტრებში შექმნილი token-ით ტვირთავს. თვეში ერთხელ განახლებადი პაკეტისთვის ეს ზედმეტია და მისი კონფიგურაციის ფორმატი რელიზებს შორის იცვლებოდა, ამიტომ ამ გზას თუ აირჩევ, დაკოპირებული მაგალითის ნაცვლად მისივე README წაიკითხე.

Config ფაილების გაგზავნა პაკეტთან ერთად#

modpack-ს მოდების გარდა პარამეტრებიც შეუძლია ატაროს. zip-ის ზედა დონის config საქაღალდეში მდებარე ფაილებს r2modman და მასზე აგებული მენეჯერები პაკეტის დაყენებისას პროფილის BepInEx/config-ში აკოპირებენ. ასე მიიღებ, რომ ყველა კლიენტის ინტერფეისის მოდი, ღილაკების გარეშე ნაგულისხმევი მნიშვნელობები და კლიენტის მხარის მნიშვნელობები პირველივე გაშვებიდან იდენტურია.

რა უნდა იყოს იქ და რა არა:

• კლიენტის მხარის პარამეტრები, რომლებიც საერთო გინდა. რუკის ნიშნულების ნაგულისხმევი მნიშვნელობები, შეთანხმებული ღილაკების განლაგება, ჯგუფის გადაწყვეტილებით გაწყობილი მოხერხებულობის მოდი.
• არა სერვერთან სინქრონიზებული პარამეტრები. თუ მოდი თავის config-ს სერვერიდან აგზავნის - ServerSync-ზე ან Jotunn-ის მხოლოდ ადმინისტრატორისთვის განკუთვნილ სინქრონზე აგებული მოდების უმეტესობა ასეა - კლიენტის ასლი დაკავშირებისას ეწერება. მისი გაგზავნა უვნებელია, მაგრამ უსარგებლო, და ატყუებს მას, ვინც ცვლილების იმედით ედითებს. როგორ მუშაობს ServerSync და config-ის იძულება განმარტავს, რომელი მხარე იმარჯვებს.
• არა BepInEx.cfg, თუ კონკრეტული მიზეზი არ გაქვს. loader-ის საკუთარი პარამეტრები კლიენტებზე პაკეტის ნაგულისხმევზე დატოვე.

შეამოწმე, რას აკეთებს შენი მენეჯერი განახლებისას. ზოგი ვერსია ყოველ განახლებაზე პაკეტის config ფაილებს ანაცვლებს და მოთამაშის პირად ცვლილებებს აბრუნებს; სხვები არსებულ ფაილებს ხელს არ ახლებენ. დააყენე პაკეტი სუფთა პროფილში, შეცვალე პარამეტრი, განაახლე პაკეტი და ნახე. თუ მოთამაშეები პირად პარამეტრებს კარგავენ, გაგზავნილი config იმ რამდენიმე ფაილით შეზღუდე, რომლებიც მართლა უნდა ემთხვეოდეს.

იგივე ნაკრები გამოყოფილ სერვერზე#

modpack-ს სერვერზე არც ერთი მენეჯერი არ აყენებს. სერვერს იგივე plugin-ები სჭირდება BepInEx/plugins-ში და ხელით უნდა მიიტანო. საიმედო მეთოდი პროფილს წყაროდ იყენებს:

1. შენი modpack სუფთა პროფილში შენს კომპიუტერზე დააიმპორტე. ეს ამოწმებს, რომ გამოქვეყნებული პაკეტი სწორად იხსნება, და ზუსტ ფაილებს გაძლევს.
2. მენეჯერის პარამეტრებში გამოიყენე პროფილის საქაღალდის დათვალიერების ვარიანტი. Windows-ზე r2modman-ისთვის ის არის %AppData%\r2modmanPlus-local\Valheim\profiles\<profile name>.
3. პროფილიდან BepInEx/plugins დააკოპირე სერვერის BepInEx/plugins-ში, მხოლოდ კლიენტის მოდების გარეშე.
4. BepInEx/patchers-ის შიგთავსიც დააკოპირე. HookGenPatcher იქ ცხოვრობს და არა plugins-ში.
5. სერვერი ერთხელ გაუშვი, გააჩერე, შემდეგ სერვერის BepInEx/config-ში გენერირებული config-ები შეცვალე.
6. ისევ გაუშვი და ლოგში plugin-ების ხაზები შეადარე შენს manifest-ს.

$ grep -o 'Loading \[[^]]*\]' BepInEx/LogOutput.log | sortLoading [EpicLoot 0.10.3]Loading [Jotunn 2.20.1]Loading [PlantEverything 1.18.2]

BepInExPack-ი თავადაც სერვერზე უნდა იდოს, ოღონდ თავისივე ჩამოტვირთვიდან, სერვერის ძირში გახსნილი, როგორც წერია Valheim-ის მოდები BepInEx-ით სერვერზე, და არა კლიენტის პროფილიდან ნაწილ-ნაწილ გადმოკოპირებული. RE:NODE-ის Valheim სერვერზე ატვირთვა ფაილების მენეჯერით ან SFTP-ით ხდება - გადაათრიე plugins საქაღალდე ან ატვირთე zip და ადგილზე გახსენი - და კონსოლში სერვერის გაშვებისას ცოცხლად ჩანს BepInEx-ის ბანერი და ყოველი Loading ხაზი.

კლიენტის მოდები სერვერზე არ დატოვო, მაშინაც კი, თუ ისინი ჩაიტვირთება. უმეტესობა უსაფრთხოა headless პროცესში, რამდენიმე კი გაშვებისას ინტერფეისს ეხება და exception-ს აგდებს, ხოლო ყოველი ზედმეტი plugin კიდევ ერთი ხაზია საკითხავი, როცა რამე მართლა გაფუჭდება. თუ არ იცი, მოდი რომელ მხარეს ეკუთვნის, ავტორის გვერდი გეტყვის, ხოლო BepInEx-ის ლოგის გზამკვლევი აჩვენებს, როგორ გამოიყურება სერვერზე გაფუჭებული კლიენტის მოდი.

პაკეტის განახლება მოდების ცვლილებისას#

პაკეტი მხოლოდ მაშინ არის სასარგებლო, როცა სერვერს ემთხვევა, და ის დღესვე წყვეტს დამთხვევას, როცა ერთ მხარეს განაახლებენ და მეორეს - არა. სამუშაო რუტინა:

1. განაახლე გადაწყვეტილებით და არა ავტორების კვალდაკვალ. Epic Loot-ის ახალი რელიზი სამშაბათ საღამოს პაკეტის შეცვლის მიზეზი არ არის. ცვლილებები შეაგროვე და სესიამდე გააკეთე და არა მის დროს.
2. სერვერის `BepInEx` საქაღალდე და სამყარო შეინახე backup-ში. ბოლო სამუშაო მდგომარეობის დაბლოკილი backup არის ის, რასაც აღადგენ, როცა ახალი ნაკრები გაფუჭდება. Backup-ები, რომლებიც მართლა აღდგება ამის გამოცდის სასარგებლოდ მსჯელობს.
3. ჯერ სატესტო პროფილი განაახლე. ვერსიები პროფილის ასლში შეცვალე, გაუშვი, ცვლილების დიდი მასშტაბის შემთხვევაში სამყაროს ასლი ლოკალურად ჩატვირთე და დარწმუნდი, რომ სუფთად იწყება.
4. გაზარდე ვერსიის ნომერი. Patch - ერთი მოდის ვერსიის ასამაღლებლად, minor - მოდის დასამატებლად ან ამოსაღებად, major - ცვლილებისთვის, რომელსაც ახალი სამყარო სჭირდება ან შენახულს არღვევს.
5. ჩაწერე changelog-ის ხაზი. თითო ხაზი ყოველ ცვლილებაზე, მიზეზით.
6. ატვირთე, შემდეგ სერვერი განაახლე, შემდეგ ჯგუფს შეატყობინე. ამ თანმიმდევრობით და ერთ საათში. სერვერის შეცვლასა და მოთამაშეების განახლებას შორის არსებულ ფანჯარაში ხალხი შეუსაბამობის გამო გამოაგდებს.

## 1.3.0- Added PlantEverything (agreed in Discord, 12 Oct)- Jotunn 2.20.1, required by the new Epic Loot## 1.2.1- Epic Loot 0.10.3 - fixes the enchanting table crash

Valheim-ის patch-ის შემდეგ თანმიმდევრობა სხვაა: თამაშის განახლება მოდებს ამსხვრევს, სანამ ავტორები არ დაეწევიან, ამიტომ პაკეტი მათ ელოდება და სერვერი - პაკეტს. რა გააკეთო, როცა მოდის განახლება აფუჭებს ზოგად პროცედურას შეიცავს, ხოლო მოდის ვერსიის შეუსაბამობის გამო გამოგდება იმ შეტყობინებებს ეხება, რომლებსაც მოთამაშეები ხედავენ, როცა მხარეები დაშორდება.

ატვირთვისა და დაყენების პრობლემები#

"Manifest is invalid" ან ველის შეცდომა ატვირთვისას. ჩვეულებრივ name-ში დეფისი ან გამოტოვებაა, ორნაწილიანი ვერსია, როგორიცაა 1.0, გამოტოვებული website_url ან ბოლო dependency-ის შემდეგ ზედმეტი მძიმე. ფაილი ვალიდატორში გაატარე.

"Icon must be 256x256". ზუსტად ეს ზომა, PNG ფორმატი. ხელახლა დააექსპორტე და სხვა ფორმატი არ გადაარქვა.

ატვირთვა ამბობს, რომ პაკეტს manifest არ აქვს. ფაილები zip-ში რომელიმე საქაღალდის შიგნითაა. გახსენი არქივი; manifest.json პირდაპირ უნდა ჩანდეს და არა დირექტორია.

"Version already exists". version_number არ გაგიზრდია და ხელახლა ატვირთე. გაზარდე, თუნდაც README-ში ერთი სიმბოლოს შესწორებაა.

მოთამაშეები პაკეტს იმპორტირებენ და რომელიმე მოდი აკლია. dependency სტრიქონში namespace-ის შეცდომაა ან ვერსია, რომელიც არასდროს გამოქვეყნებულა. ყოველი სტრიქონი პაკეტის გვერდიდან უნდა იყოს დაკოპირებული და არა აკრეფილი.

პაკეტი დგება, მაგრამ მოთამაშეები მაინც გამოგდებულნი არიან დაკავშირებისას. სერვერი პაკეტს არ ემთხვევა. სერვერის Loading ხაზები შეადარე manifest-ს; განსხვავება არის პასუხი. ჩვეულებრივი დამნაშავე ხელით სერვერზე განახლებული ბიბლიოთეკაა.

მოთამაშეების პარამეტრები ყოველი პაკეტის განახლებისას ნულდება. პაკეტი config ფაილებს აგზავნის, რომლებსაც მენეჯერი ანაცვლებს. config საქაღალდე იმ ფაილებამდე შეამცირე, რომლებიც უნდა ემთხვეოდეს.

FAQ#

შეიძლება Thunderstore modpack პირადი იყოს?

არა. Thunderstore-ზე პირადი ან ჩამონათვალში არარსებული პაკეტები არ არსებობს; ყველაფერი, რაც აიტვირთება, ყველასთვის ჩანს. პირადი ჯგუფისთვის r2modman-ის პროფილი .r2z ფაილად დააექსპორტე და უშუალოდ გაუზიარე. მასში იგივე მოდების სია და config-ები იქნება.

მჭირდება თუ არა ნებართვა, რომ სხვისი მოდი ჩემს modpack-ში ჩავრთო?

დამოკიდებულებისთვის - არა. modpack მოდებს dependency სტრიქონით ჩამოთვლის და თითოეული მოთამაშე მათ ავტორის საკუთარი პაკეტიდან ჩამოტვირთავს, ზუსტად ისე, როგორც Thunderstore-ს modpack-ები განუზრახავს. ავტორის ფაილების შენს zip-ში გადაკოპირება სულ სხვაა და დაუშვებელია.

მოთამაშეები ჩემს განახლებებს ავტომატურად მიიღებენ?

მენეჯერი აჩვენებს, რომ პაკეტის უფრო ახალი ვერსია არსებობს, და განახლებას სთავაზობს. უმეტესობა მას მოთამაშის დაწკაპუნების გარეშე არ ჩართავს, ამიტომ განახლების დღეს ჯგუფის ჩატში მოკლე შეტყობინება გამოგდების ერთ რაუნდს დაგიზოგავს.

modpack აყენებს BepInEx-ს სერვერზე?

არა. modpack-ებს მოდების მენეჯერები კლიენტის პროფილებში აყენებენ. სერვერს სჭირდება BepInExPack ძირში გახსნილი და იგივე plugin-ები BepInEx/plugins-ში, რაც ხელით კეთდება SFTP-ით ან ფაილების მენეჯერით.

შეიძლება Xbox-ის მოთამაშეები ჩემი პაკეტის სერვერზე შევიდნენ?

მხოლოდ იმ შემთხვევაში, თუ პაკეტის ყველა მოდი კლიენტებისთვის არასავალდებულოა. კონსოლის მოთამაშეებს მოდების დაყენება არ შეუძლიათ, ამიტომ კლიენტისა და სერვერის მოდებისგან შემდგარი პაკეტი სერვერს crossplay-ის პარამეტრის მიუხედავად მხოლოდ PC-სთვის ტოვებს.

რა ვქნა, თუ პაკეტის რომელიმე მოდი მოძველდა ან წაიშალა?

ძველი ვერსიები ჩვეულებრივ ჩამოსატვირთად რჩება, ამიტომ არსებული ინსტალაციები მუშაობს, მაგრამ მასზე არაფერი ააშენო. მოძებნე შემცვლელი, სამყაროს ასლზე გამოსცადე და გამოაქვეყნე პაკეტის ახალი ვერსია, სადაც ის ჩანაცვლებულია.