내려받은 파일의 이름 식별하기

참고

2018년 10월 버저닝 정책이 업데이트 됐습니다. SpongeAPI 7.1 이후 버전은 아래 문서를 읽어주시고 7.1 이전 구버전의 경우 구버전의 SpongeForge 식별하기 를 읽어주세요.

파일을 내려받으면 파일명에 버전에 관련된 중요한 정보가 같이 쓰여 있습니다. 이 단락에서는 버전 정보에 대해 설명합니다.

SpongeForge

내려받은 SpongeForge 파일명 형식은 다음과 같습니다:

spongeforge-<MCVersion>-<ForgeBuild>-<APIMajor>.<LatestAPIMinorRelease>.<RecommendedVersion(-RC<BuildNumber>)>.jar

`MCVersion`	마인크래프트 버전을 뜻하며, 해당 버전의 클라이언트만 서버에 접속할 수 있습니다.
`ForgeBuild`	Forge 빌드는 SpongeForge가 이 빌드 번호로 빌드되고 호환성이 보장되는 빌드 번호를 나타냅니다.
`APIMajor`	파일의 SpongeAPI가 구현한 메이저 번호를 나타냅니다. (semantic versioning 에서 ``X``입니다.)
`LatestAPI` `MinorRelease`	파일의 SpongeAPI가 구현한 마이너 번호를 나타냅니다. (semantic versioning 에서 ``Y``입니다.)
`권장` `버전`	``-RC<BuildNumber>``가 없는 파일의 SpongeAPI가 구현한 릴리즈 버전을 나타냅니다. (semantic versioning 에서 ``Z``입니다.)
`-RC` `<BuildNumber>`	다음 권장 릴리즈를 위해 개발 중인 빌드 번호입니다. 빌드 번호가 있으면 ``권장 버전``은 아직 릴리즈되지 않았음을 나타냅니다.

파일명에 있는 Forge 빌드는 개발 및 테스트 중에 SpongeForge가 사용한 Forge 버전을 나타냅니다. 두 가지 버전(개발 및 테스트 버전)은 서로 문제 없이 작동되도록 보장하며 이를 위해 최신 *권장 빌드*를 사용할 수도 있습니다.

참고

대체적으로 Forge 모드는 호환하는 마인크래프트 버전 (예. 1.12.2)에 대응하는 모든 Forge 빌드에서 사용 가능합니다. 그러나 SpongeForge만이 Forge의 여러 내부 요소에 접근하고 다른 모드들은 접근하지 않아야 하는데 Forge는 내부 코드가 얼마든지 바뀔 수 있어서 Forge가 보장하는 모드 하위 호환성이 SpongeForge에서는 적용되지 않습니다. 이는 SpongeForge에서 사용하는 Forge 권장 버전보다 더 최신 버전의 Forge를 사용해도 무방하지만 호환성은 항상 보장되지 않음을 의미합니다.

경고

서버 충돌 문제가 발생하면, SpongeForge의 파일명에 표시된 버전보다 높은 버전의 Forge를 적용해 볼 수도 있겠지만 먼저 권장 버전과 일치하는 Forge를 사용해 버전 문제가 원인인지 조사해 보는 것을 추천합니다. 아니면 호환성을 보장해 드릴 순 없지만 이슈 트래커(Issue tracker)에 버전 충돌 문제를 제보해 주시면 SpongePowered 팀이 해결하여 새로운 버전에 반영될 수도 있습니다.

예시

SpongeForge의 호환성을 쉽게 확인할 수 있도록 Jar 파일명은 항상 다음 형식을 따르고 있습니다.

예를 들어, spongeforge-1.12.2-2768-7.1.4.jar 라는 이름을 가진 파일은 마인크래프트 1.12.2 버전과 호환되며, Forge 14.23.5.2768 (빌드 2768)에서 빌드되었으며, SpongeAPI ``7.1.0``을 권장 버전으로 호환됨을 의미하며, 이 API로 릴리즈 된 ``4``번째 SpongeForge임을 나타냅니다.

다른 예시로 spongeforge-1.12.2-2768-7.1.5-RC3505.jar 라는 이름을 가진 파일은 마인크래프트 1.12.2 버전과 호환되며, Forge 14.23.5.2768 (빌드 2768)에서 빌드되었으며, 권장 버전이 아닌 SpongeAPI 7.1.0 버전과 호환되며, 개발 빌드 번호가 ``3505``임을 의미하며, 이 API로``5``번째로 릴리즈될 것임을 나타냅니다.

SpongeVanilla

SpongeVanilla는 SpongeForge에서 Forge 빌드 번호가 포함되어 있지 않다는 점을 제외하고 SpongeForge와 동일합니다. 따라서 위에서 보았던 SpongeForge jar 파일 예시를 SpongeVanilla로 보면 다음과 같습니다:

spongevanilla-1.12.2-7.1.4.jar 와 spongevanilla-1.12.2-7.1.5-RC148.jar

SpongeApi

파일명의 형식은 다음과 같습니다:

spongeapi-<APIMajor>.<LatestAPIMinorRelease>.0-shaded.jar

이거나

spongeapi-<APIMajor>.<LatestAPIMinorRelease>.0-<Date>.<Time>-<BuildNumber>-shaded.jar

이거나

spongeapi-<APIMajor>.<LatestAPIMinorRelease>.0-SNAPSHOT.jar

`APIMajor`	파일의 SpongeAPI가 구현한 메이저 번호를 나타냅니다. (semantic versioning 에서 ``X``입니다.)
`LatestAPI` `MinorRelease`	파일의 SpongeAPI가 구현한 마이너 번호를 나타냅니다. (semantic versioning 에서 ``Y``입니다.)
`Date`	빌드 작업이 시작할 때 날짜입니다.
`Time`	빌드 작업이 시작할 때 시간입니다.
`<BuildNumber>`	Sponge 빌드 넘버입니다. 버그를 제보하거나 기술적 도움을 받을 때 이 빌드 넘버를 알려주세요.

참고

빌드 정보가 없는 첫번째 형식은 릴리즈*와 *권장 빌드 형식입니다. (예. spongeapi-7.1.0-shaded.jar)

빌드 정보가 없는 두번째 형식은 웹 브라우저에서 파일이 내려받아 질 때 최신버전 형식입니다. 이 버전은 개발 중이므로 실사용에 적합하지 않습니다. ( 예. spongeapi-7.2.0-20190224.183500-15-shaded.jar)

빌드 정보가 없는 세번째 형식은 Gradle이나 Maven, 또는 빌드 과정에서 생성된 파일이 내려받아 질 때 최신 버전 형식입니다. 이 버전은 개발 중이므로 실사용에 적합하지 않습니다. (예. spongeapi-7.2.0-SNAPSHOT.jar)

-shaded 라벨링이 붙는 이유가 궁금하시다면 빌드 시스템 페이지를 확인하세요.