SPD Modding Guide - Hoto-Mocha/ARranged-Pixel-Dungeon GitHub Wiki

• 짧게보는 녹픽던 모딩 시작
• 녹픽던 모딩의 기초 - 1
• 녹픽던 모딩의 기초 - 2
• 특수맵 추가하기
• 인벤토리 칸 수 늘리기
• 안드로이드 스튜디오 단축키 및 기능
• 특성 추가에 따른 줄바꿈이 필요할 때
• 도트 찍기
• UI 색 바꾸기
• 3번째 세부 직업 추가하기
• 직업 추가하기
• PC 화면에서 버프에 숫자(지속 시간 등)가 뜨게 하는 메소드는 iconTextDisplay()임
• 버프 획득 시 무한로딩이 걸리는 경우 act()에 spend(TICK)이 빠져 있지는 않았는지 체크, 반격 기능일 경우 callBack()안에 next()사용해볼 것
• 버프가 메인메뉴 갔다 왔을 때 증발하는 경우 초기에 지정해주는 값에 외부 참조가 있는지 체크
• 안드로이드 스튜디오에서 한글이 깨질 때
• 세이브 로드 시 버프 혹은 아이템이 사라지는 경우 초기값에 외부 참조가 있는지 체크
• 세이브 로드 시 버프의 액션버튼이 사라지는 경우 restoreFromBundle()에 ActionIndicator.setAction(this)를 넣을 것
• 만약 안드로이드 스튜디오에서 실제로는 존재하지 않는 라인이 추가되어 보기 불편할 경우 Settings(Ctrl+Alt+S) - Inlay Hints - Code vision을 비활성화할 것
• callBack()을 사용할 때 턴을 소모하지 않으면 다음 동작까지 행동을 지연시킬 수 있다(ex. 공격 후 다음 행동시 데미지 등)
• 공격 시 번개 이펙트 및 연쇄 데미지 효과를 주고 싶다면 다음 코드를 적절히 변형해 사용할 것
• 텍스트 블럭(PixelScene.renderTextBlock)을 추가했는데 줄바꿈이 안 된다면 .maxWidth(WIDTH)로 최대 너비를 지정해 보자.

ArrayList<Lightning.Arc> arcs = new ArrayList<>(); ArrayList affected = new ArrayList<>(); affected.clear(); arcs.clear();

Shocking.arc(hero, enemy, 2, affected, arcs);

affected.remove(enemy); //defender isn't hurt by lightning for (Char ch : affected) { if (ch.alignment != hero.alignment) { ch.damage(Math.round(dmg*0.2f), this); } }

hero.sprite.parent.addToFront( new Lightning( arcs, null ) ); Sample.INSTANCE.play( Assets.Sounds.LIGHTNING );

• 영웅 스프라이트 이미지의 크기를 늘리고 싶다면

HeroSprite.java의 tiers() 메소드 내에서 SmartTexture texture = TextureCache.get( Assets.Sprites.ROGUE );에서 Assets.Sprites.ROGUE를 크기를 늘려 놓은 스프라이트로 바꿀 필요가 있다

• 영웅 선택 창의 영웅 대표 이미지를 바꾸고 싶다면

HeroSelectScene.java에서 icon(new Image(cl.spritesheet(), 0, 90, 12, 15));를 임의의 좌표로 바꾸면 된다

• 가방 창의 슬롯 색을 바꾸고 싶다면 InventorySlot.java로 가면 된다

InventoryPane.java의 BagButton클래스는 전체 스케일의 UI에서 특수 가방 탭 색에 사용된다. WndRanking.java -> ItemButton, QuickSlotButton (둘 다) -> createChildren() -> bg 색도 변경해야 랭킹의 아이템 슬롯 색깔이 바뀜

• 특정 타일이 맵 밖이 아닌지를 판별하는 조건

if (c >= 0 && c < Dungeon.level.length())

• PathFinder.NEIGHBORS~ 를 사용하지 않고 범위를 지정하는 방법 : PathFinder.buildDistanceMap 활용
• 신규 층 추가를 했는데, 내려가는 계단이 작동을 안 하면 Hero.handle()에서 Dungeon.depth < 26를 바꿔볼 것
• 버프창 갱신하는 코드는 BuffIndicator.refreshHero();다.
• 스프라이트 크기 조절하는 방법

스프라이트.java 파일에 가서 super(); 밑에 this.scale.set(0.5f, 0.5f);를 추가해 준다. 이 예시는 가로, 세로를 각 0.5배한 효과를 낸다.

• Generator.random()메서드를 사용해 아이템을 생성하면 이후 생성되는 아이템에 영향을 줄 수 있다. 즉 같은 시드라도 다른 아이템이 생성될 수 있는 것이다. 층 생성 시 랜덤 생성되는 아이템이 아니라면 Generator.randomUsingDefaults()메서드를 사용하도록 하자. 이것은 덱에서 아이템을 꺼내오지 않으며, 따라서 이후 층 생성 시 생성되는 아이템에도 영향을 주지 않는다.
• 실제 시간을 기다리게 하기 위한 클래스는 Tweener이며, onComplete()는 시간이 다 지난 후에 작동하고, updateValues()는 시간이 지나면서 지난 시간을 변수로 가지고 작동한다. 이를 통해 행동에 실제 시간을 기반으로 지연 시간을 줄 수 있다.
• 최신 버전의 녹픽던은 버전명에 INDEV가 포함된 개발 버전만 깃허브 업데이트를 체크하기 때문에, UpdateImpl.supportsUpdates()가 항상 true를 리턴하도록 바꾸면 버전에 관계없이 깃허브 업데이트를 체크하게 만들 수 있다. 깃허브 주소는 GithubUpdates.checkForUpdate()에서 바꿀 수 있다.

---

• 인스턴스에 대하여

'인스턴스를 생성한다' 라는 말은 설계도로부터 물건을 찍어내는 작업으로 비유할 수 있다. 클래스 하나를 가지고 독립적인 물체를 생산해 내어 사용하는 것이다.

예를 들어 ShortSword.java가 설계도고, ShortSword weapon = new ShortSword();를 통해 weapon이라는 이름을 가진 숏소드를 하나 생산해 내는 것이다.

static이 아닌 인스턴스 변수는 각 인스턴스(물건)이 공유하지 않는다. 독립적이라는 뜻이다.

• static에 대하여

static은 인스턴스 생성 없이 접근 가능한 메모리 상단에 위치하게 만드는 것을 의미한다. 따라서 인스턴스 생성 없이 클래스명.static멤버변수명 혹은 클래스명.static메서드명으로 접근해야 한다.

인스턴스명.static멤버명으로 접근 자체는 가능하나 이렇게 할 경우 이것이 static멤버인지 아닌지 혼란이 오기 때문에 사용하지 않는 것이 바람직하다.

인스턴스 메서드에 static 요소가 사용될 경우 에러가 발생하지 않음 : 이유는 static 요소는 클래스를 생성할 때 같이 생성되어 있어 인스턴스 생성 이전에도 사용이 가능하기 때문.

반대로 static 메서드에 인스턴스 요소가 사용될 경우 에러 발생 : 이유는 인스턴스 생성이 필요한 요소가 인스턴스 생성이 되지 않은 상태에서 호출될 수 있기 때문. 인스턴스가 언제 생성될 지 모르는 상황에서 인스턴스가 필요한 코드를 작성하는 것은 잘못된 것이고, 실제로 오류가 발생한다 : Cannot use this in a static context 에러

static을 남발할 경우 메모리 상단에 "항상" 위치하는 것들이 많아짐을 의미하며, 이는 불필요함에도 항상 준비중임을 뜻한다. 즉 사용 가능한 메모리 양이 줄어든다는 의미이고, 이는 최적화 문제로 이어진다.

• 필드의 다형성

필드의 다형성이란 조상클래스를 상속받은 객체를 조상클래스의 타입으로 생성할 수 있게 되는 것을 의미한다.

필드의 다형성을 적용하여 생성된 인스턴스들은 조상클래스라는 하나의 '종류'에 속하게 되어 조상클래스를 매개변수로 삼는 메서드에 들어가거나 할 수 있다.

이렇게 생성된 인스턴스는 자손클래스에서 독립적으로 선언된 멤버는 사용이 불가능하며, 조상클래스에서 선언된 메서드만 사용 가능한데, 이 때 자손클래스에서 오버라이딩된 메서드의 경우는 자손클래스의 것이 사용된다.

즉, 필드의 다형성을 사용하는 이유는 같은 메서드를 자손클래스별로 다르게 구현하여 사용하고 싶을 때 사용하게 되는 것이다.

추상메서드와 인터페이스의 경우도 마찬가지로, 이들 또한 리턴타입이나 인스턴스 타입으로 선언될 수 있지만, 멤버 메서드의 경우는 자손의 것을 사용하게 된다.

가령, 인터페이스 A를 Member클래스가 구현(implement)했을 경우 A a = new Member();로 인스턴스 생성이 가능하며,

A에 method();가 선언되어 있고, Member에서 그것을 오버라이드했다면(만약 오버라이드하지 않았을 경우 Member는 추상클래스가 되어야 한다) a.method()는 Member클래스에서 구현한 메서드가 선언된다.

• 추상클래스와 인터페이스

추상메서드란, 메서드의 선언부만 존재하고 구현부({})가 존재하지 않는 메서드를 말한다.

추상클래스란, 추상메서드가 하나라도 있는 클래스를 의미한다.

추상클래스는 절대로 인스턴스를 생성할 수 없다. 왜냐하면, 미완성의 메서드가 존재하기 때문이다.

추상클래스는 자손클래스가 추상클래스를 상속받고 조상의 추상메서드를 오버라이드하여 구현부를 구현함으로써 완성된다

이렇게 추상클래스를 완성한 자손클래스는 인스턴스 생성이 가능하며, 만약 미구현된 메서드가 남아 있다면 자손클래스 또한 추상클래스가 된다.

추상클래스는 여러 자손 클래스들이 공통적으로 사용하지만, 구현부는 다른 메서드들이 필요할 때 조상클래스로서 사용된다.

추상클래스는 다른 조상클래스들과 마찬가지로 메서드의 매개변수로 들어가거나, 메서드의 리턴타입이 되거나, 인스턴스의 타입이 되는 것(필드의 다형성)이 가능하다.

인터페이스란 추상클래스와 비슷하지만, 클래스가 아니다.

인터페이스에는 미구현된 메서드만이 존재하며, 멤버변수는 자동으로 static final이 된다.

인터페이스를 구현할 때에는 추상클래스와 다르게 상속이 아닌 구현(implements)를 사용하개 된다.

인터페이스는 추상클래스와 달리 클래스가 아니기 때문에, 클래스의 공통조상인 Object를 조상으로 삼지 않는다.

인터페이스를 implement한 클래스에서, 인터페이스의 미구현된 메서드를 하나라도 구현하지 않았다면 그 클래스는 추상클래스가 된다.

인터페이스 또한 추상클래스와 마찬가지로 메서드의 매개변수로 들어가거나, 메서드의 리턴타입이 되거나, 인스턴스의 타입이 되는 것(필드의 다형성)이 가능하다.

인터페이스는 서로 다른 클래스에 간접적인 관계를 만들어줄 수 있다. (List, Set, Map계열 등)

인터페이스를 만들어 놓으면 이를 구현하는 클래스에서 어떤 메서드를 사용할 지 정해놓을 수 있기 때문에, 표준화가 가능하고, 여러 명이 협업할 때 시간을 단축할 수 있게 해주는 역할을 한다.

인터페이스를 만든다는 것은 구현클래스에서 모두 메서드를 구현해야 하므로 보다 일관된 개발이 이루어져 정형화가 가능하다는 것이다.

• 모바일 로그캣 생성방법
• 만약 아이템의 강화수치가 1 이상인데도 보이지 않는다면 levelKnown을 true로 만들어볼 것