Jongyeol_(비교)

==== 개요 ====

Jongyeol Adofai Library에 약자로 얼불춤 모딩에 여러가지 편리한 기능을 제공하는 라이브러리형 모드다.

[[https://jalib.jongyeol.kr/modApplicator/JALib/betalatest|다운로드]][* 베타버전으로 정식버전은 아직 존재하지 않는다.]

JALib을 이용하여 모드를 만드려면 UMM모드 만들듯이 만들면 안되고 JALib을 사용한 모드들에 틀에 맞게 만들어야된다. [[https://github.com/Jongye0l/JALib/blob/main/Document/DevelopGuide.md|JALib 모드 개발 가이드]]

{{{#!syntax csharp

using JALib.Core;

namespace MyMod;

public class Main : JAMod {

protected override void OnSetup() {

Log("MyMod is Setuped.");

}

protected override void OnEnable() {

Log("MyMod is Enabled.");

}

protected override void OnDisable() {

Log("MyMod is Disabled.");

}

}

}}}

==== 기능 ====

라이브러리가 아직 배타버전이기 때문에 없어지거나 사용법이 바뀔 수 있다.

===== 모드 기본 기능 =====

* 자동 업데이트

* 업데이트 알림

* 모드 자동 적용

* 온라인 모드 정보 받아오기

* 모드 자동 다운로드

* 필요한 모드 자동 다운로드

===== 자동 예외 Catch =====

자동 예외 Catch는 Action, Task가 지원한다.

* Action 사용법

{{{#!syntax csharp

JAction action = new JAction(Main.Instance, () => {

throw new Exception("Action Catch");

});

action.Invoke();

}}}

* Task 사용법

{{{#!syntax csharp

JATask.Run(Main.Instance, () => {

throw new Exception("Task Catch");

});

}}}

===== 다양한 랜덤 =====

{{{#!syntax csharp

JARandom random = new JARandom();

random.NextInt();

random.NextLong();

}}}

===== 쉬운 TCP 통신 =====

{{{#!syntax csharp

JATcpClient client = new JATcpClient("localhost", 12345, new JAction(Main.Instance, () => {

client.ReadUTF();

});

}}}

SRV 사용하여 TCP연결

{{{#!syntax csharp

JATcpClient client = new JATcpClient("localhost", 12345, "MyService", false, new JAction(Main.Instance, () => {

client.ReadUTF();

});

}}}

===== 간단한 HTTP 통신 =====

{{{#!syntax csharp

HttpClient client = new HttpClient();

string result = await client.GetString("http://localhost:3000");

}}}

===== 간단한 리플렉션 =====

{{{#!syntax csharp

typeof(Main).Invoke("OnEnable", this);

this.Invoke("Log", "Hello World!");

}}}

===== 스트림 다양한 형식 읽기 =====

{{{#!syntax csharp

Stream stream;

stream.ReadInt();

stream.ReadLong();

stream.ReadUTF();

}}}

===== 메모리 형식에 파일 압축/압축해제 =====

{{{#!syntax csharp

byte[] data;

RawFile[] result = Zipper.Unzip(data);

}}}

===== 메인 스레드 =====

{{{#!syntax csharp

if(!MainThread.IsMainThread()) {

MainThread.Run(Main.Instance, () => {

Main.Instance.Log("Hello World!");

});

await MainThread.WaitForMainThread();

}

}}}

===== 언어별 글데이터 =====

언어별 글 데이터는 모드 폴더/localization/언어.json 에 넣은 데이터들을 불러옵니다.

{{{#!syntax csharp

string value = Main.Instance.Localization["Hi"];

}}}

===== 기능별 관리 =====

다음과 같이 기능을 생성할 수 있다.

{{{#!syntax csharp

public MyFeature : Feature {

public MyFeature() : base(Main.Instance, nameof(MyFeature)) {

}

protected override void OnEnable() {

Main.Instance.Log("MyFeature is Enabled");

}

protected override void OnDisable() {

Main.Instance.Log("MyFeature is Disabled");

}

}

}}}

기능 추가는 OnSetup 매서드에서 진행되며 다음과 같이 할 수 있다.

{{{#!syntax csharp

protected override void OnSetup() {

AddFeature(new MyFeature());

}

}}}

기능을 생성할 때 기능별 설정, 패치를 설정할 수 있다.

===== 패치 =====

JALib에선 기존 Harmony 기능보다 다양하게 패치를 진행할 수 있다.

일반 패치 매서드는 다음과 같이 만들 수 있다.

{{{#!syntax csharp

[JAPatch(typeof(Main), "OnEnable", PatchType.Prefix, false, TryingCatch = true)]

private static void OnEnablePrefix(Main __instance) {

__instance.Log("Enable Prefix");

}

}}}

PatchType에는 다음과 같은 종류가 있다.

* Prefix

* Postfix

* Transpiler

* Finalizer

* Replace

TryingCatch를 통해 이 패치 매서드에서 예외발생을 방지할 지 설정할 수 있다.

Reverse 패치 매서드는 다음과 같이 만들 수 있다.

{{{#!syntax csharp

[JAReversePatch(typeof(Main), "OnEnable", ReversePatchType.Original)]

private static void OnEnableReverse(Main __instance) => throw new NotImplementedException();

}}}

ReversePatchType은 Flag로 여러개를 한번에 선택할 수 있으며 다음과 같은 종류가 있다.

* Original = 0

* PrefixCombine = 1

* PostfixCombine = 2

* TranspilerCombine = 4

* FinalizerCombine = 8

* ReplaceCombine = 16

* OverrideCombine = 32

* AllCombine = PrefixCombine | PostfixCombine | TranspilerCombine | FinalizerCombine | ReplaceCombine | OverrideCombine

* DontUpdate = 0x40000000

Override 패치 매서드는 기본적으로 상속된 매서드에서 사용할 수 있다. Override 패치 매서드는 다음과 같이 만들 수 있다.

{{{#!syntax csharp

[JAOverridePatch]

public void OnEnable() {

Log("MyMod is Enabled but Patched!");

}

}}}

===== 설정 =====

다음과 같은 형식으로 설정을 만들 수 있다.

{{{#!syntax csharp

public MyModSetting : JASetting {

public string SettingField;

public MyModSetting(JAMod mod, JObject jsonObject) : base(mod, jsonObject) {

}

}

}}}

기본적으로 field를 이용해 저장한다.

다음과 같은 형식으로 field에 넣지않고 저장할수도 있다.

{{{#!syntax csharp

JASetting setting;

setting["MySetting"] = "This is my Setting";

}}}