kone
wayward-
wayward-

[10-18]Harmony-standalone

모드
10,194 views · 11 points

10-04 : aHR0cHM6Ly9raW8uYWMvYy9iOHZLbk5oWTB5UjlYWlBRVmlzNmVi

하모니 10-18pre : aHR0cHM6Ly9raW8uYWMvYy9jay1IZ0hDUXg2Vm9UNHpZSXR1UWVi

10-18pre addon-compat in harmony : aHR0cHM6Ly9raW8uYWMvYy9jTFgyN1d0ekl6VFdYWlNHSXh1UWVi
( 하모니와 중복되는 기능을 제거한 10-18pre 최신화 입니다. 선행모드로 많이 쓰고 있어 비공식 업데이트하였습니다.)

Harmony 0.11.5 기본 기능 안내

Harmony는 무엇인가요?

Harmony는 여러 WML 모드가 게임의 같은 기능을 수정할 때, 그 연결을 조정하는 기반 모드입니다.

예를 들어 두 모드가 모두 가격 계산을 수정한다면, 한쪽이 다른 쪽의 처리를 덮어쓰거나 WML이 중복 교체 오류를 낼 수 있습니다. Harmony는 자신이 수집한 수정들을 실행 순서와 연결 규칙에 따라 조합합니다.

Harmony 자체가 새로운 캐릭터·장소·이벤트·이미지를 추가하지는 않습니다. 다른 모드의 기능을 연결하고, 겹치는 처리와 연결 상태를 관리하는 역할입니다.

지원 조건은 Harmony가 실제로 가장 먼저 로드되는 것입니다. 기본 목록의 첫 항목인 것과 실제 실행 순서가 첫 번째인 것은 다를 수 있으므로, WML에 저장된 사용자 순서도 확인해야 합니다.

1. 같은 기능을 수정하는 모드의 처리 조정

모드가 게임 기능을 수정하는 방식에는 원래 처리 전후에 내용을 덧붙이는 방식과, 함수 전체를 교체하는 방식이 있습니다.

Harmony는 자신보다 뒤에서 정의된 모드의 일반적인 WML replace 등록을 수집해 중재합니다. 외부 모드가 반드시 Harmony 전용 API를 사용해야 하는 것은 아닙니다. 기존 WML의 before·around·after 훅은 그대로 전달합니다.

여러 교체 처리가 같은 함수에 등록되면 우선순위에 따라 실행합니다. 이때 첫 번째 교체 함수는 원래 인수를 받고, 두 번째부터는 앞선 교체 함수의 결과를 이어받습니다.

따라서 단순히 마지막 모드 하나만 남기는 방식과 다릅니다. 다만 서로 다른 입력·출력 구조를 전제로 작성된 모드까지 자동으로 올바르게 바꿔 주지는 않습니다. 여러 처리를 연결하는 것과, 그 조합의 게임 규칙이 서로 맞는 것은 별개의 문제입니다.

2. 겹치는 수정의 선택적 사용

Harmony 설정에서 전체 중재 사용 여부와 등록된 개별 수정의 사용 여부를 조절할 수 있습니다.

예를 들어 특정 모드의 가격 수정만 연결에서 빼고 다른 등록 처리는 유지하는 식으로 문제 범위를 좁힐 수 있습니다. 이는 해당 모드를 삭제하거나 그 모드의 모든 기능을 끈다는 뜻은 아닙니다.

설정에서 끄는 범위는 Harmony가 관리하는 연결입니다. 외부 모드가 별도로 실행하는 처리까지 모두 제어하지는 않습니다.

3. 지원 모드에 공통 연결 제공

게임 내부 함수 이름을 각 모드가 제각각 찾아 쓰는 대신, 지원 모드가 사용할 수 있는 공통 연결을 제공합니다.

대화, 캐릭터 상태, 시간 진행, 객실, 거래, 판정 등의 연결이 이에 해당합니다. 게임 버전별 연결 정보를 한곳에서 관리하므로 지원 모드가 동일한 계약을 통해 접근할 수 있습니다.

이 기능은 등록된 게임 버전과 연결 계약을 대상으로 합니다. 다른 버전의 게임이나 아무 외부 모드에나 자동으로 맞춰지는 범용 변환기는 아닙니다.

4. 지원 모드의 선택적 Harmony 연결

지원 모드는 자신의 기본 기능을 독립적으로 실행하고, 필요한 경우 Harmony가 제공하는 연결을 선택적으로 사용할 수 있습니다.

이 연결은 전체 모드의 첫 초기화가 끝난 뒤 준비된 공급자와 소비자를 확인하는 방식으로 설치됩니다. Harmony 연결을 사용한다고 캐릭터·객실·설정·기존 함수 체인을 새로 만들거나 버리는 것이 목적은 아닙니다.

다만 Harmony를 필수 선행으로 지정한 외부 모드는 별개입니다. Harmony를 끄면 그런 모드는 함께 실행되지 않을 수 있습니다.

5. 연결 상태와 충돌 진단

Harmony 설정에서는 등록된 어댑터의 연결 상태와 사용할 수 없는 이유 등을 확인할 수 있습니다. 모드가 버전 정보를 공개하지 않았다면 임의로 추정하지 않고 미공개 상태로 취급합니다.

등록된 함수 체인의 소유권이나 연결이 손상됐는지도 검사할 수 있습니다. 문제를 발견하면 진단을 남기며, 출처를 알 수 없는 함수를 추정해서 복구하거나 다른 모드의 변경을 무조건 삭제하지 않습니다.

이 진단은 원인을 좁히는 자료입니다. 연결 상태가 정상이라는 표시만으로 모든 게임 상황의 기능까지 검증됐다는 뜻은 아닙니다.

6. 개발자·LLM을 위한 명시적 연결 계약

모드 제작자는 Harmony의 공개 계약을 통해 처리의 소유자, 대상 함수, 우선순위와 실행 방식을 등록할 수 있습니다.

등록을 해제할 때도 자신이 소유한 연결만 해제하도록 구성할 수 있습니다. 따라서 다른 모드의 수정을 통째로 초기화하는 방식보다 연결의 책임과 범위를 구분하기 쉽습니다.

외부 어댑터를 가져오는 기능도 있지만, 어댑터를 가져왔다는 사실만으로 호환성이 보장되지는 않습니다. 대상 버전과 필수 API, 연결·해제 계약이 맞아야 합니다.

7. 0.11.5의 지문 차이 처리

지문은 함수 본문이 저장된 기준과 같은지 확인하는 값입니다.

0.11.5에서는 conversation·wallet·assayDuration이 호출 가능한 함수로 존재한다면, 지문이 다르다는 이유만으로 Harmony 전체를 중단하지 않습니다. 현재 함수를 유지하고 기대 지문과 실제 지문을 진단에 남깁니다.

이 처리는 Harmony 단독 설치 단계와 공용 NativeCore 최초 준비 단계 모두에 적용됩니다. 대화를 끄거나, 관련 모드를 몰래 제외하거나, 기준값을 현재 값으로 덮어쓰는 방식이 아닙니다.

함수 자체가 없거나 저장소 구조가 잘못된 경우처럼 실제로 연결을 사용할 수 없는 오류는 여전히 구별합니다.

Harmony가 보장하지 않는 것

Harmony는 모든 외부 모드의 충돌을 자동 해결하는 만능 호환 모드가 아닙니다.

원본 참조 없이 함수를 직접 덮어쓰는 코드, 잘못된 반환값, 게임 규칙 자체의 충돌, 비동기 실행 문제까지 모두 고칠 수는 없습니다. 이미 덮여 사라진 함수의 내용을 추정해 되살리지도 않습니다.

게임 HTML이나 WML 본체를 교체하는 도구도 아니며, 사용자 저장·이미지·생성 대기열을 정리하는 도구도 아닙니다.

Harmony의 핵심은 지원되는 연결을 조정하고, 등록된 수정의 실행과 소유권을 관리하며, 문제를 진단하는 것입니다. Harmony를 실제 첫 번째로 로드하는 것이 그 출발 조건입니다.



하모니는 wml 모드 목록에 가급적 상단. 첫번쨰로 로드됐을때를 기준으로 작성되었습니다.
원래는 WML에서 지원해야할 사양이지만 WML을 건들지 않는 선에서 최선이었습니다.

종속성도 강제성도 없습니다. HARMONY가 벌인 모든 행위는 harmony의 모드설정 즉시 등록됩니다. 오류가 발생하는 모드와의 연결을 끊으면 원래대로 작동합니다.

두개 이상의 모드가 하나의 대상을 바꾸려들면, 둘 다 해버리는 모드라고 생각하시면 편합니다.

요리가 한번에 4인분씩 생산되는 모드와, 8인분씩 생산되는 모드가 있다면, harmony연결시 12인분이 생산됩니다.

그외에도 구버전의 변수를 최신버전으로 만들어주는 기능이있습니다만, 요즘 모드판을 보면 괜히 만든거 같네요.


aHR0cHM6Ly9raW8uYWMvYy9iOHZLbk5oWTB5UjlYWlBRVmlzNmVi

11
4 comments
어 이거개쩌는 모드인데 호환 안되는 모드를 어디까지 지원해줄지 궁금하네..
Harmony 어댑터가 호환모드 만드느데 쓰느건가..
어흐...채고야잇
All
Title
Body