OAR External Tool

OAR External Tool - User Guide

This is an external editing tool designed to manage Open Animation Replacer (OAR) conditions easily and intuitively. It allows you to edit animation conditions via a web interface with clicks and drags, eliminating the need to modify complex JSON files manually.
You can easily modify conditions without launching the game, just like using the OAR UI in-game.

System Requirements

• OS: Windows 10 or 11 (64-bit)
• Runtime: .NET 9.0 Desktop Runtime (Required)
• WebView2: Microsoft Edge WebView2 Runtime (Required, usually pre-installed)

Important Disclaimer & Testing Status

Please note that this tool has not undergone extensive testing for complex condition configurations or deep edge cases. I have primarily tested the features I frequently use, so unforeseen issues may occur.

[IMPORTANT] It is highly recommended to backup your animation folders before using this tool. If you encounter any problems, please report them, and I will do my best to address them and provide fixes.

Key Features

• Simplified UI: Functions found in the in-game UI have been streamlined for ease of use without sacrificing functionality.
• Auto Mod Base Creation: Added a feature to automatically generate a mod base with the OAR folder structure.
• Folder Creation: You can now create specific condition folders directly within the tool.
• Hybrid Editing: Integrated a system that allows both UI-based condition editing and a raw JSON editor.

Step-by-Step Guide

1. Open Mod Folder

1. Click the [Open MOD] button at the top.
2. Select the Skyrim mod folder (or the OpenAnimationReplacer folder) you are currently working on or want to modify.
3. When the browser asks for file access permissions, select [Allow Edit Access]. (This is required to save local files.)

2. Select Animation Set

• All animation settings (config.json) within the mod will appear in the File Tree on the left.
• Click an item to view its detailed settings in the central area.
• Use the Search Bar at the top right to filter by specific names or priorities.

3. Edit Conditions

• Add: Click the + Add Condition button to select desired conditions (e.g., IsSneaking, HasPerk, etc.).
• Manage: Use the NOT button on each condition card to invert it, or the Copy button to duplicate it.
• Move (Drag): Grab the left side of a card to reorder it or move it into a group like AND/OR.

4. Save Changes

• Save Base: Directly modifies and saves the original config.json file.
• Save User: Creates and saves a user.json override file without touching the original (the safer method).

Precautions

• This tool requires a secure environment (HTTPS or localhost) for all features to function.
• Selecting a system folder (like the entire C drive) may slow down scanning. Please select the specific mod folder.
• Always check if the "Unsaved Changes" message is visible in the status bar before finishing to ensure nothing is lost.

Download & Source

Download OAR External Tool v1.0

GitHub Repository: https://github.com/skypia0147-dev/OAR-External-Tool

Credits & References

Open Animation Replacer (OAR): This tool is based on the logic and structure of the original Open Animation Replacer developed by Ersh. All credits for the OAR framework go to them.

*This program was created to support the Skyrim modding community.

OAR External Tool - 사용 설명서

스카이림의 Open Animation Replacer (OAR) 조건을 더 쉽고 직관적으로 관리하기 위한 외부 편집 툴입니다. 복합적인 JSON 파일 수정 없이 웹 인터페이스에서 클릭과 드래그만으로 애니메이션 조건을 편집할 수 있습니다.
인게임에서 OAR UI를 사용하듯이 게임을 켜지 않고도 쉽게 조건을 수정할 수 있습니다.

요구 사항 (System Requirements)

• 운영체제: Windows 10 또는 11 (64비트)
• 런타임: .NET 9.0 Desktop Runtime (실행을 위해 필수 설치 필요)
• WebView2: Microsoft Edge WebView2 Runtime (필수, 최신 윈도우에는 보통 포함됨)

주의 사항 및 테스트 현황

이 툴은 복잡한 컨디션을 구성하거나 심도 깊은 테스트는 진행하지 않았습니다. 제가 자주 사용하는 기능들만 테스트해봤기 때문에 혹시나 문제가 생길 수도 있습니다.

[중요] 작업을 시작하기 전에 반드시 애니메이션 폴더를 백업한 후 사용하시는 것을 권장합니다. 문제가 있다면 제보해 주세요. 최대한 확인하여 수정하겠습니다.

주요 기능

• 간소화된 UI: 인게임 UI에서 사용되는 기능들을 효율적으로 간소화하여 사용함에 불편함 없이 구성했습니다.
• 자동 모드 베이스 생성: OAR 폴더 구조를 가진 모드 베이스를 자동으로 생성하는 기능을 추가했습니다.
• 폴더 생성 기능: 툴 내에서 특정 조건 폴더를 직접 생성하는 기능을 추가했습니다.
• 하이브리드 편집: UI 기반의 조건 편집과 Raw JSON 에디터를 병행해서 작성할 수 있는 시스템을 통합했습니다.

단계별 사용 방법

1. 모드 폴더 열기

1. 상단의 [Open MOD] 버튼을 클릭합니다.
2. 현재 제작 중이거나 수정하고 싶은 스카이림 모드 폴더(또는 OpenAnimationReplacer 폴더)를 선택합니다.
3. 브라우저가 파일 접근 권한을 물어보면 [수정 권한 허용]을 선택해 주세요. (로컬 파일 저장을 위해 필수입니다.)

2. 애니메이션 세트 선택

• 왼쪽의 파일 트리에 모드 내의 모든 애니메이션 설정(config.json)이 나타납니다.
• 상세 설정을 보고 싶은 항목을 클릭하면 중앙 화면에 편집 창이 나타납니다.
• 우측 상단의 검색창을 이용해 특정 이름이나 우선순위로 필터링할 수 있습니다.

3. 조건(Conditions) 편집하기

• 추가: + Add Condition 버튼을 눌러 원하는 조건(예: IsSneaking, HasPerk 등)을 선택합니다.
• 관리: 각 조건 카드의 NOT 버튼으로 반전시키거나, Copy 버튼으로 복사할 수 있습니다.
• 이동 (드래그): 카드 왼쪽의 드래그 핸들을 잡아 순서를 바꾸거나 AND/OR 같은 그룹 안으로 이동시킬 수 있습니다.

4. 변경 사항 저장

• Save Base: 원본 config.json 파일을 직접 수정하여 저장합니다.
• Save User: 원본을 건드리지 않고 유저 오버라이드 파일인 user.json을 생성하여 저장합니다 (권장되는 안전한 방식).

주의 사항

• 이 툴은 모든 기능이 정상 작동하기 위해 보안이 강화된 환경(HTTPS 또는 localhost)이 필요합니다.
• 시스템 폴더(C 드라이브 전체 등)를 선택하면 스캔 속도가 매우 느려질 수 있습니다. 반드시 해당 모드 폴더를 선택해 주세요.
• 작업을 마치기 전 항상 상태 바에 "Unsaved Changes" 메시지가 떠 있는지 확인하여 데이터 유실을 방지하세요.

다운로드 및 소스

OAR External Tool v1.0 다운로드

GitHub 저장소: https://github.com/skypia0147-dev/OAR-External-Tool

크레딧 및 참조 (Credits & References)

Open Animation Replacer (OAR): 이 툴은 Ersh님이 개발한 원본 Open Animation Replacer의 로직과 구조를 참조하여 제작되었습니다. OAR 프레임워크에 대한 모든 권한은 원작자에게 있습니다.

*이 프로그램은 스카이림 모딩 커뮤니티를 지원하기 위해 제작되었습니다.