SCP: Secret Laboratory - EXILED და LabAPI plugin-ები

SCP: Secret Laboratory-ის სერვერი plugin-ებს LabAPI-ით უშვებს, Northwood-ის ოფიციალური ფრეიმვორკით, რომელიც სერვერის ყოველ build-შია ჩაშენებული. EXILED, საზოგადოების უფრო დიდი ფრეიმვორკი, ახლა თავად LabAPI plugin-ია, ასე რომ, თანამედროვე სერვერს შეუძლია LabAPI-ის მშობლიური plugin-ები და EXILED plugin-ები გვერდიგვერდ გაუშვას. Plugin-ები არის .dll ფაილები, რომლებიც სერვერის app data-ში პორტის ან გლობალურ საქაღალდეებში იდება, თითოეული პირველ გაშვებაზე YAML კონფიგს წერს, ხოლო plugin-ების ბრძანებების უფლებები მოდის permissions.yml-იდან, რომლის გასაღებები შენი Remote Admin ჯგუფების სახელებია. plugin-ის თითქმის ყველა პრობლემა ოთხიდან ერთ-ერთია: plugin თამაშის ან ფრეიმვორკის სხვა ვერსიისთვის აიწყო, არასწორ საქაღალდეშია, მისი YAML ვერ წაიკითხა, ან უფლებების ჯგუფის სახელი Remote Admin ჯგუფს ზუსტად არ ემთხვევა. ეს გზამკვლევი თითოეულს იმ რიგით განიხილავს, რომლითაც მათ შეხვდები.

თავად სერვერისთვის - LocalAdmin, config_gameplay.txt, Remote Admin როლები და ვერიფიკაცია - იხილე SCP: Secret Laboratory-ის სერვერის გზამკვლევი. ეს სტატია იქ იწყება, სადაც ის მთავრდება.

როგორ ეწყობა ერთმანეთს LabAPI და EXILED#

LabAPI საბაზო ფენაა. მისი საქაღალდეები თამაშის app data დირექტორიაშია - Linux-ზე ~/.config/SCP Secret Laboratory/, Windows-ზე %AppData%\SCP Secret Laboratory\ - LabAPI საქაღალდეში, რომლის ქვეშაც არის plugins, dependencies და configs. ნაგულისხმევად ის ტვირთავს global საქაღალდიდან და სერვერის პორტის სახელის მქონე საქაღალდიდან, ასე რომ, ერთ მანქანას შეუძლია რამდენიმე სერვერი გაუშვას plugin-ების სხვადასხვა ნაკრებით.

EXILED ზემოდან ზის. მისი loader LabAPI plugin-ია, და ჩატვირთვის შემდეგ საკუთარ ხეს კითხულობს, EXILED საქაღალდეს იმავე app data ძირში. ამ ფენოვნებას ერთი შედეგი აქვს, რომელიც უნდა გახსოვდეს: როცა თამაშის განახლება LabAPI-ის მთავარ ვერსიას ზრდის, მთელი EXILED სტეკი EXILED-ის განახლებას ელოდება და არა მხოლოდ ერთი plugin.

რომელი აირჩიო, ძირითადად შენთვის სასურველი plugin-ები წყვეტს. LabAPI-სთვის აწყობილი plugin LabAPI-ის საქაღალდეებში მიდის; EXILED-ისთვის აწყობილ plugin-ს დაყენებული EXILED სჭირდება და EXILED-ის საქაღალდეებში მიდის. plugin-ის გვერდი, რომელიც არცერთს არ ამბობს, ალბათ მოძველებულია - ძველი plugin-ები მიტოვებულ NWAPI-ს ეყრდნობოდა და ისინი მიმდინარე build-ებზე არ იტვირთება.

საქაღალდეები და ფაილები, გვერდიგვერდ#

ამ ცხრილზე ორი შენიშვნა. LabAPI ყოველი plugin-ის კონფიგის გვერდით properties.yml-საც წერს, რომელშიც არის IsEnabled და UnsupportedLoading override, და ასე თიშავ ერთ plugin-ს წაშლის გარეშე. ხოლო EXILED-ის კონფიგების განლაგება მისი loader-ის ConfigType პარამეტრზეა დამოკიდებული: მიმდინარე ნაგულისხმევი არის Separated, თითო plugin-ზე თითო პორტზე ერთი ფაილი, როგორც ზემოთაა ნაჩვენები, ხოლო Default ყველა plugin-ს ერთ EXILED/Configs/<port>-config.yml-ში ათავსებს შესაბამისი <port>-translations.yml-ით. კონსოლის ბრძანებები econfig merge და econfig split მათ შორის გარდაქმნის. ძველი გზამკვლევები ერთფაილიან განლაგებას ვარაუდობენ; თუ კონფიგს ვერ პოულობ იქ, სადაც გზამკვლევი ამბობს, მიზეზი ეს არის.

EXILED-ის დაყენება#

EXILED საკუთარი ინსტალერით ყენდება, Exiled.Installer-Linux ან Exiled.Installer-Win.exe, რომელიც GitHub-იდან რელიზს ჩამოტვირთავს და სწორ ადგილებში გაშლის:

$ ./Exiled.Installer-Linux --path /home/container \    --appdata /home/container/.config --exiled /home/container/.config

ჰოსტინგის სერვერებზე მნიშვნელოვანი ოფცია --appdata-ა. სერვერი იმ მომხმარებლის app data საქაღალდეს კითხულობს, რომლითაც ეშვება; თუ ინსტალერი სხვაგან წერს, EXILED დაყენებულია და არასდროს იტვირთება. თუ კონსოლი გაშვებისას EXILED-ის ბანერს არ აჩვენებს, შეამოწმე, ემთხვევა თუ არა ინსტალერის დაბეჭდილი გზები იმას, სადაც სერვერი თავის config საქაღალდეს ინახავს.

Loader-ს საკუთარი პარამეტრები აქვს, LabAPI-ის configs საქაღალდეში loader-ის plugin-ის სახელით შენახული. მათგან სამი ნაგულისხმევის ნაცვლად გადაწყვეტილებას იმსახურებს:

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

Plugin-ის დაყენება და კონფიგურაცია#

პროცედურა ორივე ფრეიმვორკისთვის ერთნაირია:

1. Plugin-ის გვერდზე შეამოწმე ფრეიმვორკი და თამაშის ვერსია, რომელზეც ის აიწყო. თუ რომელიმე არ ემთხვევა, გაჩერდი.
2. გააჩერე სერვერი.
3. DLL ჩადე plugin-ების საქაღალდეში, ხოლო ჩამოთვლილი დამოკიდებულებები - dependencies საქაღალდეში. გლობალური საქაღალდეები ყველა პორტზე მოქმედებს; პორტის საქაღალდეები - მხოლოდ ამ სერვერზე.
4. ერთხელ გაუშვი სერვერი. Plugin თავის ნაგულისხმევ კონფიგს დაწერს.
5. გააჩერე, დაარედაქტირე კონფიგი, ისევ გაუშვი - ან დაარედაქტირე და reload ბრძანება გამოიყენე.

EXILED plugin-ის ტიპური კონფიგი უბრალო YAML-ია ორი გასაღებით, რომელიც ყველა plugin-ს აქვს, is_enabled და debug, რასაც მისი საკუთარი ოფციები მოსდევს:

is_enabled: truedebug: false# მოთამაშისთვის შემოსვლისას ნაჩვენები შეტყობინებაwelcome_message: 'Welcome to the Site-02 night shift'broadcast_duration: 6allowed_roles:- ClassD- Scientist

YAML კონკრეტული გზებით დაუნდობელია. დაშორება სფეისებია, არასდროს ტაბები. მნიშვნელობას, რომელიც ორწერტილს, დიეზს ან წამყვან სპეციალურ სიმბოლოს შეიცავს, ბრჭყალები სჭირდება, და EXILED სტრიქონებს ნაგულისხმევად ერთმაგ ბრჭყალებში წერს, ამიტომ ეს სტილი შეინარჩუნე. სიები არის ტირე და სფეისი ხაზის დასაწყისში, სწორ სიღრმეზე. როცა ფაილი ვერ წაიკითხება, plugin ან ნაგულისხმევებით იტვირთება, ან საერთოდ არ იტვირთება, და შეცდომა გაშვებისას კონსოლშია - თამაშის სერვერის კონფიგ-ფაილების ფორმატები YAML-ის ხაფანგებს უფრო დეტალურად განიხილავს.

LabAPI plugin-ების კონფიგები ასევე მუშაობს LabAPI/configs/<port>/<PluginName>/-ის ქვეშ, ჩვეულებრივ config.yml-ის სახით, ველების სახელებით, რომლებსაც plugin-ის ავტორი ირჩევს.

ხელახალი ჩატვირთვა გადატვირთვის გარეშე

რაუნდის შუაში გადატვირთვა ყველას აგდებს, ამიტომ ორივე ფრეიმვორკს შეუძლია სერვერის კონსოლიდან ან Remote Admin-იდან reload:

კონფიგის reload უსაფრთხოა პარამეტრებისთვის, რომლებსაც plugin მაშინ კითხულობს, როცა სჭირდება. გაშვებისას ერთხელ წაკითხულ პარამეტრებს - custom როლების სიას, მონაცემთა ბაზასთან შეერთებას - შეიძლება მაინც გადატვირთვა სჭირდებოდეს. როცა reload თითქოს არაფერს აკეთებს, რაუნდებს შორის გადატვირთე, სანამ იფიქრებ, რომ პარამეტრი გაფუჭებულია.

Plugin-ების ბრძანებების უფლებები#

Remote Admin-ის უფლებები წყვეტს, რას უშვებს თამაშის საკუთარი ბრძანებები. Plugin-ების ბრძანებები მეორე ფენას ამოწმებს: ფრეიმვორკის უფლებებს, რომლებიც სტრიქონებია, მაგალითად myplugin.kick, ჯგუფებზე მინიჭებული.

EXILED-ის permissions.yml-ის გასაღებები Remote Admin ჯგუფების სახელებია, პლუს სპეციალური user ჯგუფი ყველასთვის, ვისაც ჯგუფი არ აქვს:

user:  default: true  inheritance: []  permissions: []moderator:  inheritance: []  permissions:  - adminplugin.kick  - adminplugin.muteadmin:  inheritance:  - moderator  permissions:  - adminplugin.*owner:  inheritance: []  permissions:  - .*

წესები, რომლებზეც ხალხი ბორძიკობს:

• ჯგუფების სახელები ზუსტად უნდა ემთხვეოდეს როლების სახელებს `config_remoteadmin.txt`-ში. ჯგუფი, რომელიც არაფერს ემთხვევა, იგნორირდება კონსოლში გაფრთხილებით, რომელიც გაშვებისას სწრაფად გადაიფურცლება.
• ყოველ ჯგუფს სჭირდება როგორც `inheritance`, ისე `permissions`, თუნდაც ცარიელი. ერთის გამოტოვება მთელ ფაილს ვერ წაკითხვადს ხდის და არა მხოლოდ ამ ჯგუფს.
• `default: true` აღნიშნავს ჯგუფს, რომელიც Remote Admin როლის არმქონე მოთამაშეებისთვის გამოიყენება. ზუსტად ერთ ჯგუფს უნდა ჰქონდეს.
• Wildcard-ები. adminplugin.* ანიჭებს ყველაფერს ამ პრეფიქსის ქვეშ; .* ანიჭებს ყველაფერს და მხოლოდ owner ჯგუფს ეკუთვნის.
• მემკვიდრეობა ცალმხრივია. admin, რომელიც moderator-ს იმემკვიდრებს, moderator-ის უფლებებს იღებს და არა პირიქით.

რედაქტირების შემდეგ გაუშვი reload permissions ან უფლებების ბრძანების საკუთარი reload. LabAPI-ის ეკვივალენტი არის LabAPI/configs/permissions.yml, ასევე Remote Admin ჯგუფების სახელებით, default ჯგუფით ყველა დანარჩენისთვის; labapi permissions აჩვენებს, რა გაქვს. Plugin-ების უფლებები ისევე ვიწროდ მიანიჭე, როგორც Remote Admin როლები - მოდერატორი .*-ით ყველაფერში owner-ია, სახელის გარდა. Subuser-ები და მინიმალური პრივილეგია იმავე არგუმენტს პანელზე წვდომისთვის აკეთებს.

Plugin-ების არჩევა#

ოფიციალური plugin-ების დირექტორია, საიდანაც LocalAdmin-ის p ბრძანებებს დაყენება შეუძლია, ყველაზე უსაფრთხო წყაროა. მის გარდა plugin-ები GitHub-ის რელიზებიდან მოდის. რამდენიმე კატეგორია და რას უნდა მიაქციო ყურადღება თითოეულში:

EXILED თავის შემადგენლობაში აყენებს Exiled.CustomItems, Exiled.CustomRoles, Exiled.Events და Exiled.Permissions. სხვა plugin-ებს, რომლებიც მათზეა დამოკიდებული, მათი ცალკე დაყენება არ სჭირდება.

ნაკლები უკეთესია. ყოველი გეიმფლეის plugin კიდევ ერთი hook-ია იმავე ივენთებზე, და ორი plugin, რომლებიც ერთსა და იმავეს ცვლის - spawn-ის ტალღები, როლების განაწილება, ნივთების აღება - ისე ურთიერთქმედებს, როგორც არცერთ ავტორს არ შეუმოწმებია. Plugin-ები სათითაოდ დაამატე და დამატებებს შორის ერთი რაუნდი ითამაშე.

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

თამაშის განახლებების გადატანა#

SCP: Secret Laboratory განახლებებს რეგულარულად უშვებს, და სერვერი, რომელიც გადატვირთვისას ავტომატურად ახლდება, მათ plugin-ების ავტორებზე ადრე აიღებს. სქემა ნაცნობია: სერვერი ეშვება, ლოგი ივსება MissingMethodException-ით ან სხვა მთავარ ვერსიაზე აწყობილი plugin-ის ჩატვირთვაზე უარით, და შენი ფუნქციების ნახევარი გაქრა.

რუტინა, რომელიც მუშაობს:

1. იცოდე, რას უშვებ. შეინახე plugin-ების სია ვერსიებითა და წყაროს ბმულებით, შენი კონფიგების backup-ების გვერდით.
2. patch-ის დღემდე დააფიქსირე. როცა Northwood განახლებას აცხადებს, გადაწყვიტე, მაშინვე გაუშვებ თუ არა. სერვერს შეუძლია წინა build-ზე რამდენიმე დღე დარჩეს, სანამ plugin-ები დაეწევიან, თუ კლიენტებს ჯერ კიდევ შეუძლიათ შეერთება - მთავარი განახლებისას არ შეუძლიათ, და მაინც ანახლებ.
3. ჯერ ფრეიმვორკები განაახლე, შემდეგ plugin-ები. LabAPI თამაშთან ერთად მოდის; შემდეგ EXILED; შემდეგ ყოველი plugin, რომელიც ახალი ვერსიისთვის აიწყო.
4. მხარდაუჭერელი ჩატვირთვა გამორთული დატოვე. LabAPI-ის LoadUnsupportedPlugins ნაგულისხმევად false-ია, ასე რომ, სხვა მთავარი ვერსიისთვის აწყობილ plugin-ს უარს ეუბნება და არ ტვირთავს. Plugin, რომელიც იტვირთება და რაუნდის შუაში არასწორად იქცევა, უარესია, ვიდრე ის, რომელიც არ იტვირთება.
5. დატვირთულ საათებამდე შეამოწმე. მეორე სერვერი სხვა პორტზე იმავე plugin-ებით იაფია - სატესტო სერვერი production-ის გვერდით ხსნის, როგორ შეინარჩუნო ის პატიოსნად.

RE:NODE-ზე SCP:SL სერვერის კონსოლი LocalAdmin-ის კონსოლია ბრძანებების ისტორიით, ასე რომ, reload configs და pluginmanager show იქ იკრიფება, სადაც გამონატანს კითხულობ. plugin-ებისა და კონფიგების საქაღალდეები ხელმისაწვდომია ფაილ-მენეჯერში და SFTP-ით, ხოლო ყოველი განახლების წინ აღებული backup-ის სლოტი მომუშავე ნაკრებთან დაბრუნების ყველაზე სწრაფი გზაა - აღდგენა ერთი ღილაკია. Schedules ჩანართს შეუძლია ყოველდღიური გადატვირთვა წყნარ საათზე გაუშვას, რაც ასევე ბუნებრივი მომენტია განახლებების შეგნებულად მისაღებად და არა მაშინ, როცა სერვერი შემთხვევით გადაიტვირთება. რა ვქნა, როცა მოდის განახლება რამეს ამტვრევს აღდგენის თანმიმდევრობას შეიცავს.

წარმადობა#

SCP:SL სერვერს plugin-ები ანელებს და არა მოთამაშეები. სერვერი ფიქსირებულ tick rate-ს ისახავს მიზნად, და დატვირთულ ივენთზე ყოველი დამმუშავებელი - მოთამაშის მოძრაობა, დაზიანება, ნივთის აღება - მის შიგნით ეშვება. EXILED-ის tps ბრძანება კონსოლიდან მიმდინარე სიჩქარეს აჩვენებს. თუ ის plugin-ებით ეცემა და მათ გარეშე არა, რაუნდებს შორის pluginmanager disable-ით სათითაოდ გამორთე plugin-ები, სანამ არ აღდგება. ერთ plugin-ს, რომელიც ყოველ დაზიანების ივენთზე მონაცემთა ბაზას მიმართავს, სავსე სერვერზე tick rate-ის განახევრება შეუძლია. რას ნიშნავს tick rate სინამდვილეში ხსნის, რას გრძნობენ მოთამაშეები, როცა ის ეცემა.

პრობლემების მოგვარება#

გაშვებისას EXILED-ის ბანერი არ ჩანს. Loader არ არის LabAPI/plugins/global/-ში ან პორტის საქაღალდეში, ან EXILED სხვა app data საქაღალდეში დაყენდა, ვიდრე სერვერი კითხულობს. ხელახლა გაუშვი ინსტალერი --appdata-ით, რომელიც სწორ ძირზე მიუთითებს.

Plugin სიაშია, მაგრამ არაფერი ხდება. is_enabled არის false, მისი properties.yml თიშავს მას, ან დამოკიდებულება აკლია - კონსოლი ჩატვირთვისას ამბობს, რომელია.

`MissingMethodException` განახლების შემდეგ. Plugin თამაშის ან ფრეიმვორკის წინა ვერსიაზე აიწყო. განაახლე ან წაშალე.

Plugin-ის ბრძანებები ამბობს, რომ უფლება არ გაქვს. ჯგუფის სახელი permissions.yml-ში Remote Admin როლის სახელს არ ემთხვევა, ან ფაილი ვერ წაიკითხა, რადგან ჯგუფს აკლია inheritance ან permissions.

კონფიგის ცვლილებები უკან ბრუნდება. YAML ვერ წაიკითხა და ნაგულისხმევები ხელახლა შეიქმნა. შეამოწმე ფაილი, აღადგინე შენი ასლი და შემდეგი გაშვების შემდეგ კონსოლი შეამოწმე.

კონფიგი იქ არ არის, სადაც გზამკვლევი ამბობს. გზამკვლევი EXILED-ის ერთფაილიან განლაგებას ვარაუდობს. მოძებნე EXILED/Configs/Plugins/-ში ან გაუშვი econfig merge.

FAQ#

plugin-ების გასაშვებად EXILED მჭირდება?

არა. LabAPI სერვერშია ჩაშენებული და LabAPI plugin-ებს დამატებით არაფრის დაყენების გარეშე უშვებს. EXILED მხოლოდ EXILED-ისთვის დაწერილი plugin-ებისთვის გჭირდება, რაც ჯერ კიდევ ხელმისაწვდომის დიდი წილია.

შეუძლიათ LabAPI და EXILED plugin-ებს ერთდროულად მუშაობა?

კი. EXILED-ის loader თავად LabAPI plugin-ია, ამიტომ ორივე სახეობა ერთად იტვირთება. ფასი დამატებითი ფენაა, რომელიც LabAPI-ის მთავარი ვერსიის შეცვლისას უნდა განახლდეს.

სად მიდის plugin-ების კონფიგები რამდენიმეპორტიან სერვერზე?

LabAPI კონფიგებს LabAPI/configs/<port>/-ში ინახავს, ხოლო EXILED-ის გაყოფილი განლაგება ყოველი plugin-ის კონფიგის საქაღალდეში თითო პორტზე ერთ ფაილს წერს. global საქაღალდეში არსებული plugin-ები ყველა პორტზე იტვირთება, მაგრამ მაინც პორტის მიხედვით კონფიგებს იღებს.

რატომ არ მუშაობს ჩემი უფლებების ჯგუფი?

ჯგუფის სახელი ზუსტად უნდა ემთხვეოდეს როლს config_remoteadmin.txt-ში, და ყოველ ჯგუფს სჭირდება როგორც inheritance, ისე permissions ხაზები. ერთი არასწორად შედგენილი ჯგუფი მთელი ფაილის ჩატვირთვას აჩერებს.

უნდა მივცე EXILED-ს თავისით განახლების უფლება?

ცოცხალ სერვერზე - არა. ავტომატურ განახლებებს შეუძლია ახალი EXILED დააყენოს მანამ, სანამ შენი plugin-ები მას მხარს დაუჭერს. განაახლე შეგნებულად, ყოველი plugin-ის შემოწმების შემდეგ, წინასწარ აღებული backup-ით.

როგორ ჩავტვირთო plugin-ის კონფიგი ხელახლა გადატვირთვის გარეშე?

გამოიყენე reload configs EXILED-ისთვის ან labapi reload configs LabAPI-სთვის, სერვერის კონსოლიდან ან Remote Admin-იდან. პარამეტრებს, რომლებსაც plugin მხოლოდ გაშვებისას კითხულობს, მაინც გადატვირთვა სჭირდება.