Moonstorm paylaşılan kullanımlar-içerik yükleme ve genel yardımcı programlar çerçevesi büyük içerik modifikasyonları için.

MoonstormSharedUtils, aynı zamanda msu olarak bilinir, içerik modifikasyonları oluşturmak için thunderkit sisteminin etrafında çalışmak için tasarlanmış bir API'dir.

Başlangıçta güncelleme için oluşturulan API'nin ve çerçevenin bir parçası Yıldızfırtına2 Daha iyi bir geliştirme deneyimi için bir thunderkit ayarına, kendi ayrı kütüphanesine katlanarak büyüdü, böylece thunderkit ile büyük içerik modifikasyonları oluşturmak isteyen herkes bunu kullanabilir.

API hedefleri

Msu, mod geliştirme ve yönetimi ile ilgili aşağıdaki hedefler için çalışıyor.

• Oyun içeriğini asenkron bir şekilde yönetmek ve yüklemek için basit ama güçlü bir sistem.
• Modüllere dayanan sağlam bir çerçeve, ekipman yürütme, canavar ve etkileşimli yumurtlama gibi iş akışının çeşitli bölümlerini otomatikleştirmenizi sağlar.
• Manifestleri, yolları ve boru hatlarını yönetmek için özel bir komposableobject kümesi sağlayarak thunderkit iş akışını basitleştirin.
• Varsayılan temsilciler, temel öğe davranışları ve daha fazlası gibi oyun tarafından sağlanan sistemleri mümkün olduğunca kanca üzerinden kullanmaya odaklanın.
• Mevcut r2api çerçevesini, direktör değişiklikleri gibi güç sistemlerine kullanın.
• Varlık oluşturmak için kod üzerinde çalışmak yerine düzenleyici içinde çalışmayı vurgulayın.

Temel özellikler

Contentpiece, Contentpiece sağlayıcı ve modül çerçevesi

Kod yalnızca modlar çalışma zamanında ve genellikle uyanık olduğunda içeriğini (prefablar, komut dosyası nesneleri, vb.) oluştursa da, bu "sonsuza dek siyah ekran" olarak bilinen sorunlara neden olur ve mod sistemlerinin çoğu oyun yükleme ekranı başlamadan önce başlatılır. Bu, oyunun dondurulduğu ve unutulmuş kullanıcılara yanıt vermeyeceği fikrini verir. Bu doğru olmasına rağmen, asetbundle'dan özel olarak yapılan içerik ile oyun sistemleri arasındaki yükleme ve etkileşimleri yönetmek zordur.

Msu bunu içerik parçası, içerik parçası sağlayıcısı ve modül çerçevesinin üçlü grubu ile çözer. Bu üçlü, modların yükleme ekranı sırasında varlıklarını asenkron olarak yüklemelerine ve temel oyun sistemleriyle düzgün çalışmalarına izin vermek için kullanılır.

İşaret parçası

• Bir modun eklediği bir içerik biçimini temsil eder
• Her içerik parçası, içeriğin yüklenmesini ve uygulanmasını işleyen belirli bir modüle bağlanır.
• İçerik parçalarının kullanılabilirlik sistemleri vardır ve modül hangi içeriğin yükleneceğini ve başlatılacağını bilmek için kullanır.
• Bir içerik parçası, modülün başlatma sırasında kullanan eşzamansız bir yükleme yöntemine sahiptir ve içeriğinizin varlıklarını eşzamansız olarak yüklemek için kullanılır.
• Bir arayüz olarak, api daha fazla uygulama sağlar:
  • Belirli bir içeriği temsil edin Unitymotor. Nesne.
    • Msu, uygulayan aşağıdaki arabirimleri içerir İşaret parçası<T>
      • IartifaktContentParts, için Artifaktdefs
      • Ekipman içeriği Ekipman Defs
        • Ielite bağlantı parçası Yönetim Elite Tanımı Belirli bir ekipmanla ilişkili.
      • İçerik parçası Proje Tanımı.
        • Adı verilen bir alt arayüz Ivoiditemcontentparce Boşluktan kurtulanlara eklenen proje yolsuzluk sistemini yönetir.
      • Iitemtiercontentparceİçin ItemTierDefs
      • Başka bir bağlantı parçası SceneDefs.
  • Belirli bir türle bağlı bir içeriği temsil eder Birlik motoru. Tek davranış
    • Msu, uygulayan aşağıdaki arabirimleri içerir IgameObjectContentParce<TComponent>
      • ICharacterContentPiece İçin Karakter gövdeleri
        • İçerik parçası Düşman canavarları yönetmek için kullanılabilir
        • Adı verilen alt arayüz Yaşamak içeriğiYeni hayatta kalanları yönetmek için kullanılabilir.
      • Etkileşimli bağlantı parçası İçin Etkileşimli.
  • IvanillassurvivorcontentpieceVanilyalı kurtulanlar için değişiklikleri temsil ediyor.
• Sınıflar da uygulayabilir IContentPackModifierMod içerik paketinizle doğrudan arayüz oluşturmak için kullanılır.

Modüller

• Modül, yüklemeyi ve etkileşimini yöneten bir sınıftır İşaret parçası Temel oyunla dersler.
• Her modül, olası alt arabirimlerle birlikte belirli bir arabirim türünü işler.
• Modül, hangi sınıfları başlatmak ve başlatmak için kullanacağını biliyor Sistem.
• Bir kez sağladığınızda Simge sağlayıcısıBir modüle diyebilirsiniz Başlatma İçeriğinizi asenkron bir şekilde başlatacak bir korutine geri alma yöntemi.
• Msu aşağıdaki modülleri sağlar:
  • Artifakt modülü IartifaktContentParts% s, artefactmodule arabirimi R2api. artefactcode Oyuna yeni eser kodları ekleyin. Ayrıca eserlerin uygun bağlanmasını ve çıkarılmasını da işleyecektir, böylece eser yalnızca eser etkinleştiğinde kanca etkinleştirilir.
  • Karakter modülü, yönetim ICharacterContentPiece, Yaşamak içeriği İçerik parçasıModül arabirimi R2api. Yönetmen Oyun aşamaları için canavarların yumurtlamasını idare edin.
  • Ekipman Modülü Ekipman içeriğiVe Ielite bağlantı parçasıModül, ekipman yürütme çağrısını yönetmek için tek bir kanca kullanır.
  • Etkileşimli modül, yönetim Etkileşimli bağlantı parçasıModül arabirimi R2api. Yönetmen Oyun aşamalarında etkileşimli olanların yumurtlamasını idare edin.
  • Proje Modülü İçerik parçası Ve Ivoiditemcontentparce. Proje bozukluğunu otomatik olarak ele alır.
  • Proje Modülü IitemtiercontentparceÇalışma başlangıcında katman için kullanılabilir bırakma listesinin otomatik olarak bir koleksiyonu oluşturur.
  • Sahne Modülü, yönetim Diğer bağlantı parçalarıVe arayüz R2api. aşamalar Oyuna bir sahne eklemeyi ele alın.
  • Vanillassurvivormodül, yönetim IvanillassurvivorcontentpieceTemel oyunun hayatta kalanlarına yeni içerik eklemek için kullanılır (deri, beceri, vb.)

• Modülün hangi içerik parçalarının oluşturulacağını, yükleneceğini ve başlatılacağını bilmesi için. Msu kullanımı Sağlayın İşaret parçasıModüllere% s.
  • Kendi uygulamalarınızı oluşturabilirken Simge parçası sağlayıcısı Kullanılabilirlik senaryolarını yönetmek için arayüz, MSU İçerik faydalı Sınıflar, yalnızca derlemenizi analiz ederek bunları sıfırdan oluşturmak için yöntemler içerir.

Ror2 dostu sistem

MSU'nun temel hedeflerinden biri, temel oyun sistemini bizimkilerle çalışmaya zorlamak yerine, yağmur 2 sisteminin riski ile birlikte çalışmak ve onunla çalışan içerik oluşturmaktır. Bu nedenle, msu, ekipman, hoşlanma, öğeler ve daha fazlası gibi oyunun temel sistemleriyle birlikte etkileşime girmek için sağlam bir sistem sağlar.

Bileşen arabirimi

Yaygın olarak kullanılan türler için gereksiz bağlanmayı önlemek için msu, aşağıdaki sistemler için bileşenlerin içinde kullanılabilecek arabirimler sağlar:

• IonincomingdamageotherserverreceiverKurbanın gelen hasarını değiştirmek için kullanılabilecek takedamage'de bir kanca olarak çalışır.
• Istatistik davranışıİstatistikleri yeniden hesaplamadan önce ve sonra çalışma yöntemlerini içeren istatistikleri yeniden hesaplamak için bir kanca olarak çalışan bir arayüz.
• iBodyStatArg değiştiricisiBir uygulama olarak çalışan bir arayüz R2API. Yeniden hesaplamaGetstatcoefficient delegasyonu.

BaseItemMasterDavranış

Temel master davranışı, tıpkı vücudun muadili gibi (Temel vücut davranışı) Belirli bir öğe elde edildiğinde karakter masterine eklenen bir davranış oluşturmak için kullanılır.

Basebuffdavranış

Basebuffbehaviour, buff'in etkilerini yönetmek için kullanılabilecek bir bileşendir. Performans nedenlerinden dolayı, buff kaldırıldığında basebuffbehaviours yok edilmez, bunun yerine buff ilk kez bir gövde tarafından elde edildiğinde, davranış eklenir ve buff yığınları tükendiğinde, davranış EngelliDaha sonra, vücut tekrar buff'u aldığında, davranış EtkinleştirildiBu, çöp toplayıcısının iş yükünü azaltır ve genel olarak sistemin performansını artırır.

Geliştirilmiş Thunderkit iş akışı:

MSU'nun hedefleri editörde çalışmanın etrafında döndüğünden, msu oyun içeriği oluşturma ile ilgili birçok yardımcı programla birlikte gelir.

Wwise desteği

Msu, projeniz için wwise entegrasyon sistemini kullanmanıza izin veren oyundan wwise derlemelerini kara listesine almak için kullanılabilecek özel bir import uzantısı sağlar.

Komut dosyası yapabilir nesneler

Msu, düzenleyici zamanında "yalnızca çalışma zamanı" içeriğinin oluşturulmasına izin veren aşağıdaki komut dosyası nesnelerini sağlar.

• Elde edilebilir kilit açılabilir defKilitlenebilir def ve performancedef sisteminin soyutlaması olarak çalışır Kilitlenebilir def Bu bir başarı yoluyla açıldı.
• BuffDef noktasıDotdef'in soyutlaması olarak çalışır ve otomatik olarak belirtilen buffdef'e bir dotdef atar.
• Genişletilmiş silme tanımıUzantısı olarak çalışır EliteDef Sınıf, temel oyun seviyelerine, elit rampalara, kaplama malzemelerine ve daha fazlasına otomatik eklemeyi destekler.
• Etkileşimli kart sağlayıcısıEtkileşimli ürünleri aşamalı olarak oluşturmak için gereken meta verileri içeren bir komut dosyası nesnesi, tek bir kartta birden fazla aşama atılabilir.
• MonsterCard sağlayıcıCanavarları aşamalı olarak yumurtlamak için gereken meta verileri içeren bir komut dosyası nesnesi, tek bir kartta birden fazla aşama atılabilir.
• Proje görüntüleme sözlüğüBenzer çalışan bir komut dosyası nesnesi R2api. öğelerMevcut programlara birden fazla kural grubu eklemek için kullanılabilecek itemdisplaydictionary sistemi Proje görüntüleme kuralları kümesiTemel varlıklar ve ekran prefabrikleri
• NamedItemDisplayRuleSet setiTam bir komut dosyası oluşturmak için kullanılabilecek bir komut dosyası nesnesi Proje görüntüleme kuralları kümesi Karakter modelleri için. Temel varlıklar ve ekran prefabrikleri Proje ekranı kataloguMsu içindeki sistem.
• Serileştirilebilir elitetierdefBir soyutlama olarak çalışır Elit DEF Oyun içindeki sistem, temel oyun seçkin seviyelerine ve modlarına bir maliyet çarpanı, adreslenebilir referanslar atayabilir.
• UberSkinDefR2API'nin skinvfx sistemini desteklemek ve vanilya karakterlerine deriler eklemek için skindefs için kapsamlı bir yardımcı programı olarak çalışır

Önceden yapılmış elde edilebilir nesneler

Msu thunderkit'i göz önünde bulundurarak oluşturulduğundan, msu projenize aşağıdaki composableobjektleri sağlar:

• Basit bir Manifest Gerekli şeylerle Manifest Tarihi Modunuzu beyan etmek için
• Bir ayarlama PatherferenceTemiz inşaat ve modlarınızın serbest bırakılması için kullanılır
• Yüksek düzenlenebilir boru hattı sistemi:
  • Modunuzun serbest bırakılmasına hazır bir zip dosyası otomatik olarak oluşturan bir sürüm boru hattı.
  • Montajınızı oluşturmak, sıkıştırılmış veya sıkıştırılmamış varlık paketlerinizi oluşturmak ve modunuzun akış varlıklarını düzenlemek için kullanılabilecek genel boru hatları.
  • Katkıcı boru hattı ayarları, katkıcı modlarınızı oluşturmak için bir boru hattını kolayca ayarlamak için kullanabilirler.

Yapılandırma ve belirteçlerin yönetimi

Modunuz için yapılandırma oluşturmak varsayılan bepinex uygulamalarını kullanarak son derece ayrıntılı olabilir Msu, bepinex'in üstünde her şeyi kolayca yapılandırmanıza izin veren bir yapılandırma sistemi uygular.

ConfigureField, ConfiguredVariable ve seçeneklerin riski

Msu, bepinex yapılandırma sisteminin aşağıdaki soyutlamasını sağlar:

• Yapılandırma alanı

  • Otomatik olarak yapılandırmak için statik alanlara uygulanabilecek özel bir öznitelik.
  • Yapılandırma işlemi, yapılandırmayı yapılandırma dosyasına bağlamak için özel bir yapılandırma dosyasına atadığınız benzersiz bir dize kimliğini kullanır.
  • - Yapılandırma bölümü Ve Takma adı Uygulamaya gerek yok, msu varsayılan olarak kullanılır Üye Bilgileri YapılandırmaNameVe.. Bildirim türüŞu adı Yapılandırma bölümü
  • RiskOfOptions API'yi kullanarak otomatik olarak seçenekler oluşturan yapılandırma alanının "RiskOfOptions" sürümü var. Bununla birlikte, özelliklerin sınırlamaları nedeniyle bu seçenekler büyük ölçüde özelleştirilemez.

• Yapılandırılmış değişken

  • Configuredvariable, yapılandırılabilecek bir değişkeni temsil eden bir sınıftır.
  • Seçenekler riski olan karmaşık yapılandırma senaryoları oluşturmak için kullanılabilir.

Formattoken sistemi

Yapılandırma değişikliklerini jeton değerlerine bağlamak, kod kullanarak jeton oluşturmanın en iyi kısımlarından biridir, ancak çevirmenin çeviriyi doğrudan c # kaynak dosyasına kodlamasını gerektirdiğinden, bu jetonların çevirisini yönetmek zor olabilir.

Msu sağlar Biçim işareti Sistem, artık belirteçinizin değerlerini yazmak için c # dize biçimlendirme sistemini kullanabilirsiniz. Bununla, uygun dizin sırasını koruduğu sürece, çevirmenler çeviri için kolayca kullanabilecek json langauge dosyalarını doğru bir şekilde kullanabilirsiniz.

Belgeler ve kaynak kodu

• Belgeler ve kaynak kodları moonstormsharedutil'in github deposunda bulunabilir Burada.

Bağış

Msu, teammoonstorm üyelerinden biri Nebby'nin tutku projesidir. Bu nedenle, topluluğun geri kalanının inanılmaz ve inanılmaz içerik yaratmasına izin vermek için boş zamanlarında bu konuda çalışıyor.

Msu sonsuza dek ücretsiz kullanılabilir ve asla ödeme duvarlarının arkasında kapalı olmayacak, ancak bağışlar inanılmaz bir şekilde takdir edilir.

MSU'yu kullanan mod

(Bana tıklayın!)

(Not: Mod için yeni bir sekme açmak için simgeyi tıklayın!)

Simge/URL	Adı	Açıklama
	Yıldızfırtına2	Starstorm 1'in devamı. Yeni kurtulanlar, mekanik öğeler, beceriler, düşmanlar ve daha fazlası ekleyin!
	Taşınma sırasında kayıp	Taşınma sırasında kayıp, şu anda öğeler de dahil olmak üzere yağmur riski nedeniyle kaybedilen özellikleri geri yüklemeye odaklanan bir moddur.
	Varyans api	Varianceapi, karakterler için varyantlar oluşturmanıza olanak tanır ve varyantlar farklı dokulara, ışıklara, becerilere ve daha fazlasına sahip olabilir.
	Serbest bırakılacak-atık bahçesinden servet	Üçüncü taraf uzay şirketlerinin etrafında dönen ve çöp alanı ve siber punk temalarına göre görsel olarak dayanan genişleme benzeri bir içerik modu.
	Kırmızı uçağın hükümdarı	Kırmızı düzlemde genişleyen genel içerik modları

Teşekkürler ve krediler

• Thunderkit yaratmak için twiner.
• Çeşitli kodlama sorularına yardımcı olma fikri ve harb.
• Vanillaskindef sistemi için bir taban olarak kullanılan ror2skinbuilder için kingendertuz suyu ve runefox237.
• Modül sisteminin kavramlaştırılması sırasında yardımcı olmak ve stubbedshaders sağlamak için groovesalad.
• MSU'nun logosu bilinmeyen glaze
• Starstorm 2 ekibi, Nebby'nin derin uçtan çıkmasına ve ilk başta msu yaratmasına izin verdiği için.
• Hedeflerime inanmak ve mod için MSU'yu kullanmak için çöp ekibinin kaderi.
• KevinFromHPCustomerService, nihayetinde msu 2.0 haline gelen orijinal modül sistemleri oluşturmak için
• Yağmur Riski Topluluğundan herkes çalışmamı takdir ediyor.