Vortex adalah pengelola mod terkini dari Nexus Mods. Ini dirancang untuk membuat modding game Anda sesederhana mungkin bagi pengguna baru, sambil tetap memberikan kontrol yang cukup untuk veteran yang lebih berpengalaman dalam dunia modding.
Pendekatan kami dengan Vortex bertujuan untuk melakukan tugas-tugas kompleks seperti mengurutkan urutan pemuatan atau mengelola file mod Anda dan mengotomatiskan sebanyak mungkin proses dengan tujuan agar Anda mencapai game modded yang stabil dengan sedikit usaha. Kami ingin membantu Anda menghabiskan lebih sedikit waktu untuk melakukan modding dan lebih banyak waktu bermain game.
Dukungan Multi-game - dengan dukungan mod untuk lebih dari 250 game berbeda dan terus bertambah, Vortex adalah pengelola mod paling serbaguna yang tersedia. Ini termasuk game seperti Skyrim, Fallout 3, Fallout 4, Fallout: New Vegas, Cyberpunk 2077, Baldur's Gate 3, Starfield, Stardew Valley, Bannerlord, Witcher 3, Elden Ring, The Sims 4, Monster Hunter: World, Oblivion, Palworld , Pedang & Sihir, Valheim, Warisan Hogwarts, 7 Hari Menuju Kematian.
Integrasi erat dengan Nexus Mods - Vortex dirancang untuk berinteraksi secara lancar dengan Nexus Mods sehingga Anda dapat dengan mudah menemukan, memasang, dan memainkan mod dari situs kami, mempelajari file baru, dan mengetahui berita terkini.
Modding menjadi mudah - Sistem penyortiran otomatis bawaan mengelola urutan pemuatan Anda dan membantu Anda menyelesaikan konflik mod dengan fitur manajemen plugin yang kuat namun mudah digunakan.
Profil Mod - Dengan mudah mengatur, beralih di antara, dan mengelola profil mod independen yang memungkinkan Anda menggunakan kombinasi mod yang Anda inginkan untuk permainan tertentu.
UI Modern dan Mudah Digunakan - Menampilkan antarmuka yang sepenuhnya dapat disesuaikan, Vortex memungkinkan Anda mengakses alat dan mengelola game, plugin, pengunduhan, dan menyimpan game dengan cepat dan mudah.
Ekstensi dan Plugin - Vortex dirilis di bawah Lisensi GPL-3 yang memberikan komunitas kami kemampuan untuk menulis ekstensi dan kerangka kerja yang kemudian dapat berinteraksi dengan Vortex, terus menambah fungsinya.
Untuk memulai, Vortex dapat diunduh dari Nexus Mods atau dari GitHub. Setelah penginstal diunduh, jalankan saja dan ikuti petunjuknya.
Informasi tambahan tentang Vortex dan panduannya dapat ditemukan di Vortex Wiki.
Untuk memulai pengembangan di Vortex, silakan gunakan metode yang sebagian besar otomatis ini untuk mengunduh dan menginstal semua dependensi, mengkloning repo Vortex dari GitHub, lalu membangunnya sehingga dapat dijalankan dari sumber. Sebagian besar dependensi diinstal menggunakan Scoop.
Mulai PowerShell dengan mengklik tombol Start dan mengetik powershell
.
Jalankan Invoke-WebRequest "https://raw.githubusercontent.com/Nexus-Mods/Vortex/master/bootstrap.ps1" -OutFile bootstrap.ps1
untuk mengambil skrip bootstrap
Secara default, skrip ini akan membangun Vortex di C:buildvortex
. Jika Anda ingin menempatkannya di tempat lain, edit skrip untuk mengubah direktori build sebelum menjalankannya.
Kemungkinan besar Anda harus mengizinkan skrip dijalankan. Ini dapat diatur menggunakan Set-ExecutionPolicy Unrestricted
tetapi diperlukan PowerShell dengan akses admin.
Jalankan skrip ( .bootstrap.ps1
)
Bagian berikut bertujuan untuk memperjelas dan menjelaskan beberapa keputusan pembangunan.
Toolchain untuk build pengembangan dan build rilis sangat berbeda.
Dalam build dev, kompiler skrip ketikan (tsc) digunakan secara langsung untuk mentransliterasi setiap file .ts
menjadi .js
satu per satu, elektron menjalankan file tersebut secara langsung, dependensi dimuat dari node_modules
.
Dalam versi rilis, kami menggunakan webpack dan ts-loader untuk memanggang semua file .ts
dan dependensi menjadi dua file javascript (satu untuk proses utama/browser, satu untuk renderer). electron-builder
digunakan untuk menggabungkan kode & aset, menghasilkan penginstal nsis, membuatnya menjadi penginstal exe dan menandatanganinya (dan semua file executable dan dll yang kami kirimkan). Ada beberapa file konfigurasi pembuat elektron untuk beberapa varian, hanya "oneclick" dan "advanced" yang digunakan untuk versi rilis, yang lain mungkin berada dalam kondisi rusak yang berbeda (meskipun ci juga dapat berfungsi)
Hasilnya, pembangunan dev lebih mudah untuk dikerjakan dan pembangunannya jauh lebih cepat tetapi waktu prosesnya lebih lambat.
Selanjutnya, kami menggunakan struktur dua paket, artinya file /package.json
digunakan untuk semua pengembangan dan lingkungan build untuk rilis (misalnya file ini selalu mengontrol versi elektron yang digunakan/dibundel) sedangkan /app/package.json
memutuskan pengaturan (nama, versi, dependensi) hanya untuk versi rilis. Kami menggunakan skrip khusus ( checkPackages.js
) untuk memastikan bahwa dependensi untuk rilis adalah bagian dari dependensi build env
dan menggunakan versi yang sama untuk menghindari masalah yang tidak terjadi selama pengujian karena dependensi yang berbeda.
Sebaliknya, ekstensi yang dibundel dibuat sama antara dev dan rilis: ekstensi selalu dibuat dengan webpack dan masing-masing memiliki pengaturan build sendiri - dengan pengecualian ekstensi game sederhana yang sudah berupa file js tunggal, ekstensi tersebut disalin begitu saja.
Basis kode ini masih menggunakan benang 1 (klasik). Setiap upaya untuk menggunakan benang 2 atau 3 berakhir dengan kesalahan yang tidak masuk akal (hilangnya dependensi yang terdaftar dengan jelas, instalasi berturut-turut menyebabkan paket hilang) tanpa cara yang masuk akal untuk menyelidiki alasannya. npm dan pnpm cukup lambat jika dibandingkan. Kami tidak benar-benar menggunakan fitur khusus benang apa pun (ruang kerja?) jadi peralihan seharusnya tidak terlalu sulit tetapi untuk saat ini benang "klasik" berfungsi.
Pada saat penulisan, elektron tidak mendukung modul ES sehingga semuanya ditranspilasi ke commonjs. Hal ini mempunyai konsekuensi bahwa beberapa perpustakaan yang diperbarui hanya mendukung esm tidak dapat digunakan (misalnya versi baru d3). Ini juga berarti bahwa impor asinkron ( const foo = await import('bar')
) sebenarnya sinkron saat runtime. Namun tidak terlalu penting karena semuanya dimasukkan ke dalam satu file pada rilis build dan pemisahan kode tidak terlalu diperlukan.
Silakan laporkan masalah di GitHub dan sertakan setidaknya informasi berikut:
Versi persis Vortex yang Anda gunakan
OS Anda
Apa yang Anda lakukan saat bug terjadi
Apa sebenarnya bug tersebut (kerusakan? pesan kesalahan? perilaku tak terduga?)
Jika Anda mendapatkan pesan kesalahan, sertakan pesan kesalahan yang lengkap dan tepat. Jangan memparafrasekan, jangan tinggalkan informasi yang tampak samar atau tidak penting bagi Anda
File log (lihat di bawah)
Idealnya juga status aplikasi (lihat di bawah)
Semua data yang dihasilkan klien (termasuk pengaturan dan log) disimpan di:
Tipe Bangun | Lokasi | Jalan Umum |
---|---|---|
Melepaskan | %AppData%Vortex | C:Users |
Dev | %AppData%vortex_devel | C:Users |
Jika Anda perlu melaporkan bug, jalur berikut di dalam direktori tersebut mungkin berguna selain pesan kesalahan yang ditampilkan di layar:
vortex.log
(log diputar dengan ukuran tertentu, ini yang terbaru)
state
kecuali global_account (yang berisi kunci dan kata sandi sehingga informasi sensitif)
(jika bug berkaitan dengan game tertentu)
TODO: Langkah manual dengan dependensi dan versi
Unduh Vortex dari Nexus Mods
GitHub untuk kode sumber, masalah, dan permintaan penarikan.
Vortex Forum atau Discord untuk dukungan dan diskusi dengan komunitas dan tim.
Vortex Wiki untuk basis pengetahuan, artikel dan pemecahan masalah
Struktur Proyek untuk gambaran umum tentang bagaimana basis kode diatur.
Mayoritas kode Vortex adalah sumber terbuka. Kami berkomitmen terhadap proses pembangunan yang transparan dan sangat menghargai kontribusi apa pun. Baik Anda membantu kami memperbaiki bug, mengusulkan fitur baru, menyempurnakan dokumentasi kami, atau menyebarkan berita - kami ingin Anda menjadi bagian dari komunitas Vortex.
Laporan Bug: Jika Anda melihat pesan kesalahan atau mengalami masalah saat menggunakan Amplication, silakan buat laporan bug.
Permintaan Fitur: Jika Anda memiliki ide atau jika ada kemampuan yang kurang dan akan membuat pengembangan lebih mudah dan kuat, silakan kirimkan permintaan fitur.
Ekstensi Ulasan: Jika Anda membuat ekstensi game dan memerlukan kami untuk meninjaunya, kirimkan permintaan ekstensi ulasan.
Proyek ini dilisensikan di bawah lisensi GPL-3.0.