와동
1.12.6
Vortex는 현재 Nexus Mods의 모드 관리자입니다. 이는 새로운 사용자를 위해 게임을 최대한 간단하게 모딩하는 동시에 모딩 분야의 숙련된 베테랑에게도 충분한 제어 기능을 제공하도록 설계되었습니다.
Vortex에 대한 우리의 접근 방식은 로드 순서 정렬 또는 모드 파일 관리와 같은 복잡한 작업을 수행하고 최소한의 노력으로 안정적인 모드 게임을 달성한다는 목표로 가능한 많은 프로세스를 자동화하는 것을 목표로 합니다. 우리는 귀하가 모딩에 소요되는 시간을 줄이고 게임을 플레이하는 데 더 많은 시간을 할애할 수 있도록 돕고 싶습니다.
다중 게임 지원 - 250개 이상의 다양한 게임에 대한 모드 지원을 통해 Vortex는 가장 다재다능한 모드 관리자입니다. 여기에는 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와 같은 게임이 포함됩니다. , 블레이드 앤 소서리, 발하임, 호그와트 레거시, 7 Days to Die.
Nexus Mods와의 긴밀한 통합 - Vortex는 Nexus Mods와 원활하게 상호 작용하도록 설계되어 사이트에서 모드를 쉽게 찾고, 설치하고, 재생할 수 있고, 새 파일에 대해 알아보고, 최신 뉴스를 확인할 수 있습니다.
간편한 모딩 - 내장된 자동 정렬 시스템은 로드 순서를 관리하고 강력하면서도 사용하기 쉬운 플러그인 관리 기능을 통해 모드 충돌을 해결하는 데 도움을 줍니다.
모드 프로필 - 특정 플레이에서 원하는 모드 조합을 정확하게 사용할 수 있도록 독립적인 모드 프로필을 쉽게 설정하고 전환하고 관리할 수 있습니다.
현대적이고 사용하기 쉬운 UI - 완전히 사용자 정의 가능한 인터페이스를 갖춘 Vortex를 사용하면 빠르고 쉽게 도구에 액세스하고 게임, 플러그인, 다운로드를 관리하고 게임을 저장할 수 있습니다.
확장 및 플러그인 - Vortex는 GPL-3 라이센스에 따라 출시되어 커뮤니티에 확장 및 프레임워크를 작성하고 Vortex와 상호 작용하여 지속적으로 기능을 추가할 수 있는 기능을 제공합니다.
시작하려면 Nexus Mods 또는 GitHub에서 Vortex를 다운로드할 수 있습니다. 설치 프로그램을 다운로드한 후 실행하고 지침을 따르십시오.
Vortex 및 가이드에 대한 추가 정보는 Vortex Wiki에서 확인할 수 있습니다.
Vortex에서 개발을 시작하려면 대부분 자동화된 이 방법을 사용하여 모든 종속성을 다운로드 및 설치하고 GitHub에서 Vortex 저장소를 복제한 다음 소스에서 실행할 수 있도록 빌드하십시오. 대부분의 종속성은 Scoop을 사용하여 설치됩니다.
시작 버튼을 클릭하고 powershell 입력하여 powershell을 시작합니다.
Invoke-WebRequest "https://raw.githubusercontent.com/Nexus-Mods/Vortex/master/bootstrap.ps1" -OutFile bootstrap.ps1 실행하여 부트스트랩 스크립트를 가져옵니다.
기본적으로 이 스크립트는 C:buildvortex 에서 Vortex를 빌드합니다. 다른 곳에 위치시키려면 스크립트를 편집하여 실행하기 전에 빌드 디렉터리를 변경하세요.
스크립트 실행을 허용해야 할 가능성이 높습니다. 이는 Set-ExecutionPolicy Unrestricted 사용하여 설정할 수 있지만 관리자 액세스 권한이 있는 Powershell이 필요합니다.
스크립트 실행( .bootstrap.ps1 )
다음 섹션에서는 몇 가지 개발 결정을 명확히 하고 설명하는 것을 목표로 합니다.
개발 빌드와 릴리스 빌드를 위한 툴체인은 상당히 다릅니다.
개발 빌드에서 TypeScript 컴파일러(tsc)는 각 .ts 파일을 개별적으로 .js 로 음역하는 데 직접 사용되며, 전자는 해당 파일을 직접 실행하고, 종속성은 node_modules 에서 로드됩니다.
릴리스 빌드에서는 webpack과 ts-loader를 사용하여 모든 .ts 파일과 종속성을 두 개의 자바스크립트 파일(기본/브라우저 프로세스용 하나, 렌더러용 하나)로 굽습니다. electron-builder 는 코드와 자산을 묶고, nsis 설치 프로그램을 생성하고, exe 설치 프로그램으로 빌드하고 서명하는 데 사용됩니다(그리고 우리가 제공하는 모든 실행 파일과 dll). 여러 변형에 대한 여러 개의 Electron-Builder 구성 파일이 있습니다. 릴리스 빌드에는 "oneclick" 및 "advanced"만 사용되며, 나머지는 서로 다른 파손 상태에 있을 수 있습니다(ci도 작동해야 함).
결과적으로 개발 빌드 작업이 더 쉽고 빌드 속도가 훨씬 빨라지지만 런타임은 느려집니다.
또한 우리는 2개의 패키지 구조를 사용합니다. 즉, /package.json 파일은 모든 개발 및 릴리스용 빌드 환경에 사용되는 반면(예: 이 파일은 항상 사용/번들링되는 전자 버전을 제어함) /app/package.json 결정합니다. 릴리스 빌드에 대한 설정(이름, 버전, 종속성)만 해당됩니다. 우리는 사용자 정의 스크립트( checkPackages.js )를 사용하여 릴리스 종속성이 빌드 env 종속성의 하위 집합인지 확인하고 서로 다른 종속성으로 인해 테스트 중에 발생하지 않은 문제를 방지하기 위해 동일한 버전을 사용하는지 확인합니다.
반면에 번들 확장은 개발과 릴리스 간에 동일하게 구축됩니다. 항상 webpack으로 구축되고 각각 고유한 빌드 설정을 갖습니다. 이미 단일 js 파일인 간단한 게임 확장을 제외하고는 단순히 복사됩니다.
이 코드베이스는 여전히 원사 1(클래식)을 사용합니다. Yarn 2 또는 3을 사용하려는 모든 시도는 원인을 조사할 합리적인 방법 없이 무의미한 오류(명확하게 나열된 종속성 누락, 연속 설치로 인해 패키지 누락)로 끝났습니다. npm과 pnpm은 비교해 보면 상당히 느립니다. 우리는 실제로 원사 관련 기능(작업 공간?)을 사용하지 않으므로 전환이 너무 어렵지 않아야 하지만 현재 원사 "클래식" 작업에서는 작동합니다.
이 글을 쓰는 시점에서 전자는 ES 모듈을 지원하지 않으므로 모든 것이 commonjs로 변환됩니다. 이로 인해 esm만 지원하는 일부 업데이트된 라이브러리를 사용할 수 없게 됩니다(예: d3의 새 버전). 이는 또한 비동기 가져오기( const foo = await import('bar') )가 실제로 런타임에 동기적이라는 것을 의미합니다. 어쨌든 릴리스 빌드에서 모든 것이 단일 파일로 구워지고 코드 분할이 실제로 필요하지 않기 때문에 실제로 중요하지 않습니다.
GitHub에 문제를 보고하고 최소한 다음 정보를 포함하세요.
사용 중인 Vortex의 정확한 버전
귀하의 OS
버그가 발생했을 때 무엇을 하고 있었나요?
버그가 정확히 무엇입니까(충돌, 오류 메시지, 예상치 못한 동작?)
오류 메시지가 나타나면 전체적이고 정확한 오류 메시지를 포함하세요. 의역하지 말고, 이해하기 어렵거나 중요하지 않은 정보를 생략하지 마십시오.
로그 파일(아래 참조)
이상적으로는 애플리케이션 상태(아래 참조)
클라이언트가 생성하는 모든 데이터(설정 및 로그 포함)는 다음 위치에 저장됩니다.
| 빌드 유형 | 위치 | 공통 경로 |
|---|---|---|
| 풀어 주다 | %AppData%Vortex | C:Users |
| 데브 | %AppData%vortex_devel | C:Users |
버그를 보고해야 하는 경우 화면에 표시되는 오류 메시지 외에 해당 디렉터리 내의 다음 경로가 유용할 수 있습니다.
vortex.log (로그는 특정 크기로 회전하는데, 이것이 최신입니다)
global_account를 제외한 state (키와 비밀번호가 포함되어 있어 민감한 정보임)
TODO: 종속성 및 버전이 포함된 수동 단계
Nexus Mods에서 Vortex 다운로드
소스 코드, 문제 및 끌어오기 요청을 위한 GitHub입니다.
커뮤니티 및 팀과의 지원 및 토론을 위한 Vortex Forum 또는 Discord.
기술 자료, 기사 및 문제 해결을 위한 Vortex Wiki
코드베이스가 어떻게 구성되어 있는지에 대한 개요를 위한 프로젝트 구조.
Vortex 코드의 대부분은 오픈 소스입니다. 우리는 투명한 개발 프로세스를 위해 최선을 다하고 있으며 모든 기여에 깊은 감사를 드립니다. 버그 수정을 돕거나, 새로운 기능을 제안하거나, 문서를 개선하거나, 소문을 퍼뜨리는 등 Vortex 커뮤니티의 일원이 되어 주시길 바랍니다.
버그 보고서: Amplication을 사용하는 동안 오류 메시지가 표시되거나 문제가 발생하는 경우 버그 보고서를 작성해 주세요.
기능 요청: 아이디어가 있거나 누락되어 개발을 더 쉽고 강력하게 만드는 기능이 있는 경우 기능 요청을 제출하세요.
추가 리뷰 추가: 게임 확장을 생성 중이고 검토가 필요한 경우 리뷰 연장 요청을 제출하세요.
A 이 프로젝트는 GPL-3.0 라이선스에 따라 라이선스가 부여됩니다.
