Ore Eklentisi Gönderme Kuralları

Uyarı

This document refers to an outdated SpongeAPI version and is no longer actively maintained. The policies, guidelines, and some links have changed. Please refer to the latest version of the documentation instead.

Ore sunum kılavuzuna hoş geldiniz. Bu belge hem proje hem de dosya sunumlarına yönelik beklentilerimizin bir taslağını sunmaktadır.

Bunların sadece kurallar olduğunu ve bu kılavuz ilkeler boyunca “personel” olarak belirtilen Ore takımı, burada açıkça belirtilmeyen bir eylemi kendi takdirimize bağlı olarak kabul veya reddetmeyi seçebilir.

Projeler

Gönderilen projeler aşağıdaki beklentileri karşılamalıdır:

Ad

Projenizin gönderilen adı bir sürüm, etiket satırı veya başka bir açıklama içermemelidir. Adı benzersiz ve orijinal olmalı ve bir Sponge projesi olduğunu ima eden bir isme sahip olmamalıdır. (ör. * SpongeWarp * ‘a müsaade edilmez, Sponge için Serin Çözgü olmalı).

Ana Belgeler Sayfası (Ev)

Bu, projenizi ziyaret ederken başkalarının gördüğü ilk sayfadır. Burada bilgi, projenizin özelliklerinin bir açıklamasını içermelidir. Aşağıdaki eklentinizde bulunuyorsa, Maden Projesi’nin herhangi bir yerinde belgelendirilmemişse, ana sayfada, komutlar, yapılandırma ve izin düğümleri belgelenmelidir. Ayrıca, eğer varsa, ana sayfada aşağıdaki bilgiler belgelendirilmelidir:

Harici Bağlantılar

Projeniz bir web API’sini kullanıyorsa, veri toplamak için eve telefon açarsa veya çalışmakta olduğu sunucunun dışındaki bir sisteme bağlanırsa, bu özelliğin varlığı ve bunun nasıl etkinleştirileceği veya devre dışı bırakılacağına dair bilgiler belirgin bir şekilde gösterilmelidir Ana sayfa. Projenizin tek amacı harici bir sistem kullanmayı içeriyorsa (diller arasında sohbeti çeviren bir Sünger eklentisi gibi), bu hizmetle bağlantı kurmaya geçiş yapacak bir yapılandırma seçeneği gerekmez. Eklentiniz bilgi gönderirse (örneğin, eklenti listesi veya oynatıcı verileri), toplanan bilgilerin ana sayfada listelenmesi gerekir.

Dokümantasyon gerektiren sistem örnekleri:

  • İstatistik veya kullanım bilgileri toplama (‘metrikler’)

  • Coğrafi Konum

  • Çeviri servisi

  • Eklenti üzerinde çalışan, kullanıcılara bilgi sunan Web sunucusu

  • Eklenti üzerinde çalışan, diğer servislerden gelen istekleri dinleyen sunucu

  • IRC/Discord/Telegram/WhatsApp bot veya röle

Kategori

Seçtiğiniz kategori doğru olmalıdır. Projeniz, hafifçe uygulanan herhangi bir kategoriden ziyade mümkün olan en dar kategoriyi kullanmalıdır. Herhangi bir kategori doğru görünmüyorsa, Muhtelif kategori kullanılmalıdır.

Para Kazandırma / Reklamcılık

Gönderimler satılamaz, ödeme ile ek özelliklerin kilidinin açılması mümkün olmayabilir. Reklamlar ve diğer gelir getiren bağlantılar (ör. Adfly) için izin verilmiyor. Dokümantasyon, proje yöneticisine veya diğer katkıda bulunanlara teşekkür etmek için bağış yapacak bir sayfaya bağlantı içerebilir, ancak bu sayfa ek özellikler veya satış için ek eklentiler / modlar sunmayabilir.

“Kırık” / Çevrimdışı-modu / çevrimiçi-moda=yanlış Destek

Bu tür kullanımlar için tasarlandıklarını açıkça beyan eden projelere izin verilmez. Kimlik doğrulama sistemleri gibi bazı projelerde, sunucunun Mojang kimlik doğrulamasını kullanmasından bağımsız olarak sunucular için yararlı olabilecek işlevler olabilir, ancak bu ek kullanımını destekleyemeyebilir veya Mojang kimlik doğrulamasını engelleyen sunucular için özel olarak tasarlanmış olabilirler. Minecraft hesabı sahipliğinin atılmasını kolaylaştırmak için yazılmadığı sürece, çevrimiçi mod = yanlış gerektiren vekiller için tasarlanan projelere izin verilir.

EULA

Tamamıyla Mojang EULA’ya uymayı hedefliyoruz. EULA’yı ihlal ettiğinden şüphelenilen eklentiler, hizmetler, mesajlar ve / veya bağlantılar, Sponge Personelinin takdirine bağlı olarak veya Mojang AB’nin talebi üzerine kaldırılabilir.

Çatallar

Çatallara, aşağıdaki listede yer alan tüm öğeleri karşılamaları şartıyla izin verilir. Kabul edilen çatalı neyin oluşturduğu konusunda personel son neticeye sahiptir. Ana projenin lisansını uygun bir şekilde uygulayın.

Her iki:

  • Yeni bir projenin oluşturulmasını garanti eden önemli değişiklikler içerir. Bu, “Eklenti X’deki ileti renklerini değiştirdim ve şimdi de kredi talebinde bulunmaktan” kaçınmaktır

  • Terk edilmiş olan bir eklentiyi devam ettirin, yazarların iletileri cevaplamadığına dair kanıtla veya projenin artık güncelleneceğini belirtmeden kağıda geçirin.

Geçmişte olan eklentiyi ve geliştiricileri onaylayın veya kredilendirin. Esasen yeni bir eklenti ve yalnızca yaratılışınız olduğunu iddia etmeyin.

Dosyalar

Sunulan dosyalar aşağıdaki beklentileri karşılamalıdır:

Gizleme

Şaşırtmayı kullanan bir dosya, aşağıdaki istisna kapsamına girmediği sürece reddedilecektir:

NMS Çatışması

Bu sadece Minecraft veya Forge modunu referans alan eklentiler için geçerlidir. Örnekler, Mixins’i kullanan bir eklenti veya bir Forge modu (karma eklenti) olarak iki katına çıkaran bir eklenti olacaktır. Yalnızca karmaşık referansların ForgeGradle veya VanillaGradle kullanılarak üretilen karmaşık kaynaklara ait olması koşuluyla, eklentinin inceleme süreci boyunca ilerlemesine izin verilir.

Çekirdek Modlar ve Karışıklıklar: Minecraft Temel Kodunun Değiştirilmesi

Minecraft temel kodunu çalışma zamanında değiştiren bir sistem kullanan eklentiler ve modlar (çekirdek modlar ve mixins gibi), Minecraft kodunda yaptıkları düzenlemeleri ve onların mantığını açıklamalıdır. Sponge eklentileri, mümkün olduğunda Sünger API’sini kullanmalıdır. Sponge uygulamaları, bu tür değişikliklerin varsayılan olarak uygulanmasını önlemek için teknik kısıtlamaları uygulayabilir. Dosyaların bu kısıtlamalar etrafında çalışmaya teşebbüs etmesine izin verilmez, ancak geliştirilmiş işlevselliği Sponge sağlanan yapılandırma seçenekleri aracılığıyla etkinleştirebileceğini kullanıcıya bildirebilirsiniz.

Harici Bağlantılar (Web API’leri, Telefon Defteri Evleri vb.)

Harici sistemlere çağrı yaparak birçok harika özellik yazılabilir. Proje açıklamalarında açıkça belgelenmiş olmasının yanı sıra bu tür işlevler varsayılan olarak yapılandırılabilir ve devre dışı bırakılmış olmalıdır. Projenizin tek amacı harici bir sistem kullanmayı içeriyorsa (diller arasında sohbeti çeviren bir Sponge eklentisi gibi), o sisteme bağlanmanın devre dışı bırakılması gerekmez. Eklentiniz dış sistemlere bilgi (ör. Bir eklenti listesi, oynatıcı verileri veya harita verileri) gönderirse, toplanan bilgiler ana sayfada listelenmelidir (yukarıya bakın).

İndirilen Kodun Yürütülmesi

Bu, hoşunuza gitmeyecek bir güvenlik riski. Bu, kavanozu veya sınıf dosyalarını indirmeyi, indirilen kaynaklardan bayt kodunu üretmeyi ve yürütme kabuğu komut dosyalarını içerir.

Para Kazandırma / Reklamcılık

Eklentinizde bulunan tüm işlevler kısıtlama olmaksızın kullanılabilir olmalı ve çalışması için bir lisans anahtarı gerektirememelidir. İşlevsellik için ödeme yapılması gereken çeviri veya coğrafi konumlandırma hizmetleri gibi harici API’lere izin verilebilir, ancak onay için önce personel arasında tartışılması gerekir. Eklentiler, reklamları görüntülemek için kullanılamaz.

Güncelleme Kontrolü

Güncellemeleri kontrol etmek, verilen Ore API’sını kullanarak yapılmalıdır. Eklentinizdeki kullanıcıları yeni sürümleri indirmeye yönlendirirken eklentiniz hiçbir Cidden bağlanamaz. Bu güncelleme denetiminin, belgelenmesi ve onu devre dışı bırakmak için hangi yapılandırmanın var olması gereken harici bir bağlantı olarak sayıldığına dikkat edin.

Ayrıcalık Vermek

Eklentiler, eklenti geliştiricisi tarafından belirlenen herhangi bir kullanıcıya veya kullanıcı grubuna özellik erişimi vermemeli veya iptal etmemelidir. Bu, yazarın kendisine özel bir görünen ad vermesi ya da kendisine özel bir komut vermesine izin verir. Mümkünse, yazar tarafından önceden belirlenmiş bir erişim olmak yerine, izin düğümlerinin arkasına kilitlenmelidir. Belirli, önceden programlanmış kullanıcılara OP veya izin verme talimatları kabul edilemez.